XML Format Reference

Versiune: 2.0 — Iunie 2026
Format: XML proprietar, aliniat convențiilor GS1 XML

EDIconnect utilizează un format XML cu structură comună pentru toate mesajele. Această pagină descrie regulile generale de structură, codificare și validare.

Tipuri de documente

Câmpul DocumentType din antetul mesajului identifică tipul documentului. Valoarea determină modul în care mesajul este procesat în sistem:

Mesaj	DocumentType	Descriere
ORDERS	`OR`	Comandă de cumpărare
ORDRSP	`OA`	Confirmare comandă (acceptată)
ORDRSP	`OR`	Răspuns comandă cu modificări
DESADV	`DL`	Aviz de livrare
INVOIC	`FV`	Factură fiscală
INVOIC	`NC`	Notă de credit
RECADV	`NIR`	Notă de intrare recepție
RECADV	`R`	Retur marfă
RECADV	`70E`	Confiscare (deteriorare/carantină)
PRICAT	`PC`	Catalog prețuri

Câmpul se specifică în elementul <DocumentType> din secțiunea <Header> a mesajului:

<Header>
  <DocumentType>FV</DocumentType>
  <DocumentNumber>FACT2024001</DocumentNumber>
  <DocumentDate>2024-03-15</DocumentDate>
  ...
</Header>

Encoding & Declarație

<?xml version="1.0" encoding="UTF-8"?>

Toate mesajele trebuie să utilizeze encoding UTF-8. Declarația XML este obligatorie.

Structură generală

<?xml version="1.0" encoding="UTF-8"?>
<Message>
  <Version>2.0</Version>
  <Documents>
    <{MessageType}>
      <Header>
        <DocumentType>{type}</DocumentType>
        <DocumentNumber>{number}</DocumentNumber>
        <DocumentDate>{date}</DocumentDate>
        ...
      </Header>
      <{Parties}>
        ...
      </{Parties}>
      <Lines>
        <Line>...</Line>
      </Lines>
      <Summary>
        ...
      </Summary>
    </{MessageType}>
  </Documents>
</Message>

Versiunea XML (<Version>) variază per mesaj: toate mesajele folosesc v2.0.

Namespace-uri

Mesaj	Namespace
ORDERS	`urn:azuvio:ediconnect:orders:v1`
DESADV	`urn:azuvio:ediconnect:desadv:v1`
INVOIC	`urn:azuvio:ediconnect:invoic:v1`
RECADV	`urn:azuvio:ediconnect:recadv:v1`

Format date și ore

Tip	Format	Exemplu
Dată	`YYYY-MM-DD`	`2024-03-15`
DateTime	`YYYY-MM-DDTHH:MM:SS`	`2024-03-15T14:30:00`
DateTime cu TZ	ISO 8601	`2024-03-15T14:30:00+02:00`

Format numeric

Separator zecimal: . (punct, nu virgulă)
Fără separatori de mii
Cantități: până la 3 zecimale
Prețuri: până la 4 zecimale
Valori monetare: până la 2 zecimale

GLN (Global Location Number)

GLN-urile sunt șiruri numerice de 13 cifre. Trimiteți întotdeauna ca string, cu zerourile leading păstrate:

<BuyerGLN>0594123456789</BuyerGLN>  <!-- corect -->
<BuyerGLN>594123456789</BuyerGLN>   <!-- greșit — 12 cifre -->

Warning

GLN-ul și EAN-ul trebuie trimise întotdeauna ca string, nu ca număr întreg. Un GLN de tipul 0594123456789 devine 594123456789 dacă este tratat ca long — invalidând identificatorul partenerului.

EAN / GTIN

Codurile de produs urmează GTIN-13 (EAN-13): șiruri numerice de 13 cifre.

Coduri unitate de măsură

EDIconnect utilizează codurile UN/ECE Recomandarea 20:

Cod	Descriere
`PCE`	Bucată
`KGM`	Kilogram
`LTR`	Litru
`CTN`	Carton
`PLT`	Palet
`MTR`	Metru
`SET`	Set

Coduri monedă

Coduri ISO 4217 din trei litere: RON, EUR, USD, GBP.

Limite dimensiune mesaj

Parametru	Limită
Dimensiune maximă fișier	10 MB
Linii maxime per mesaj	9.999
Pachete maxime per DESADV	999
Articole maxime per PRICAT	50.000

Validare XSD

Validați față de schema XSD corespunzătoare înainte de trimitere:

Mesaj	Schemă XSD
ORDERS	`Azuvio-CRMconnect-EDIconnect-ORDERS-v2.0.xsd`
DESADV	`Azuvio-CRMconnect-EDIconnect-DESADV-v2.0.xsd`
RECADV	`Azuvio-CRMconnect-EDIconnect-RECADV-v2.0.xsd`
INVOIC	`Azuvio-CRMconnect-EDIconnect-INVOIC-v2.0.xsd`

Transportul HTTP returnează 400 Bad Request cu un body de eroare dacă validarea eșuează.

HTTP Headers (transport REST)

Content-Type: application/xml; charset=UTF-8
Accept: application/xml
Authorization: Bearer {token}
X-EDI-SenderGLN: {GLN-ul dvs.}
X-EDI-ReceiverGLN: {GLN partener}
X-EDI-MessageType: ORDERS
X-EDI-DocumentType: OR

Header-ul X-EDI-DocumentType trebuie să corespundă câmpului <DocumentType> din corpul mesajului.