Messaggi di errore e soluzioni per pacchetto ERP. Questo articolo tratta gli errori specifici di ogni pacchetto. Per problemi generici di API, webhook e connettività: vedere Risoluzione problemi integrazioni.

I messaggi di errore con il prefisso U4 provengono da Unit4 ERPx. La soluzione si trova quasi sempre sul lato software, non in eConnect. Il cliente può scaricare il file XML dalla piattaforma e inviarlo all'amministratore Unit4.

Compensazione DueDate: Unit4 non può elaborare le fatture senza DueDate/PaymentDueDate (il campo non è obbligatorio nell'XML). eConnect imposta di default il PaymentDueDate sulla IssueDate (data della fattura) più 30 giorni quando questo campo è assente. Si tratta di una Rule Based Enrichment standard, configurata per cliente come PrivateObject nella PSB (tipicamente con Id unit4-setDueDate-30days).

Fattura registrata ma allegato PDF mancante: le precedenti interruzioni di connessione dal lato Unit4 dove il PDF andava perso vengono ora riprovate (confermato da Platform & Integrazioni, maggio 2026). Casi rimanenti: vedere il percorso diagnostico di seguito.

UBW è il nome classico Agresso/UBW; all'interno di eConnect lo usiamo come alias di ricerca insieme a Unit4 ERPx, dove avviene questo inoltro.

Sintomo: una fattura in entrata (spesso non-Peppol) è stata inviata manualmente via e-mail a @trust.econnect.eu, è visibile nella piattaforma, ma non è ancora in UBW/Agresso o nel pacchetto finanziario collegato. Vedere anche Email Receiver per l'afflusso tramite questo indirizzo.

Fai prima questa distinzione, prima di escalare:

1. Ritardo temporaneo di batch o inoltro: il documento è correttamente nella piattaforma, ma il processo automatico di recupero o registrazione del cliente deve ancora essere eseguito o è in corso. Questo di solito si risolve da sé; non c'è un'interruzione.
2. Non arrivata permanentemente: dopo l'esecuzione prevista, la fattura è ancora assente. Continua allora con Diagnostica: fattura non ricevuta in ERPx senza messaggio di errore di seguito (tipo di integrazione, documentId/consignmentId, Events, idempotenza tra Autopilot e ERPx).

In caso di segnalazione recente:

1. Confermare la visibilità e lo stato della fattura nella piattaforma.
2. Chiedere il tipo di integrazione o il pacchetto ERP (UBW/Agresso, Unit4 ERPx via Autopilot, SFTP/PSB, ...) e se il processo automatico è già stato eseguito oggi.
3. Il processo non è ancora stato eseguito o è in corso? Attendere quindi brevemente e confermare dopo l'esecuzione. Non escalare prematuramente.
4. Il processo è stato eseguito e la fattura è ancora permanentemente assente? Raccogliere gli ID e seguire il percorso diagnostico di seguito.

Non esiste un SLA fisso in ore tra l'invio tramite Email Receiver e l'elaborazione in UBW/ERPx.

Questo percorso si applica a reclami come "Registrato in eConnect ma non visibile in ERPx" o "La fattura sembra non essere mai arrivata, nessun messaggio nel Document Journal".

Contesto: La route Autopilot -- Unit4 ERPx è idempotente (corrispondenza su numero fattura + cliente + fornitore). In caso di corrispondenza, ERPx non viene chiamato nuovamente e viene caricato solo un PDF mancante, mentre la piattaforma mostra comunque Booked. Un Document Journal vuoto per il secondo invio non significa quindi che la fattura è andata persa, ma generalmente che è stata attivata la verifica idempotente.

Verifica prima questo con un partner Unit4 con più fatture:

0. Solo consegnato, nessun journal: lo stato Delivered/Ricevuto nella Posta in arrivo con 0 risultati nei Document Journal significa che non è ancora avvenuto alcun tentativo di registrazione Autopilot (Booked/Booking failed). Ripresentare prima la fattura al software collegato; avviare un'indagine Events solo dopo. Vedere Autopilot -- Registri documenti.
1. Separare le parti: il cliente destinatario (utente ERPx) non è lo stesso del fornitore sulla fattura, né lo stesso di un'eventuale parte intermedia su un log allegato.
2. Log o documento corretto: verificare se l'allegato o il log eConnect è il documento rivendicato (numero fattura, fornitore verso destinatario). Un log errato è un documento diverso; non avviare un'indagine ERPx su di esso.
3. Identificativo per fattura rivendicata: come minimo il numero di fattura, preferibilmente anche documentId o consignmentId. Più numeri di fattura mancanti sono documenti separati; Booked sulla fattura A non copre la fattura B.
4. Booked più errore di duplicato (ad es. invoice number already exists, o dopo un nuovo invio): spesso lo stesso numero di fattura è stato inviato di nuovo. La piattaforma può mostrare Booked sulla registrazione precedente; questo non è prova che un altro numero di fattura sia in ERPx. Confermare questo tramite Events (passo 3 di seguito) o una registrazione ERPx esistente.

Passi:

La trasformazione ABWInvoice è stata creata sulla base dei documenti di test originali. Le varianti di documenti non standard (es. fatture in testo libero) possono fallire con "API400: Initializing failed". Soluzione: richiesta di modifica allo sviluppo per un'estensione della trasformazione.

I messaggi di errore con il prefisso BC provengono da Business Central. Poca influenza da parte di eConnect; il cliente deve verificare la configurazione BC.

Il prefisso tra parentesi quadre indica il tipo di risposta che eConnect ha ricevuto da Business Central durante la registrazione della fattura:

• [BC400] -- una richiesta rifiutata da Business Central (BC ha restituito un errore di tipo 400). Si tratta quasi sempre di un errore di validazione o relazione di tabella nella configurazione BC del cliente (es. un valore mancante in una tabella correlata o un campo che non soddisfa una condizione BC). Il testo direttamente dopo [BC400]: (come Internal_InvalidTableRelation o Application_FieldValidationException) nomina l'errore BC concreto e punta al campo o alla tabella da correggere.
• [BCBadRequest] / [BCNotFound] / [BCTooManyRequests] -- risposte simili dal lato BC (richiesta rifiutata, non trovata, limite di velocità).
• [API400] -- rifiutato dall'API eConnect stessa, per BC (es. un'impostazione di connessione errata).

In tutti i casi di prefisso BC, la soluzione risiede dal lato BC (configurazione del cliente); eConnect ha poca influenza qui.

Interruzione nota? Verifica prima status.exact.com per le interruzioni Exact attuali -- indipendente dalla pagina di stato propria di eConnect (support.econnect.eu/status/). Un'interruzione presso Exact stesso (ad es. Exact Online, Exact API) a volte spiega errori non legati al collegamento eConnect.

Connessione: SOAP-enterprise, solo ricezione (acquisti). Configurazione: Collegare ECI Inventive.

Due cause, da non confondere:

1. Interruzione della piattaforma eConnect: ad esempio allegati PDF non consegnati. Controlla lo stato della fattura nella Posta in arrivo eConnect.
2. Errore di validazione del payload proprio sul lato Inventive: fuori dall'ambito del supporto eConnect. L'amministratore Inventive indaga su questo.

Stato "elaborata" nella Posta in arrivo eConnect significa che eConnect ha consegnato correttamente la fattura. Se la fattura manca ancora in Inventive dopo, controlla prima il payload/import di Inventive (lavori batch), non di nuovo la ricezione eConnect.

Per ogni pacchetto ERP si applicano i seguenti passi:

1. Testare la connessione: tutti i pacchetti richiedono la porta 443 verso l'endpoint eConnect.
2. Revocare l'integrazione software: Piattaforma > Connessioni > Revocare la chiave > rimuovere anche nel software collegato.
3. Reinviare i documenti: Posta in arrivo/in uscita > tre punti > "Reinviare il download API". Per il contrassegno duplicato, prima "Contrassegnare come originale".