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, tai logistiikka-alustaan?
Kyllä. DGAssistantin JSON REST API on suunniteltu integraatioihin toiminnanohjausjärjestelmien (ERP) ja logistiikka-alustojen kanssa, ja sitä voi käyttää mistä tahansa järjestelmästä, joka pystyy käyttämään JSON-muotoisia REST-verkkopalveluita – nykyään käytännössä kaikista. Asiakkaat ovat integroineet sen esimerkiksi SAP- ja SAGE X3 -järjestelmiin sekä useisiin muihin järjestelmiin. Integraation toteuttaa asiakkaan oma IT-tiimi tai järjestelmää ylläpitävä kumppani, ja DGAssistantin tiimi tukee jatkuvasti määrittelyn, toteutuksen ja käyttöönoton aikana. Täydellinen määrittely on julkaistu vaarallisten aineiden API:n dokumentaatiossa.
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?
DGAssistantin API:n käyttö mitataan lisensseittäin: kuhunkin lisenssiin sisältyy 20 000 kutsua vuodessa, joista enintään 1 500 lähetysten luomiseen, ja tietokantaan voi tallentaa enintään 5 000 perustietojen tietuetta: tuotteet, osapuolet, omat paikat, ajoneuvot, perävaunut ja alukset. Kukin lähetys vastaa yhtä todellista kuljetusta, jolla on oma rahtikirjansa, kuten käyttöehdoissa määrätään. 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.