Crée ou met à jour des commandes (bulk)

POST

https://core.shopimind.com/v1/orders

Crée ou met à jour jusqu'à 50 commandes en une seule requête. Chaque enregistrement est apparié sur order_id : les commandes existantes sont mises à jour, les nouvelles sont créées. La validation s'effectue item par item — les items rejetés sont retournés dans rejected_items tandis que les items valides sont acceptés. Le traitement est asynchrone : les modifications peuvent ne pas être immédiatement visibles lors des lectures suivantes.

Parameters

Header Parameters

spm-api-key*

[Authentication] Required API key, in the form {prefix}.{secret}.

Type

string

Required

Example"a1b2c3d4.xK9pR2mVn6QwErTyUiOpAsDfGhJkLzXcVbNmQwErTyU"

Pattern

"^[a-zA-Z0-9]{8}\\.[A-Za-z0-9_-]+$"

Request Body

application/json

[

  

{

  

  

"order_id": "order_id_1",

  

  

"shop_id": "shop_id_1",

  

  

"lang": "en",

  

  

"reference": "ref0001",

  

  

"carrier_id": "carrier_id_1",

  

  

"status_id": "pending",

  

  

"address_delivery_id": "address_id_1",

  

  

"address_invoice_id": "address_id_2",

  

  

"customer": {

  

  

  

"customer_id": "customer_id_1",

  

  

  

"email": "test@test.com",

  

  

  

"created_at": "2023-01-29T14:47:00.000Z",

  

  

  

"first_name": "Jean",

  

  

  

"last_name": "Dupont"

  

  

},

  

  

"products": [

  

  

  

{

  

  

  

  

"product_id": "prod_001",

  

  

  

  

"product_variation_id": 1,

  

  

  

  

"price": 10.99,

  

  

  

  

"price_without_tax": 9.99,

  

  

  

  

"manufacturer_id": "manufacturer_id_1",

  

  

  

  

"quantity": 1

  

  

  

}

  

  

],

  

  

"cart_id": "cart_id_1",

  

  

"cart_updated_at": "2023-01-29T14:47:00.000Z",

  

  

"amount": 109.99,

  

  

"amount_without_tax": 100.99,

  

  

"shipping_costs": 2.99,

  

  

"shipping_costs_without_tax": 10.99,

  

  

"shipping_number": "string",

  

  

"currency": "USD",

  

  

"voucher_used": "VOUCHER_CODE",

  

  

"voucher_value": "10.99",

  

  

"is_confirmed": true,

  

  

"created_at": "2023-01-29T14:47:00.000Z",

  

  

"updated_at": "2023-01-29T14:47:00.000Z"

  

}

]

Responses

Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items.

Content-Type

application/json

{

  

"statusCode": 200,

  

"sent_count": 5,

  

"rejected_count": 0,

  

"rejected_items": [

  

]

}

POST

https://core.shopimind.com/v1/orders

Playground

Headers

spm-api-key*

Body

Samples

Crée ou met à jour des commandes (bulk) Crée ou met à jour jusqu'à 50 commandes en une seule requête. Chaque enregistrement est apparié sur order_id : les commandes existantes sont mises à jour, les nouvelles sont créées. La validation s'effectue item par item — les items rejetés sont retournés dans rejected_items tandis que les items valides sont acceptés. Le traitement est asynchrone : les modifications peuvent ne pas être immédiatement visibles lors des lectures suivantes. POST /v1/orders bulkCreateOrders Orders spm-api-key [Authentication] Required API key, in the form {prefix}.{secret}. Objects have been sent to the processing queue. Partially invalid objects are rejected and returned in rejected_items. All objects are invalid, or the request body is not an array, or the array exceeds the maximum allowed size Server error - Internal processing failure