{"_id":"55035fc26cb452370085b3ef","editedParams2":true,"__v":4,"parentDoc":null,"user":"5436a1afb7cf0e1c0020d9ca","version":{"_id":"54cc2148380ecd0d00ca18aa","__v":2,"forked_from":"5436a1e1d0ffee0e00f18f8f","project":"5436a1e1d0ffee0e00f18f8c","createdAt":"2015-01-31T00:26:48.753Z","releaseDate":"2015-01-31T00:26:48.753Z","categories":["54cc2149380ecd0d00ca18ab","54cc2149380ecd0d00ca18ac","54cc2149380ecd0d00ca18ad","54cc2149380ecd0d00ca18ae","54cc2149380ecd0d00ca18af","54cc2149380ecd0d00ca18b0","54cc2149380ecd0d00ca18b1","54cc2149380ecd0d00ca18b2","54cc2149380ecd0d00ca18b3","552f29ca633a5b0d00e99d09"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"category":{"_id":"54cc2149380ecd0d00ca18ac","pages":["54cc2149380ecd0d00ca18c4","54cc2149380ecd0d00ca18c5","54cc2149380ecd0d00ca18c6","54cc2149380ecd0d00ca18c7","54cc2149380ecd0d00ca18c8","54cc2149380ecd0d00ca18c9","54cc2601380ecd0d00ca18dc","55035fc26cb452370085b3ef","561dbc1defcf8217003adf22","561e6b043e744b2100d21191"],"project":"5436a1e1d0ffee0e00f18f8c","version":"54cc2148380ecd0d00ca18aa","__v":5,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-09T15:31:21.989Z","from_sync":false,"order":1,"slug":"customer-api","title":"Customer API"},"editedParams":true,"project":"5436a1e1d0ffee0e00f18f8c","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-03-13T22:08:02.388Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"name":"Example payload","code":"{\"order\":{\"order_status\":\"awaiting_payment\"}}","language":"json"}]},"method":"put","results":{"codes":[{"language":"json","status":200,"name":"","code":"{\n    \"order\": {\n        \"id\": 217055,\n        \"external_order_identifier\": \"ABC-1633\",\n        \"ext_order_reference_id\": \"ABC-1633\",\n        \"owner_id\": null,\n        \"ordered_at\": \"2016-02-11T20:37:56Z\",\n        \"order_status\": \"ready_for_shipment\",\n        \"parent_order_id\": null,\n        \"source_order_ids\": null,\n        \"total_including_tax\": \"10.00\",\n        \"total_excluding_tax\": \"10.00\",\n        \"discount_amount\": \"0.00\",\n        \"coupon_discount\": \"0.00\",\n        \"subtotal_including_tax\": \"10.00\",\n        \"subtotal_excluding_tax\": \"0.00\",\n        \"subtotal_tax\": \"0.00\",\n        \"total_tax\": \"0.00\",\n        \"base_shipping_cost\": \"0.00\",\n        \"shipping_cost_including_tax\": \"0.00\",\n        \"shipping_cost_excluding_tax\": \"0.00\",\n        \"shipping_cost_tax\": \"0.00\",\n        \"base_handling_cost\": \"0.00\",\n        \"handling_cost_excluding_tax\": \"0.00\",\n        \"handling_cost_including_tax\": \"0.00\",\n        \"handling_cost_tax\": \"0.00\",\n        \"base_wrapping_cost\": \"0.00\",\n        \"wrapping_cost_excluding_tax\": \"0.00\",\n        \"wrapping_cost_including_tax\": \"0.00\",\n        \"wrapping_cost_tax\": \"0.00\",\n        \"billing_company\": \"Compnay Billing name test 1\",\n        \"billing_first_name\": \"Jack\",\n        \"billing_last_name\": \"Rico\",\n        \"billing_address\": \"1560 Ave Comerio\",\n        \"billing_address2\": \"\",\n        \"billing_city\": \"Bayamon\",\n        \"billing_state\": \"\",\n        \"billing_country\": \"PR\",\n        \"billing_postal_code\": \"00961\",\n        \"billing_phone_number\": \"3235735009\",\n        \"billing_email\": \"jack:::at:::shippingeasy.com\",\n        \"recipients\": [\n            {\n                \"company\": \"\",\n                \"first_name\": \"Jack\",\n                \"last_name\": \"Shipping\",\n                \"address\": \"1560 Ave Comerio\",\n                \"address2\": \"\",\n                \"address3\": null,\n                \"city\": \"Bayamon\",\n                \"residential\": false,\n                \"state\": null,\n                \"province\": null,\n                \"country\": \"United States\",\n                \"postal_code\": \"00961\",\n                \"postal_code_plus_4\": \"3962\",\n                \"phone_number\": \"3235735009\",\n                \"email\": \"jack@shippingeasy.com\",\n                \"base_cost\": \"10.00\",\n                \"cost_excluding_tax\": \"10.00\",\n                \"cost_including_tax\": \"0.00\",\n                \"cost_tax\": \"0.00\",\n                \"base_handling_cost\": \"0.00\",\n                \"handling_cost_excluding_tax\": \"0.00\",\n                \"handling_cost_including_tax\": \"0.00\",\n                \"handling_cost_tax\": \"0.00\",\n                \"shipping_zone_id\": 123,\n                \"shipping_zone_name\": \"XYZ\",\n                \"items_total\": 1,\n                \"shipping_method\": \"Ground\",\n                \"items_shipped\": 0,\n                \"ext_shipping_detail_id\": null,\n                \"line_items\": [\n                    {\n                        \"item_name\": \"Innokin MVP 3 PRO KIT\",\n                        \"sku\": \"I_MVP_4\",\n                        \"bin_picking_number\": null,\n                        \"bundled_product\": null,\n                        \"weight_in_ounces\": \"1.0\",\n                        \"quantity\": 1,\n                        \"total_excluding_tax\": \"10.00\",\n                        \"price_excluding_tax\": \"0.00\",\n                        \"unit_price\": \"10.00\",\n                        \"ext_line_item_id\": null,\n                        \"ext_product_id\": null,\n                        \"product_options\": null,\n                        \"uuid\": \"32b600b3-0381-43b2-9527-04ab2d2291b5\",\n                        \"order_source_id\": 87168,\n                        \"gift_message\": null\n                    }\n                ],\n                \"original_order\": {\n                    \"id\": 217055,\n                    \"customer_id\": 371,\n                    \"store_id\": 1672,\n                    \"order_detail_id\": 217095,\n                    \"workflow_state\": \"ready_for_shipment\",\n                    \"shipment_id\": null,\n                    \"destination_id\": null,\n                    \"split_from_order_id\": null,\n                    \"total_weight_in_ounces\": \"1.0\",\n                    \"total_quantity\": 1,\n                    \"is_international\": false,\n                    \"usps_shipping_zone\": 8,\n                    \"created_at\": \"2016-02-12T17:14:40Z\",\n                    \"updated_at\": \"2016-05-20T13:45:25Z\",\n                    \"ext_shipment_confirmation_id\": null,\n                    \"store_order_status\": \"awaiting_payment\",\n                    \"drop_ship_tracking_number\": null,\n                    \"category_id\": null,\n                    \"internal_notes\": \"\",\n                    \"line_item_name\": \"innokin mvp 3 pro kit\",\n                    \"line_item_sku\": \"i_mvp_4\",\n                    \"address_kind\": \"C\",\n                    \"recipient_last_name\": \"shipping\",\n                    \"recipient_requested_service\": \"ground\",\n                    \"gift\": false,\n                    \"prime_order_id\": 217055,\n                    \"state\": null,\n                    \"owner_id\": null,\n                    \"denormalized_ordered_at\": \"2016-02-11T20:37:56Z\",\n                    \"grab_bag\": {},\n                    \"line_item_bin_picking_number\": null,\n                    \"denormalized_ext_order_id\": \"ABC-1633\",\n                    \"packing_slip_generated\": null,\n                    \"denormalized_ext_order_reference_id\": \"ABC-1633\",\n                    \"denormalized_alternate_order_id\": null,\n                    \"denormalized_sales_channel\": null\n                }\n            }\n        ],\n        \"store_api_key\": \"c29928ea5f96c34c05241682d23a9f37\",\n        \"shipments\": [],\n        \"updated_at\": \"2016-05-20T13:45:25Z\",\n        \"internal_notes\": \"\",\n        \"meta_data\": null,\n        \"prime_order_id\": 217055,\n        \"is_prime\": null,\n        \"split_from_order_id\": null\n    }\n}"}]},"settings":"","auth":"required","params":[{"_id":"561e61faefcf8217003adfcb","ref":"","in":"path","required":false,"desc":"Found in the user interface of ShippingEasy, as described on the [API Credentials](doc:api-credentials) page.","default":"","type":"string","name":"store_api_key"},{"_id":"561e61faefcf8217003adfca","ref":"","in":"path","required":false,"desc":"The same value you used when creating the order. It is typically the ID used in your e-commerce system.","default":"","type":"string","name":"external_order_identifier"}],"url":"/api/stores/:store_api_key/orders/:external_order_identifier/status"},"isReference":false,"order":7,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Parameter values\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**Field**\",\n    \"0-1\": \"**Description**\",\n    \"1-0\": \"order_status\",\n    \"1-1\": \"Store order status for the order. Must be one of:\\n\\nawaiting_payment\\n\\nawaiting_fulfillment\\n\\nawaiting_shipment\\n\\npartially_shipped\"\n  },\n  \"cols\": 2,\n  \"rows\": 2\n}\n[/block]\nNote that the value that is being changed is the store_order_status in the original_order node. This value is displayed in the Status column on the Orders page in the ShippingEasy user interface.  The Orders page in ShippingEasy has a filter setting for Status.","excerpt":"Update the status of an order","slug":"storesstore_api_keyordersexternal_order_identifier","type":"endpoint","title":"/stores/:store_api_key/orders/:external_order_identifier/status"}

put/stores/:store_api_key/orders/:external_order_identifier/status

Update the status of an order

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

store_api_key:
string
Found in the user interface of ShippingEasy, as described on the [API Credentials](doc:api-credentials) page.
external_order_identifier:
string
The same value you used when creating the order. It is typically the ID used in your e-commerce system.

Examples


Result Format


Documentation

[block:api-header] { "type": "basic", "title": "Parameter values" } [/block] [block:parameters] { "data": { "0-0": "**Field**", "0-1": "**Description**", "1-0": "order_status", "1-1": "Store order status for the order. Must be one of:\n\nawaiting_payment\n\nawaiting_fulfillment\n\nawaiting_shipment\n\npartially_shipped" }, "cols": 2, "rows": 2 } [/block] Note that the value that is being changed is the store_order_status in the original_order node. This value is displayed in the Status column on the Orders page in the ShippingEasy user interface. The Orders page in ShippingEasy has a filter setting for Status.