These docs are for v1.0. Click to read the latest docs for v2024.09.

Discussions

Ask a Question
ANSWERED

Shipping rates calculator Shipping From country issue

I am checking easyship shipping rates calculator but here Shipping From dropdown not showing "China" country why? Explain in more detail.

ANSWERED

Clarification needed for sandbox environment

Is there anyway we can test whole workflow using sandbox credentials not using production environment ?

ANSWERED

Create a Tracking API issue

Request:

ANSWERED

how can i change my carrier in shipping rate calculator

how can i change carrier using the following link

ANSWERED

Create a Tracking issue

$response = $client->request('POST', 'https://api.easyship.com/2023-01/trackings', [
'body' => '{"origin_address":{"company_name":"Test Plc.","contact_name":"Foo Bar","contact_email":"[email protected]","contact_phone":"+852-1234-5678","line_1":"123 Test Street","line_2":"Block 3","postal_code":"ABC123","city":"City","state":"State","country_alpha2":"SG"},"destination_address":{"company_name":"Test Plc.","contact_name":"Foo Bar","contact_email":"[email protected]","contact_phone":"+65 6910 1185","line_1":"123 Test Street","line_2":"Block 3","postal_code":"247964","city":"Singapore","state":"Singapore","country_alpha2":"SG"},"tracking_number":"13213213","courier_id":"01563646-58c1-4607-8fe0-cae3e33c0002","items":[{"description":"iPhone","quantity":1},{"description":"Macbook"}]}',
'headers' => [
'accept' => 'application/json',
'authorization' => 'Bearer prod_xxx,
'content-type' => 'application/json',
],
]);

ANSWERED

Create a shipment sandbox account access token

{#3520 ▼
+"shipment": {#3345 ▼
+"easyship_shipment_id": "ESHK10131608"
+"consignee_tax_id": null
+"courier": {#3347 ▼
+"id": "64b5d8b2-4c60-4faf-bf1b-9f7b1b7ca1c8"
+"name": "SF Express - Domestic"
}
+"created_at": "2023-10-20T10:05:09Z"
+"currency": "INR"
+"delivery_state": "not_created"
+"destination_address": {#3499 ▼
+"city": "Kowloon City"
+"company_name": null
+"contact_email": "
[email protected]"
+"contact_name": "Nikunj Buyer"
+"contact_phone": "+85230085678"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": null
+"postal_code": "0000"
+"state": "Kowloon Region"
}
+"eei_reference": null
+"incoterms": "DDU"
+"insurance": {#3319 ▶}
+"label_generated_at": null
+"label_paid_at": null
+"label_state": "not_created"
+"last_failure_http_response_messages": []
+"metadata": {#3511}
+"order_created_at": null
+"order_data": {#3504 ▶}
+"origin_address": {#3500 ▼
+"city": "Hong Kong"
+"company_name": "Threeniti"
+"contact_email": "[email protected]"
+"contact_name": "Threeniti"
+"contact_phone": "+852-3008-5678"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": ""
+"postal_code": "0000"
+"state": "Yuen Long"
}
+"parcels": array:1 [▼
0 => {#3344 ▼
+"box": {#3346 ▼
+"id": null
+"name": null
+"outer_dimensions": {#3507 ▼
+"length": 18.0
+"width": 30.0
+"height": 20.0
}
+"slug": null
+"type": "box"
+"weight": 0.0
}
+"items": array:1 [▼
0 => {#3343 ▼
+"actual_weight": 1.0
+"category": "Home Appliances"
+"contains_battery_pi966": null
+"contains_battery_pi967": null
+"contains_liquids": null
+"declared_currency": "HKD"
+"declared_customs_value": 50.0
+"description": "Stainless Steel Vacuum With Straw Handle Cup"
+"dimensions": {#3377 ▶}
+"hs_code": "40000000"
+"origin_country_alpha2": "HK"
+"origin_currency": "INR"
+"origin_customs_value": 436.6812227
+"quantity": 1
+"sku": null
}
]
+"total_actual_weight": 1.0
}
]
+"pickup_state": "not_requested"
+"rates": array:1 [▼
0 => {#3514 ▼
+"additional_services_surcharge": 0.0
+"available_handover_options": array:2 [▶]
+"cost_rank": 1.0
+"courier_id": "64b5d8b2-4c60-4faf-bf1b-9f7b1b7ca1c8"
+"courier_logo_url": null
+"courier_name": "SF Express - Domestic"
+"courier_remarks": null
+"currency": "INR"
+"ddp_handling_fee": 0.0
+"delivery_time_rank": 1.0
+"description": null
+"discount": {#3515 ▶}
+"easyship_rating": null
+"estimated_import_duty": 0
+"estimated_import_tax": 0
+"fuel_surcharge": 0.0
+"full_description": null
+"import_duty_charge": 0.0
+"import_tax_charge": 0.0
+"import_tax_non_chargeable": 0.0
+"incoterms": "DDU"
+"insurance_fee": 0.0
+"is_above_threshold": false
+"max_delivery_time": 3
+"min_delivery_time": 2
+"minimum_pickup_fee": 0.0
+"other_surcharges": null
+"oversized_surcharge": 0.0
+"payment_recipient": "Easyship"
+"provincial_sales_tax": 0.0
+"rates_in_origin_currency": {#3516 ▶}
+"remote_area_surcharge": 0.0
+"remote_area_surcharges": null
+"residential_discounted_fee": null
+"residential_full_fee": null
+"sales_tax": 0.0
+"shipment_charge": 238.3
+"shipment_charge_total": 238.3
+"total_charge": 238.3
+"tracking_rating": 3.0
+"value_for_money_rank": 1.0
+"warehouse_handling_fee": 0.0
}
]
+"regulatory_identifiers": {#3517 ▼
+"eori": null
+"ioss": null
+"vat_number": null
}
+"return": false
+"return_address": {#3518 ▼
+"city": "Hong Kong"
+"company_name": "Threeniti"
+"contact_email": "[email protected]"
+"contact_name": "Threeniti"
+"contact_phone": "+852-3008-5678"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": ""
+"postal_code": "0000"
+"state": "Yuen Long"
}
+"sender_address": {#3519 ▼
+"city": "Hong Kong"
+"company_name": "Threeniti"
+"contact_email": "[email protected]"
+"contact_name": "Threeniti"
+"contact_phone": "+852-3008-5678"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": ""
+"postal_code": "0000"
+"state": "Yuen Long"
}
+"set_as_residential": false
+"shipment_state": "created"
+"shipping_documents": []
+"tracking_page_url": "https://www.trackmyshipment.co/shipment-tracking/ESHK10131608"
+"trackings": []
+"updated_at": "2023-10-20T10:05:10Z"
+"warehouse_state": "none"
}
+"meta": {#3521 ▼
+"unavailable_couriers": []
}
}

ANSWERED

Integrate Flow API

I integrated Create a Shipment API so then after which the API needs to implement flow

ANSWERED

Cant create shipment with status code 202

+"shipment": {#3344 ▼
+"easyship_shipment_id": "ESHK166415782"
+"consignee_tax_id": null
+"courier": {#3346 ▼
+"id": "64b5d8b2-4c60-4faf-bf1b-9f7b1b7ca1c8"
+"name": "SF Express - Domestic"
}
+"created_at": "2023-10-19T09:14:52Z"
+"currency": "INR"
+"delivery_state": "not_created"
+"destination_address": {#3443 ▶}
+"eei_reference": null
+"incoterms": "DDU"
+"insurance": {#327 ▶}
+"label_generated_at": null
+"label_paid_at": null
+"label_state": "not_created"
+"last_failure_http_response_messages": []
+"metadata": {#3500}
+"order_created_at": null
+"order_data": {#3502 ▼
+"platform_name": null
+"platform_order_number": null
+"order_tag_list": []
+"seller_notes": null
+"buyer_notes": null
}
+"origin_address": {#3499 ▶}
+"parcels": array:1 [▶]
+"pickup_state": "not_requested"
+"rates": array:1 [▶]
+"regulatory_identifiers": {#3516 ▶}
+"return": false
+"return_address": {#3517 ▼
+"city": "Hong Kong"
+"company_name": "Demo"
+"contact_email": "
[email protected]"
+"contact_name": "Demo"
+"contact_phone": "9876543211"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": ""
+"postal_code": "0000"
+"state": "Yuen Long"
}
+"sender_address": {#3518 ▼
+"city": "Hong Kong"
+"company_name": "demo"
+"contact_email": "[email protected]"
+"contact_name": "Demo"
+"contact_phone": "*11"
+"country_alpha2": "HK"
+"line_1": "Kennedy Town"
+"line_2": ""
+"postal_code": "0000"
+"state": "Yuen Long"
}
+"set_as_residential": false
+"shipment_state": "created"
+"shipping_documents": []
+"tracking_page_url": "https://www.trackmyshipment.co/shipment-tracking/ESHK166415782"
+"trackings": []
+"updated_at": "2023-10-19T09:14:53Z"
+"warehouse_state": "none"
}
+"meta": {#3520 ▼
+"unavailable_couriers": []
}

ANSWERED

Create shipment error "Invalid request" with this SKU

{
"incoterms": "DDP",
"origin_address": {
"contact_name": "Wong",
"country_alpha2": "FR",
"postal_code": "25640",
"state": "Doubs",
"line_1": "6 Route de Moncey ",
"line_2": "",
"city": "Chaudefontaine",
"contact_phone": "+852 1234 5612",
"contact_email": "
[email protected]",
"company_name": "[STAGING] KYC-approved"
},
"destination_address": {
"contact_name": "Ben Suen",
"country_alpha2": "HK",
"postal_code": "0000",
"state": "Hong Kong",
"line_1": "Tung Lo Wan Road",
"line_2": "38",
"city": "Tai Hang",
"contact_phone": "+852 9877 0084",
"contact_email": "[email protected]"
},
"return_address": {
"contact_name": "Wong",
"country_alpha2": "FR",
"postal_code": "25640",
"state": "Doubs",
"line_1": "6 Route de Moncey ",
"line_2": "",
"city": "Chaudefontaine",
"contact_phone": "+852 1234 5612",
"contact_email": "[email protected]",
"company_name": "[STAGING] KYC-approved"
},
"parcels": [
{
"total_actual_weight": 100,
"items": [
{
"sku": "12345",
"description": "testproduct2",
"quantity": 4,
"declared_currency": "HKD",
"declared_customs_value": 785,
"origin_country_alpha2": "FR",
"hs_code": "5d7df2ea-6f39-4ba4-a029-4c187836b015"
}
],
"box": {
"slug": "custom-box",
"length": 30,
"width": 20,
"height": 30,
"packageWeight": 100
}
}
],
"shipping_settings": {
"units": {
"dimensions": "in",
"weight": "lb"
},
"buy_label": false
},
"eei_reference": null,
"courier_selection": {
"selected_courier_id": "1f09d069-7c0b-4d80-87dd-7917af48c692",
"apply_shipping_rules": true,
"allow_courier_fallback": false
},
"insurance": {
"is_insured": true,
"insured_amount": 4239,
"insured_currency": "HKD"

Return log with "invalid_content", we don't know the root cause to debug

Request log
{
"incoterms": "DDP",
"parcels": [
{
"total_actual_weight": null,
"items": [
{
"actual_weight": 0.090718474,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 51.09,
"description": "Toothpaste Tablets with Fluoride Minty Yuzu Flavor",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 51.09,
"quantity": 10,
"sku": "tidalminttablettin"
},
{
"actual_weight": 0.181436948,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 110.04,
"description": "Botanical Body Wash Sheets",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 110.04,
"quantity": 10,
"sku": "tidalbodyrefilltin"
},
{
"actual_weight": 0.0226796185,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 23.58,
"description": "100% Konjac Body Sponge",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 23.58,
"quantity": 20,
"sku": "860008458698"
},
{
"actual_weight": 0.1632932532,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 102.18,
"description": "3 in 1 Face Wash Beans Purifying",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 102.18,
"quantity": 10,
"sku": "tidalfacialrefillgrnt"
},
{
"actual_weight": 0.1632932532,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 102.18,
"description": "3 in 1 Face Wash Beans Calming",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 102.18,
"quantity": 10,
"sku": "tidalfacialrefillwhttin"
},
{
"actual_weight": 0.1632932532,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 102.18,
"description": "3 in 1 Face Wash Beans Brightening",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 102.18,
"quantity": 10,
"sku": "tidalfacialrefillorgt"
},
{
"actual_weight": 0.090718474,
"category": null,
"contains_battery_pi966": null,
"contains_battery_pi967": null,
"contains_liquids": null,
"declared_currency": "HKD",
"declared_customs_value": 51.09,
"description": "Toothpaste Tablets with Fluoride Cinnamon Flavor",
"dimensions": {
"length": 1.27,
"width": 1.27,
"height": 1.27
},
"hs_code": "33049900",
"origin_country_alpha2": "US",
"origin_currency": "HKD",
"origin_customs_value": 51.09,
"quantity": 10,
"sku": "tidalpinktablettin"
}
],
"box": null
}
],
"shipping_settings": {
"units": {
"dimensions": "in",
"weight": "lb"
},
"output_currency": "HKD"
},
"origin_address": {
"city": "2-6 Foo Ming Street, Causeway Bay",
"company_name": "TLE Wellness",
"contact_email": "
[email protected]",
"contact_name": "Genie Cheung",
"contact_phone": "+85297915880",
"country_alpha2": "HK",
"line_1": "2K, Po Ming Building",
"line_2": null,
"postal_code": "0000",
"state": "Hong Kong"
},
"destination_address": {
"state": "Hong Kong",
"postal_code": "0000",
"contact_phone": "+852 6042 2519",
"contact_name": "Bob",
"city": "Wong Chuk Hang",
"contact_email": "[email protected]",
"line_1": "20/F Metro South Tower 1",
"line_2": "39 Wong Chuk Hang Road",
"country_alpha2": "HK"
},
"insurance": {
"is_insured": true,
"insured_currency": "HKD",
"insured_amount": 5659.2
}
}