Introduction

Dit document beschrijft de standaard interfaces tussen de Shoxl Shop en ERP systemen.

In deze interface wordt een onderscheid gemaakt tussen batch-interfaces en realtime interfaces (webservices). Batch interfaces worden ingezet voor het transport van grote hoeveelheden data, die direct (en dus lokaal) beschikbaar moet zijn wanneer de bezoeker navigeert door de shop.

Real-time interfaces worden ingezet voor het ophalen van actuele data uit het ERP systeem. Deze data kan typisch niet worden klaargezet omdat deze te veranderlijk is, of omdat er complexe berekeningen of regels aan ten grondslag liggen.

Shoxl kent de volgende batch interfaces met ERP systemen:

• Bruto prijsinformatie

• Klanten

• Orders

Shoxl kent de volgende realtime interfaces met ERP systemen:

• Ophalen klantspecifieke prijzen en voorraad

• Ophalen calculatie volledige order (winkelwagen)

• Verzenden orders

• Ophalen orderhistorie

• Ophalen factuurhistorie

Dit vertaalt zich in de volgende Webservices (Methods):

Name	Description
CalculateOrder	We use this method to calculate the order in real time against the business rules defined in the ERP system. Extra orderlines can be returned, for example service fees, shipping costs and/or administrative fees.
GetInvoiceHistory	Using this method we want to receive the outstanding invoices of the given customer.
GetOrderHistory	Using filters we want to receive the orders of a customer. These orders will come directly from the ERP system and can contain our web orders but also orders placed in the shop or by phone.
GetOrderHistoryDetail	With this method we want to receive the order details of a given order number.
GetProductInformation	With this method, we want to receive real time product information from the ERP system. It contains customer-specific product information like pricing and discount information. Also stock information is returned. We will use this method to show real time product information on the product detail page in the web shop.
PlaceOrder	This is method is used to place an order. We will sent again the complete order given from the last CalculateOrder result including billing and shipping address information.

Het communicatieformaat is SOAP 1.1 en SOAP 1.2. De structuur van de SOAP communicate is vastgelegd in een door Integrace gedefinieerd WSDL document.

Orders kunnen dus zowel via de batch-interface worden klaargezet voor het ERP-systeem, als via een webservice worden aangeboden aan dat systeem.

Alle genoemde data wordt rechtstreeks aangeboden aan de shop. Er is dus geen lokaal beheer of nabewerking van data meer; alle beheer vindt plaats in het ERP systeem. De enige uitzondering hierop wordt gevormd door klantdata: deze data kan worden ingezien en aangevuld in Vendisto ERP. De achtergrond hiervan is de rol die de shop speelt bij de uitgifte van toegangsgegevens voor de shop. Daarnaast kunnen desgewenst ook orders worden ingezien, zoals ingevoerd in de shop. Latere mutaties van orders in het ERP systeem zijn in een dergelijk geval echter niet ook zichtbaar in Vendisto.