noon_inbound_CreateShipment
Create an FBN inbound shipment (ASN) header in CREATED status with no items — step 2, after noon_inbound_ListEligibleItems.
writenoonnoon
Idempotent: the same exref_nr + shipment_type returns the existing ASN instead of a duplicate. noon API · AsnService_CreateShipment · POST /fbn/inbound/v1/shipment/create Docs: https://noon-docs.noonpartners.dev/docs/api-reference/inbound/asn-service-create-shipment Gate: approve — interactive: show the change (noon's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask.
Call it
In an AI client (MCP)
{
"name": "noon_inbound_CreateShipment",
"arguments": {
"store": "myStore-US",
"exref_nr": "<exref_nr>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/noon_inbound_CreateShipment \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","exref_nr":"<exref_nr>"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the noon account ref `<account>-<CC>` (name-country, e.g. 'myNoon-AE') — one of get_user_context's noon store_refs, verbatim. |
exref_nrrequired | string | your external reference (e.g. a PO number) — required, unique per shipment_type within the account. |
country_code | string | the destination country code (e.g. AE, SA); omit it to use the store ref's marketplace. |
shipment_type | string | the ASN's shipment type — SHIPMENT_TYPE_FBN_GLOBAL is noon's only usable value, and the one sent when this is omitted. Allowed: SHIPMENT_TYPE_UNSPECIFIED | SHIPMENT_TYPE_FBN_GLOBAL.SHIPMENT_TYPE_UNSPECIFIEDSHIPMENT_TYPE_FBN_GLOBAL |
Result
Every tool answers {notification, data, human_action}; data carries:
data.shipment.asn_nr— the new ASN — pass it as asn_nr to noon_inbound_UpdateShipmentItems.data.shipment.status— ASN_STATUS_CREATED (the header shape of noon_inbound_GetShipment).
Workflow
- 1. noon_inbound_UpdateShipmentItems — add the lines. 2. noon_inbound_UpdateShipmentStatus with action SEAL. 3. noon_inbound_GetSlotAvailability, then noon_inbound_ScheduleShipment.