Technische handleiding
1. Functionele beschrijving
OCI roundtrip tussen klant en de DESTIL-catalogus.
In onderstaand schema is aangegeven dat een gebruiker inlogt en middels een OCI koppeling gebruikmaakt van de externe catalogus link die door DESTIL beschikbaar wordt gesteld.
De gebruiker kan in de externe catalogus van DESTIL zijn winkelwagentje samenstellen. Vervolgens vindt er een afronding plaats van de bestelling door een zogenaamde 'punch-out' te doen. Met de punch-out worden de gegevens van het winkelwagentje naar het winkelwagentje van de door de klant gebruikte software gestuurd.
2. Relevante gegevens
Inloggegevens OCI test account www.destil.nl
Username: OCI-TEST
Password: ABc123Def456
2.1 Relevante gegevens voor DESTIL
De gegevens die DESTIL van u nodig heeft:
- Gegevens contactpersonen
- De HOOK_URL waar de gegevens van het mandje na de inkoop heen gestuurd moeten. Deze gegevens worden meegestuurd door de software van de klant bij de start van de roundttrip (zie hoofdstuk 1).
- De OCI parameters. Dit zijn aanvullende gegevens voor het posten van de gegevens. Standaard moeten de volgende variabelen worden meegegeven:
- HOOK_URL =
- USERNAME =
- PASSWORD =
- ~OkCode" value = "ADDI"
- ~TARGET" value = "_top"
- ~CALLER" value = "CTLG"
2.2 Webservices
Via internet worden door DESTIL onderstaande webservices aangeboden (poort 81 voor de productie- en 82 voor de testomgeving). Hiermee kan men rechtstreeks informatie aan het ERP onttrekken, maar ook gegevens toevoegen. Dat laatste gebeurt alleen na validatie door het ERP. De services zijn alleen toegankelijk voor vrijgegeven ip-adressen ('white list').
Order INSBOU aanmaken (live):
http://webservices.destil.nl:81/Web_Order_INSBOU_Create/PutOrder.svc
Order INSBOU aanmaken (test):
http://webservices.destil.nl:82/Web_Order_INSBOU_Create/PutOrder.svc
De beschrijving van de service is eenvoudig op te halen door via http de gewenste service aan te roepen en daarna de bijbehorende WSDL (Web Services Description Language) te openen. Hierin worden de bijbehorende XSD's getoond. Zie een voorbeeld hieronder aan de hand van Get Customer service.
De aan te leveren order moet voldoen aan de specificaties van de INSBOU order, versie 003. De schema- en entiteitenbeschrijvingen zijn beschikbaar bij GS1.
3. Beschrijving OCI parameters
Dit hoofdstuk geeft inzicht in de parameters van de OCI roundtrip tussen klantsoftware en een externe leverancierscatalogus. Dit hoofdstuk specificeert welke elementen uit de standaard OCI gebruikt kunnen worden in de punch-out in de externe catalogus.
Elementen die gepost worden
| Element | Omschrijving | Verplicht |
| NEW_ITEM-DESCRIPTION | Omschrijving van het artikel | Ja |
| NEW_ITEM-QUANTITY | Hoeveelheid besteld per eenheid | Ja |
| NEW_ITEM-PRICE | Prijs van besteld artikel | Ja |
| NEW_ITEM-EXT_PRODUCT_ID | Artikelnummer van besteld artikel | Ja |
| NEW_ITEM-VENDORMAT | Artikelnummer van leverancier | Nee |
| NEW_ITEM-VENDOR | Leverancier identificatie van besteld artikel | Ja |
| NEW_ITEM-CURRENCY | Valuta code voor prijs van besteld artikel (EUR) | Ja |
| NEW_ITEM-UNIT | Eenheid voor besteld aantal van een artikel | Ja |
| NEW_ITEM-MATGROUP | Categorie | Nee |
| NEW_ITEM-VATPERCENTAGE | Dit element is geen onderdeel van de OCI standaard. Het is toegevoegd om het mogelijk te maken om BTW gegevens, en in dit geval het percentage, terug te geven. Het is van belang dat bekend is of de prijs van een artikel inclusief of exclusief is. Deze instelling wordt vastgelegd in de parameters bij de externe catalogus definitie vna het vorige hoofdstuk het percentage wordt in hele cijfers weergegevens. 19% BTW wordt al waarde 19 doorgegeven | Nee |
| NEW_ITEM-PRICEUNIT | Prijseenheid | Ja |
4. OCI Form post
In dit hoofdstuk wordt gekeken naar de gegevens die vanuit DESTIL gestuurd worden naar de klantomgeving. Het versturen van de gegevens wordt ook wel een HTTP form POST genoemd. De gegevens worden d.m.v. HTTP gestuurd naar de klantomgeving die bij de HOOK_URL parameter is aangegeven. In de bijlage SAP OCI 3.0 staat een uitgebreide beschrijving voor het gebruik van de parameters en de velden.
Voorbeeld OCI Form POST
Data van de post met alle mogelijke velden: (Dikgedrukt wordt door DESTIL gepost)
Na het inkopen moet het mandje met de producten die de klant heeft geselecteerd overgehaald worden in het klantsysteem om daar verder verwerkt te worden. Het catalogussysteem van DESTIL moet na het afsluiten de catalogusgegevens naar het klantsysteem sturen in het formaat zoals in het bovenstaande voorbeeld. Het is hierbij van belang goed te letten op het juiste gebruik van de namen van de variabelen, de juiste syntax en interpunctie.
5. Login
Er is een testomgeving beschikbaar bij DESTIL.
/services/login.aspx
Testaccount:
Gebruikersnaam: OCI_Test
Wachtwoord: TestOCITest
Live-omgeving:
Hiervoor kunnen we op aanvraag een account aanmaken.