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.