API și integrare ERP

Da. API-ul REST JSON al DGAssistant a fost conceput pentru integrarea cu sisteme ERP și logistice. Clienții l-au integrat cu SAP, SAGE X3 și cu alte câteva sisteme. Integrarea propriu-zisă este realizată de echipa dumneavoastră IT sau de partenerul dumneavoastră ERP, cu sprijinul constant al echipei DGAssistant în etapele de analiză, implementare și punere în funcțiune.

Da, API-ul este un modul licențiat separat, suplimentar față de licențele standard. Îl adăugați la abonament atunci când decideți să realizați integrarea.

Utilizarea API-ului se măsoară pe licență: fiecare licență acoperă 1.500 de expediții și 10.000 de apeluri de serviciu pe an și permite ca baza de date să conțină până la 5.000 de obiecte, altele decât expedițiile, cum ar fi produsele și participanții (destinatari, furnizori, conducători auto și ceilalți). Dacă vă așteptați la un volum mai mare, adăugați pur și simplu licențe suplimentare. Prețul unitar exact al modulului API este afișat împreună cu restul catalogului în magazinul nostru și poate fi inclus în orice ofertă personalizată.

Modul în lot primește specificația completă a expediției într-un singur apel de serviciu – ideal atunci când sistemul ERP cunoaște deja mărfurile, participanții și cantitățile. Modul interactiv vă permite să construiți expediția pas cu pas, validând fiecare marfă pe măsură ce o adăugați; este mai apropiat de modul de funcționare al aplicației web și este util atunci când aveți nevoie de fluxuri de lucru conduse de utilizator pe baza API-ului.

Ambele variante sunt acceptate. Abordarea recomandată este cea a „datelor predefinite”: creați mărfurile și participanții o singură dată în aplicația web (sau îi importați) și faceți referire la ei prin cod în apelurile API. Abordarea „ad-hoc” vă permite să transmiteți toate datele în fiecare apel, ceea ce este convenabil atunci când sistemul ERP este sursa principală a acestor date și nu doriți să le încărcați în prealabil.

Există două opțiuni. Puteți primi documentele în răspunsul API, ca fișiere PDF codificate în base64 (document de transport, declarația expeditorului, listă de control, marcarea coletelor etc.), sau puteți solicita ca platforma să le trimită automat prin e-mail la o adresă configurată.

Da. Două abordări funcționează bine: (a) sistemul ERP descarcă fișierul PDF prin API și îl trimite în propria coadă de tipărire; (b) DGAssistant trimite documentele prin e-mail către o căsuță poștală dedicată, iar un mic utilitar de tipărire automată din partea dumneavoastră le tipărește la imprimanta potrivită. Mulți clienți utilizează varianta prin e-mail, deoarece nu necesită cod suplimentar în sistemul ERP.

Specificația OpenAPI completă este publicată în documentația API pentru mărfuri periculoase. Punem la dispoziție și un proiect SoapUI preîncărcat cu apeluri de test realiste, astfel încât dezvoltatorii dumneavoastră să poată explora API-ul în câteva minute.

Fiecare apel API trebuie să includă un requestGuid unic, care identifică cererea în jurnalele noastre și permite echipei noastre de asistență să găsească tranzacția exactă atunci când raportați o problemă. Este acceptată orice valoare alfanumerică unică; vă recomandăm să generați un UUID/GUID standard pe partea clientului.

Credențialele pe care serviciul nu le acceptă: fie un antet HTTP Basic Authorization lipsă sau greșit, fie, atunci când apelul este autentificat cu OAuth2, un token de acces care nu a fost solicitat niciodată, care aparține altui mediu sau care a expirat deja. Există o adresă URL de asistență dedicată, pe care o puteți apela pentru a confirma că API-ul funcționează și că credențialele dumneavoastră sunt valide. Dacă vă blocați, trimiteți-ne cererea și răspunsul HTTP complete (inclusiv requestGuid) și o descriere a comportamentului așteptat – este ceea ce deblochează cel mai rapid problema.