01.software Docs

createFulfillment

Use the SDK for application integration. This read-only reference covers Commerce, Customer Auth, Membership and Events.

All HTTP operations
POST
/api/orders/create-fulfillment

Tenant-editor write; shared lifecycle quantity/lock rules. Returns a validated shipment receipt with relationship IDs. Optional X-Idempotency-Key retains same-body retry identity.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Public integration credentials: verified opaque sk01_ secret key or pat01_ personal access token; operation policy and read/write scopes still apply. These credentials are not Customer JWTs.

Header Parameters

X-Idempotency-Key?string

Optional retry identity. Preserve exact body and identity for the same operation; absence does not imply safe automatic retry.

Length1 <= length

Request Body

application/json
  1. body
orderNumber*string
Length1 <= length
fulfillmentOrderId?string|number
carrier?string
Length1 <= length
trackingNumber?string
Length1 <= length
items?array<>
Items1 <= items <= 100

Response Body

Actual shaped success body

application/json
  1. response
id*string
tenant?string|null
order*string
fulfillmentOrder*string|null
status*string
Value in"pending""packed""shipped""delivered""canceled""failed"
carrier?string|null
trackingNumber?string|null
trackingUrl?string|null
packedAt?string|null
shippedAt?string|null
deliveredAt?string|null
createdAt*string
updatedAt*string

Examples may be generated from schemas; they are illustrative, not recorded successful API calls. Example snippets may omit required authentication headers.

Example Request
curl -X POST 'https://api.01.software/api/orders/create-fulfillment' \  -H 'Content-Type: application/json' \  -d '{  "orderNumber": "string"}'
Example Response
{  "id": "string",  "tenant": "string",  "order": "string",  "fulfillmentOrder": "string",  "status": "pending",  "carrier": "string",  "trackingNumber": "string",  "trackingUrl": "string",  "packedAt": "string",  "shippedAt": "string",  "deliveredAt": "string",  "createdAt": "string",  "updatedAt": "string"}