API- og ERP-integrasjon
Hvordan DGAssistant passer inn i ERP-systemet, WMS-systemet eller forsendelsesplattformen din.
Trenger jeg en egen modul for å bruke API-et?
Ja, API-et er en separat lisensiert modul i tillegg til standardlisensene dine. Du legger den til i abonnementet når du bestemmer deg for å integrere.
Hvordan måles og prises bruken av API-et?
API-et fra DGAssistant måles per lisens: hver lisens omfatter 20 000 kall per år, hvorav opptil 1 500 til å opprette forsendelser, og gjør det mulig å ha opptil 5 000 grunndataposter i databasen: produkter, aktører, egne steder, kjøretøy, tilhengere og fartøyer. Hver forsendelse tilsvarer en faktisk transport med eget transportdokument, slik bruksvilkårene fastsetter. Hvis du forventer større volum, legger du ganske enkelt til flere lisenser. Den nøyaktige enhetsprisen for API-modulen vises sammen med resten av katalogen i nettbutikken vår og kan tas med i ethvert tilpasset tilbud.
Hvilke to måter finnes det å bruke API-et på: satsvis eller interaktivt?
Satsvis modus mottar hele forsendelsesspesifikasjonen i ett enkelt tjenestekall – ideelt når ERP-systemet allerede kjenner godset, aktørene og mengdene. Interaktiv modus lar deg bygge opp forsendelsen trinn for trinn og validerer hvert gods etter hvert som du legger det til; dette ligger nærmere hvordan nettapplikasjonen fungerer, og er nyttig når du trenger brukerstyrte arbeidsflyter oppå API-et.
Bør jeg opprette produkter og aktører på forhånd eller sende dem «i kallet»?
Begge deler støttes. Den anbefalte fremgangsmåten er «forhåndsdefinerte data»: opprett godset og aktørene én gang i nettapplikasjonen (eller importer dem), og vis til dem med kode i API-kallene. Med fremgangsmåten «data i kallet» sender du alt i hvert kall, noe som er praktisk når ERP-systemet er hovedkilden til disse dataene og du ikke ønsker å legge dem inn på forhånd.
Hvordan henter jeg genererte PDF-filer via API-et?
Det finnes to alternativer. Du kan motta dokumentene i API-svaret som base64-kodede PDF-filer (transportdokument, avsenderdeklarasjon, sjekkliste, kollimerking osv.), eller du kan la plattformen sende dem automatisk med e-post til en konfigurert adresse.
Kan jeg skrive ut dokumenter generert via API-et automatisk?
Ja. To løsninger fungerer godt: (a) ERP-systemet laster ned PDF-filen fra API-et og sender den til sin egen utskriftskø; (b) DGAssistant sender dokumentene med e-post til en egen postboks, og et lite program for automatisk utskrift hos deg skriver dem ut på riktig skriver. Mange kunder bruker e-postløsningen fordi den ikke krever ekstra kode i ERP-systemet.
Hvor finner jeg API-spesifikasjonen?
Den fullstendige OpenAPI-spesifikasjonen er publisert i dokumentasjonen for API-et for farlig gods. Vi leverer også et SoapUI-prosjekt med ferdig innlagte, realistiske testkall, slik at utviklerne dine kan utforske API-et på noen få minutter.
Hva er requestGuid, og hvorfor er den påkrevd?
Hvert API-kall må inneholde en unik requestGuid som identifiserer forespørselen i loggene våre, og som gjør det mulig for kundestøtten vår å finne nøyaktig den aktuelle transaksjonen når du melder fra om et problem. Enhver unik alfanumerisk verdi godtas; vi anbefaler å generere en standard UUID/GUID på klientsiden.
Hva er den vanligste årsaken til at et API-kall feiler ved første forsøk?
Påloggingsopplysninger som tjenesten ikke godtar: enten en manglende eller feil HTTP Basic Authorization-header eller, når kallet autentiseres med OAuth2, et tilgangstoken som aldri ble forespurt, som tilhører et annet miljø, eller som allerede er utløpt. Det finnes en egen støtte-URL du kan kalle for å bekrefte at API-et svarer, og at påloggingsopplysningene dine er gyldige. Hvis du står fast, send oss hele HTTP-forespørselen og -svaret (inkludert requestGuid) og en beskrivelse av forventet oppførsel – det er det som løser problemet raskest.