A fulfillment represents a shipment of one or more items in an order. When we say that an order has been completely fulfilled, we mean that all the items that make up that order have been sent to the customer.
Ideally, a shop owner would want to make just one fulfillment per order, but there are times when the availability or size of items in the order make it necessary to make more than one shipment, which is why an order can have one or more fulfillments.
Authenticated access scopes: com.read_orders, com.write_orders
What you can do with Fulfillment
The Haravan API lets you do the following with the Fulfillment resource.
- GET https://apis.haravan.com/com/orders/{order_id}/fulfillments.json Retrieves a list fulfillment of the order
- GET https://apis.haravan.com/com/orders/{order_id}/fulfillments/count.json Retrieve a count fulfillment of the order.
- GET https://apis.haravan.com/com/orders/{order_id}/fulfillments/{fulfillment_id}.json Retrieves single fulfillment of the order.
- POST https://apis.haravan.com/com/orders/{order_id}/fulfillments.json Create a fulfillment for order.
- PUT https://apis.haravan.com/com/orders/{order_id}/fulfillments/{fulfillment_id}.json Update an existing fulfillment of the order.
Product variant properties
Endpoints
Retrieves a list of all fulfillment of orders. You can filter resources by params.
ids | A comma-separated list of order ids. |
limit | Limit of the result. |
page | Page to show the result. |
since_id | Restrict results to after the specified ID |
created_at_min | Show fulfillments of order after date (format: 2008-12-31 03:00) |
created_at_max | Show fulfillments of order created before date (format: 2008-12-31 03:00) |
updated_at_min | Show fulfillments of order last updated after date (format: 2008-12-31 03:00) |
updated_at_max | Show fulfillments of order last updated before date (format: 2008-12-31 03:00) |
fields | comma-separated list of fields to include in the response. |
Retrieve all fulfillment orders.
GET https://apis.haravan.com/com/orders/1229422895/fulfillments.json
HTTP/1.1 200 OK
{ "fulfillments": [ { "created_at": "2021-09-27T03:42:17.571Z", "id": 1054978733, "order_id": 1229422895, "receipt": null, "status": "success", "tracking_company": "Khác", "tracking_company_code": "other", "tracking_numbers": [], "tracking_number": null, "tracking_url": "http://www.google.com/search?q=", "tracking_urls": [ "http://www.google.com/search?q=" ], "updated_at": "2021-09-27T03:42:31.466Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1054978733, "price": 240000.0000, "product_id": 1028183635, "quantity": 1, "requires_shipping": true, "sku": "AO999", "title": "Áo len cổ tròn kiểu Cổ điển", "variant_id": 1061514635, "variant_title": "Trắng / L", "vendor": "Khác", "name": "Áo len cổ tròn kiểu Cổ điển", "variant_inventory_management": null, "properties": null, "product_exists": true }, { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1054978733, "price": 240000.0000, "product_id": 1028183635, "quantity": 1, "requires_shipping": true, "sku": "AO999", "title": "Áo len cổ tròn kiểu Cổ điển", "variant_id": 1061514635, "variant_title": "Trắng / L", "vendor": "Khác", "name": "Áo len cổ tròn kiểu Cổ điển", "variant_inventory_management": null, "properties": null, "product_exists": true } ], "province": "Hồ Chí Minh", "province_code": "HC", "district": "Quận 11", "district_code": "HC476", "ward": "Phường 15", "ward_code": "27208", "cod_amount": 510000.0000, "carrier_status_name": "Đã giao hàng", "carrier_cod_status_name": "Đã nhận", "carrier_status_code": "delivered", "carrier_cod_status_code": "codreceipt", "location_id": 1091390, "note": null, "carrier_service_package": 0, "carrier_service_package_name": "", "is_new_service_package": false, "coupon_code": "", "ready_to_pick_date": "2021-09-27T03:42:18Z", "picking_date": null, "delivering_date": null, "delivered_date": "2021-09-27T03:42:29Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": null, "cod_receipt_date": "2021-09-27T03:42:24Z", "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": "Vietnam", "country_code": "VN", "zip_code": null, "city": null, "real_shipping_fee": 0.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": "184 Le Dai Hanh", "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "Nguyen", "last_name": "Le", "shipping_address": "184 Le Dai Hanh", "shipping_phone": "0123456789" } ] }
Retrieve the count fulfillments of order.
Retrieve the count fulfillments of order.
GET https://apis.haravan.com/com/orders/1229422895/fulfillments/count.json
HTTP/1.1 200 OK
{ "count": 1 }
Retrieve a fulfillment of the order by specifying the ID.
Retrieves single fulfillment of the order by ID.
GET https://apis.haravan.com/com/orders/1229422895/fulfillments/1054978733.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-09-27T03:42:17.571Z", "id": 1054978733, "order_id": 1229422895, "receipt": null, "status": "success", "tracking_company": "Khác", "tracking_company_code": "other", "tracking_numbers": [], "tracking_number": null, "tracking_url": "http://www.google.com/search?q=", "tracking_urls": [ "http://www.google.com/search?q=" ], "updated_at": "2021-09-27T03:42:31.466Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1054978733, "price": 240000.0000, "product_id": 1028183635, "quantity": 1, "requires_shipping": true, "sku": "AO999", "title": "Áo len cổ tròn kiểu Cổ điển", "variant_id": 1061514635, "variant_title": "Trắng / L", "vendor": "Khác", "name": "Áo len cổ tròn kiểu Cổ điển", "variant_inventory_management": null, "properties": null, "product_exists": true }, { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1054978733, "price": 240000.0000, "product_id": 1028183635, "quantity": 1, "requires_shipping": true, "sku": "AO999", "title": "Áo len cổ tròn kiểu Cổ điển", "variant_id": 1061514635, "variant_title": "Trắng / L", "vendor": "Khác", "name": "Áo len cổ tròn kiểu Cổ điển", "variant_inventory_management": null, "properties": null, "product_exists": true } ], "province": "Hồ Chí Minh", "province_code": "HC", "district": "Quận 11", "district_code": "HC476", "ward": "Phường 15", "ward_code": "27208", "cod_amount": 510000.0000, "carrier_status_name": "Đã giao hàng", "carrier_cod_status_name": "Đã nhận", "carrier_status_code": "delivered", "carrier_cod_status_code": "codreceipt", "location_id": 1091390, "note": null, "carrier_service_package": 0, "carrier_service_package_name": "", "is_new_service_package": false, "coupon_code": "", "ready_to_pick_date": "2021-09-27T03:42:18Z", "picking_date": null, "delivering_date": null, "delivered_date": "2021-09-27T03:42:29Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": null, "cod_receipt_date": "2021-09-27T03:42:24Z", "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": "Vietnam", "country_code": "VN", "zip_code": null, "city": null, "real_shipping_fee": 0.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": "184 Le Dai Hanh", "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "Nguyen", "last_name": "Le", "shipping_address": "184 Le Dai Hanh", "shipping_phone": "0123456789" } }
Creates a fulfillment for the specified order and line items. If the line items in the fulfillment use a manual or custom fulfillment service the status of the returned fulfillment will be set immediately. If the line items use an external fulfillment service they will be queued for fulfillment and the status will be set to pending until the external fulfillment service has been invoked. Not specifying line item IDs causes all unfulfilled and partially fulfilled line items for the order to be fulfilled. Note that all line items being fulfilled must have the same fulfillment service.
Fulfill all line items for an order and send the shipping confirmation email. Not specifying line item IDs causes all unfulfilled and partially fulfilled line items for the order to be fulfilled.
POST https://apis.haravan.com/com/orders/1230369995/fulfillments.json
{ "fulfillment": { "tracking_number": "123456789", "notify_customer": true } }
HTTP/1.1 201 Created
{ "fulfillment": { "created_at": "2021-10-02T13:47:32.8910054Z", "id": 1055494186, "order_id": 1230369995, "receipt": null, "status": "success", "tracking_company": "Khác", "tracking_company_code": "other", "tracking_numbers": [ "123456789" ], "tracking_number": "123456789", "tracking_url": "http://www.google.com/search?q=", "tracking_urls": [ "http://www.google.com/search?q=", "http://www.google.com/search?q=" ], "updated_at": "2021-10-02T13:47:32.8910108Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305723156, "price": 10000000.0000, "product_id": 1035626312, "quantity": 6, "requires_shipping": true, "sku": "S300912-1", "title": "SP 30094-1", "variant_id": 1078252093, "variant_title": "Be đậm", "vendor": "2080", "name": "SP 30094-1", "variant_inventory_management": "haravan", "properties": null, "product_exists": true }, { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305723157, "price": 9900000.0000, "product_id": 1035626312, "quantity": 5, "requires_shipping": true, "sku": "S300912-2", "title": "SP 30094-1", "variant_id": 1078252094, "variant_title": "Túi 500g", "vendor": "2080", "name": "SP 30094-1", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": null, "ward_code": null, "cod_amount": 109500000.0000, "carrier_status_name": "Chờ lấy hàng", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "readytopick", "carrier_cod_status_code": "codpending", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": " - ", "is_new_service_package": false, "coupon_code": null, "ready_to_pick_date": "2021-10-02T13:47:32.8637077Z", "picking_date": null, "delivering_date": null, "delivered_date": null, "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": null, "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 0.0, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.0, "package_width": 0.0, "package_height": 0.0, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Fulfill all line items for an order and send the shipping confirmation email. Not specifying line item IDs causes all unfulfilled and partially fulfilled line items for the order to be fulfilled.
POST https://apis.haravan.com/com/orders/1230064550/fulfillments.json
{ "fulfillment": { "notify_customer": true, "tracking_company":"Giao Hàng Nhanh", "location_id":"963414", "note": "test", "cod_amount": 20000, "coupon_code": "abc", "carrier_service_package": 1, "carrier_service_package_name": "giao abc", "is_new_service_package": true, "carrier_service_code": "abc" } }
HTTP/1.1 201 Created
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.7549066Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [], "tracking_number": null, "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-02T13:58:58.7549122Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0, "carrier_status_name": "Chờ lấy hàng", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "readytopick", "carrier_cod_status_code": "codpending", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:58.7406356Z", "picking_date": null, "delivering_date": null, "delivered_date": null, "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": null, "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 0.0, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.0, "package_width": 0.0, "package_height": 0.0, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update an existing fulfillment of the order.
Update tracking number and status of fulfillment.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932.json
{ "fulfillment": { "tracking_number": "2021", "carrier_status_code":"delivered" } }
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:43:00.345Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1055494932, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Đã giao hàng", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "delivered", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package_name": "giao abc", "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": null, "delivering_date": null, "delivered_date": "2021-10-03T04:40:15Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": "Vietnam", "country_code": "VN", "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": "HCN", "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585" } }
Update status picking.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/carrier_status/picking.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:51:26.5279791Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Đang đi lấy", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "picking", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:26.526012Z", "delivering_date": null, "delivered_date": "2021-10-03T04:40:15Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status delivering.
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:53:12.747917Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Đang giao hàng", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "delivering", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:12.745645Z", "delivered_date": "2021-10-03T04:40:15Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status delivered.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/carrier_status/delivered.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:53:41.557Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Đã giao hàng", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "delivered", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": null, "not_meet_customer_date": null, "waiting_for_return_date": null, "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status does not meet customer.
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:57:21.2991246Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Không gặp khách", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "notmeetcustomer", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": null, "not_meet_customer_date": "2021-10-03T04:57:21.2971689Z", "waiting_for_return_date": null, "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status waiting for return.
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T04:58:46.0662403Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Chờ chuyển hoàn", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "waitingforreturn", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": null, "not_meet_customer_date": "2021-10-03T04:57:21Z", "waiting_for_return_date": "2021-10-03T04:58:46.0648984Z", "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status return.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/carrier_status/return.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T05:00:55.477775Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Chuyển hoàn", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "return", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": "2021-10-03T05:00:55.4754006Z", "not_meet_customer_date": "2021-10-03T04:57:21Z", "waiting_for_return_date": "2021-10-03T04:58:46Z", "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update COD status paid.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/cod_status/paid.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T05:00:55.478Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Chuyển hoàn", "carrier_cod_status_name": "Chưa nhận", "carrier_status_code": "return", "carrier_cod_status_code": "codpaid", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": "2021-10-03T05:00:55Z", "not_meet_customer_date": "2021-10-03T04:57:21Z", "waiting_for_return_date": "2021-10-03T04:58:46Z", "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": null, "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update COD status receipt.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/cod_status/receipt.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T05:04:17.1170943Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Chuyển hoàn", "carrier_cod_status_name": "Đã nhận", "carrier_status_code": "return", "carrier_cod_status_code": "codreceipt", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": "2021-10-03T05:00:55Z", "not_meet_customer_date": "2021-10-03T04:57:21Z", "waiting_for_return_date": "2021-10-03T04:58:46Z", "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": "2021-10-03T05:04:17.1154441Z", "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": null, "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }
Update status cancel.
PUT https://apis.haravan.com/com/orders/1230064550/fulfillments/1055494932/carrier_status/cancel.json
HTTP/1.1 200 OK
{ "fulfillment": { "created_at": "2021-10-02T13:58:58.755Z", "id": 1055494932, "order_id": 1230064550, "receipt": null, "status": "success", "tracking_company": "Giao Hàng Nhanh", "tracking_company_code": "ghn2018", "tracking_numbers": [ "2021" ], "tracking_number": "2021", "tracking_url": "https://donhang.ghn.vn/?order_code=", "tracking_urls": [ "https://donhang.ghn.vn/?order_code=" ], "updated_at": "2021-10-03T05:06:32.881063Z", "line_items": [ { "fulfillable_quantity": 0, "fulfillment_service": "Thủ công", "fulfillment_status": "Đã hoàn thành", "grams": 0.0000, "id": 1305098847, "price": 4000000.0000, "product_id": 1035620803, "quantity": 3, "requires_shipping": true, "sku": "S30091-2", "title": "SP 30092", "variant_id": 1078238660, "variant_title": "Da tổng hợp / Hộp 350g", "vendor": "2.5 NEW VISION GENERATION", "name": "SP 30092", "variant_inventory_management": "haravan", "properties": null, "product_exists": true } ], "province": "Hà Nội", "province_code": "HI", "district": "Quận Ba Đình", "district_code": "HI2", "ward": "Phường Giảng Võ", "ward_code": "00031", "cod_amount": 20000.0000, "carrier_status_name": "Hủy giao hàng", "carrier_cod_status_name": "Đã nhận", "carrier_status_code": "cancel", "carrier_cod_status_code": "codreceipt", "location_id": 963414, "note": null, "carrier_service_package": null, "carrier_service_package_name": "giao abc", "is_new_service_package": false, "coupon_code": "abc", "ready_to_pick_date": "2021-10-02T13:58:59Z", "picking_date": "2021-10-03T04:51:27Z", "delivering_date": "2021-10-03T04:53:13Z", "delivered_date": "2021-10-03T04:53:42Z", "return_date": "2021-10-03T05:00:55Z", "not_meet_customer_date": "2021-10-03T04:57:21Z", "waiting_for_return_date": "2021-10-03T04:58:46Z", "cod_paid_date": "2021-10-03T04:40:15Z", "cod_receipt_date": "2021-10-03T05:04:17Z", "cod_pending_date": null, "cod_not_receipt_date": null, "cancel_date": "2021-10-03T05:06:32.8797837Z", "is_view_before": null, "country": null, "country_code": null, "zip_code": null, "city": null, "real_shipping_fee": 100000.0000, "shipping_notes": null, "total_weight": 0.0000, "package_length": 0.00, "package_width": 0.00, "package_height": 0.00, "boxme_servicecode": null, "transport_type": 0, "address": null, "sender_phone": null, "sender_name": null, "carrier_service_code": null, "from_longtitude": 0.0, "from_latitude": 0.0, "to_longtitude": 0.0, "to_latitude": 0.0, "sort_code": null, "is_drop_off": false, "is_insurance": false, "insurance_price": 0.0, "is_open_box": false, "request_id": null, "carrier_options": null, "note_attributes": null, "first_name": "02", "last_name": "Thành viên", "shipping_address": "HCN", "shipping_phone": "0586888585", "carrier_shop_id": null, "request_mode": null } }