Order management

Retrieving Orders

Method :
GetOrderList

Retrieve Orders

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<GetOrderList>
    <orderFilter>
      <BeginCreationDate>{{BeginCreationDate}}</BeginCreationDate>
        <BeginModificationDate>{{BeginModificationDate}}</BeginModificationDate>
        <EndCreationDate>{{EndCreationDate}}</EndCreationDate>
        <EndModificationDate>{{EndModificationDate}}</EndModificationDate>
        <FetchOrderLines>true</FetchOrderLines>
        <States>
            <OrderStateEnum>CancelledByCustomer</OrderStateEnum>
            <OrderStateEnum>WaitingForSellerAcceptation</OrderStateEnum>
            <OrderStateEnum>AcceptedBySeller</OrderStateEnum>
            <OrderStateEnum>WaitingForShipmentAcceptation</OrderStateEnum>
            <OrderStateEnum>Shipped</OrderStateEnum>
            <OrderStateEnum>RefusedBySeller</OrderStateEnum>
            <OrderStateEnum>ShipmentRefusedBySeller</OrderStateEnum>
        </States>
    </orderFilter>
</GetOrderList>

Route :
GET /orders

This route allows you to retrieve orders through filters and using paginated results.

Request URL

GET /orders?pageSize=100&sort=createdAt&,code>

This route does not have any path parameters or body.

All filtering is passed as query string parameters.

Currently available filters are as follows :

Order State
Order Reference
Sorting
Pagination
SalesChannel filter
Date filters

Sample Response

{
  "itemsPerPage": 1,
  "items": [
    {
      "orderId": "SCID01210525142759UT8E",
      "reference": "testCdiscount_04e",
      "businessOrder": true,
      "salesChannel": {
        "id": "SCID01",
        "name": "SalesChannel01"
      },
      "seller": {
        "id": "98979"
      },
      "customer": {
        "reference": "custm_001"
      },
      "purchasedAt": "2026-03-19T09:57:29Z",
      "updatedAt": "2026-03-25T09:57:29Z",
      "createdAt": "2022-03-15T09:57:29Z",
      "shippedAtMax": "2021-02-19T09:57:29Z",
      "status": "WaitingAcceptance",
      "payment": {
        "method": "Card"
      },
      "currencyCode": "ALL",
      "billingAddress": {
        "civility": "M",
        "firstName": "Jane",
        "lastName": "Doe",
        "companyName": "Company Inc.",
        "addressLine1": "12 avenue de paris",
        "addressLine2": "Bat C",
        "addressLine3": "4eme etage",
        "postalCode": "75001",
        "city": "Paris",
        "stateOrRegion": "Ile de france",
        "countryCode": "FR"
      },
      "totalPrice": {
        "offerPrice": 504,
        "sellingPrice": 504
      },
      "statusEvents": [],
      "lines": [
        {
          "orderLineId": "1AZRT",
          "status": "Refused",
          "quantity": 10,
          "totalPrice": {
            "offerPrice": 252,
            "sellingPrice": 252
          },
          "offerPrice": {
            "unitSalesPrice": 25,
            "shippingCost": 2,
            "commission": {
              "amountWithVat": 12,
              "amountWithoutVat": 10,
              "rate": 12
            },
            "taxes": [
              {
                "code": "VAT",
                "target": "offer",
                "amount": 20
              }
            ]
          },
          "sellingPrice": {
            "unitSalesPrice": 25,
            "shippingCost": 2,
            "taxes": [
              {
                "code": "VAT",
                "target": "offer",
                "amount": 20
              }
            ]
          },
          "offer": {
            "id": "Offer12345",
            "sellerProductId": "PID123456",
            "supplyMode": "Seller",
            "productId": "NIN6452650",
            "productTitle": "Nintendo Switch Lite Gray Console",
            "condition": "New",
            "productGtin": "045496452650"
          },
          "delivery": {
            "mode": "TrackedHomeDelivery",
            "promisedAtMin": "2021-02-19T09:57:29Z",
            "promisedAtMax": "2021-01-23T09:57:29Z",
            "shippedAtMax": "2021-02-19T09:57:29Z"
          },
          "shippingAddress": {
            "civility": "Mr",
            "firstName": "John",
            "lastName": "Doe",
            "companyName": "Company Inc.",
            "addressLine1": "10 avenue de Paris",
            "addressLine2": "Batiment A",
            "addressLine3": "Appartement A001",
            "postalCode": "75001",
            "city": "Paris",
            "stateOrRegion": "Ile de france",
            "countryCode": "FR",
            "phone": "+33176548976",
            "email": "johndoe@mymail.com"
          },
          "parcels": [
            {
              "parcelNumber": "3Y00523771050",
              "carrierName": "LaPoste",
              "trackingUrl": "https://chronopost/mypackage"
            }
          ],
          "productAttributes": {
            "RegistrationNumber": [
              "123456789"
            ],
            "IMEI": [
              "90018001900"
            ],
            "SerialNumber": [
              "BA-123456"
            ]
          },
          "statusEvents": []
        }
      ]
    }
  ]
}

See also : GET/orders

Method :
GetOrderListByIdentifier

Retrieve Orders

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<GetOrderList>
    <orderFilter>
        <FetchOrderLines>true<FetchOrderLines>
        <OrderReferenceList>
            <string>{{OrderReference}}<string>
        <OrderReferenceList>
        <States />
    <orderFilter>
<GetOrderList>

Route :
GET /orders/{orderId}

This route allows you to retrieve all details about a single order.

Request URL

GET /orders/{orderId}

Sample Response

{
  "orderId": "SCID01210525142759UT8E",
  "reference": "testCdiscount_04e",
  "businessOrder": true,
  "salesChannel": {
    "id": "SCID01",
    "name": "SalesChannel01"
  },
  "seller": {
    "id": "98979"
  },
  "customer": {
    "reference": "custm_001"
  },
  "purchasedAt": "2026-03-19T09:57:29Z",
  "updatedAt": "2026-03-25T09:57:29Z",
  "createdAt": "2022-03-15T09:57:29Z",
  "shippedAtMax": "2021-02-19T09:57:29Z",
  "status": "WaitingAcceptance",
  "payment": {
    "method": "Card"
  },
  "currencyCode": "ALL",
  "billingAddress": {
    "civility": "M",
    "firstName": "Jane",
    "lastName": "Doe",
    "companyName": "Company Inc.",
    "addressLine1": "12 avenue de paris",
    "addressLine2": "Bat C",
    "addressLine3": "4eme etage",
    "postalCode": "75001",
    "city": "Paris",
    "stateOrRegion": "Ile de france",
    "countryCode": "FR"
  },
  "totalPrice": {
    "offerPrice": 504,
    "sellingPrice": 504
  },
  "statusEvents": [],
  "lines": [
    {
      "orderLineId": "1AZRT",
      "status": "Refused",
      "quantity": 10,
      "totalPrice": {
        "offerPrice": 252,
        "sellingPrice": 252
      },
      "offerPrice": {
        "unitSalesPrice": 25,
        "shippingCost": 2,
        "commission": {
          "amountWithVat": 12,
          "amountWithoutVat": 10,
          "rate": 12
        },
        "taxes": [
          {
            "code": "VAT",
            "target": "offer",
            "amount": 20
          }
        ]
      },
      "sellingPrice": {
        "unitSalesPrice": 25,
        "shippingCost": 2,
        "taxes": [
          {
            "code": "VAT",
            "target": "offer",
            "amount": 20
          }
        ]
      },
      "offer": {
        "id": "Offer12345",
        "sellerProductId": "PID123456",
        "supplyMode": "Seller",
        "productId": "NIN6452650",
        "productTitle": "Nintendo Switch Lite Gray Console",
        "condition": "New",
        "productGtin": "045496452650"
      },
      "delivery": {
        "mode": "TrackedHomeDelivery",
        "promisedAtMin": "2021-02-19T09:57:29Z",
        "promisedAtMax": "2021-01-23T09:57:29Z",
        "shippedAtMax": "2021-02-19T09:57:29Z"
      },
      "shippingAddress": {
        "civility": "Mr",
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Company Inc.",
        "addressLine1": "10 avenue de Paris",
        "addressLine2": "Batiment A",
        "addressLine3": "Appartement A001",
        "postalCode": "75001",
        "city": "Paris",
        "stateOrRegion": "Ile de france",
        "countryCode": "FR",
        "phone": "+33176548976",
        "email": "johndoe@mymail.com"
      },
      "parcels": [
        {
          "parcelNumber": "3Y00523771050",
          "carrierName": "LaPoste",
          "trackingUrl": "https://chronopost/mypackage"
        }
      ],
      "productAttributes": {
        "RegistrationNumber": [
          "123456789"
        ],
        "IMEI": [
          "90018001900"
        ],
        "SerialNumber": [
          "BA-123456"
        ]
      },
      "statusEvents": []
    },
    {
      "orderLineId": "1AZRT",
      "status": "WaitingAcceptance",
      "quantity": 10,
      "totalPrice": {
        "offerPrice": 252,
        "sellingPrice": 252
      },
      "offerPrice": {
        "unitSalesPrice": 25,
        "shippingCost": 2,
        "commission": {
          "amountWithVat": 12,
          "amountWithoutVat": 10,
          "rate": 12
        },
        "taxes": [
          {
            "code": "VAT",
            "target": "offer",
            "amount": 20
          }
        ]
      },
      "sellingPrice": {
        "unitSalesPrice": 25,
        "shippingCost": 2,
        "taxes": [
          {
            "code": "VAT",
            "target": "offer",
            "amount": 20
          }
        ]
      },
      "offer": {
        "id": "Offer12345",
        "sellerProductId": "PID123456",
        "supplyMode": "Seller",
        "productId": "NIN6452650",
        "productTitle": "Nintendo Switch Lite Gray Console",
        "condition": "New",
        "productGtin": "045496452650"
      },
      "delivery": {
        "mode": "TrackedHomeDelivery",
        "promisedAtMin": "2021-02-19T09:57:29Z",
        "promisedAtMax": "2021-01-23T09:57:29Z",
        "shippedAtMax": "2021-02-19T09:57:29Z"
      },
      "shippingAddress": {
        "civility": "Mr",
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Company Inc.",
        "addressLine1": "10 avenue de Paris",
        "addressLine2": "Batiment A",
        "addressLine3": "Appartement A001",
        "postalCode": "75001",
        "city": "Paris",
        "stateOrRegion": "Ile de france",
        "countryCode": "FR",
        "phone": "+33176548976",
        "email": "johndoe@mymail.com"
      },
      "parcels": [
        {
          "parcelNumber": "3Y00523771050",
          "carrierName": "LaPoste",
          "trackingUrl": "https://chronopost/mypackage"
        }
      ],
      "productAttributes": {
        "RegistrationNumber": [
          "123456789"
        ],
        "IMEI": [
          "90018001900"
        ],
        "SerialNumber": [
          "BA-123456"
        ]
      },
      "statusEvents": []
    }
  ]
}

Specific : Sellers managing Cdiscount Orders

Depending on seller configuration regarding order management,
IF the seller did not enable Automatic Order Acceptance within the SellerPortal,
THEN orders have to be Approved before moving on to shipping.

The following applies to orders on Cdiscount only, and can be done on orders with the “WaitingAcceptance” status only.

REST Order Approval is Global

Order Approval cannot be made on a specific order Line.

Making a call to this route, will accept all lines within the order.

Method :
ValidateOrderList – Order Approval

Approve an order after receiving it

Request URL

POST https://wsvc.cdiscount.com/MarketplaceAPIService.svc

Body

<ValidateOrderList>
    <validateOrderListMessage>
        <OrderList>
            <ValidateOrder>
                <OrderLineList>
                    <ValidateOrderLine>
                        <AcceptationState>AcceptedBySeller</AcceptationState>
                        <ProductCondition>{{ProductCondition}}</ProductCondition>
                        <SellerProductId>{{SellerProductId}}</SellerProductId>
                    </ValidateOrderLine>
                </OrderLineList>
                <OrderNumber>{{OrderNumber}}</OrderNumber>
                <OrderState>AcceptedBySeller</OrderState>
            </ValidateOrder>
        </OrderList>
    </validateOrderListMessage>
</ValidateOrderList>

Route :
POST /orders/{orderId}/approval-status

This route allows you to retrieve all details about a single order.

Request URL

POST /orders/{orderId}/approval-status

Sample Response

{
  "approval_status": "Accepted"
}

<< Offers

Discussions >>

Order management

On this page

Retrieving Orders

Method :GetOrderList

Route :GET /orders

Method :GetOrderListByIdentifier

Route :GET /orders/{orderId}

Specific : Sellers managing Cdiscount Orders

REST Order Approval is Global

Method :ValidateOrderList – Order Approval

Route :POST /orders/{orderId}/approval-status

Method :
GetOrderList

Route :
GET /orders

Method :
GetOrderListByIdentifier

Route :
GET /orders/{orderId}

Method :
ValidateOrderList – Order Approval

Route :
POST /orders/{orderId}/approval-status