Flux comenzi API: Ghid complet de automatizare de la livrare la factură

Un flux comenzi API reprezintă procesul cap-la-coadă prin care cererile transmise prin interfețe programatice devin rezervări de stoc, note de livrare și facturi fiscale. Datele din payload-ul JSON/REST generează automat documentele operaționale, declanșează picking-ul în depozit și emit factura integrată direct în sistemul național RO e-Factura fără intervenție manuală.

Pe scurt

•Fluxul comenzi API transformă cererile transmise prin JSON/REST în documente operaționale și livrări fără reintroducere manuală.
•Include etape esențiale: validare idempotență, rezervare logică de stoc, verificare credit comercial și generare picking WMS.
•Asigură conformitatea legală automată pentru generarea codurilor UIT (RO e-Transport) și a facturilor XML UBL (RO e-Factura).
•CRMconnect orchestrează fluxul ca strat inteligent peste depozit și gestiune, sincronizând datele finale în ERP-ul contabil.

Digitalizarea canalelor B2B și B2C impune companiilor procesarea comenzilor în timp real, eliminând introducerea manuală a datelor. Un flux comenzi API conectează direct magazinele online, platformele marketplace, aplicațiile mobile sau sistemele partenerilor la motorul operațional al companiei. Structurarea unui proces complet de la recepția payload-ului, alocarea stocurilor, generarea dispozițiilor de livrare și până la transmiterea automată în RO e-Factura asigură acuratețe operațională, elimină întârzierile la livrare și respectă conformitatea fiscală din România.

Recepția și validarea automată a cererii prin API

Recepția comenzilor prin API se bazează pe endpoint-uri de tip REST sau webhook-uri securizate care primesc structuri de date standardizate (de regulă JSON). În prima etapă, sistemul validează integritatea datelor: existența partenerului sau a CUI-ului, corectitudinea adreselor de livrare și a codurilor de produs (SKU). O componentă critică este verificarea idempotenței, prin care se garantează că o reîncercare de trimitere a rețelei nu va genera două comenzi identice în gestiune. După validare, sistemul returnează un cod de confirmare și creează obiectul operațional de comandă.

•Validarea sintactică și semantică a payload-ului JSON
•Verificarea automată a codului fiscal în baza de date locală sau registre oficiale
•Asignarea unei stări inițiale de tip Preluat / În procesare

Alocarea stocului și validarea regulilor comerciale

După salvarea comenzii, sistemul interoghează stocul disponibil în depozitele alocate. Dacă produsele sunt pe stoc, se aplică o rezervare imediată pentru a împiedica vânzarea pe alte canale. În cazul fluxurilor B2B, motorul de reguli verifică totodată plafonul de credit comercial al clientului și existența unor facturi restante cu termen depășit. Dacă verificările financiare sunt conforme, comanda este eliberată automat către fluxul de picking, eliminând aprobările administrative consumatoare de timp.

•Rezervare cantitativă pe bază de SKU și depozit definit
•Calcul automat al termenelor de plată și aplicarea matricelor de preț negociate
•Blocarea automată a livrării în caz de depășire a limitei de creditare

Procesarea în depozit: Picking, Packing și expediție

Odată comanda eliberată, sistemul WMS sau modulul de gestiune a depozitului generează dispoziția de picking. Lucrătorii din depozit colectează produsele utilizând terminale mobile cu scanare de coduri de bare, asigurând acuratețea loturilor, a seriilor și a datelor de expirare. La finalizarea împachetării, se emite Packing List-ul și se generează automat documentul de expediție (aviz de însoțire a mărfii sau AWB-ul curierului prin integrare API dedicată), actualizând starea comenzii în sistem.

•Grupare și rutare optimizată a liniilor de picking în depozit
•Validare prin scanare de coduri de bare pentru eliminarea erorilor de expediere
•Generare automată a AWB-urilor și etichetelor de colet

Conformitate RO e-Transport la nivel de expediție

Dacă transportul include bunuri cu risc fiscal ridicat sau intră sub incidența monitorizării transporturilor rutiere pe teritoriul național, sistemul generează structura de date cerută de sistemul RO e-Transport. Trimiterea automată a datelor de transport (vehicul, traseu, expeditor, destinatar, bunuri) către SPV ANAF se face înainte de plecarea vehiculului din depozit, obținând codul UIT unic. Acest cod este imprimat direct pe documentele de transport care însoțesc marfa.

•Identificarea automată a produselor supuse regimului RO e-Transport
•Transmiterea declarației către ANAF prin conexiune API securizată cu certificat digital
•Preluarea și afișarea codului UIT pe avizul de însoțire a mărfii

Facturarea automată și raportarea în RO e-Factura

Încheierea livrării sau confirmarea expedierii declanșează emiterea automată a facturii fiscale. Pe baza datelor validate din comandă și aviz, se generează fișierul XML în format standardizat UBL (SR EN 16931). CRMconnect transmite fișierul către sistemul RO e-Factura din SPV ANAF, stochează ID-ul de descărcare și atașează recipisa de validare fără erori. La final, detaliile tranzacției și notele contabile aferente sunt sincronizate cu ERP-ul sau softul de contabilitate, unde rămâne înregistrat ledgerul financiar.

•Conversia datelor din comandă în structură XML UBL 2.1
•Semnarea și trimiterea automată în SPV fără intervenție umană
•Sincronizarea documentelor fiscale emise cu sistemul ERP contabil

Rolul CRMconnect în orchestratrea fluxului cap-la-coadă

Implementarea unui flux comenzi API prin CRMconnect transformă operațiunile fragmentate într-un sistem coerent de tip Smart Operations Layer. Platforma preia sarcinile de la recepția comenzii din surse externe, gestionează regulile de business, organizează fluxurile de depozit și generează documentele fiscale conforme legislației din România. Prin această arhitectură, echipele de vânzări și logistică au trasabilitate completă pe fiecare linie de comandă, iar ERP-ul companiei primește date curate, validate fiscal și operațional.

•Monitorizare în timp real a fiecărei etape din ciclul de viață al comenzii
•Reducerea erorilor de operare la zero prin validări automate de date
•Arhitectură scalabilă care nu suprasolicită baza de date a ERP-ului existent

Etapele fluxului comenzi API și documentele asociate

Etapă Flux	Date / Document Intrare	Acțiune Sistem	Document / Rezultat Ieșire	Conformitate / Sistem Țintă
1. Preluare Comandă	Payload JSON (REST API)	Validare date, verificare idempotență	Comandă de vânzare înregistrată	Bază de date internă
2. Alocare Stoc	Comandă de vânzare aprobată	Rezervare cantități pe depozit/SKU	Stoc rezervat, comandă pregătită	Modul OMS / Gestiune stocuri
3. Procesare Depozit	Comandă cu stoc rezervat	Picking prin scanare coduri bare, packing	Aviz de însoțire marfă / AWB	WMS / Serviciu Curierat
4. Transport Marfă	Date transport și aviz marfă	Transmitere date transport în SPV	Cod UIT generat	RO e-Transport (ANAF)
5. Facturare și Închidere	Aviz confirmat / Bunuri expediate	Generare XML UBL și export ERP	Factură fiscală + Recipisă ANAF	RO e-Factura (ANAF) / ERP Contabil

Pas cu pas

1. Configurarea endpoint-urilor API și a mecanismelor de autentificare
Definiți specificația tehnică OpenAPI (Swagger) pentru comenzi, incluzând reguli stricte de validare a CUI-ului, monedei, cotelor de TVA și adreselor de livrare.
2. Maparea nomenclatoarelor de articole și parteneri
Configurați regulile de conversie între identificatorii externi de produs (SKU, cod de bare) și nomenclatoarele interne de gestiune.
3. Stabilirea politicilor de alocare a stocurilor și credit comercial
Implementați logica de rezervare instantanee a stocului și politicile de verificare a limitelor financiare sau a soldurilor restante per client.
4. Automatizarea fluxului de picking și generare AWB
Conectați comenzile confirmate cu terminalele mobile de depozit pentru picking ghidat și integrați API-ul de curierat pentru emiterea etichetelor de transport.
5. Activarea mecanismului de raportare RO e-Transport
Configurați trimiterea automată a datelor de transport către SPV ANAF pentru mărfurile care necesită cod UIT obligatoriu.
6. Automatizarea generării facturii și transmiterea în RO e-Factura
Configurați conversia automată a comenzilor expediate în facturi XML UBL și trimiterea automată în SPV, urmată de sincronizarea cu softul contabil/ERP.

Întrebări frecvente

Ce date minime sunt necesare într-un apel API pentru a iniția comanda?

Payload-ul JSON/REST trebuie să conțină datele de identificare ale clientului (CUI/CIF, denumire, adresă de livrare), liniile de comandă (SKU, cantitate, preț unitar, monedă, cotă TVA) și referințe unice de tranzacție pentru a preveni dublarea procesării.

Cum se gestionează dublarea comenzilor transmise prin API?

Printr-o cheie de idempotență (Idempotency Key) unică transmisă în antetul cererii API. Sistemul verifică dacă referința comenzii a fost deja înregistrată; dacă da, respinge duplicatul și returnează starea tranzacției existente fără a reîncărca stocurile.

Cum funcționează rezervarea stocului la recepția unei comenzi prin API?

În momentul validării comenzii, sistemul efectuează o alocare logică (hard reservation) a cantităților pe baza SKU-urilor. Stocul disponibil se reduce instantaneu pentru a preveni vânzarea aceleiași unități pe alte canale integrate.

Când se generează codul UIT pentru RO e-Transport în fluxul API?

Pentru transporturile eligibile (bunuri cu risc fiscal sau transporturi rutiere internaționale), validarea documentului de expediție (aviz/picking finalizat) apelează automat serviciile SPV/ANAF pentru obținerea codului UIT necesar documentelor de însoțire.

Cum se integrează sistemul RO e-Factura în ciclul comenzilor API?

Factura fiscală este generată automat în format XML standardizat (UBL 2.1) și trimisă programatic către SPV ANAF prin endpoint-urile dedicate, salvând ID-ul de încărcare și starea de validare direct pe fișa comenzii.

Care este diferența dintre CRMconnect și un sistem ERP în acest flux?

CRMconnect funcționează ca un strat operațional inteligent (OMS/WMS) care preia datele API, coordonează depozitul, generează documentele fiscale și sincronizează rezultatele finale cu ERP-ul sau softul de contabilitate, unde rămâne ledgerul financiar.

Surse oficiale

Vrei fluxul acesta automatizat în CRMconnect?

Îți arătăm pe datele tale cum arată procesul, integrat cu ERP-ul pe care îl folosești deja.

Discută cu un specialist