API- ja ERP-integraatio
Miten DGAssistant liitetään toiminnanohjausjärjestelmään (ERP), varastonhallintajärjestelmään (WMS) tai lähetysalustaan.
Voiko DGAssistantin integroida toiminnanohjausjärjestelmään (ERP), kuten SAP, SAGE X3, Dynamics tai Navision?
Kyllä. DGAssistantin JSON REST API on suunniteltu ERP- ja logistiikkaintegraatioihin. Asiakkaat ovat integroineet sen esimerkiksi SAP- ja SAGE X3 -järjestelmiin sekä useisiin muihin järjestelmiin. Integraation toteuttaa asiakkaan oma IT-tiimi tai ERP-kumppani, ja DGAssistantin tiimi tukee jatkuvasti määrittelyn, toteutuksen ja käyttöönoton aikana.
Tarvitaanko API:n käyttöön erillinen moduuli?
Kyllä, API on erikseen lisensoitava moduuli tavallisten lisenssien lisäksi. Se lisätään tilaukseen, kun integrointi päätetään toteuttaa.
Miten API:n käyttö mitataan ja hinnoitellaan?
API:n käyttö mitataan lisensseittäin: kukin lisenssi kattaa 1 500 lähetystä ja 10 000 palvelukutsua vuodessa, ja tietokantaan voi tallentaa enintään 5 000 muuta kohdetta kuin lähetyksiä, kuten tuotteita ja osapuolia (vastaanottajia, toimittajia, kuljettajia ja muita). Jos volyymin odotetaan olevan suurempi, hankitaan yksinkertaisesti lisää lisenssejä. API-moduulin tarkka yksikköhinta näkyy verkkokaupassamme muun valikoiman rinnalla, ja se voidaan sisällyttää mihin tahansa räätälöityyn tarjoukseen.
Mitkä ovat API:n kaksi käyttötapaa: eräkäsittely ja vuorovaikutteinen käsittely?
Eräkäsittelyssä lähetyksen täydellinen määrittely vastaanotetaan yhdellä palvelukutsulla – tämä on ihanteellinen tapa, kun ERP-järjestelmä tietää jo aineet, osapuolet ja määrät. Vuorovaikutteisessa käsittelyssä lähetys kootaan vaihe vaiheelta ja kukin aine tarkistetaan sitä lisättäessä; tämä on lähempänä verkkosovelluksen toimintaa ja hyödyllinen, kun API:n päälle tarvitaan käyttäjän ohjaamia työnkulkuja.
Kannattaako tuotteet ja osapuolet luoda etukäteen vai määrittää ne kutsussa ("on the fly")?
Kumpaakin tuetaan. Suositeltava tapa on "ennalta määritetyt tiedot": aineet ja osapuolet luodaan kerran verkkosovelluksessa (tai tuodaan sinne), ja API-kutsuissa niihin viitataan koodilla. "Kutsussa määritettävät tiedot" -tavassa kaikki tiedot lähetetään jokaisessa kutsussa, mikä on kätevää, kun ERP-järjestelmä on näiden tietojen päälähde eikä niitä haluta ladata etukäteen.
Miten luodut PDF-tiedostot haetaan API:n kautta?
Vaihtoehtoja on kaksi. Asiakirjat (rahtikirja, lähettäjän ilmoitus, tarkastuslista, kollien merkinnät jne.) voidaan vastaanottaa API-vastauksessa base64-koodattuina PDF-tiedostoina, tai palvelu voi lähettää ne automaattisesti sähköpostitse määritettyyn osoitteeseen.
Voiko API:n luomat asiakirjat tulostaa automaattisesti?
Kyllä. Kaksi tapaa toimii hyvin: (a) ERP-järjestelmä lataa PDF-tiedoston API:sta ja lähettää sen omaan tulostusjonoonsa; (b) DGAssistant lähettää asiakirjat sähköpostitse erilliseen postilaatikkoon, ja asiakkaan päässä toimiva pieni automaattitulostusohjelma tulostaa ne oikealla tulostimella. Monet asiakkaat käyttävät sähköpostitapaa, koska se ei vaadi lisäkoodia ERP-järjestelmän puolella.
Mistä API:n määrittely löytyy?
Täydellinen OpenAPI-määrittely on julkaistu vaarallisten aineiden API:n dokumentaatiossa. Toimitamme myös SoapUI-projektin, johon on valmiiksi ladattu realistisia testikutsuja, joten kehittäjät voivat tutustua API:hin muutamassa minuutissa.
Mikä requestGuid on ja miksi sitä vaaditaan?
Jokaisessa API-kutsussa on oltava yksilöllinen requestGuid, joka tunnistaa pyynnön lokeissamme ja jonka avulla tukitiimimme löytää juuri kyseisen tapahtuman, kun ongelmasta ilmoitetaan. Mikä tahansa yksilöllinen aakkosnumeerinen arvo hyväksytään; suosittelemme tavallisen UUID/GUID-tunnisteen luomista asiakkaan päässä.
Mikä on yleisin syy siihen, että API-kutsu epäonnistuu ensimmäisellä yrityksellä?
Tunnistetiedot, joita palvelu ei hyväksy: joko puuttuva tai virheellinen HTTP Basic Authorization -otsake tai, kun kutsu todennetaan OAuth2-protokollalla, käyttöoikeustunnus, jota ei ole koskaan pyydetty, joka kuuluu toiseen ympäristöön tai joka on jo vanhentunut. Erillisen tukiosoitteen avulla voidaan varmistaa, että API on toiminnassa ja tunnistetiedot ovat kelvolliset. Jos ongelma ei ratkea, pyydämme lähettämään meille täydellisen HTTP-pyynnön ja -vastauksen (requestGuid mukaan lukien) sekä kuvauksen odotetusta toiminnasta – näin ongelma ratkeaa nopeimmin.