Cele Mai Frecvente Greșeli EDI

Top 10 erori întâlnite la implementare — cauze și rezolvări

Documentul acoperă erorile care apar cel mai des în primele luni de integrare EDI cu Azuvio / CRMconnect. Fiecare eroare este documentată cu simptomul exact, cauza tehnică și pașii de rezolvare.

Eroarea 1 — GLN cu număr greșit de cifre

Simptom: Partenerul sau sistemul receptor returnează eroare de tip Invalid GLN sau Party not found, deși GLN-ul pare corect.

Cauză: GLN-ul a fost trimis ca tip numeric (integer) în loc de string. Aplicația sursă a eliminat cifra 0 de la începutul numărului. De exemplu, GLN-ul 0594123456789 (13 cifre) a ajuns ca 594123456789 (12 cifre).

Rezolvare: Stocați și transmiteți întotdeauna GLN-ul ca string de exact 13 caractere. Dacă baza de date stochează valoarea numeric, convertiți cu padding la stânga înainte de a scrie în mesajul EDI.

<!-- Greșit -->
<GLN>594123456789</GLN>

<!-- Corect -->
<GLN>0594123456789</GLN>

Eroarea 2 — UNT count incorect

Simptom: Mesajul EDIfact este respins cu eroare de tip Segment count mismatch sau UNT count error.

Cauză: Valoarea din segmentul UNT (primul element, care declară numărul de segmente) nu corespunde cu numărul real de segmente din mesaj. Se întâmplă de obicei când segmente sunt adăugate sau eliminate manual după ce contorul a fost calculat.

Rezolvare: Numărați toate segmentele de la UNH până la UNT inclusiv (ambele capete sunt incluse) și puneți acea valoare în UNT. Calculul trebuie efectuat automat de aplicație, nu manual.

UNH+1+ORDERS:D:01B:UN:EAN010'   ← segment 1
BGM+220+CMD001+9'                 ← segment 2
DTM+137:20240307:102'             ← segment 3
... (alte segmente) ...
UNT+[TOTAL]+1'                    ← ultimul segment, TOTAL = numărul real

Eroarea 3 — DocumentType=OR în loc de O

Simptom: Comanda ajunge la receptor ca răspuns la o comandă, nu ca comandă nouă. Sistemul o poate ignora sau o poate asocia greșit cu o comandă anterioară.

Cauză: La transmiterea unei comenzi noi, câmpul DocumentType a fost setat la OR (Order Response — răspuns la comandă) în loc de O (Order — comandă nouă).

Rezolvare: Comenzile noi folosesc DocumentType=O. Verificați tabelul complet de valori acceptate în secțiunea DocumentType XML din Quick Reference.

<!-- Greșit — acesta este un răspuns la comandă, nu o comandă nouă -->
<DocumentType>OR</DocumentType>

<!-- Corect — comandă nouă -->
<DocumentType>O</DocumentType>

Eroarea 4 — Versiune EDIfact greșită (D.96A în loc de D.01B)

Simptom: Mesajul este respins sau procesat incorect. Eroarea din log poate fi Unknown message version sau Version not supported.

Cauză: Segmentul UNH conține referința la versiunea D.96A (o versiune EDIfact mai veche), în loc de D.01B care este standardul EANCOM utilizat în schimburile cu Azuvio / CRMconnect.

Rezolvare: Actualizați identificatorul de versiune în segmentul UNH pentru fiecare tip de mesaj.

<!-- Greșit -->
UNH+1+ORDERS:D:96A:UN'

<!-- Corect -->
UNH+1+ORDERS:D:01B:UN:EAN010'

Același format se aplică pentru DESADV, RECADV și INVOIC.

Eroarea 5 — SSCC cu număr greșit de cifre

Simptom: Codul SSCC de pe palet sau colet nu poate fi scanat sau este respins de sistem cu eroare Invalid SSCC length.

Cauză: SSCC-ul a fost generat cu 17 sau 19 cifre în loc de 18. Această eroare apare de obicei din cauza unui prefix de companie greșit sau a unui cifru de control calculat incorect.

Rezolvare: SSCC (Serial Shipping Container Code) trebuie să fie exact 18 cifre conform standardului GS1. Structura este: [extensie 1 cifră] + [prefix GS1 al companiei] + [număr serial] + [cifră de control]. Verificați că aplicația de generare SSCC produce întotdeauna exact 18 cifre.

<!-- Greșit -->
<SSCC>123456789012345</SSCC>    <!-- 15 cifre -->
<SSCC>1234567890123456789</SSCC> <!-- 19 cifre -->

<!-- Corect -->
<SSCC>123456789012345678</SSCC>  <!-- exact 18 cifre -->

Eroarea 6 — EAN/GTIN invalid (12 cifre în loc de 13)

Simptom: Produsul nu este recunoscut în sistemul receptor. Eroarea este de tip Product not found sau Invalid GTIN.

Cauză: EAN-ul a fost trimis în format UPC (12 cifre, standard american) în loc de EAN-13 (13 cifre, standard european). La fel ca la GLN, cifra 0 de la început a fost pierdută prin conversie numerică.

Rezolvare: Completați EAN-ul cu un zero 0 la stânga pentru a obține 13 cifre. Stocați și transmiteți EAN-ul ca string.

<!-- Greșit — format UPC american, 12 cifre -->
<EAN>594123456789</EAN>

<!-- Corect — format EAN-13 european, 13 cifre -->
<EAN>0594123456789</EAN>

Eroarea 7 — Format dată greșit

Simptom: Data din mesaj este interpretată greșit (zi și lună inversate) sau mesajul este respins cu eroare Invalid date format.

Cauză: Data a fost trimisă în format românesc (07/03/2024) sau în format compact fără separator (20240703) în câmpul XML, care acceptă doar formatul ISO 8601.

Rezolvare:

• În mesajele XML: formatul obligatoriu este YYYY-MM-DD (cu cratimă ca separator).
• În mesajele EDIfact: formatul este YYYYMMDD (fără separator), specificat împreună cu codul de format 102.

<!-- Greșit în XML -->
<Date>07/03/2024</Date>
<Date>20240307</Date>

<!-- Corect în XML -->
<Date>2024-03-07</Date>

<!-- Corect în EDIfact -->
DTM+137:20240307:102'

Eroarea 8 — Tabel TVA lipsă sau incomplet în INVOIC

Simptom: Factura este respinsă cu eroare Tax summary missing sau Tax lines incomplete. Alternativ, suma TVA din totale nu corespunde cu suma TVA-ului detaliat pe linii.

Cauză: Secțiunea TaxSummary lipsește complet din factură sau conține un singur TaxLine pentru toate cotele TVA, deși factura conține produse cu cote diferite (ex: 9% alimente și 19% alte produse).

Rezolvare: Adăugați câte un TaxLine separat pentru fiecare cotă TVA distinctă din factură. Fiecare TaxLine trebuie să conțină baza impozabilă și valoarea TVA aferente acelei cote.

<TaxSummary>
  <!-- Un TaxLine pentru cota de 9% -->
  <TaxLine>
    <TaxRate>9</TaxRate>
    <TaxableAmount>1000.00</TaxableAmount>
    <TaxAmount>90.00</TaxAmount>
  </TaxLine>
  <!-- Un TaxLine separat pentru cota de 19% -->
  <TaxLine>
    <TaxRate>19</TaxRate>
    <TaxableAmount>500.00</TaxableAmount>
    <TaxAmount>95.00</TaxAmount>
  </TaxLine>
</TaxSummary>

Eroarea 9 — Capital social lipsă în INVOIC

Simptom: Factura este respinsă de sistemul receptor sau generează avertisment RegisteredCapital missing or empty.

Cauză: Câmpul Seller/RegisteredCapital a fost lăsat gol sau omis din mesajul INVOIC. Conform legislației române, capitalul social trebuie menționat pe documentele fiscale emise de societăți comerciale.

Rezolvare: Completați câmpul cu valoarea capitalului social în RON, ca număr întreg fără separator de mii (fără punct sau virgulă).

<!-- Greșit -->
<RegisteredCapital></RegisteredCapital>
<RegisteredCapital>200.000</RegisteredCapital>

<!-- Corect -->
<RegisteredCapital>200000</RegisteredCapital>

Eroarea 10 — InvoiceSeries + InvoiceNumber depășesc 16 caractere

Simptom: Factura este respinsă sau trunchiată în sistemele mai vechi ale partenerilor. Eroarea poate fi Invoice reference too long sau Field length exceeded.

Cauză: Lungimea combinată a câmpurilor InvoiceSeries și InvoiceNumber depășește 16 caractere, limita acceptată de sistemele EDI mai vechi.

Rezolvare: Lungimea totală InvoiceSeries + InvoiceNumber nu poate depăși 16 caractere. Dacă seria sau numărul sunt alfanumerice și combinate depășesc limita, puneți întregul identificator al facturii în câmpul InvoiceSeries și lăsați InvoiceNumber gol sau cu valoarea 0.

<!-- Greșit — total 18 caractere -->
<InvoiceSeries>AZUVIO</InvoiceSeries>
<InvoiceNumber>2024031200001</InvoiceNumber>

<!-- Corect — total 16 caractere sau mai puțin -->
<InvoiceSeries>AZ</InvoiceSeries>
<InvoiceNumber>2024031200001</InvoiceNumber>

<!-- Alternativă dacă referința e alfanumerică -->
<InvoiceSeries>AZ-2024031200001</InvoiceSeries>
<InvoiceNumber>0</InvoiceNumber>

Unde raportezi o eroare

Dacă ai întâlnit o eroare care nu este acoperită în acest document sau dacă rezolvările de mai sus nu au funcționat, contactează echipa de suport EDI Azuvio / CRMconnect:

Email suport tehnic EDI: edi-support@azuvio.io

Ce să incluzi în mesaj:

1. Tipul mesajului EDI afectat (ORDERS, DESADV, RECADV sau INVOIC)
2. DocumentType și numărul documentului
3. GLN-ul expeditorului și al destinatarului
4. Mesajul de eroare exact (copiați textul complet, nu o captură de ecran)
5. Fișierul EDI sau XML original care a generat eroarea (atașat la email)
6. Data și ora aproximativă la care a apărut eroarea

Timp de răspuns: 1 zi lucrătoare pentru erori de producție, 3 zile lucrătoare pentru întrebări tehnice generale.

Portal suport: support.azuvio.io — puteți deschide un ticket și urmări statusul rezolvării.