Update an integration mapping
Update an existing integration mapping by ID.
When changing mapping_config, see the Integration Mapping Guide
for the rule structure, field-path syntax, the full transformation catalogue, and
fallback behavior.
At most one of source_order_id, source_product_id, or source_purchase_order_id
may be set on a single request. source_supplier_purchase_order_shipment_id links the
mapping to an inbound purchase-order shipment (for PUSH_INBOUND_SHIPMENT mappings).
On these inbound-shipment mappings, updating source_supplier_purchase_order_shipment_id
alone re-infers source_purchase_order_id from the shipment’s linked purchase-order
items (the majority PO); the request is rejected if the shipment has none.
Authorizations
Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token.
Path Parameters
Integration mapping ID
Body
255Source fulfillment order. Mutually exclusive with the other two source_* order fields.
Source product. Mutually exclusive with the other two source_* order fields.
Source purchase order. Mutually exclusive with the other two source_* order fields.
Inbound purchase-order shipment the mapping is sourced from (for PUSH_INBOUND_SHIPMENT mappings). Setting this without source_purchase_order_id infers the purchase order from the shipment's linked purchase-order items; the request is rejected if the shipment has none.
Response
Successful response
Updated integration mapping record (same shape as GET /integration-mappings/{id}).