API og ERP-integration

Ja. DGAssistants JSON REST-API er udviklet til integration med ERP- og logistiksystemer. Kunder har integreret det med SAP, SAGE X3 og flere andre systemer. Selve integrationen udføres af din IT-afdeling eller din ERP-partner med løbende støtte fra DGAssistant-teamet under analyse, implementering og idriftsættelse.

Ja, API'et er et modul, der licenseres separat ud over dine standardlicenser. Du føjer det til dit abonnement, når du beslutter dig for at integrere.

Brugen af API'et måles pr. licens: hver licens dækker 1.500 forsendelser og 10.000 servicekald om året, og databasen kan rumme op til 5.000 andre objekter end forsendelser, f.eks. produkter og deltagere (modtagere, leverandører, førere og andre). Hvis du forventer et større omfang, tilføjer du blot flere licenser. Den nøjagtige enhedspris for API-modulet vises sammen med resten af kataloget i vores butik og kan indgå i ethvert individuelt tilbud.

I batchtilstand modtager API'et hele specifikationen af forsendelsen i ét servicekald – ideelt, når ERP-systemet allerede kender godset, deltagerne og mængderne. I interaktiv tilstand kan du opbygge forsendelsen trin for trin og validere hvert gods, efterhånden som du tilføjer det; det ligger tættere på den måde, webapplikationen fungerer på, og er nyttigt, når du har brug for brugerstyrede arbejdsgange oven på API'et.

Begge dele understøttes. Den anbefalede fremgangsmåde er "foruddefinerede data": opret dit gods og dine deltagere én gang i webapplikationen (eller importér dem), og henvis til dem med deres kode i dine API-kald. Med fremgangsmåden "undervejs" sender du alle data i hvert kald, hvilket er praktisk, når dit ERP-system er det førende system for disse data, og du ikke ønsker at indlæse dem på forhånd.

Der er to muligheder. Du kan modtage dokumenterne i API-svaret som base64-kodede PDF-filer (transportdokument, afsendererklæring, tjekliste, kollimærkning osv.), eller du kan lade platformen sende dem automatisk pr. e-mail til en konfigureret adresse.

Ja. To fremgangsmåder fungerer godt: (a) dit ERP-system henter PDF-filen fra API'et og sender den til sin egen udskriftskø; (b) DGAssistant sender dokumenterne pr. e-mail til en dedikeret postkasse, og et lille program til automatisk udskrivning hos dig udskriver dem på den rigtige printer. Mange kunder bruger e-mailløsningen, fordi den ikke kræver ekstra kode i ERP-systemet.

Den komplette OpenAPI-specifikation er offentliggjort i dokumentationen til API'et for farligt gods. Vi stiller også et SoapUI-projekt til rådighed med realistiske testkald, så dine udviklere kan udforske API'et på få minutter.

Hvert API-kald skal indeholde et unikt requestGuid, der identificerer anmodningen i vores logfiler og gør det muligt for vores supportteam at finde den nøjagtige transaktion, når du rapporterer et problem. Enhver unik alfanumerisk værdi accepteres; vi anbefaler at generere et standard-UUID/GUID på klientsiden.

Adgangsoplysninger, som tjenesten ikke accepterer: enten en manglende eller forkert HTTP Basic Authorization-header eller, når kaldet autentificeres med OAuth2, et adgangstoken, der aldrig er blevet anmodet om, som hører til et andet miljø, eller som allerede er udløbet. Der findes en særlig support-URL, som du kan kalde for at bekræfte, at API'et kører, og at dine adgangsoplysninger er gyldige. Hvis du sidder fast, så send os hele HTTP-anmodningen og -svaret (inklusive requestGuid) og en beskrivelse af den forventede adfærd – det er den hurtigste vej til at løse problemet.