Create fulfillment shipping logistics event

Requires write_assigned_fulfillment_orders access scope.

For more info, refer to:

POST https://{handle}.myshopline.com/admin/openapi/v20260301/fulfillments/:order_id/:fulfillment_id/events/create.json

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

Path Parameters

fulfillment_id string required

Invoice id

Example: 22060720884441337538627925
order_id string required

Order id

Example: 21056024607602932623437925

Request Headers

Content-Type string required

The field must be set to the fixed value application/json; charset=utf-8.
Authorization string required

The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
Example:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Request Body

province string

Province
Example: Ontario
status string required

Status ,Includes : label_printed、label_purchased、attempted_delivery、ready_for_pickup、picked_up、confirmed、in_transit、out_for_delivery、delivered、failure
Example: label_printed
happened_at string

Event duration ( format see ISO 8601 )
Example: 2021-08-16T08:27:57+00:00
longitude string

Longitude
Example: 113.301255
message string

Note , the maximum length is 512
Example: nothing
city string

City
Example: Ottawa
estimated_delivery_at string

Estimated delivery time ( format see ISO 8601 )
Example: 2021-08-16T08:27:57+00:00
zip string

Postal code
Example: A1B 2C3
country string

Country
Example: Canada
latitude string

Latitude
Example: 23.32947
address string

Address
Example: 126 York Street

Status Codes

For the complete list of codes and messages, see Http status code.

Response Headers

traceId

A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.

Response Body

fulfillment_eventobject

Event information
create_at string

Creation time
Example: 2021-08-16T08:27:57+00:00
order_id string

Order id
Example: 21056024607602932623437925
update_at string

Update time
Example: 2021-08-16T08:27:57+00:00
id string

Event id
Example: 4206234611998187371524
longitude string

Longitude
Example: 113.301255
message string

Notes
Example: nothing
address string

Address
Example: 126 York Street
country string

Country
Example: Canada
shop_id string

store ID
Example: 2331445
city string

City
Example: Ottawa
status string

Status ,Includes : label_printed、label_purchased、attempted_delivery、ready_for_pickup、picked_up、confirmed、in_transit、out_for_delivery、delivered、failure
Example: label_printed
fulfillment_id string

Invoice id
Example: 22060720884441337538627925
happened_at string

Event duration ( format see ISO 8601 )
Example: 2021-08-16T08:27:57+00:00
latitude string

Latitude
Example: 23.32947
province string

Province
Example: Ontario
zip string

Postal code
Example: A1B 2C3
estimated_delivery_at string

Estimated delivery time ( format see ISO 8601 )
Example: 2021-08-16T08:27:57+00:00

API Explorer

Debugger

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

fulfillment_id — path required

order_id — path required

Authorization — header required

Body

Body required

{
  "message": "nothing",
  "province": "Ontario",
  "address": "126 York Street",
  "estimated_delivery_at": "2021-08-16T08:27:57+00:00",
  "latitude": "23.32947",
  "status": "label_printed",
  "city": "Ottawa",
  "happened_at": "2021-08-16T08:27:57+00:00",
  "longitude": "113.301255",
  "zip": "A1B 2C3",
  "country": "Canada"
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/fulfillments/order_id/fulfillment_id/events/create.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal