post

/order/fulfill-one

Fulfills an order in the Joom system. Call this API once you have shipped the item to the recipient. Joom will notify the user their order has been shipped upon completion of this request.

Returns

If the order is in the APPROVED state, the order is not already fulfilled and all the parameters are correct, the API will mark the order as shipped and return a HTTP status code of 200.

Request Body

Schema
object
id
string

Joom’s unique identifier for the order (order_id in the Order object)

required
tracking_number
string

The unique identifier that your carrier provided so that the user can track their package as it is being delivered. Tracking number should only contain alphanumeric characters with no space between them

ship_note
string

The note to the user when you marked the order as shipped (if applicable)

shipping_time
string

The amount of time it takes for the shipment to reach the buyer. Provide a time range in number of days. Lower bound cannot be less than 2 days

channel_id
string

Required for Joom Express orders. Need to pass channel_id value from the shipping_option from the order.

tracking_provider
string

The carrier that will be shipping your package to its destination. See list of accepted providers

tracking_provider_id
string

ID of the carrier that will be shipping your package to its destination. See list of accepted providers

Responses

1 Example
Schema
object
code
number

Contains the status code for the request, 0 means success and any other number implies a failure

1 validation + required
message
string

Sometimes will store a human readable status message to aid in debugging. It is generally used only for errors

required

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
host