Documentation REST API Return Order Integration

Return Order Integration

A return order can be released from ERP directly to Axacon WMS.

Recommended integration sequence

  1. Zip code
  2. Addressee
  3. Return order
  4. Return-order lines

Create the zip code

POST https://[SERVER]/integration/rest/V1/ZipCode
{
  "Id": "8000",
  "City": "Aarhus C"
}

Create the addressee

POST https://[SERVER]/integration/rest/V1/Addressee
{
  "Id": "47586622",
  "Name": "Monabekken Barnesenger A/S",
  "Address1": "Solbakken 21",
  "Address2": "",
  "Address3": "Aarhus",
  "City": "Aarhus",
  "Country": "DK",
  "Attention": "Mona",
  "ZipCode": "8000"
}

Create the return order

POST https://[SERVER]/integration/rest/V1/ReturnOrder
{
  "Id": "8003",
  "ReturnOrderType": "RETURN",
  "Addressee": "47586622",
  "OrderName": "Monabekken Barnesenger A/S",
  "DeliveryDate": "14112022",
  "ReceivingNotes": "Check contents",
  "ReturnOrderLine": [
    {
      "Id": "8003-10000",
      "ReturnOrderId": "8003",
      "ItemId": "1964-S",
      "Qty": "110"
    },
    {
      "Id": "8003-20000",
      "ReturnOrderId": "8003",
      "ItemId": "1968-S",
      "Qty": "110"
    }
  ]
}

Updating a return order

  1. Send the CloseReturnOrder command.
  2. Continue only when the response is 200.
  3. Adjust the order in Business Central.
  4. Send the ReopenReturnOrders command.
  5. Send the updated return-order payload.
Warehouse processing has started
If CloseReturnOrder returns 400, contact the warehouse before making changes.