Skip to main content

Submit Square Order Fulfillments

POST 
/api/square/orders/submit-fulfillments

Push pending SKU fulfillments back to Square for the given instance. Omit fulfillment_ids to submit every pending fulfillment on the instance; provide them to submit a specific subset. Returns per-run counts (submitted, skipped, waiting, failed) plus any per-fulfillment errors.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Square accepts only one shipment per order, so an order's shipment is marked COMPLETED only once every unit on it has shipped (or the rest was cancelled, returned or fulfilled outside SKU.io), using the last parcel's tracking. Earlier parcels of a partly shipped order are not pushed yet: they are counted in waiting and are submitted together with the order's last parcel. A waiting parcel is not a failure and is not marked as submitted.

Body fields:

  • integration_instance_id (integer, required) — the Square instance.
  • fulfillment_ids (array of integers, optional) — specific SKU fulfillment IDs; omit to submit all pending.

Requires the integrations.sync permission.

Request​

Responses​

OK

Response Headers
    Content-Type