Coduri de Eroare
Confirmare Funcțională EDIfact (CONTRL)
EDIconnect trimite un mesaj CONTRL pentru a confirma fiecare interchange EDIfact recepționat. Mesajul CONTRL indică dacă interchange-ul, grupul funcțional sau mesajul individual a fost acceptat sau respins.
UCI — Răspuns Interchange
| Cod | Semnificație |
|---|---|
4 |
Interchange recepționat; confirmat |
5 |
Interchange recepționat; respins |
UCM — Răspuns Mesaj
| Cod | Semnificație |
|---|---|
7 |
Mesaj recepționat și acceptat |
4 |
Mesaj recepționat, dar respins (consultați UCS pentru detalii) |
UCS / UCF — Coduri de Eroare Segment/Grup
| Cod | Descriere |
|---|---|
2 |
Versiunea sau nivelul de sintaxă nu este suportat |
7 |
Expeditorul interchange-ului este necunoscut |
14 |
Valoare invalidă |
16 |
Segment obligatoriu lipsă |
17 |
Segment nedefinit în mesaj |
18 |
Numărul de apariții depășește maximul admis |
26 |
Prea multe elemente de date |
35 |
Element de date obligatoriu lipsă |
37 |
Valoare de cod invalidă |
38 |
Dată invalidă |
39 |
Oră invalidă |
Coduri de Eroare Transport XML / HTTP
Coduri de Status HTTP
| Status | Semnificație | Acțiune recomandată |
|---|---|---|
200 OK |
Mesaj acceptat | Nicio acțiune necesară |
202 Accepted |
Mesaj în așteptare pentru procesare asincronă | Interogați sau așteptați callback-ul |
400 Bad Request |
Mesajul nu a trecut validarea | Corectați mesajul și retrimiteți |
401 Unauthorized |
Token invalid sau expirat | Reînnoiți token-ul Bearer |
403 Forbidden |
GLN-ul nu este autorizat pentru această operațiune | Contactați suportul EDI |
404 Not Found |
Documentul referențiat nu a fost găsit | Verificați numerele de referință |
409 Conflict |
Mesaj duplicat (același ID) | Verificați cheia de idempotență |
413 Payload Too Large |
Mesajul depășește limita de dimensiune (10 MB) | Împărțiți mesajul |
422 Unprocessable Entity |
Încălcare a regulilor de business | Consultați corpul răspunsului |
429 Too Many Requests |
Limita de rată a fost depășită | Așteptați și reîncercați |
500 Internal Server Error |
Eroare internă server | Contactați suportul EDI |
503 Service Unavailable |
Fereastră de mentenanță | Reîncercați după header-ul Retry-After |
Coduri de Eroare Validare Business (422)
Returnate în corpul răspunsului sub forma:
{
"error": "BUSINESS_RULE_VIOLATION",
"code": "EDI-007",
"message": "Product EAN 5901234123457 not found in catalogue",
"line": 1
}
| Cod | Mesaj | Cauză |
|---|---|---|
EDI-001 |
Unknown sender GLN | GLN-ul dvs. nu este înregistrat |
EDI-002 |
Unknown receiver GLN | GLN-ul partenerului nu a fost găsit |
EDI-003 |
Duplicate document reference | Același număr de comandă/factură a fost deja recepționat |
EDI-004 |
Referenced PO not found | ORDRSP/DESADV/INVOIC face referire la o comandă necunoscută |
EDI-005 |
Referenced ASN not found | RECADV/INVOIC face referire la un DESADV necunoscut |
EDI-006 |
Currency not supported | Utilizați RON sau EUR |
EDI-007 |
Product EAN not in catalogue | EAN necunoscut; actualizați PRICAT sau contactați suportul |
EDI-008 |
Delivery location GLN not mapped | GLN-ul de livrare nu este configurat pentru acest partener |
EDI-009 |
Quantity exceeds ordered quantity | Cantitatea din ORDRSP/DESADV depășește cantitatea din ORDERS |
EDI-010 |
Invoice amount mismatch | Suma calculată diferă de totalul declarat |
EDI-011 |
VAT rate not valid for product | Verificați clasa de TVA a produsului |
EDI-012 |
PRICAT validity dates overlap | Noul PRICAT se suprapune cu prețurile active existente |
Politica de Reîncercare
Warning
Nu reîncercați automat mesajele cu erori 400 (Bad Request) sau 422 (Unprocessable). Cauza este în conținutul mesajului, nu în transport — reîncercarea fără corectare va genera același rezultat și poate declanșa protecția anti-spam a partenerului.
| Tip Eroare | Reîncercare? | Întârziere |
|---|---|---|
400 Bad Request |
Nu — corectați mesajul mai întâi | — |
401 Unauthorized |
Da — reînnoiți token-ul | Imediat |
429 Too Many Requests |
Da | Conform header-ului Retry-After |
5xx Server Error |
Da | Back-off exponențial: 30s, 60s, 120s |
422 Business Error |
Nu — necesită corecție manuală | — |
Suport
Pentru erori EDI nerezolvate: edi-support@azuvio.io
Includeți: GLN expeditor, tipul mesajului, referința documentului, codul de eroare, timestamp-ul.