[Order]
[What it does] Updates fields still editable on a DSers order in its current status — shipping address, DSers-only note, sales-channel note, supplier order message, and/or the selected supplier-row shipping method — without changing payment status, quantities, supplier product, fulfillment Variant, or mapping.
[When to use] Use when the user explicitly provides new address, contact, note, or shipping-method values and the target is still editable.
[When not to use] To change which supplier product or fulfillment Variant fulfills the order, use update_order_supplier. Freight can be changed only on an unplaced, canceled, or failed supplier row; a fulfilled item cannot be edited. Never guess or infer address or contact details. Do not invent a freight amount other than the documented omitted default of 0.
[How to use] address fields are partial; omitted fields are preserved, so provide at least one field to change. supplier_platform_id is required only when setting sales_order_sales_channel_note or dsers_supplier_order_message, using the exact platform ID from this order, or 0 for Unmapped. freight requires service_id and company copied from list_supplier_product_shipping_methods_and_cost quotes[]. Omitted currency defaults to USD; omitted amount defaults to 0. Other omitted freight fields are written empty and clear origin, destination, tracking, transit time, and replenish. supplier_order_item_id is required with freight; copy only that ID from get_order items[].suppliers[].supplier_order_item_id. The Tool loads all current order items and supplier rows internally to resolve its owning line item. Address and freight may be sent together, but any copied quote must match the destination that will exist after this call. Show the before/after diff, including shipping method and cost (including a 0 default), and get explicit confirmation before writing. If the outcome is unknown, re-read the order rather than retry.
[Side effects] Changes order details and selected supplier freight, which can affect fulfillment cost and delivery. Omitting freight amount writes 0.
[Confirmation] Required, never skippable: show the diff and get explicit confirmation for exactly the specified fields, including freight cost when freight is present.