{"_id":"54cc2149380ecd0d00ca18c6","editedParams":true,"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"},"project":"5436a1e1d0ffee0e00f18f8c","editedParams2":true,"parentDoc":null,"user":"5436a1afb7cf0e1c0020d9ca","__v":3,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2014-10-09T16:15:15.216Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"","language":"text"}]},"method":"post","results":{"codes":[]},"settings":"","auth":"required","params":[{"_id":"561e61a73e744b2100d21183","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"}],"url":"/api/stores/:store_api_key/orders"},"isReference":false,"order":5,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Request Body\"\n}\n[/block]\nThe body of the request must contain the JSON for a single order.\n\n## Order Attributes\n\nThe following is a list of attributes.\n\n**external_order_identifier**\n: *Required.* The e-commerce system's order ID.\n\n**ordered_at**\n: *Required.* Timestamp when the order was created.\n\n**order_status**\n: Possible values are \"awaiting_shipment\", \"awaiting_payment\", \"awaiting_fulfillment\", \"awaiting_shipment\", \"partially_shipped\". Default is \"awaiting_shipment\".\n\n**alternate_order_id**\n: Additional identifier for the e-commerce order.\n\n**total_including_tax**\n: Defaults to 0.0 if not specified.\n\n**total_excluding_tax**\n: Defaults to 0.0 if not specified.\n\n**discount_amount**\n: Defaults to 0.0 if not specified.\n\n**coupon_discount**\n: Defaults to 0.0 if not specified.\n\n**subtotal_including_tax**\n: Defaults to 0.0 if not specified.\n\n**subtotal_excluding_tax**\n: Defaults to 0.0 if not specified.\n\n**subtotal_tax**\n: Defaults to 0.0 if not specified.\n\n**total_tax**\n: Defaults to 0.0 if not specified.\n\n**base_shipping_cost**\n: Defaults to 0.0 if not specified.\n\n**shipping_cost_including_tax**\n: Defaults to 0.0 if not specified.\n\n**shipping_cost_excluding_tax**\n: Defaults to 0.0 if not specified.\n\n**shipping_cost_tax**\n: Defaults to 0.0 if not specified.\n\n**base_handling_cost**\n: Defaults to 0.0 if not specified.\n\n**handling_cost_excluding_tax**\n: Defaults to 0.0 if not specified.\n\n**handling_cost_including_tax**\n: Defaults to 0.0 if not specified.\n\n**handling_cost_tax**\n: Defaults to 0.0 if not specified.\n\n**base_wrapping_cost**\n: Defaults to 0.0 if not specified.\n\n**wrapping_cost_excluding_tax**\n: Defaults to 0.0 if not specified.\n\n**wrapping_cost_including_tax**\n: Defaults to 0.0 if not specified.\n\n**wrapping_cost_tax**\n: Defaults to 0.0 if not specified.\n\n**notes**\n: Customer notes on the order.\n\n**billing_company**\n: Company name for billing address\n\n**billing_first_name**\n: Customer first name for billing address\n\n**billing_last_name**\n: Customer last name for billing address\n\n**billing_address**\n: First address line for billing address\n\n**billing_address2**\n: Additional address line for billing address\n\n**billing_city**\n: City name for billing address\n\n**billing_state**\n: State name for billing address\n\n**billing_country**\n: Country name for billing address\n\n**billing_postal_code**\n: Postal code for billing address\n\n**billing_phone_number**\n: Phone number.\n\n**billing_email**\n: Email address\n\n**sales_channel**\n:Sales channel that provided the order, if any\n\n**custom_1**\n:Customer-defined value\n\n**custom_2**\n:Customer-defined value\n\n**custom_3**\n:Customer-defined value\n\n**tags**\n:An array of up to 10 tags for the order\n\n**recipients**\n: A nested associative array of recipient attributes. At least one recipient is required.\n\n**recipients > company**\n: Company name for shipping address\n\n**recipients > first_name**\n: Customer first name for shipping address\n\n**recipients > last_name**\n: Customer last name for shipping address\n\n**recipients > address**\n: *Required.* First address line for shipping address\n\n**recipients > address2**\n: Additional address line for shipping address\n\n**recipients > city**\n: City name for shipping address\n\n**recipients > state**\n: State name for shipping address\n\n**recipients > country**\n: Country name for shipping address\n\n**recipients > residential**\n: Whether or not address is residential or not. Value can be \"true\" or \"false\".\n\n**recipients > postal_code**\n: *Required.* Postal code for shipping address\n\n**recipients > postal_code_plus_4**\n: Postal code plus 4 for shipping address\n\n**recipients > phone_number**\n: Customer phone number\n\n**recipients > email**\n: Customer email address\n\n**recipients > base_cost**\n: Cost before tax for all line items sent to this recipient\n\n**recipients > cost_excluding_tax**\n: Cost before tax for all line items sent to this recipient\n\n**recipients > cost_including_tax**\n: Cost including tax for all line items sent to this recipient\n\n**recipients > cost_tax**\n: Cost of the tax for all line items sent to this recipient\n\n**recipients > base_handling_cost**\n: Handling cost before tax for all line items sent to this recipient\n\n**recipients > handling_cost_excluding_tax**\n: Handling cost before tax for all line items sent to this recipient\n\n**recipients > handling_cost_including_tax**\n: Handling cost including tax for all line items sent to this recipient\n\n**recipients > handling_cost_tax**\n: Handling cost of the tax for all line items sent to this recipient\n\n**recipients > shipping_zone_id**\n: ID of the shipping zone.\n\n**recipients > shipping_zone_name**\n: Name of the shipping zone.\n\n**recipients > shipping_method**\n: Method of shipment.\n\n**recipients > items_total**\n: Total number of items.\n\n**recipients > items_shipped**\n: Total number of items shipped.\n\n**recipients > line_items**\n: A nested associative array of line item attributes. At least one line item is required.\n\n**recipients > line_items > item_name**\n: Name of the item/product.\n\n**recipients > line_items > sku**\n: SKU of the item/product.\n\n**recipients > line_items > bin_picking_number**\n: Bin number where the item may be stored in a warehouse.\n\n**recipients > line_items > weight_in_ounces**\n: Weight of the item in ounces. This is the single unit weight - ShippingEasy multiplies weight_in_ounces by quantity to calculate shipping weight.\n\n**recipients > line_items > quantity**\n: Quantity of the items for the line item.\n\n**recipients > line_items > total_excluding_tax**\n: Total amount excluding tax for the item. This is the single unit amount - ShippingEasy multiplies total_excluding_tax by quantity to display a line item total on packing slips.\n\n**recipients > line_items > unit_price**\n: Unit price of the item. Should be set to the same value as total_excluding_tax.\n\n**recipients > line_items > price_excluding_tax**\n: Unit price of the item. Should be set to the same value as total_excluding_tax. Used for displaying order search results.\n\n**recipients > line_items > product_options**\n: Hash of product variations applicable to this line item. E.g. {\"color\":\"red\", \"size\":\"XXL\"}\n\n**recipients > line_items > ext_line_item_id**\n: Unique identifier used in the store for this line item in the order\n\n## Example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{ \\\"order\\\": \\n   {\\n      \\\"external_order_identifier\\\":\\\"ABC-100\\\",\\n      \\\"ordered_at\\\":\\\"2014-01-16 14:37:56 -0600\\\",\\n      \\\"order_status\\\":\\\"awaiting_shipment\\\",\\n      \\\"subtotal_including_tax\\\":\\\"10.00\\\",\\n      \\\"total_including_tax\\\":\\\"10.00\\\",\\n      \\\"total_excluding_tax\\\":\\\"10.00\\\",\\n      \\\"discount_amount\\\":\\\"0.00\\\",\\n      \\\"coupon_discount\\\":\\\"1.00\\\",\\n      \\\"subtotal_including_tax\\\":\\\"0.00\\\",\\n      \\\"subtotal_excluding_tax\\\":\\\"0.00\\\",\\n      \\\"subtotal_excluding_tax\\\":\\\"0.00\\\",\\n      \\\"subtotal_tax\\\":\\\"0.00\\\",\\n      \\\"total_tax\\\":\\\"0\\\",\\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      \\\"notes\\\":\\\"Please send promptly.\\\",\\n      \\\"billing_company\\\":\\\"Acme Inc.\\\",\\n      \\\"billing_first_name\\\":\\\"Fred\\\",\\n      \\\"billing_last_name\\\":\\\"Jones\\\",\\n      \\\"billing_address\\\":\\\"1234 Street\\\",\\n      \\\"billing_address2\\\":\\\"Suite 100\\\",\\n      \\\"billing_city\\\":\\\"Austin\\\",\\n      \\\"billing_state\\\":\\\"TX\\\",\\n      \\\"billing_postal_code\\\":\\\"78701\\\",\\n      \\\"billing_country\\\":\\\"USA\\\",\\n      \\\"billing_phone_number\\\":\\\"512-123-1234\\\",\\n      \\\"billing_email\\\":\\\"test:::at:::test.com\\\",\\n      \\\"recipients\\\":[{\\n         \\\"first_name\\\":\\\"Colin\\\",\\n         \\\"last_name\\\":\\\"Homenick\\\",\\n         \\\"company\\\":\\\"Wintheiser-Hickle\\\",\\n         \\\"email\\\":\\\"charles.crona@okeefe.org\\\",\\n         \\\"phone_number\\\":\\\"637-481-6505\\\",\\n         \\\"residential\\\":\\\"true\\\",\\n         \\\"address\\\":\\\"21937 Adelbert Springs\\\",\\n         \\\"address2\\\":\\\"\\\",\\n         \\\"province\\\":\\\"\\\",\\n         \\\"state\\\":\\\"CT\\\",\\n         \\\"city\\\":\\\"Terryfurt\\\",\\n         \\\"postal_code\\\":\\\"93322\\\",\\n         \\\"postal_code_plus_4\\\":\\\"1234\\\",\\n         \\\"country\\\":\\\"Andorra\\\",\\n         \\\"shipping_method\\\":\\\"Ground\\\",\\n         \\\"base_cost\\\":\\\"10.00\\\",\\n         \\\"cost_excluding_tax\\\":\\\"10.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         \\\"items_shipped\\\":\\\"0\\\",\\n         \\\"line_items\\\":[{\\n            \\\"item_name\\\":\\\"Pencil Holder\\\",\\n            \\\"sku\\\":\\\"9876543\\\",\\n            \\\"bin_picking_number\\\":\\\"7\\\",\\n            \\\"unit_price\\\":\\\"1.30\\\",\\n            \\\"total_excluding_tax\\\":\\\"1.30\\\",\\n            \\\"weight_in_ounces\\\":\\\"10\\\",\\n            \\\"product_options\\\":{\\n               \\\"pa_size\\\":\\\"large\\\",\\n               \\\"Colour\\\":\\\"Blue\\\"\\n            },\\n            \\\"quantity\\\":\\\"1\\\"\\n         }]\\n      }]\\n   }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"apiorders","type":"endpoint","title":"/stores/:store_api_key/orders"}

post/stores/:store_api_key/orders


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.

Documentation

[block:api-header] { "type": "basic", "title": "Request Body" } [/block] The body of the request must contain the JSON for a single order. ## Order Attributes The following is a list of attributes. **external_order_identifier** : *Required.* The e-commerce system's order ID. **ordered_at** : *Required.* Timestamp when the order was created. **order_status** : Possible values are "awaiting_shipment", "awaiting_payment", "awaiting_fulfillment", "awaiting_shipment", "partially_shipped". Default is "awaiting_shipment". **alternate_order_id** : Additional identifier for the e-commerce order. **total_including_tax** : Defaults to 0.0 if not specified. **total_excluding_tax** : Defaults to 0.0 if not specified. **discount_amount** : Defaults to 0.0 if not specified. **coupon_discount** : Defaults to 0.0 if not specified. **subtotal_including_tax** : Defaults to 0.0 if not specified. **subtotal_excluding_tax** : Defaults to 0.0 if not specified. **subtotal_tax** : Defaults to 0.0 if not specified. **total_tax** : Defaults to 0.0 if not specified. **base_shipping_cost** : Defaults to 0.0 if not specified. **shipping_cost_including_tax** : Defaults to 0.0 if not specified. **shipping_cost_excluding_tax** : Defaults to 0.0 if not specified. **shipping_cost_tax** : Defaults to 0.0 if not specified. **base_handling_cost** : Defaults to 0.0 if not specified. **handling_cost_excluding_tax** : Defaults to 0.0 if not specified. **handling_cost_including_tax** : Defaults to 0.0 if not specified. **handling_cost_tax** : Defaults to 0.0 if not specified. **base_wrapping_cost** : Defaults to 0.0 if not specified. **wrapping_cost_excluding_tax** : Defaults to 0.0 if not specified. **wrapping_cost_including_tax** : Defaults to 0.0 if not specified. **wrapping_cost_tax** : Defaults to 0.0 if not specified. **notes** : Customer notes on the order. **billing_company** : Company name for billing address **billing_first_name** : Customer first name for billing address **billing_last_name** : Customer last name for billing address **billing_address** : First address line for billing address **billing_address2** : Additional address line for billing address **billing_city** : City name for billing address **billing_state** : State name for billing address **billing_country** : Country name for billing address **billing_postal_code** : Postal code for billing address **billing_phone_number** : Phone number. **billing_email** : Email address **sales_channel** :Sales channel that provided the order, if any **custom_1** :Customer-defined value **custom_2** :Customer-defined value **custom_3** :Customer-defined value **tags** :An array of up to 10 tags for the order **recipients** : A nested associative array of recipient attributes. At least one recipient is required. **recipients > company** : Company name for shipping address **recipients > first_name** : Customer first name for shipping address **recipients > last_name** : Customer last name for shipping address **recipients > address** : *Required.* First address line for shipping address **recipients > address2** : Additional address line for shipping address **recipients > city** : City name for shipping address **recipients > state** : State name for shipping address **recipients > country** : Country name for shipping address **recipients > residential** : Whether or not address is residential or not. Value can be "true" or "false". **recipients > postal_code** : *Required.* Postal code for shipping address **recipients > postal_code_plus_4** : Postal code plus 4 for shipping address **recipients > phone_number** : Customer phone number **recipients > email** : Customer email address **recipients > base_cost** : Cost before tax for all line items sent to this recipient **recipients > cost_excluding_tax** : Cost before tax for all line items sent to this recipient **recipients > cost_including_tax** : Cost including tax for all line items sent to this recipient **recipients > cost_tax** : Cost of the tax for all line items sent to this recipient **recipients > base_handling_cost** : Handling cost before tax for all line items sent to this recipient **recipients > handling_cost_excluding_tax** : Handling cost before tax for all line items sent to this recipient **recipients > handling_cost_including_tax** : Handling cost including tax for all line items sent to this recipient **recipients > handling_cost_tax** : Handling cost of the tax for all line items sent to this recipient **recipients > shipping_zone_id** : ID of the shipping zone. **recipients > shipping_zone_name** : Name of the shipping zone. **recipients > shipping_method** : Method of shipment. **recipients > items_total** : Total number of items. **recipients > items_shipped** : Total number of items shipped. **recipients > line_items** : A nested associative array of line item attributes. At least one line item is required. **recipients > line_items > item_name** : Name of the item/product. **recipients > line_items > sku** : SKU of the item/product. **recipients > line_items > bin_picking_number** : Bin number where the item may be stored in a warehouse. **recipients > line_items > weight_in_ounces** : Weight of the item in ounces. This is the single unit weight - ShippingEasy multiplies weight_in_ounces by quantity to calculate shipping weight. **recipients > line_items > quantity** : Quantity of the items for the line item. **recipients > line_items > total_excluding_tax** : Total amount excluding tax for the item. This is the single unit amount - ShippingEasy multiplies total_excluding_tax by quantity to display a line item total on packing slips. **recipients > line_items > unit_price** : Unit price of the item. Should be set to the same value as total_excluding_tax. **recipients > line_items > price_excluding_tax** : Unit price of the item. Should be set to the same value as total_excluding_tax. Used for displaying order search results. **recipients > line_items > product_options** : Hash of product variations applicable to this line item. E.g. {"color":"red", "size":"XXL"} **recipients > line_items > ext_line_item_id** : Unique identifier used in the store for this line item in the order ## Example [block:code] { "codes": [ { "code": "{ \"order\": \n {\n \"external_order_identifier\":\"ABC-100\",\n \"ordered_at\":\"2014-01-16 14:37:56 -0600\",\n \"order_status\":\"awaiting_shipment\",\n \"subtotal_including_tax\":\"10.00\",\n \"total_including_tax\":\"10.00\",\n \"total_excluding_tax\":\"10.00\",\n \"discount_amount\":\"0.00\",\n \"coupon_discount\":\"1.00\",\n \"subtotal_including_tax\":\"0.00\",\n \"subtotal_excluding_tax\":\"0.00\",\n \"subtotal_excluding_tax\":\"0.00\",\n \"subtotal_tax\":\"0.00\",\n \"total_tax\":\"0\",\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 \"notes\":\"Please send promptly.\",\n \"billing_company\":\"Acme Inc.\",\n \"billing_first_name\":\"Fred\",\n \"billing_last_name\":\"Jones\",\n \"billing_address\":\"1234 Street\",\n \"billing_address2\":\"Suite 100\",\n \"billing_city\":\"Austin\",\n \"billing_state\":\"TX\",\n \"billing_postal_code\":\"78701\",\n \"billing_country\":\"USA\",\n \"billing_phone_number\":\"512-123-1234\",\n \"billing_email\":\"test@test.com\",\n \"recipients\":[{\n \"first_name\":\"Colin\",\n \"last_name\":\"Homenick\",\n \"company\":\"Wintheiser-Hickle\",\n \"email\":\"charles.crona@okeefe.org\",\n \"phone_number\":\"637-481-6505\",\n \"residential\":\"true\",\n \"address\":\"21937 Adelbert Springs\",\n \"address2\":\"\",\n \"province\":\"\",\n \"state\":\"CT\",\n \"city\":\"Terryfurt\",\n \"postal_code\":\"93322\",\n \"postal_code_plus_4\":\"1234\",\n \"country\":\"Andorra\",\n \"shipping_method\":\"Ground\",\n \"base_cost\":\"10.00\",\n \"cost_excluding_tax\":\"10.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 \"items_shipped\":\"0\",\n \"line_items\":[{\n \"item_name\":\"Pencil Holder\",\n \"sku\":\"9876543\",\n \"bin_picking_number\":\"7\",\n \"unit_price\":\"1.30\",\n \"total_excluding_tax\":\"1.30\",\n \"weight_in_ounces\":\"10\",\n \"product_options\":{\n \"pa_size\":\"large\",\n \"Colour\":\"Blue\"\n },\n \"quantity\":\"1\"\n }]\n }]\n }\n}", "language": "json" } ] } [/block]