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

Get the evaluation of an order

Request

Path
order_idstringrequired
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.

localestring

<ISO-639>_<ISO-3166> ("en_US") or <ISO-639> ("en") locale for internationalized data translation. The APIs only accept locales that are equivalent to the languages activated in the back-office.

curl -i -X GET \
  'https://your-instance.mirakl.net/api/orders/{order_id}/evaluation?locale=string&shop_id=0'

Responses

OK

Bodyapplication/json
assessmentsArray of objects(OR51_Response_200_Assessments)

List of assessments

commentstring

Evaluation comment

customer_idstring

Identifier of the customer who posted the evaluation

datestring(date-time)

Evaluation creation date

firstnamestring

First name of the customer who posted the evaluation

gradeinteger(int32)

Evaluation grade

last_updated_datestring(date-time)

Evaluation last updated date

lastnamestring

Last name of the customer who posted the evaluation

replyobject(OR51_Response_200_Reply)
visibleboolean

Whether the evaluation is visible or not

Response
application/json
{ "assessments": [ { … } ], "comment": "string", "customer_id": "string", "date": "2019-08-24T14:15:22Z", "firstname": "string", "grade": 0, "last_updated_date": "2019-08-24T14:15:22Z", "lastname": "string", "reply": { "comment": "string", "date": "2019-08-24T14:15:22Z", "type": "string" }, "visible": true }

Lists order's documents

Request

Returns a list of all the documents available on the order

Query
order_idsstring<= 100

the orders' identifiers, using comma as separator

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 GET \
  'https://your-instance.mirakl.net/api/orders/documents?order_ids=string&shop_id=0'

Responses

OK

Bodyapplication/json
order_documentsArray of objects(OR72_Response_200_OrderDocuments)

The document details

Response
application/json
{ "order_documents": [ { … } ] }

Download one or multiple documents attached to one or multiple orders

Request

  • If a list of document identifiers is specified only these documents are downloaded.
    • If more than one document id is specified, the documents will be wrapped in a ZIP archive
    • If only one document id is specified the document will not be zipped
  • If a list of order identifiers is specified, all documents from those orders are downloaded.
    Use a list of order document type codes to retrieve specific types from those orders.
    In this case, the output of the API will always be a ZIP archive even if there is only one document to retrieve.
When documents are retrieved, they're wrapped into a ZIP archive except when only one document id is specified. The tree structure of this archive is as follow:

documents-timestamp.zip
|
|__ order_id_x/
|   |__ foo.txt
|   |__ bar.txt
|   |__ baz.pdf
|
|__ order_id_y/
|   |__ image.png
|   |__ image(1).png
Query
order_idsstring<= 100

A list of identifiers of the orders (separated by a comma)

document_idsstring<= 100

A list of document identifiers (separated by a comma)

document_codesstring<= 100

A list of document type codes (separated by a comma)

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 GET \
  'https://your-instance.mirakl.net/api/orders/documents/download?document_codes=string&document_ids=string&order_ids=string&shop_id=0'

Responses

OK

Bodyapplication/octet-stream
string(binary)

Incidents

Operations

Picklists

Operations

Promotions

Operations

Returns

Operations

Multiple shipments

Operations