Salt la conținut

Ajutor

API și integrare ERP

Cum se integrează DGAssistant în sistemul dumneavoastră ERP, WMS sau în platforma de expediere.

DGAssistant se integrează cu ERP-ul meu – SAP, SAGE X3, Dynamics, Navision – sau cu platforma mea logistică?

Da. API-ul REST JSON al DGAssistant a fost conceput pentru integrarea cu sisteme ERP și platforme logistice și poate fi utilizat de orice sistem capabil să folosească servicii web REST cu JSON, adică, în prezent, practic de toate. 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 care întreține sistemul dumneavoastră, cu sprijinul constant al echipei DGAssistant în etapele de analiză, implementare și punere în funcțiune. Specificația completă este publicată în documentația API pentru mărfuri periculoase.

Am nevoie de un modul special pentru a utiliza API-ul?

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.

Cum se măsoară și cum se tarifează utilizarea API-ului?

Utilizarea API-ului DGAssistant se măsoară pe licență: fiecare licență include 20.000 de apeluri pe an, dintre care până la 1.500 pentru crearea de expediții, și permite ca baza de date să conțină până la 5.000 de înregistrări de date de bază: produse, factori implicați, locații proprii, vehicule, remorci și nave. Fiecare expediție corespunde unui transport real, cu propriul document de transport, conform condițiilor de utilizare. 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ă.

Care sunt cele două moduri de utilizare a API-ului: în lot sau interactiv?

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, factorii implicați ș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.

Trebuie să creez produsele și factorii implicați în prealabil sau „ad-hoc”?

Ambele variante sunt acceptate. Abordarea recomandată este cea a „datelor predefinite”: creați mărfurile și factorii implicați 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.

Cum obțin prin API fișierele PDF generate?

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ă.

Pot tipări automat documentele generate prin API?

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.

Unde se găsește specificația API?

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.

Ce este requestGuid și de ce este obligatoriu?

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.

Care este cel mai frecvent motiv pentru care un apel API eșuează la prima încercare?

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.

Înapoi la Ajutor

Pentru a vedea cât de rapid și de simplu este, puteți beneficia de o perioadă de probă de două săptămâni, fără nicio obligație