Connecter Unit4 avec eConnect : ERPx via l'Autopilot, ERP CR via SFTP et Financials via HTTPS.
Unit4 propose en 2026 trois variantes, chacune avec sa propre méthode d'intégration. La variante applicable dépend de votre produit Unit4.
Vous connectez Unit4 ERPx via l'Autopilot. Les factures d'achat sont automatiquement importées et comptabilisées. La configuration est mise en place lors de l'implémentation avec eConnect.
La configuration Autopilot passe par un assistant par étapes sur la plateforme eConnect :
Attention : traitez d'abord tous les documents via l'ancienne route avant de basculer. La configuration de la connexion n'est pas réalisée par le client lui-même, mais lors de l'implémentation.
Lors de la comptabilisation via Unit4 ERPx, le message [U4OK.JSON]: System.Int32 overflow peut apparaître. Cause : le numéro de facture est numériquement si grand qu'il dépasse la limite d'un entier 32 bits (maximum 2.147.483.647). Dans cette partie du traitement Unit4, le système ne peut alors pas traiter le numéro. Il s'agit d'une limitation dans Unit4 lui-même, et non dans la connexion eConnect ni dans notre code d'intégration.
En pratique, cela se produit chez les organisations qui utilisent des séries très élevées pour les numéros de factures sortantes (par exemple des valeurs largement supérieures à 2 milliards).
Que pouvez-vous faire ? La solution doit venir d'Unit4. Modifier le numéro de facture dans le XML source via eConnect n'est pas une solution de contournement viable sans risque pour votre administration et votre numérotation. Unit4 en est informé et travaille à une correction structurelle. En attendant : escaladez vers votre administrateur ou partenaire Unit4 et, si nécessaire, utilisez le téléchargement XML depuis la plateforme eConnect (Boîte de réception) pour documenter le cas.
Unit4 ERP CR (y compris ERP7) et Unit4 Financials by Coda se connectent respectivement via SFTP et HTTPS. Ces connexions enterprise nécessitent un contrat et sont configurées par Unit4 ou un partenaire Unit4 en collaboration avec eConnect.
La méthode d'intégration standard pour Unit4 ERP CR et ERP7 est SFTP (Secure File Transfer Protocol). Pour plus d'informations sur la mise en place technique d'une connexion SFTP, consultez l'article Intégration SFTP.
Par le passé, il pouvait arriver qu'une facture soit comptabilisée avec succès dans Unit4 ERPx, mais que la pièce jointe PDF ne soit pas transmise. La cause était une rupture de connexion côté Unit4, entraînant la suppression du PDF. Depuis mai 2026, ces cas sont automatiquement retentés, confirmé par Platform & Integraties. Dans la plupart des situations, vous ne rencontrerez donc plus ce problème.
Si vous rencontrez toutefois encore un cas où une facture est comptabilisée mais la pièce jointe PDF manque, il s'agit d'un cas résiduel. Suivez alors le chemin de diagnostic ci-dessous pour déterminer si le document est réellement perdu ou s'il s'agit d'une correspondance idempotente.
Conseil : vous pouvez toujours télécharger la facture depuis la plateforme eConnect (Boîte de réception, trois points à côté du document). Transmettez le document manuellement à votre administrateur Unit4 si nécessaire.
Unit4 ERPx ne peut pas traiter les factures d'achat sans date d'échéance (DueDate/PaymentDueDate) ; le champ n'est pas obligatoire dans le XML. Lorsqu'une facture arrive sans ce champ, eConnect définit par défaut le PaymentDueDate à l'IssueDate (date de facture) plus 30 jours. Cela évite l'échec de la comptabilisation pour un champ formellement manquant, alors que le délai de paiement effectif est le plus souvent de 30 jours en pratique.
Il s'agit d'un Rule Based Enrichment (RBE) standard, configuré par client en tant que PrivateObject dans la PSB (typiquement avec l'Id unit4-setDueDate-30days). Si vous souhaitez utiliser un autre délai par défaut, contactez le support ; ce n'est pas un paramètre en libre-service.
Ce chemin de diagnostic s'applique aux plaintes du type « la facture est sur Booked dans eConnect, mais je ne la vois pas dans ERPx » ou « la facture ne semble jamais être arrivée, le Document Journal ne montre rien ». Contexte : la route Autopilot ↔ Unit4 ERPx est idempotente (correspondance sur numéro de facture plus client plus fournisseur). En cas de correspondance, eConnect n'appelle plus ERPx et ne télécharge qu'un PDF manquant, tandis que la plateforme affiche quand même Booked. Un Document Journal vide pour la deuxième soumission ne signifie donc généralement pas que la facture est perdue, mais que la vérification idempotente a été activée. Voir aussi Autopilot — comptabilisation idempotente.
L'interprétation des libellés de statut diffère selon le type de connexion. Déterminez s'il s'agit d'Autopilot (Unit4 ERPx), d'une autre route PSB, d'une API SOAP directe ou d'une connexion SFTP. Consultez le tableau des statuts dans Autopilot — Statuts de comptabilisation pour la signification par type de connexion.
Notez au minimum l'un de ces deux identifiants pour le document :
documentId (provenant du PSB), ouconsignmentId (provenant de la plateforme).L'un des deux suffit pour retrouver le document dans tous les systèmes internes.
Ouvrez le document dans la Management API interne via documentId ou consignmentId et consultez la chronologie Events. Elle indique, pour chaque étape, quelle action a été effectuée sur le document : réception, validation, soumission à ERPx, retries, correspondance idempotente et téléchargement PDF. Pour les connexions SFTP, c'est le seul endroit où le statut de livraison est visible, car le progiciel via SFTP ne renvoie pas de statut.
Voyez-vous dans la chronologie Events qu'eConnect a reconnu la facture comme existante (même numéro de facture, client et fournisseur) et n'a effectué qu'un téléchargement PDF ? Alors il s'agit d'un comportement attendu. La facture était déjà dans ERPx lors d'une soumission antérieure. Communiquez cela au client ; une escalade n'est pas nécessaire.
Uniquement lorsque la chronologie Events ne donne pas une image cohérente, escaladez vers l'équipe technique. Fournissez au minimum :
documentId ou consignmentId,partyId du destinataire,Lors du traitement de factures via la transformation ABWInvoice (utilisée pour les intégrations Agresso/Unit4), le message d'erreur [API400]: Initializing failed. Unhandled error occurred. peut apparaître. La cause est que la transformation a été construite sur la base des documents de test initiaux. Les variantes de documents divergentes (comme les factures free text) contiennent des champs absents du mapping, ce qui fait échouer la transformation.
Une demande de modification est en cours pour étendre la transformation à plusieurs types de documents. Si vous rencontrez ce message d'erreur, contactez le support.
Pour les intégrations Unit4 avec des devises étrangères (par ex. USD avec taux de change), la configuration des devises relève de la responsabilité du client dans l'environnement Unit4. eConnect traite ce que l'ERP fournit. Les questions de support concernant les devises étrangères renvoient vers la configuration ERP du client.
Les messages d'erreur commençant par le préfixe U4 proviennent d'Unit4 ERPx. La solution se trouve presque toujours côté Unit4. Vous pouvez télécharger le fichier XML depuis la plateforme eConnect (Boîte de réception, trois points à côté du document) et le transmettre à votre administrateur Unit4.
Mapping TVA : différence entre factures entrantes et sortantes
Pour les factures entrantes (Autopilot), eConnect assure le mapping TVA. Vous configurez le schéma via Plateforme > Autopilot > Connexion > Schéma de comptabilisation > GÉRER LES SCHÉMAS > TVA. Pour les factures sortantes, eConnect n'effectue pas de mapping TVA : Unit4 doit lui-même fournir les codes UNCL5305 corrects dans le XML de la facture.
Il s'agit d'un message d'erreur générique pouvant avoir plusieurs causes : un time-out chez Unit4, une facture avec plus de 200 lignes, des lignes de facture d'un montant de € 0, ou des codes TVA en double dans le schéma de comptabilisation. Soumettez la facture à nouveau via la Boîte de réception. Si l'erreur persiste, comptabilisez la facture manuellement dans ERPx et vérifiez le schéma TVA pour les doublons.
La combinaison fournisseur et numéro de facture existe déjà dans Unit4. Vérifiez si la facture a déjà été soumise (par exemple via une autre route) et si l'IDR a correctement reconnu le numéro de facture. Si la facture est réellement en double, vous n'avez rien à faire. S'il s'agit d'un autre document avec le même numéro, vérifiez la reconnaissance dans la plateforme eConnect.
Le XML de la facture contient un code TVA absent du schéma de comptabilisation Autopilot. Cela se produit surtout pour les factures reçues par e-mail avec un code TVA divergent ou incorrect. Ajoutez le mapping manquant via Plateforme > Autopilot > Connexion > Schéma de comptabilisation > GÉRER LES SCHÉMAS > TVA, ou demandez au fournisseur d'envoyer la facture via Peppol (ce qui utilise des codes TVA standard).
Le créancier dans Unit4 ERPx n'a pas de délai de paiement (condition de paiement) configuré. eConnect ne transmet pas lui-même de date d'échéance à Unit4. Configurez le délai de paiement sur la fiche fournisseur dans Unit4 ERPx.
Le Dummy Crediteur dans Unit4 n'est pas actif. Activez le Dummy Crediteur dans Unit4 ERPx et soumettez les factures à nouveau.
Le total de la facture est de € 0,00. Une facture sans montant ne peut pas être comptabilisée dans Unit4.
Le cycle de comptabilisation (boekingscyclus) dans Unit4 ERPx n'est pas correctement configuré ou n'est pas actif pour la période concernée. Vérifiez et activez le bon cycle de comptabilisation dans Unit4.
La référence de paiement sur la facture dépasse 27 caractères, ce qu'Unit4 n'accepte pas. Comme solution temporaire, vous pouvez envoyer la facture en PDF au lieu de via la connexion automatique. Structurellement, le fournisseur doit raccourcir la référence de paiement.
L'utilisateur machine-to-machine (M2M) avec lequel eConnect se connecte à Unit4 dispose de droits insuffisants ou a été désactivé. Demandez à l'administrateur Unit4 de vérifier et de restaurer les droits de l'utilisateur M2M eConnect.
La facture est comptabilisée sur le Dummy Crediteur, mais un document antérieur avec le même numéro de facture s'y trouve déjà. Traitez d'abord la facture existante sur le Dummy Crediteur, puis soumettez la nouvelle facture à nouveau.
La configuration de routage dans Unit4 ERPx manque un nœud pour le workflow indiqué. Il s'agit d'un problème côté Unit4. Téléchargez le XML depuis la plateforme eConnect et transmettez-le à votre administrateur Unit4 pour ajuster le routage.
Le PDF joint contient un préfixe « data » invalide dans les données Base64 (par exemple dataJVBERi0x... au lieu de JVBERi0x...). Pour les factures reçues via l'IDR, cela est automatiquement corrigé. Pour les factures reçues directement via Peppol, ce problème peut encore survenir. L'expéditeur source doit corriger le XML.
Unit4 ERPx se connecte via l'Autopilot pour la réception automatique des factures d'achat. Unit4 ERP CR et ERP7 utilisent SFTP, et Unit4 Financials by Coda se connecte via HTTPS. Ces deux dernières variantes nécessitent un contrat et sont configurées par Unit4 ou un partenaire Unit4.
Pour Unit4 ERPx, la configuration est mise en place lors de l'implémentation avec eConnect, et non par le client lui-même. Pour Unit4 ERP CR et Financials by Coda, la configuration est réalisée par Unit4 ou un partenaire Unit4 en collaboration avec eConnect.
::e-accordion-item{value="item-3" header="Que faire en cas de message d'erreur "Int32 overflow" avec de grands numéros de facture ?"} Il s'agit d'une limitation dans Unit4 lui-même lorsque le numéro de facture est supérieur à 2.147.483.647. La solution doit venir d'Unit4. Escaladez vers votre administrateur ou partenaire Unit4 et, si nécessaire, utilisez le téléchargement XML depuis la plateforme eConnect pour documenter le cas. ::
Vous souhaitez connecter Unit4 ? Contactez Unit4 ou votre partenaire Unit4, ou eConnect commercial pour un entretien d'accueil.
Démarrer la connexion