{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/shipments-split-merge","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/shipping/shipments-split-merge","default":true,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/shipments-split-merge","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml","oas-apis/@shipstation-v2/openapi.yaml":"oas-apis/@shipstation-v2/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","openapi-code-sample"]},"type":"markdown"},"seo":{"title":"Split and Merge Shipments","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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"split-and-merge-shipments","__idx":0},"children":["Split and Merge Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A shipment doesn't always match how you'll ship its items. Some items may be on backorder, some may ship from"," ","another warehouse, or several orders for the same customer may need to go out in one box. The split and merge"," ","endpoints let you change which shipment holds which items before you buy a label."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Split"]}," moves items from one shipment into one or more new shipments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merge"]}," moves all of the items from one or more shipments onto another shipment and deletes the shipments"," ","they came from."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both operations keep each shipment linked to its sales orders, so order sources keep getting shipment"," ","notifications for every item."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before You Start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Split and merge only work on shipments that haven't shipped yet and that came from a sales order. Every"," ","shipment in the request must:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Have a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_status"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_payment"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on_hold"]},". You can't split or merge shipments"," ","that have shipped or been cancelled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Be linked to at least one sales order. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_ids"]}," array on the shipment lists its sales orders. If"," ","the array is empty, you can't split or merge the shipment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Not come from a marketplace that supplies its own shipping labels."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check these values, get the shipment with"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/get_shipment_by_id"},"children":["Get shipment by id"]},". The response also has the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]}," array, which you'll need when you split."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sales-order-fields-on-shipments","__idx":2},"children":["Sales Order Fields on Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Shipment responses include these fields that show how a shipment is linked to its sales orders:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The sales orders the shipment is linked to. This array is always present and is empty if the shipment isn't linked to a sales order. It's read-only and is ignored in requests."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].sales_order_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The sales order that the item belongs to, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if the item isn't linked to one."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].sales_order_item_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The sales order line item that the item belongs to, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if the item isn't linked to one."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These fields are returned by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/get_shipment_by_id"},"children":["Get shipment by id"]},","," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/get_shipment_by_external_id"},"children":["Get shipment by external ID"]},","," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/list_shipments"},"children":["List shipments"]},","," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/create_shipments"},"children":["Create shipments"]},", and"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/update_shipment"},"children":["Update shipment"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"split-a-shipment","__idx":3},"children":["Split a Shipment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To split a shipment, send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/shipments/{shipment_id}/split"]},". Each entry in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipments"]}," array creates"," ","one new shipment, and lists the items and quantities to move into it. Anything you don't list stays on the"," ","original shipment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requirements","__idx":4},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_id"]}," of each item you want to move. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].item_id"]}," values from the original shipment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quantity"]}," of each item to move. This must be at least 1."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rules","__idx":5},"children":["Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every item you move must belong to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["same sales order"]},". Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].sales_order_id"]}," to check. To move"," ","items from more than one sales order, send one split request for each sales order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one item must ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["stay on the original shipment"]},". To move everything, leave at least one unit behind,"," ","or move the items to a shipment that already exists by using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#merge-shipments"},"children":["merge"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An item can be listed only ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["once"]}," in each new shipment. You can list the same item in more than one new"," ","shipment, but the total quantity you move can't be more than the quantity on the original shipment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can create up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["100"]}," new shipments in one request, and each new shipment can list up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["200"]}," items."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":6},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The original shipment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902255"]}," has two items:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipment_id\": \"se-202902255\",\n  \"sales_order_ids\": [\"8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c\"],\n  \"items\": [\n    {\n      \"item_id\": \"1402291169813\",\n      \"sku\": \"MUG-BLUE\",\n      \"quantity\": 3,\n      \"sales_order_id\": \"8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c\"\n    },\n    {\n      \"item_id\": \"1402291169814\",\n      \"sku\": \"TEE-L\",\n      \"quantity\": 1,\n      \"sales_order_id\": \"8c1f2a5e-3b7d-4e9a-a6c2-1d4f5e6a7b8c\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To ship one of the mugs separately, move one unit of item ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1402291169813"]}," into a new shipment:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v2/shipments/se-202902255/split"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/shipments/se-202902255/split HTTP/1.1\nHost: api.shipstation.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipments\": [\n    {\n      \"items\": [\n        { \"item_id\": \"1402291169813\", \"quantity\": 1 }\n      ]\n    }\n  ]\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipment_id\": \"se-202902255\",\n  \"new_shipment_ids\": [\"se-202902301\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["new_shipment_ids"]}," lists the new shipments in the same order as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipments"]}," array in the request. After the"," ","split:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902255"]}," has 2 units of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MUG-BLUE"]}," and 1 unit of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TEE-L"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902301"]}," has 1 unit of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MUG-BLUE"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-happens-to-the-new-shipments","__idx":7},"children":["What Happens to the New Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each new shipment:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Is created from the original shipment, so it starts with the same details, such as addresses, tags, tax"," ","identifiers, notes, and assigned user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Is linked to the same sales order as the items it holds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Gets a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]},". Get it with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#operation/get_shipment_by_id"},"children":["Get shipment by id"]}," ","to see its items and other details."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The package weight and customs information are recalculated for the original shipment and for each new"," ","shipment. Rates you got before the split may no longer be accurate, so get new rates before you buy labels."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Sales orders after a split"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you move all of a sales order's items off a shipment, the original shipment can still list that sales order in"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_ids"]},". To see which sales order each item belongs to, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].sales_order_id"]},"."]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v2/openapi.yaml","operationId":"split_shipment","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merge-shipments","__idx":8},"children":["Merge Shipments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To merge shipments, send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/shipments/{shipment_id}/merge"]},". The shipment in the URL is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["target"]},". The"," ","items from every shipment in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," move onto the target, and the shipments in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," are then"," ","deleted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"requirements-1","__idx":9},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_id"]}," of the target shipment, in the URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," array with the shipments to merge into it, up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["100"]}," per request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rules-1","__idx":10},"children":["Rules"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," must include at least one shipment other than the target. If the array includes the target"," ","shipment or lists a shipment more than once, the extra entries are ignored."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The shipments can belong to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["different sales orders"]},". The target becomes linked to the sales orders of every"," ","shipment merged into it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Every shipment, including the target, must meet the requirements in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#before-you-start"},"children":["Before You Start"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-1","__idx":11},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merge shipments ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902301"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902302"]}," into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["se-202902255"]},":"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /v2/shipments/se-202902255/merge"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/shipments/se-202902255/merge HTTP/1.1\nHost: api.shipstation.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment_ids\": [\"se-202902301\", \"se-202902302\"]\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"shipment_id\": \"se-202902255\",\n  \"merged_shipment_ids\": [\"se-202902301\", \"se-202902302\"]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-happens-after-a-merge","__idx":12},"children":["What Happens After a Merge"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The target shipment holds all of the items from the merged shipments, along with its own."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The tags from the merged shipments are added to the target shipment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The target's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_ids"]}," includes the sales orders of the merged shipments."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The package weight and customs information on the target shipment are recalculated. Get new rates before you"," ","buy a label."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The shipments listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merged_shipment_ids"]}," are deleted. Remove any references to them in your system."]}]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v2/openapi.yaml","operationId":"merge_shipments","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":13},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a request can't be completed, the response has an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["errors"]}," array. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}," tells you why:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"error_code"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HTTP status"},"children":["HTTP status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means"},"children":["What it means"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_field_value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A value in the request can't be used. For example, a quantity is larger than the quantity on the shipment, an item is listed twice in the same new shipment, no items would stay on the original shipment, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shipment_ids"]}," has no shipment other than the target."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 or 404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A split ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_id"]}," isn't on the shipment (400), or a shipment wasn't found on your account (404)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A shipment has shipped, has been cancelled, or has another status that can't be split or merged."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sales_order_link_required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A shipment isn't linked to a sales order."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multiple_sales_orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The items in a split belong to more than one sales order. Split them in separate requests."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bring_your_own_label_not_supported"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A shipment comes from a marketplace that supplies its own shipping labels."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unspecified"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400 or 500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The request was rejected for another reason. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," explains why."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," field describes the problem. When the problem is with a specific value, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_name"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["field_value"]}," identify it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":14},"children":["Related Guides"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/orders/understanding-orders-shipments"},"children":["Understanding Orders & Shipments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/list-shipments"},"children":["List Shipments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/shipments/update"},"children":["Update Shipments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tag-shipments"},"children":["Tag Shipments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/create-labels"},"children":["Create Labels"]}]}]}]},"headings":[{"value":"Split and Merge Shipments","id":"split-and-merge-shipments","depth":1},{"value":"Before You Start","id":"before-you-start","depth":2},{"value":"Sales Order Fields on Shipments","id":"sales-order-fields-on-shipments","depth":3},{"value":"Split a Shipment","id":"split-a-shipment","depth":2},{"value":"Requirements","id":"requirements","depth":3},{"value":"Rules","id":"rules","depth":3},{"value":"Example","id":"example","depth":3},{"value":"What Happens to the New Shipments","id":"what-happens-to-the-new-shipments","depth":3},{"value":"Merge Shipments","id":"merge-shipments","depth":2},{"value":"Requirements","id":"requirements-1","depth":3},{"value":"Rules","id":"rules-1","depth":3},{"value":"Example","id":"example-1","depth":3},{"value":"What Happens After a Merge","id":"what-happens-after-a-merge","depth":3},{"value":"Errors","id":"errors","depth":2},{"value":"Related Guides","id":"related-guides","depth":2}],"frontmatter":{"slug":"/split-merge-shipments","seo":{"title":"Split and Merge Shipments"}},"lastModified":"2026-10-21T20:38:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/split-merge-shipments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}