v1

latestOpenAPI 3.0.22026-07-223907721.1 MB
Order

Create Orders

Create new Orders

post/v1/channel/order

Request body

Example request

{
  "orderList": [
    {
      "sellerId": "4711",
      "paymentMethod": "CHANNEL",
      "orderId": "43523-43432-43532",
      "purchasedAt": "2019-02-11T14:54:32+00:00",
      "lastChangedAt": "2019-02-11T16:54:32+00:00",
      "currency": "EUR",
      "orderItem": [
        {
          "orderItemId": "5437233",
          "grossPrice": "2.00",
          "total": "2.00",
          "taxPercent": "16.00",
          "grossFee": "0.29",
          "offerId": 5437233,
          "channelOfferId": "XCD233554",
          "sku": "BEER-001",
          "quantity": "1.0",
          "title": "Dark Beer",
          "estimatedShippingDate": "2010-03-11T00:00:00+00:00",
          "estimatedDeliveryDate": "2010-03-12T00:00:00+00:00",
          "remainingQuantity": "54.0",
          "additionalOrderItemData": [
            {
              "group": "Marketplace Fees",
              "values": [
                {
                  "key": "Advertising fee",
                  "value": "0.50 USD"
                }
              ]
            }
          ],
          "shipFromCountry": "DEU"
        }
      ],
      "billingAddress": {
        "firstName": "Arno",
        "lastName": "Nym",
        "street": "Leyboldstrasse",
        "houseNumber": "14a",
        "addition": "1. UG",
        "postcode": "50354",
        "city": "Hürth",
        "phone": "+49 0221 123456",
        "country": "DE",
        "state": "NRW"
      },
      "shippingAddress": {
        "firstName": "Arno",
        "lastName": "Nym",
        "street": "Leyboldstrasse",
        "houseNumber": "14a",
        "addition": "1. UG",
        "postcode": "50354",
        "city": "Hürth",
        "phone": "+49 0221 123456",
        "country": "DE",
        "state": "NRW"
      },
      "note": "This note can be everything, but a least a additional message.",
      "weeePickup": true,
      "language": "de",
      "invoiceDocumentTransfer": "from-seller",
      "additionalOrderData": [
        {
          "group": "Marketplace Fees",
          "values": [
            {
              "key": "Advertising fee",
              "value": "0.50 USD"
            }
          ]
        }
      ],
      "fbc": true,
      "salesChannelName": "MyMarketplace.de"
    }
  ]
}

Response

Call was overall successful but some items can be faulty

Example response

{
  "errorList": [
    {
      "code": "GEN700",
      "message": "Seller SELLER_4711 does not exist on channel kaufland.",
      "severity": "error",
      "hint": "i9n-order22"
    }
  ]
}