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?
Az API használatát licencenként mérjük: minden licenc évente 1500 küldeményt és 10 000 szolgáltatáshívást foglal magában, és lehetővé teszi, hogy az adatbázisban legfeljebb 5000, küldeménynek nem minősülő objektum legyen, például termékek és résztvevők (címzettek, beszállítók, járművezetők és a többi). 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.