01.software Docs

bulkImportFulfillments

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

All HTTP operations
POST
/api/fulfillments/bulk-import

Requires tenant-editor policy: sk01_/pat01_ with write scope. Customer JWT and tenant-viewer are denied. Per-item failures are returned in failed; the batch is not atomic.

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.

Request Body

application/json
  1. body
items*array<>
Items1 <= items <= 500

Response Body

Successful operation

application/json
  1. response
succeeded*array<>
failed*array<>

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/fulfillments/bulk-import' \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "orderNumber": "string",      "carrier": "string",      "trackingNumber": "string"    }  ]}'
Example Response
{  "succeeded": [    {      "orderNumber": "string",      "fulfillmentId": "string"    }  ],  "failed": [    {      "orderNumber": "string",      "error": "string"    }  ]}