Mirakl Marketplace APIs (latest-release)

Languages
Servers
URL to be replaced by your Mirakl instance URL
https://your-instance.mirakl.net/

Stores

Operations

Platform Settings

Operations

Invoicing and Accounting

Operations

Products

Operations

Messages

Operations

Offers

Operations

Orders

Operations

Perform a full cancelation of an order

Request

Path
order_idstringrequired

Order's identifier

Query
shop_idinteger(int64)

Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

curl -i -X PUT \
  'https://your-instance.mirakl.net/api/orders/{order_id}/cancel?shop_id=0'

Responses

No Content

Perform cancelations on order lines

Request

Query
shop_idinteger(int64)

Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

Bodyapplication/json
cancelationsArray of objects(OR30_Request_Cancelations)

List of representations of cancellations to be created

order_tax_modestring

Please note: If the taxes are not specified, the prices with mode TAX_EXCLUDED and with mode TAX_INCLUDED will return the same amounts.
Possible values:

  • TAX_EXCLUDED: the price fields (price, unit price, shipping price and order total prices) do not include taxes.
  • TAX_INCLUDED: the price fields include the tax amounts.
  • If not specified, the default order tax mode of the platform is used.

curl -i -X PUT \
  'https://your-instance.mirakl.net/api/orders/cancel?shop_id=0' \
  -H 'Content-Type: application/json' \
  -d '{
    "cancelations": [
      {
        "amount": 0,
        "currency_iso_code": "string",
        "fees": [
          {
            "amount": 0,
            "code": "string"
          }
        ],
        "order_line_id": "string",
        "quantity": 0,
        "reason_code": "string",
        "shipping_amount": 0,
        "shipping_taxes": [
          {
            "amount": 0,
            "code": "string"
          }
        ],
        "taxes": [
          {
            "amount": 0,
            "code": "string"
          }
        ]
      }
    ],
    "order_tax_mode": "string"
  }'

Responses

OK

Bodyapplication/json
cancelationsArray of objects(OR30_Response_200_Cancelations)

List of representations of created cancellations

order_tax_modestring

Please note: In case there is no tax, the prices will show the same amount in TAX_EXCLUDED and TAX_INCLUDED mode. The tax mode is only useful if taxes are specified in the cancelation.
Possible values:

  • TAX_EXCLUDED: the price fields (amount, shipping amount) are expressed without tax (taxes should be added to these prices in order to get the full amount including taxes).
  • TAX_INCLUDED: the price fields include the tax amount.

Response
application/json
{ "cancelations": [ {} ], "order_tax_mode": "string" }

Update the custom fields of an order and its order lines

Request

Only specified custom field values will be updated.
In order to delete an custom field's value, set it to null or an empty string. Note that you may not delete the value of a required custom field value.
Output will return information on the status of the update attempt by giving:

  • either all of the order and its order lines custom field values after the update
  • or in case of errors, the list of errors and the body of the initial call

Path
order_idstringrequired

Order identifier

Query
shop_idinteger(int64)

Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

Bodyapplication/json
order_additional_fieldsArray of objects(OR31_Request_OrderAdditionalFields)

Order custom fields

order_linesArray of objects(OR31_Request_OrderLines)

Order lines custom fields

curl -i -X PUT \
  'https://your-instance.mirakl.net/api/orders/{order_id}/additional_fields?shop_id=0' \
  -H 'Content-Type: application/json' \
  -d '{
    "order_additional_fields": [
      {
        "code": "string",
        "type": "string"
      }
    ],
    "order_lines": [
      {
        "order_line_additional_fields": [
          {
            "code": "string",
            "type": "string"
          }
        ],
        "order_line_id": "string"
      }
    ]
  }'

Responses

OK

Bodyapplication/json
order_update_errorsobject(OR31_Response_200_OrderUpdateErrors)
order_update_resultobject(OR31_Response_200_OrderUpdateResult)
Response
application/json
{ "order_update_errors": { "errors": [], "input": {} }, "order_update_result": { "order_additional_fields": [], "order_lines": [] } }

Incidents

Operations

Picklists

Operations

Promotions

Operations

Returns

Operations

Multiple shipments

Operations