GKS Public API
Integrera din webbshop med GKS och få ett automatiserat orderflöde som skapar upp försäljningsorder i GKS samt vid behov arbetsorder för tillverkning.
Last updated
Was this helpful?
Integrera din webbshop med GKS och få ett automatiserat orderflöde som skapar upp försäljningsorder i GKS samt vid behov arbetsorder för tillverkning.
Last updated
Was this helpful?
Med följande REST-API går det att ta emot lagda order från din webbshop. Den mottagna försäljningsordern blir underlag för fakturering, men kan även skapa upp tillverkningsorder utifrån kända artikelnummer.
API:et ligger i molnet och drift ingår vilket gör det enklare att ansluta nya externa system.
Framtidssäker. Detta API fungerar direkt mot GKS4, men är även bakåtkompatibelt och går att koppla mot GKS3.
Modernare och enklare teknik med JSON över REST.
Utökad med ytterligare funktionalitet:
Möjlighet att få in artikelnummer.
Möjlighet att få för kända artikelnummer.
Kunna få in flera leveransadresser per orderrad/produkt. Dvs. en färdig distribution med antal till respektive adress.
Möjlighet att få in kostnad per orderrad.
Möjlighet att få in en rabattsats.
Möjlighet att få in valuta.
OAuth 2.0 client credentials flow.
Från en inkommande webborder via API:et finns nu möjlighet att automatiskt få tillverkningsorder uppskapade.
Genom att koppla artikelnummer till en utvald produktmall kommer API:et automatiskt kunna skapa upp en tillverkningsorder då den identifierar att en känd artikel har beställts. Tillhörande jobb blir även direkt synligt i GKS Plan för produktionen att påbörja tillverkning. Artikelnumret identifieras om det finns i fältet för artikel på produktmallen.
Tillverkningsordern skapas upp med det inkommande artikelnumret och beskrivningen som kommer in på den fria orderraden från webbportalen. Numret på friordern sätts i början på benämningen för att kunna spåra vilken friorder som fick in beställningen. Webportalens ordernummer sätts också i fältet för beställningsnummer på arbetsordern.
Börja med att skapa en kund i företagsregistret med firmanamn PLACESIMPLEORDER
om denna inte redan är upplagd. Kund-ID kan sättas till valfritt värde.
Skapa därefter en tillverkningsoffert och välj kunden. Lägg därefter till en ny produkt. Sedan sätter du artikelnummer i fält Mall för artikel. När allt är klart sparar du offerten. Offerten kan med fördel sparas med 0 i värde.
Kopplingen mellan ett artikelnummer och en mall visas i ett separat program som heter Produktmallar Place Simple Order (Produktmallar.exe
). Programmet finns tillgängligt i GKS3-mappen från och med GKS3 Kalkyl v3.83.1.
Vid start av programmet visas en vy där man ser alla artiklar och till vilka offertmallar som dessa är kopplade till.
I GKS4 finns API tillgängligt som standard, tillsammans med tjänsten för att skapa tillverkningsorder. Om du använder GKS3 behöver du däremot installera både en API-adapter och en tjänst på din serverdator.
Skapa en mapp för API:et, t.ex. c:\inetpub\wwwroot\gks3api
och lägg filer från paketet du erhållit av Simutek.
Kopiera in GKS.INI till mappen.
Konvertera appen till en applikation i IIS Manager.
Testa åtkomst genom en webbläsare: http://localhost/gks3api/swagger/index.html
.
Se till att API:et görs tillgängligt externt via brandvägg.
Kontrollera att mappen c:\gks3\PlaceSimpleOrder
finns på serverdator, samt att den innehåller filerna:
CreateProdOrderNT.exe
dbexpsda41.dll
GKS.INI
Kör kommando: CreateProdOrderNT.exe -install
Ladda ner och installera Hosting Bundle för Windows.
The customer number in GKS of the buyer. A company with this customer number must exist in GKS.
K100421
Optional name of the sales order that will be useful when searching for the order.
Obsolete. We do not see a business need to change the date of purchase. It should always be the same date as the order request is received.
An optional purchase order number from the buyer. In PlaceSimpleOrder API, "CustOrderNo".
The preferred language (ISO 639-1) of documents communicated with the buyer, i.e. order confirmation. Accepted values: sv, no, en
The currency of the amounts in this sales order. ISO 4217.
SEK
A comment added by the customer during placement of the order. Commonly with instructions to the seller.