API och ERP-integration
Hur DGAssistant passar in i ditt ERP-system, ditt WMS eller din transportplattform.
Kan DGAssistant integreras med mitt ERP-system, till exempel SAP, SAGE X3, Dynamics eller Navision?
Ja. JSON REST-API:et i DGAssistant är utformat för integration med ERP- och logistiksystem. Kunder har integrerat det med SAP, SAGE X3 och flera andra system. Själva integrationen utförs av din IT-avdelning eller av din ERP-partner, med ständigt stöd från DGAssistants team under analys, implementering och driftstart.
Behöver jag en särskild modul för att använda API:et?
Ja, API:et är en modul som licensieras separat utöver dina standardlicenser. Du lägger till den i ditt abonnemang när du bestämmer dig för att integrera.
Hur mäts och prissätts användningen av API:et?
API:et mäts per licens: varje licens omfattar 1 500 sändningar och 10 000 tjänsteanrop per år, och databasen kan rymma upp till 5 000 andra objekt än sändningar, till exempel produkter och aktörer (mottagare, leverantörer, förare med flera). Om du räknar med större volymer lägger du helt enkelt till fler licenser. Det exakta styckpriset för API-modulen visas tillsammans med resten av sortimentet i vår webbutik och kan tas med i en anpassad offert.
Vilka är de två sätten att använda API:et, satsvis och interaktivt?
I satsvist läge tar API:et emot den fullständiga specifikationen av sändningen i ett enda tjänsteanrop – lämpligt när ERP-systemet redan känner till godset, aktörerna och mängderna. I interaktivt läge bygger du upp sändningen steg för steg, och varje gods valideras när du lägger till det; det liknar mer hur webbprogrammet fungerar och är användbart när du behöver användarstyrda arbetsflöden ovanpå API:et.
Ska jag skapa produkter och aktörer i förväg eller ”direkt i anropet”?
Båda stöds. Det rekommenderade arbetssättet är ”fördefinierade data”: skapa ditt gods och dina aktörer en gång i webbprogrammet (eller importera dem) och hänvisa till dem med deras koder i dina API-anrop. Med arbetssättet ”direkt i anropet” skickar du allt i varje anrop, vilket är praktiskt när ditt ERP-system är huvudkällan för dessa data och du inte vill läsa in dem i förväg.
Hur hämtar jag skapade PDF-filer via API:et?
Det finns två alternativ. Du kan få dokumenten i API-svaret som base64-kodade PDF-filer (godsdeklaration, avsändardeklaration, checklista, kollimärkning osv.), eller låta plattformen skicka dem automatiskt per e-post till en konfigurerad adress.
Kan jag skriva ut dokument som har skapats via API:et automatiskt?
Ja. Två arbetssätt fungerar bra: (a) ditt ERP-system hämtar PDF-filen från API:et och skickar den till sin egen utskriftskö; (b) DGAssistant skickar dokumenten per e-post till en särskild brevlåda, och ett litet program för automatisk utskrift hos dig skriver ut dem på rätt skrivare. Många kunder använder e-postvarianten eftersom den inte kräver någon extra kod i ERP-systemet.
Var finns API-specifikationen?
Den fullständiga OpenAPI-specifikationen publiceras i dokumentationen för API:et för farligt gods. Vi tillhandahåller också ett SoapUI-projekt med realistiska testanrop, så att dina utvecklare kan utforska API:et på några minuter.
Vad är requestGuid och varför krävs det?
Varje API-anrop måste innehålla ett unikt requestGuid som identifierar anropet i våra loggar och gör det möjligt för vårt supportteam att hitta exakt rätt transaktion när du rapporterar ett problem. Alla unika alfanumeriska värden godtas; vi rekommenderar att du genererar ett standard-UUID/GUID på klientsidan.
Vilken är den vanligaste orsaken till att ett API-anrop misslyckas första gången?
Inloggningsuppgifter som tjänsten inte godtar: antingen ett HTTP Basic Authorization-huvud som saknas eller är felaktigt eller, när anropet autentiseras med OAuth2, en åtkomsttoken som aldrig har begärts, som tillhör en annan miljö eller som redan har gått ut. Det finns en särskild support-URL som du kan anropa för att bekräfta att API:et är i drift och att dina inloggningsuppgifter är giltiga. Om du kör fast, skicka oss hela HTTP-anropet och -svaret (inklusive requestGuid) och en beskrivning av det förväntade beteendet – det är det som snabbast löser problemet.