8.6 Order Fulfillment

post

create fulfillment to order

Body

Details of customer support

order_idstringOptional
callback_phonestring · phoneOptional
Responses
default

Successful closure of a chat session

application/json
post
/fulfillments
default

Successful closure of a chat session

get

create a fulfillment

Path parameters
fulfillmentIdstringRequired

Unique reference ID to the fulfillment of an order

Responses
default

Successful closure of a chat session

application/json
get
/fulfillments/{fulfillmentId}
default

Successful closure of a chat session

put

Update fulfillment state for an order

Path parameters
fulfillmentIdstringRequired

Unique reference ID to the fulfillment of an order

Body

Describes the state of fulfillment

updated_atstring · date-timeOptional
updated_bystringOptional

ID of entity which changed the state

Responses
default

Successful closure of a chat session

application/json
put
/fulfillments/{fulfillmentId}
default

Successful closure of a chat session

delete

Cancel the fulfillment for an order

Path parameters
fulfillmentIdstringRequired

Human-readable ID of the order. This is generated at the Provider Platform layer. The Provider Platform can either generate order id within its system or forward the order ID created at the provider level.

Responses
default

Successful closure of a chat session

application/json
delete
/fulfillments/{fulfillmentId}
default

Successful closure of a chat session

post

Check serviceability of an order

Body

Describes a legal purchase order. It contains the complete details of the legal contract created between the buyer and the seller.

idstringOptional

Human-readable ID of the order. This is generated at the Provider Platform layer. The Provider Platform can either generate order id within its system or forward the order ID created at the provider level.

ref_order_idsstring[]Optional

A list of order IDs to link this order to previous orders.

statusstring · enumOptional

Status of the order. Allowed values can be defined by the network policy

Possible values:
typestring · enumOptional

This is used to indicate the type of order being created to Provider Platforms. Sometimes orders can be linked to previous orders, like a replacement order in a retail domain. A follow-up consultation in healthcare domain. A single order part of a subscription order. The list of order types can be standardized at the network level.

Default: DEFAULTPossible values:
created_atstring · date-timeOptional

The date-time of creation of this order

updated_atstring · date-timeOptional

The date-time of updated of this order

Responses
default

Serviceable

application/json
post
/fulfillment/checkServiceability
default

Serviceable

put

Add fulfillment to an order

Path parameters
fulfillmentIdstringRequired

Unique reference ID to the fulfillment of an order

Body

Describes the direct performer, driver or executor that fulfills an order. It is usually a person. But in some rare cases, it could be a non-living entity like a drone, or a bot. Some examples of agents are Doctor in the healthcare sector, a driver in the mobility sector, or a delivery person in the logistics sector. This object can be set at any stage of the order lifecycle. This can be set at the discovery stage when the Provider Platform wants to provide details on the agent fulfilling the order, like in healthcare, where the doctor's name appears during search. This object can also used to search for a particular person that the customer wants fulfilling an order. Sometimes, this object gets instantiated after the order is confirmed, like in the case of on-demand taxis, where the driver is assigned after the user confirms the ride.

idstringOptional
ratingstringOptional

Rating value given to the object. This can be a single value or can also contain an inequality operator like gt, gte, lt, lte. This can also contain an inequality expression containing logical operators like && and ||.

Responses
default

Order with allocated agent

application/json
put
/fulfillment/{fulfillmentId}/agent/allocate
default

Order with allocated agent

delete

Add fulfillment to an order

Path parameters
fulfillmentIdstringRequired

Unique reference ID to the fulfillment of an order

Responses
default

Order with agent deallocated

application/json
delete
/fulfillment/{fulfillmentId}/agent/deallocate
default

Order with agent deallocated

Last updated

Was this helpful?