Arhitectură și conectivitate

Prezentare generală

EDIconnect funcționează ca un strat de traducere și rutare între Azuvio / CRMconnect (comenzi, facturi, depozit) și partenerii comerciali externi.

Partener comercial
      │
      │  AS2 / SFTP / API / VAN
      ▼
┌─────────────┐
│ EDIconnect  │  ← traducere format (XML ↔ EDIfact)
│  Gateway    │  ← validare (XSD)
└──────┬──────┘
       │
       ▼
 CRMconnect Core
 (Comenzi, WMS, Financiar)

Protocoale de transport

AS2 (Applicability Statement 2)

Recomandat pentru parteneri retaileri cu volum mare (Carrefour, Metro, Kaufland, Profi etc.).

Note

AS2 este protocolul recomandat pentru parteneri mari (Carrefour, Metro, Kaufland). Schimbul de certificate se face o singură dată la onboarding și rămâne valabil ani de zile — după configurare, funcționează automat fără intervenție manuală.

Parametru	Valoare
Protocol	HTTPS
Port	443
MDN	Sincron sau asincron
Criptare	AES-128 / AES-256
Semnătură	SHA-256

URL-ul AS2 și certificatele digitale sunt furnizate în cadrul procesului de integrare a partenerului.

SFTP

Utilizat pentru schimbul de fișiere în loturi (de regulă noaptea sau de 4 ori pe zi).

Parametru	Descriere
Host	Furnizat la integrarea partenerului
Port	22
Autentificare	Cheie SSH sau parolă
Director intrare	`/in/`
Director ieșire	`/out/`
Director arhivă	`/archive/`
Convenție denumire fișiere	`{MessageType}_{SenderID}_{YYYYMMDD}_{HHMMSS}.edi`

REST API

Pentru parteneri moderni cu suport HTTP/JSON sau HTTP/XML.

Tip

La REST API, header-ul X-EDI-DocumentType trebuie să fie identic cu valoarea câmpului <DocumentType> din corpul mesajului XML. Ex: dacă trimiteți o factură originală, ambele trebuie să conțină O. Nepotrivirea cauzează eroare 422.

Parametru	Valoare
URL de bază	`https://edi.azuvio.io/api/v1`
Autentificare	Bearer token (OAuth 2.0)
Formate acceptate	`application/json`, `application/xml`

Consultați Referința API pentru detalii privind endpoint-urile disponibile.

VAN (Value Added Network)

EDIconnect este certificat cu următorii furnizori VAN:

GXS / OpenText Trading Grid
SPS Commerce
Transart EDI (România)
(furnizori suplimentari disponibili la cerere)

Fluxul mesajelor

Intrare (Partener → CRMconnect)

Mesajul este recepționat prin protocolul de transport
Validare sintactică (EDIfact) sau validare conform schemei (XSD)
Validarea regulilor de business (câmpuri obligatorii, verificare GLN)
Traducerea în formatul intern CRMconnect
Rutarea către modulul destinatar (Comandă de achiziție → purchase, Aviz de recepție → warehouse)
Trimiterea confirmării de primire (CONTRL / HTTP 200)

Ieșire (CRMconnect → Partener)

Declanșarea unui eveniment de business (ex.: expediere creată → DESADV)
Maparea datelor interne în mesajul EDI
Generarea formatului (XML sau EDIfact conform configurației partenerului)
Încapsularea în plicuri de schimb (UNA/UNB/UNG/UNH sau echivalent)
Livrarea prin protocolul de transport configurat
Înregistrarea confirmării de livrare