Integration Overview
...
Orders
OR11 - List Orders
{ "tab" "examples", "url" "https //saksus2 dev mirakl net/api/orders", "name" "or11 list orders", "method" "get", "request" { "pathparameters" \[], "queryparameters" \[ { "kind" "optional", "name" "order ids", "type" "string", "children" \[], "description" "a comma separated list of order's identifiers max 100" }, { "kind" "optional", "name" "order references for customer", "type" "string", "children" \[], "description" "a comma separated list of order references for customer max 100" }, { "kind" "optional", "name" "order references for seller", "type" "string", "children" \[], "description" "a comma separated list of order references for seller max 100" }, { "kind" "optional", "name" "order state codes", "type" "string", "children" \[], "description" "a comma separated list of order state's codes" }, { "kind" "optional", "name" "channel codes", "type" "string", "children" \[], "description" "a comma separated list of channel codes max 100" }, { "kind" "optional", "name" "only null channel", "type" "boolean", "children" \[], "description" "return only orders without channel if true, ignore the channel codes default to false " }, { "kind" "optional", "name" "start date", "type" "string", "children" \[], "description" "start creation date for filtering" }, { "kind" "optional", "name" "end date", "type" "string", "children" \[], "description" "end creation date for filtering" }, { "kind" "optional", "name" "start update date", "type" "string", "children" \[], "description" "start update date for filtering mirakl will subtract a time delta to ensure no orders are missed due to network and/or software latency " }, { "kind" "optional", "name" "end update date", "type" "string", "children" \[], "description" "end update date for filtering" }, { "kind" "optional", "name" "paginate", "type" "boolean", "children" \[], "description" "control the pagination usage default to true " }, { "kind" "optional", "name" "customer debited", "type" "boolean", "children" \[], "description" "order paid by customer" }, { "kind" "optional", "name" "payment workflow", "type" "string", "children" \[], "description" "payment workflow of an order one of pay on acceptance, pay on delivery, pay on due date, pay on shipment, no customer payment confirmation" }, { "kind" "optional", "name" "has incident", "type" "boolean", "children" \[], "description" "if true returns only orders with incidents in progress, if false returns orders without incidents in progress default to all " }, { "kind" "optional", "name" "fulfillment center code", "type" "array", "children" \[], "description" "code of the fulfillment center max 100" }, { "kind" "optional", "name" "order tax mode", "type" "string", "children" \[], "description" "one of tax included, tax excluded 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, cancellation amount, refund amount and order total prices) do not include taxes (taxes come on top of the price amount) tax included the price fields include the tax amount if this query parameter is not specified, the default order tax mode of the platform is used m is used " }, { "kind" "optional", "name" "shop id", "type" "integer", "children" \[], "description" "use this parameter when your user has access to several shops if not specified, the shop id from your default shop will be used " } ], "headerparameters" \[ { "kind" "required", "name" "authorization", "type" "string", "children" \[], "description" "" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "v7dtfm7x5fbgjc quhw8w", "code" "", "language" "200", "customlabel" "" } ], "selectedlanguageid" "v7dtfm7x5fbgjc quhw8w" }, "examples" { "languages" \[ { "id" "cuwelsxdf4hxbshmfxqcv", "code" "curl location request get 'https //saksus2 dev mirakl net/api/orders?order ids=string\&order references for customer=string\&order references for seller=string\&order state codes=string\&channel codes=string\&only null channel=boolean\&start date=string\&end date=string\&start update date=string\&end update date=string\&paginate=boolean\&customer debited=boolean\&payment workflow=string\&has incident=boolean\&fulfillment center code=array\&order tax mode=string\&shop id=integer' \\\\\n header 'accept application/json' \\\\\n header 'authorization string'", "language" "curl", "customlabel" "" }, { "id" "yomdbushoq79tayt zi75", "code" "var request = require('request');\nvar options = {\n 'method' 'get',\n 'url' 'https //saksus2 dev mirakl net/api/orders?order ids=string\&order references for customer=string\&order references for seller=string\&order state codes=string\&channel codes=string\&only null channel=boolean\&start date=string\&end date=string\&start update date=string\&end update date=string\&paginate=boolean\&customer debited=boolean\&payment workflow=string\&has incident=boolean\&fulfillment center code=array\&order tax mode=string\&shop id=integer',\n 'headers' {\n 'accept' 'application/json',\n 'authorization' 'string'\n }\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "language" "nodejs", "customlabel" "" }, { "id" "4almd6jd6punto9vugucb", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"authorization\\", \\"string\\");\n\nvar requestoptions = {\n method 'get',\n headers myheaders,\n redirect 'follow'\n};\n\nfetch(\\"https //saksus2 dev mirakl net/api/orders?order ids=string\&order references for customer=string\&order references for seller=string\&order state codes=string\&channel codes=string\&only null channel=boolean\&start date=string\&end date=string\&start update date=string\&end update date=string\&paginate=boolean\&customer debited=boolean\&payment workflow=string\&has incident=boolean\&fulfillment center code=array\&order tax mode=string\&shop id=integer\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "language" "javascript", "customlabel" "" }, { "id" "me8ue13tpqz 8cxdckjzh", "code" "import requests\n\nurl = \\"https //saksus2 dev mirakl net/api/orders?order ids=string\&order references for customer=string\&order references for seller=string\&order state codes=string\&channel codes=string\&only null channel=boolean\&start date=string\&end date=string\&start update date=string\&end update date=string\&paginate=boolean\&customer debited=boolean\&payment workflow=string\&has incident=boolean\&fulfillment center code=array\&order tax mode=string\&shop id=integer\\"\n\npayload={}\nheaders = {\n 'accept' 'application/json',\n 'authorization' 'string'\n}\n\nresponse = requests request(\\"get\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "language" "python", "customlabel" "" }, { "id" "kkw2n fn0n9ldksmiz1py", "code" "require \\"uri\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //saksus2 dev mirakl net/api/orders?order ids=string\&order references for customer=string\&order references for seller=string\&order state codes=string\&channel codes=string\&only null channel=boolean\&start date=string\&end date=string\&start update date=string\&end update date=string\&paginate=boolean\&customer debited=boolean\&payment workflow=string\&has incident=boolean\&fulfillment center code=array\&order tax mode=string\&shop id=integer\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http get new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"authorization\\"] = \\"string\\"\n\nresponse = https request(request)\nputs response read body\n", "language" "ruby", "customlabel" "" } ], "selectedlanguageid" "cuwelsxdf4hxbshmfxqcv" }, "description" "when available, refunds will be returned within the refunds object under orders order lines refunds", "currentnewparameter" { "label" "header parameter", "value" "headerparameters" } } call frequencies recommended \ asynchronous every 5 minutes \ synchronous at each order page display maximum \ asynchronous once per minute \ synchronous at each order page display pagination this resource supports offset pagination sort fields sort field can have the following values datecreated (default) sort by creation date, and then by order identifier (asc by default) localization this resource supports locale parameter ( see documentation https //saksus1 dev mirakl net/help/help/api doc/seller/mmp html#locale ) localized output fields will be highlighted with a flag icon