Dépannage de la migration JTL

Tu trouveras ici des solutions aux écueils les plus fréquents lors de la migration depuis JTL-Wawi.

#Connexion

#jtl-bridge signale « Die Wawi-API … ist nicht erreichbar » (l'API Wawi … est inaccessible)

jtl-bridge n'atteint pas le serveur REST. Vérifie : le serveur REST tourne-t-il ? Le port et le nom de la base de données sont-ils corrects dans l'adresse ? Le port est celui que tu as réglé dans la Wawi pour le serveur REST (p. ex. 5883 ou 5885). Au démarrage, le programme cherche lui-même sur les ports 5883 à 5890 et redemande après un échec. Le plus simple est de lancer jtl-bridge directement sur l'ordinateur où tourne ta JTL-Wawi. Si tu le lances sur un autre PC, le pare-feu Windows du serveur doit autoriser le port.

#« Die Wawi-API lehnt den API-Schlüssel ab » (l'API Wawi refuse la clé API)

L'application a été supprimée dans la Wawi ou la clé est incorrecte. Relance simplement jtl-bridge : il enregistre alors de nouveau allverto, tu parcours l'assistant de la Wawi jusqu'à Einrichtung abschließen, et la nouvelle clé remplace l'ancienne. Détails : Configurer l'API REST.

#Comment enregistrer allverto dans la Wawi ?

Dans la JTL-Wawi, ouvre Anwendungsregistrierungen (enregistrements d'applications) → Anwendung registrieren (enregistrer une application) et avance jusqu'à Registrierung beginnen (commencer l'enregistrement). Ce n'est que lorsque « Es wird auf die Übermittlung einer Registrierungsanfrage … gewartet » (en attente d'une demande d'enregistrement) y est affiché que tu appuies sur Entrée dans la fenêtre de jtl-bridge – avant, la Wawi n'accepte aucune demande. Ensuite, vérifie Anwendungsinformationen, choisis un utilisateur Wawi sous Benutzer, confirme les droits (lecture seule) sous Zugriffsverwaltung et clique sur Einrichtung abschließen (terminer la configuration).

#Où trouver la clé API dans la Wawi ?

Nulle part – et c'est voulu. La Wawi n'affiche aucune clé et n'en crée pas d'un clic. Elle ne la délivre qu'à une application qui en fait la demande à cet instant. C'est jtl-bridge qui s'en charge et qui transmet la clé chiffrée à allverto.

#« Tester la connexion » indique que le test est fait par jtl-bridge

Ton adresse (p. ex. localhost ou 192.168.…) n'est accessible que sur ton serveur ou dans ton réseau d'entreprise, pas depuis Internet. Lance jtl-bridge sur le serveur et colle le code de configuration – le résultat s'affiche dans l'assistant.

#La fenêtre indique « Login failed » pour SQL Server

Il s'agit de l'utilisateur et du mot de passe SQL Server (généralement sa), pas de ta connexion à la JTL-Wawi. Après un échec, la fenêtre redemande – saisis simplement à nouveau les informations. Détails : Accès via la base de données JTL.

#« Nur HTTPS ist erlaubt » (seul HTTPS est autorisé)

Pour des raisons de sécurité, jtl-bridge ne téléverse que via https://. Recopie le code de configuration depuis allverto – il contient la bonne adresse.

#« Récupérer les données directement maintenant » échoue

Cela ne fonctionne que si ton serveur Wawi est accessible depuis Internet et ouvre le port pour les serveurs allverto (2.31.70.120, 2.31.74.112, 2.31.72.228). Vérifie l'adresse avec Tester la connexion. Pour l'API Wawi, la clé API doit en plus être enregistrée (Envoyer l’enregistrement depuis allverto). Si ton serveur n'est accessible que dans ton réseau, utilise jtl-bridge sur l'ordinateur où tourne ta JTL-Wawi.

#« Dein REST-Server antwortet nur über HTTPS » (ton serveur REST ne répond qu'en HTTPS)

Ton serveur REST n'accepte que des connexions via https://. Dans le résultat du test, clique sur Changer l’adresse en https://. allverto enregistre l'adresse et teste à nouveau.

#allverto demande de confirmer le certificat

Ton serveur REST utilise un certificat créé par toi. allverto affiche l'empreinte (SHA-256), l'émetteur et la validité. Compare l'empreinte avec le certificat de ton serveur et clique sur Faire confiance à ce certificat. Ensuite, allverto ne se connecte qu'avec exactement ce certificat. Si allverto signale plus tard un autre certificat, ne le confirme que si tu l'as renouvelé toi-même.

#Données et simulation

#Les quantités sous « Données trouvées » ne correspondent pas à ma Wawi

Si tu as saisi une date de bascule, seuls les documents jusqu'à cette date sont pris en compte. Avec la voie API, les abonnements et les factures fournisseurs manquent si Compléter les données manquantes depuis la base de données est désactivé.

#Que signifient les résultats dans le journal ?

Pour chaque enregistrement, tu vois s'il a été créé, mis à jour, ignoré (inchangé ou non pris en charge) ou rejeté – avec le motif. Filtre par résultat et par type de données, et télécharge le journal en CSV si besoin.

#Pourquoi certains attributs sont-ils « ignorés » ?

L'API Wawi ne fournit les attributs d'article que sous forme d'identifiant sans nom. Avec Compléter les données manquantes depuis la base de données, jtl-bridge complète les noms.

#Les données sont-elles créées en double si je reprends plusieurs fois ?

Non. allverto mémorise pour chaque enregistrement JTL ce qu'il est devenu. Les enregistrements inchangés sont ignorés, ceux modifiés sont mis à jour.

#Pourquoi les factures reprises ne prennent-elles pas de nouveau numéro ?

Les documents sont repris à l'identique avec leur numéro d'origine de JTL. C'est pourquoi tu reprends les plages de numéros d'abord – ainsi, après la migration, la numérotation continue avec le prochain numéro libre.

#Finalisation

#Puis-je resynchroniser après la finalisation ?

Non. Après Terminer la bascule, le code de configuration n'est plus valable et la zone tampon est supprimée. Le jour de la bascule, lance donc d'abord une exécution delta et vérifie le journal.

#Les journaux sont-ils conservés ?

Oui. Les données reprises, les correspondances et les journaux sont conservés même après la finalisation.