{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/sales-orders/split-ship-order","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/sales-orders/split-ship-order","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/sales-orders/split-ship-order","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Split Ship a Sales Order","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"split-ship-a-sales-order","__idx":0},"children":["Split Ship a Sales Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide demonstrates how to split ship a sales order by creating multiple shipments from a single order with multiple items."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"process-overview","__idx":1},"children":["Process Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The split shipping process involves:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retrieve the Sales Order"]}," with multiple items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create separate shipments"]}," for each item"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Generate labels"]}," for the individual shipments"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-examples","__idx":2},"children":["API Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-use-a-sales-order-with-multiple-sales-order-items","__idx":3},"children":["1. Use a Sales Order with Multiple Sales Order Items"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v-beta/sales_orders/0d3c142a-7516-5f5b-8a40-b437b5e01317 HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-create-a-shipment-for-the-first-item","__idx":4},"children":["2. Create a Shipment for the First Item"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v-beta/shipments HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipments\": [{\n    \"validate_address\": \"validate_and_clean\",\n    \"carrier_id\": \"se-123890\",\n    \"service_code\": \"usps_priority_mail\",\n    \"warehouse_id\": \"se-241419\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"packages\": [{\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 1.0,\n        \"unit\": \"ounce\"\n      }\n    }],\n    \"items\": [{\n      \"sales_order_id\": \"0d3c142a-7516-5f5b-8a40-b437b5e01317\",\n      \"sales_order_item_id\": \"0399c595-774a-599b-a566-27ea86fec17d\",\n      \"quantity\": 1\n    }]\n  }]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-create-a-shipment-for-the-second-item","__idx":5},"children":["3. Create a Shipment for the Second Item"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request structure is similar, but references a different ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_item_id"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipments\": [{\n    \"validate_address\": \"validate_and_clean\",\n    \"carrier_id\": \"se-123890\",\n    \"service_code\": \"usps_priority_mail\",\n    \"warehouse_id\": \"se-241419\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"packages\": [{\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 1.0,\n        \"unit\": \"ounce\"\n      }\n    }],\n    \"items\": [{\n      \"sales_order_id\": \"0d3c142a-7516-5f5b-8a40-b437b5e01317\",\n      \"sales_order_item_id\": \"4afd6df4-d679-51d7-a858-8aff7d6103c2\",\n      \"quantity\": 1\n    }]\n  }]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-create-labels-for-the-shipments","__idx":6},"children":["4. Create Labels for the Shipments"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v-beta/labels/shipment/se-201053690 HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_format\": \"pdf\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-features","__idx":7},"children":["Key Features"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Split orders across multiple shipments"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each shipment references specific order items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Address validation included"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support for various carriers and services"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Multiple label formats available"]}]}]},"headings":[{"value":"Split Ship a Sales Order","id":"split-ship-a-sales-order","depth":1},{"value":"Process Overview","id":"process-overview","depth":2},{"value":"API Examples","id":"api-examples","depth":2},{"value":"1. Use a Sales Order with Multiple Sales Order Items","id":"1-use-a-sales-order-with-multiple-sales-order-items","depth":3},{"value":"2. Create a Shipment for the First Item","id":"2-create-a-shipment-for-the-first-item","depth":3},{"value":"3. Create a Shipment for the Second Item","id":"3-create-a-shipment-for-the-second-item","depth":3},{"value":"4. Create Labels for the Shipments","id":"4-create-labels-for-the-shipments","depth":3},{"value":"Key Features","id":"key-features","depth":2}],"frontmatter":{"seo":{"title":"Split Ship a Sales Order"}},"lastModified":"2026-07-29T23:05:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/sales-orders/split-ship-order","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}