Testing your integration

In this section we describe how you can test your integration without involving end-users. Following the guidelines here you will be able to simulate the actions performed by the end-users.

Sales order integration

When testing your sales order integration you may:

1. POST /shipments
2. POST /invocations/pack (for each line on your shipment)
3. POST /invocations/createDeliveryNote

After step 1 you will receive an event of type ‘shipmentCreated’. Furthermore, you will receive one or more events of the types ‘availableStockChanged’ and ‘availabilityChanged’.

After step 2 you will receive one or more events of type ‘physicalStockChanged’. This is, however, conditioned by the availability of the item in question. If it is not possible to draw the item from stock, you will not get this event.

After step 3 you will receive an event of type ‘documentCreated’ with document type equal to ‘DELIVERY_NOTE’.

Purchase order integration

When testing your purchase order integration you may:

1. POST /inboundShipments
2. POST /globalTradeItemLots (for each line on your inbound shipment)
3. POST /invocations/receive (for each line on your inbound shipment)
4. POST /invocations/createGoodsReceipt

After step 1 you will receive an event of type ‘inboundShipmentCreated’.

After step 3 you will receive one or more events of the type ‘availableStockChanged’, ‘physicalStockChanged’ and ‘availabilityChanged’.

After step 4 you will receive an event of type ‘documentCreated’ with document type equal to ‘GOODS_RECEIPT’.

Stock adjustment integration

When testing your stock adjustment integration you may:

1. POST /invocations/countGlobalTradeItemLot
2. POST /invocations/createAdjustmentList

After step 1 you will receive events of the types ‘availableStockChanged’, ‘physicalStockChanged’ and ‘availabilityChanged’.

After step 2 you will receive an event of the type ‘documentCreated’ with document type equal to ‘ADJUSTMENT_LIST’.

Return integration

When testing your return integration you may:

1. POST /returnShipments
2. POST /invocations/receiveReturned (for each line on your return shipment)
3. POST /invocations/createReturnReceipt

When doing step 2 you need to refer to a trade item lot. You can either refer to the lot the items were drawn from when delivered, or you can refer to a new lot. If you choose to refer to a new lot, you will have to create that first by calling POST /globalTradeItemLot.

After step 1 you will receive an event of type ‘returnShipmentCreated’.

After step 2 you will receive one or more events of the types ‘availableStockChanged’, ‘physicalStockChanged’ and ‘availabilityChanged’.

After step 3 you will receive an event of the type ‘documentCreated’ with document type equal to ‘RETURN_RECEIPT’.