API és ERP-integráció
Hogyan illeszkedik a DGAssistant az Ön ERP-, WMS- vagy szállítási platformjába.
Szükségem van külön modulra az API használatához?
Igen, az API külön licencelt modul a standard licencein felül. Akkor adhatja hozzá az előfizetéséhez, amikor az integráció mellett dönt.
Hogyan mérik és árazzák az API használatát?
A DGAssistant API használatát licencenként mérjük: minden licenc évente 20 000 hívást tartalmaz, ebből legfeljebb 1500 küldemények létrehozására használható, és lehetővé teszi, hogy az adatbázisban legfeljebb 5000 törzsadat-rekord legyen: termékek, résztvevők, saját helyek, járművek, pótkocsik és vízi járművek. A felhasználási feltételek szerint minden küldemény egy tényleges szállításnak felel meg, saját fuvarokmánnyal. Ha nagyobb forgalomra számít, egyszerűen további licenceket vásárol. Az API-modul pontos egységára a katalógus többi elemével együtt megtalálható webáruházunkban, és bármely egyedi árajánlatba belefoglalható.
Melyik az API kétféle használati módja: kötegelt vagy interaktív?
A kötegelt mód egyetlen szolgáltatáshívásban kapja meg a küldemény teljes leírását – ez ideális, ha az ERP-rendszer már ismeri az árukat, a résztvevőket és a mennyiségeket. Az interaktív móddal lépésről lépésre építheti fel a küldeményt, és a rendszer minden árut a hozzáadáskor ellenőriz; ez közelebb áll a webalkalmazás működéséhez, és akkor hasznos, ha az API-ra épülő, felhasználó által vezérelt munkafolyamatokra van szüksége.
A termékeket és a résztvevőket előre hozzam létre, vagy „menet közben”?
Mindkét lehetőség támogatott. Az ajánlott megközelítés az „előre rögzített adatok” használata: áruit és résztvevőit egyszer hozza létre a webalkalmazásban (vagy importálja őket), és az API-hívásokban a kódjukkal hivatkozzon rájuk. A „menet közbeni” megközelítéssel minden hívásban minden adatot elküldhet, ami kényelmes, ha ezeknek az adatoknak az ERP-rendszer a gazdája, és nem kívánja azokat előre betölteni.
Hogyan kérhetem le az API-n keresztül az elkészített PDF-fájlokat?
Két lehetőség van. Az okmányokat megkaphatja az API válaszában base64 kódolású PDF-ként (fuvarokmány, feladói nyilatkozat, ellenőrző lista, küldeménydarab-jelölés stb.), vagy a platform automatikusan elküldheti őket e-mailben egy beállított címre.
Kinyomtathatom automatikusan az API által készített okmányokat?
Igen. Két megoldás vált be: (a) az ERP-rendszer letölti a PDF-et az API-ból, és a saját nyomtatási sorába küldi; (b) a DGAssistant e-mailben elküldi az okmányokat egy erre kijelölt postafiókba, ahol egy kis automatikus nyomtatóprogram a megfelelő nyomtatón kinyomtatja őket. Sok ügyfél az e-mailes megoldást választja, mert az ERP oldalán nem igényel további programkódot.
Hol található az API specifikációja?
A teljes OpenAPI-specifikáció a veszélyesáru-API dokumentációjában érhető el. Valósághű teszthívásokkal előre feltöltött SoapUI-projektet is biztosítunk, így fejlesztői percek alatt megismerhetik az API-t.
Mi a requestGuid, és miért kötelező?
Minden API-hívásnak tartalmaznia kell egy egyedi requestGuid értéket, amely naplóinkban azonosítja a kérést, és lehetővé teszi, hogy ügyfélszolgálatunk hibabejelentéskor megtalálja a pontos tranzakciót. Bármilyen egyedi alfanumerikus érték elfogadható; javasoljuk, hogy az ügyféloldalon szabványos UUID/GUID azonosítót generáljon.
Mi a leggyakoribb oka annak, hogy egy API-hívás elsőre sikertelen?
A szolgáltatás által el nem fogadott hozzáférési adatok: vagy hiányzik, illetve hibás a HTTP Basic Authorization fejléc, vagy – OAuth2-hitelesítésű hívás esetén – a hozzáférési tokent nem kérték le, másik környezethez tartozik, vagy már lejárt. Egy erre szolgáló támogatási URL meghívásával ellenőrizheti, hogy az API működik-e, és érvényesek-e a hozzáférési adatai. Ha elakad, küldje el nekünk a teljes HTTP-kérést és -választ (a requestGuid értékkel együtt), valamint a várt működés leírását – így oldható meg a probléma a leggyorsabban.