Cette page n'est disponible qu'en anglais.
Mark shipped / attach tracking
POST /rest/v1/orders/{id}/fulfillment
Marks the order as shipped and/or attaches tracking. Applies to the whole channel order (every line). No confirmation is asked: shipping is the normal, automated step of a fulfillment integration, and the marketplace is notified at most once per order (below). Each call is recorded in the action log as irreversible. With tracking present, Nembol also notifies the source marketplace (default; disable with notify_channel: false). Supported on eBay, Etsy, Shopify, WooCommerce, Amazon, TikTok Shop, OnBuy, Square and Squarespace. Marketplace notification is once-per-order (hard idempotent): a tracking sent later (after mark_shipped without one) is notified, but once the marketplace has a tracking a different number is saved in Nembol only, and channel_notification.error is then channel_already_notified; correct it on the marketplace itself. Without tracking, mark_shipped updates Nembol only (the marketplace is not told). Tracking fields over their limit are refused (422), never shortened. Requires the orders:write scope.
Authorization
apiKey Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Path Parameters
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/orders/string/fulfillment" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "ord_1f83b", "object": "order", "channel_account_id": "string", "channel": "string", "order_id_on_channel": "string", "number": "1011", "order_url": "http://example.com", "status": "awaiting_payment", "fulfillment_status": "unfulfilled", "source_status": "string", "tracking": { "number": "string", "carrier": "string", "url": "http://example.com" }, "currency": "string", "subtotal": "string", "shipping": "string", "discount": "string", "tax": "string", "tax_remitted_by": "marketplace", "total": "19.90", "lines": [ { "id": "oline_66f0a1b2c3d4e5f6a7b8c9d0", "sku": "string", "title": "string", "quantity": 1, "price": "19.90", "product_id": "string", "variant_id": "string" } ], "buyer": { "name": "string", "email": "string", "country": "string", "address": { "line1": "string", "line2": "string", "city": "string", "zip": "string", "province": "string", "country": "string" } }, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "channel_notification": { "attempted": true, "delivered": true, "error": "already_notified_same_tracking", "simulated": true }}Dernière mise à jour le 17 octobre 2026
Besoin d'aide ?
Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.