API- og ERP-integrasjon

Ja. DGAssistants JSON-baserte REST-API er utviklet for integrasjon med ERP- og logistikksystemer. Kunder har integrert det med SAP, SAGE X3 og flere andre systemer. Selve integrasjonen utføres av IT-avdelingen din eller ERP-partneren din, med løpende støtte fra DGAssistant-teamet under analyse, implementering og idriftsetting.

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.

API-et måles per lisens: hver lisens omfatter 1 500 forsendelser og 10 000 tjenestekall per år og gjør det mulig å ha opptil 5 000 andre objekter enn forsendelser i databasen, for eksempel produkter og deltakere (mottakere, leverandører, førere og de øvrige). 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.

Satsvis modus mottar hele forsendelsesspesifikasjonen i ett enkelt tjenestekall – ideelt når ERP-systemet allerede kjenner godset, deltakerne 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.

Begge deler støttes. Den anbefalte fremgangsmåten er «forhåndsdefinerte data»: opprett godset og deltakerne é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.

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.

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.

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.

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.

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.