Tài nguyên shippingsettings cho phép bạn truy xuất và cập nhật chế độ cài đặt thông tin vận chuyển của tài khoản nhiều khách hàng (MCA) và tất cả tài khoản phụ được liên kết với tài khoản đó.
Tài khoản người bán đa năng thường được các đơn vị tích hợp, đơn vị tổng hợp và đối tác kênh sử dụng để quản lý cửa hàng trực tuyến và dịch vụ API cho nhiều người bán. Những người bán có nhiều cửa hàng trực tuyến hoặc thương hiệu được bán trên các trang web riêng biệt cũng có thể chọn sử dụng tài khoản phụ trong một tài khoản nhiều khách hàng.
Google có thể tự động cập nhật thời gian giao hàng dự kiến cho một số sản phẩm. Hãy xem bài viết Bật tính năng tự động cải thiện để biết thêm thông tin chi tiết.
shippingsettings.list
Lệnh gọi shippingsettings.list trả về tất cả thông tin về tài nguyên vận chuyển của một tài khoản hoặc tất cả tài khoản phụ nếu bạn đang xử lý tài khoản nhiều khách hàng.
URL mẫu cho phương thức shippingsettings.list:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings
Sau đây là một phản hồi JSON mẫu cho thấy chế độ cài đặt thông tin vận chuyển cho các tài khoản phụ 1111 và 2222 của một tài khoản MCA:
{
"kind": "content#shippingsettingsListResponse",
"resources": [
{
"accountId": "1111",
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1,
"transitTimeTable": {
"postalCodeGroupNames": [
"Region1",
"Region2",
"all other locations"
],
"transitTimeLabels": [
"all other labels"
],
"rows": [
{
"values": [
{
"minTransitTimeInDays": 1,
"maxTransitTimeInDays": 2
}
]
},
{
"values": [
{
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 3
}
]
},
{
"values": [
{
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 5
}
]
}
]
}
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "0",
"currency": "USD"
}
},
"name": "Standard Shipping"
}
],
"eligibility": "All scenarios"
},
{
"name": "Expedited",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 2,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "9.99",
"currency": "USD"
}
},
"name": "Expedited"
}
],
"eligibility": "All scenarios"
}
],
"postalCodeGroups": [
{
"name": "Region1",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94035",
"postalCodeRangeEnd": "94070"
}
]
},
{
"name": "Region2",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94071",
"postalCodeRangeEnd": "94082"
}
]
}
]
},
{
"accountId": "2222",
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 4,
"maxTransitTimeInDays": 6,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "5.99",
"currency": "USD"
}
},
"name": "All products"
}
],
"eligibility": "All scenarios except Shopping Actions"
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 7,
"minHandlingTimeInDays": 1,
"maxHandlingTimeInDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"value": "49.99",
"currency": "USD"
},
{
"value": "infinity",
"currency": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"value": "6.99",
"currency": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"value": "0",
"currency": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
],
"eligibility": "Shopping Actions"
}
]
}
]
}
shippingsettings.get
Lệnh gọi shippingsettings.get cho phép tài khoản MCA nhận thông tin về chế độ cài đặt thông tin vận chuyển cho một tài khoản phụ hoặc tài khoản độc lập để nhận thông tin về trạng thái tài khoản của chính tài khoản đó.
Sử dụng lệnh gọi sau để nhận thông tin về chế độ cài đặt thông tin vận chuyển, trong đó merchantId là số tài khoản MCA và accountId là tài khoản phụ của tài khoản đó. Nếu tài khoản Merchant Center không phải là tài khoản nhiều khách hàng, shippingsettings.get vẫn có thể trả về thông tin về chế độ cài đặt thông tin vận chuyển. Trong trường hợp này, hãy sử dụng cùng một số tài khoản Merchant Center cho cả tham số merchantId và accountId.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId
Sau đây là một phản hồi JSON mẫu cho một tài khoản phụ có dịch vụ vận chuyển Standard và Expedited được định cấu hình từ tài khoản MCA dùng cho lệnh gọi list:
{
"accountId": "1111",
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1,
"transitTimeTable": {
"postalCodeGroupNames": [
"Region1",
"Region2",
"all other locations"
],
"transitTimeLabels": [
"all other labels"
],
"rows": [
{
"values": [
{
"minTransitTimeInDays": 1,
"maxTransitTimeInDays": 2
}
]
},
{
"values": [
{
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 3
}
]
},
{
"values": [
{
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 5
}
]
}
]
}
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "0",
"currency": "USD"
}
},
"name": "Standard Shipping"
}
],
"eligibility": "All scenarios"
},
{
"name": "Expedited",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 2,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "9.99",
"currency": "USD"
}
},
"name": "Expedited"
}
],
"eligibility": "All scenarios"
}
],
"postalCodeGroups": [
{
"name": "Region1",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94035",
"postalCodeRangeEnd": "94070"
}
]
},
{
"name": "Region2",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94071",
"postalCodeRangeEnd": "94082"
}
]
}
]
}
shippingsettings.update
Lệnh gọi shippingsettings.update cho phép tài khoản MCA cập nhật thông tin về chế độ cài đặt thông tin vận chuyển cho một tài khoản phụ hoặc tài khoản độc lập.
PUT https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId
Sau đây là một phần nội dung yêu cầu JSON mẫu để cập nhật maxTransitTimeInDays thành 7 cho Dịch vụ vận chuyển GSA Shipping - Free Ship Over $49.99 của tài khoản phụ có mã tài khoản là 2222 trong mã người bán MCA là 10.
{
...
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 4,
"maxTransitTimeInDays": 6,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "5.99",
"currency": "USD"
}
},
"name": "All products"
}
],
"eligibility": "All scenarios except Shopping Actions"
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 7,
"minHandlingTimeInDays": 1,
"maxHandlingTimeInDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"value": "49.99",
"currency": "USD"
},
{
"value": "infinity",
"currency": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"value": "6.99",
"currency": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"value": "0",
"currency": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
],
"eligibility": "Shopping Actions"
}
]
}
}
Sau đây là một nội dung phản hồi JSON mẫu:
{
"accountId": "2222",
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 4,
"maxTransitTimeInDays": 6,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "5.99",
"currency": "USD"
}
},
"name": "All products"
}
],
"eligibility": "All scenarios except Shopping Actions"
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 7,
"minHandlingTimeInDays": 1,
"maxHandlingTimeInDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"value": "49.99",
"currency": "USD"
},
{
"value": "infinity",
"currency": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"value": "6.99",
"currency": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"value": "0",
"currency": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
],
"eligibility": "Shopping Actions"
}
]
}
shippingsettings.custombatch
Lệnh gọi shippingsettings.custombatch truy xuất hoặc cập nhật thông tin về chế độ cài đặt thông tin vận chuyển cho nhiều tài khoản phụ của một tài khoản nhiều khách hàng.
Yêu cầu JSON bao gồm merchantId của số tài khoản MCA, accountId của tài khoản phụ, một batchId duy nhất và method được đặt thành get để truy xuất chế độ cài đặt thông tin vận chuyển và update để sửa đổi chế độ cài đặt thông tin vận chuyển.
POST https://shoppingcontent.googleapis.com/content/v2.1/shippingsettings/batch
Nội dung yêu cầu JSON mẫu sau đây có 2 phần:
batchId=1dùng để truy xuất chế độ cài đặt thông tin vận chuyển cho mã tài khoản1111.batchId=2, được dùng để cập nhậtmaxTransitTimeInDaysthành8cho Dịch vụ vận chuyểnGSA Shipping - Free Ship Over $49.99. (Chế độ cài đặt này đã thay đổi từ7cho mã nhận dạng tài khoản2222xuất hiện trong ví dụ về nội dung phản hồi trước choshippingsettings.update).
{
"entries": [
{
"accountId": 1111,
"merchantId": 10,
"method": "get",
"batchId": 1
},
{
"accountId": 2222,
"merchantId": 10,
"method": "update",
"batchId": 2,
"shippingSettings": {
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 4,
"maxTransitTimeInDays": 5,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "5.99",
"currency": "USD"
}
},
"name": "All products"
}
],
"eligibility": "All scenarios except Shopping Actions"
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 8,
"minHandlingTimeInDays": 1,
"maxHandlingTimeInDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"value": "49.99",
"currency": "USD"
},
{
"value": "infinity",
"currency": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"value": "6.99",
"currency": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"value": "0",
"currency": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
],
"eligibility": "Shopping Actions"
}
]
}
}
]
}
Sau đây là một nội dung phản hồi JSON mẫu:
{
"kind": "content#shippingsettingsCustomBatchResponse",
"entries": [
{
"kind": "content#shippingsettingsCustomBatchResponseEntry",
"batchId": 1,
"shippingSettings": {
"accountId": "1111",
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1,
"transitTimeTable": {
"postalCodeGroupNames": [
"Region1",
"Region2",
"all other locations"
],
"transitTimeLabels": [
"all other labels"
],
"rows": [
{
"values": [
{
"minTransitTimeInDays": 1,
"maxTransitTimeInDays": 2
}
]
},
{
"values": [
{
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 3
}
]
},
{
"values": [
{
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 5
}
]
}
]
}
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "0",
"currency": "USD"
}
},
"name": "Standard Shipping"
}
],
"eligibility": "All scenarios"
},
{
"name": "Expedited",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 2,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "9.99",
"currency": "USD"
}
},
"name": "Expedited"
}
],
"eligibility": "All scenarios"
}
],
"postalCodeGroups": [
{
"name": "Region1",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94035",
"postalCodeRangeEnd": "94070"
}
]
},
{
"name": "Region2",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94071",
"postalCodeRangeEnd": "94082"
}
]
}
]
}
},
{
"kind": "content#shippingsettingsCustomBatchResponseEntry",
"batchId": 2,
"shippingSettings": {
"accountId": "2222",
"services": [
{
"name": "FedEx",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 4,
"maxTransitTimeInDays": 5,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 0
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "5.99",
"currency": "USD"
}
},
"name": "All products"
}
],
"eligibility": "All scenarios except Shopping Actions"
},
{
"name": "GSA Shipping - Free Ship Over $49.99",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 8,
"minHandlingTimeInDays": 1,
"maxHandlingTimeInDays": 2
},
"rateGroups": [
{
"mainTable": {
"rowHeaders": {
"prices": [
{
"value": "49.99",
"currency": "USD"
},
{
"value": "infinity",
"currency": "USD"
}
]
},
"rows": [
{
"cells": [
{
"flatRate": {
"value": "6.99",
"currency": "USD"
}
}
]
},
{
"cells": [
{
"flatRate": {
"value": "0",
"currency": "USD"
}
}
]
}
]
},
"name": "Free Ship Over $49.99"
}
],
"eligibility": "Shopping Actions"
}
]
}
}
]
}
shippingsettings.getsupportedcarriers
Lệnh gọi shippingsettings.getsupportedcarriers cho phép tài khoản MCA hoặc tài khoản độc lập nhận được các hãng vận chuyển được hỗ trợ.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedCarriers
Sau đây là một nội dung phản hồi JSON mẫu:
{
"kind": "content#shippingsettingsGetSupportedCarriersResponse",
"carriers": [
{
"name": "FedEx",
"country": "US",
"services": [
"Ground",
"Home Delivery",
"Express Saver",
"First Overnight",
"Priority Overnight",
"Standard Overnight",
"2Day"
]
},
{
"name": "UPS",
"country": "US",
"services": [
"2nd Day Air",
"2nd Day Air AM",
"3 Day Select",
"Ground",
"Next Day Air",
"Next Day Air Early AM",
"Next Day Air Saver"
]
},
{
"name": "USPS",
"country": "US",
"services": [
"Priority Mail Express",
"Media Mail",
"Retail Ground",
"Priority Mail",
"First Class Package Service Retail",
"First Class Package Service Commercial Base"
]
},
{
"name": "Australia Post",
"country": "AU",
"services": [
"Regular Parcel",
"Express Post"
]
},
{
"name": "TNT",
"country": "AU",
"services": [
"Road Express",
"Overnight Express"
]
},
{
"name": "TOLL",
"country": "AU",
"services": [
"Road Delivery",
"Overnight Priority"
]
},
{
"name": "DHL",
"country": "DE",
"services": [
"Paket",
"Päckchen"
]
},
{
"name": "DPD",
"country": "DE",
"services": [
"Express 12",
"Express",
"Classic Parcel"
]
},
{
"name": "Hermes",
"country": "DE",
"services": [
"Päckchen",
"Paketklasse S",
"Paketklasse M",
"Paketklasse L"
]
},
{
"name": "UPS",
"country": "DE",
"services": [
"Express",
"Express Saver",
"Standard"
]
},
{
"name": "DHL UK",
"country": "GB",
"services": [
"Express",
"Express 12"
]
},
{
"name": "DPD UK",
"country": "GB",
"services": [
"Express 12",
"Express Next Day",
"Standard Parcel 12",
"Standard Parcel Next Day",
"Standard Parcel Two Day"
]
},
{
"name": "RMG",
"country": "GB",
"services": [
"1st Class Small Parcel",
"1st Class Medium Parcel",
"2nd Class Small Parcel",
"2nd Class Medium Parcel"
]
},
{
"name": "TNT UK",
"country": "GB",
"services": [
"Express",
"Express 10",
"Express 12"
]
},
{
"name": "UPS UK",
"country": "GB",
"services": [
"Express",
"Express Saver",
"Standard"
]
},
{
"name": "Yodel",
"country": "GB",
"services": [
"B2C 48HR",
"B2C 72HR",
"B2C Packet"
]
}
]
}
shippingsettings.getsupportedholidays
Lệnh gọi shippingsettings.getsupportedholidays cho phép tài khoản MCA hoặc tài khoản độc lập truy xuất các ngày lễ được hỗ trợ.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedHolidays
Sau đây là một phản hồi JSON mẫu:
{
"kind": "content#shippingsettingsGetSupportedHolidaysResponse",
"holidays": [
{
"id": "FR_Christmas_2019-12-25",
"countryCode": "FR",
"type": "Christmas",
"date": "2019-12-25",
"deliveryGuaranteeDate": "2019-12-24",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Easter_2019-04-21",
"countryCode": "US",
"type": "Easter",
"date": "2019-04-21",
"deliveryGuaranteeDate": "2019-04-20",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Mother's Day_2019-05-12",
"countryCode": "US",
"type": "Mother's Day",
"date": "2019-05-12",
"deliveryGuaranteeDate": "2019-05-11",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Father's Day_2019-06-16",
"countryCode": "US",
"type": "Father's Day",
"date": "2019-06-16",
"deliveryGuaranteeDate": "2019-06-15",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Independence Day (USA)_2019-07-04",
"countryCode": "US",
"type": "Independence Day (USA)",
"date": "2019-07-04",
"deliveryGuaranteeDate": "2019-07-03",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Halloween_2019-10-31",
"countryCode": "US",
"type": "Halloween",
"date": "2019-10-31",
"deliveryGuaranteeDate": "2019-10-30",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Thanksgiving_2019-11-28",
"countryCode": "US",
"type": "Thanksgiving",
"date": "2019-11-28",
"deliveryGuaranteeDate": "2019-11-27",
"deliveryGuaranteeHour": "18"
},
{
"id": "US_Christmas_2019-12-25",
"countryCode": "US",
"type": "Christmas",
"date": "2019-12-25",
"deliveryGuaranteeDate": "2019-12-24",
"deliveryGuaranteeHour": "18"
}
]
}
Thiết lập nhóm mã bưu chính
Mặc dù bạn có thể dễ dàng tạo khu vực trong Merchant Center, nhưng hãy sử dụng Content API để duy trì các tài khoản có nhiều khu vực thường xuyên thay đổi.
Dịch vụ Chế độ cài đặt thông tin vận chuyển cho phép bạn đặt, nhận và cập nhật chế độ cài đặt thông tin vận chuyển cũng như khu vực. Trong API, các khu vực được gọi là postalCodeGroups.
"postalCodeGroups": [
{
"name": "string,
"country": string,
"postalCodeRanges": [
{
"postalCodeRangeBegin": string,
"postalCodeRangeEnd": string
}
]
}
]
Như trong giao diện người dùng, postalCodeGroups là một danh sách đơn giản gồm mã bưu chính, dải mã bưu chính, tiền tố mã bưu chính hoặc dải tiền tố.
Vì các khu vực được truy xuất và thiết lập cùng với chế độ cài đặt thông tin vận chuyển, nên chỉ việc điền postalCodeGroups thông qua tài nguyên Chế độ cài đặt thông tin vận chuyển hiện có mới xoá các dịch vụ vận chuyển.
Sau đây là cách thiết lập khu vực phù hợp thông qua API:
- Thực hiện lệnh gọi
getđể truy xuất tất cả dịch vụ vận chuyển vàpostalCodeGroups(khu vực). - Sao chép dịch vụ vận chuyển từ lệnh gọi
getsang lệnh gọiupdate. Xoá mục sau đây khỏi nội dung yêu cầu nếu bạn không sử dụng nhãn thời gian vận chuyển trong dịch vụ vận chuyển:
"transitTimeLabels": [ "all other labels" ],Điền thông tin về các khu vực trong phần
postalCodeGroupscho lệnh gọiupdate.Thực hiện lệnh gọi
updatekhi cả dịch vụ vận chuyển vàpostalCodeGroupsđều được điền sẵn.
Sau đây là nội dung yêu cầu gọi update mẫu từ ví dụ get đầu tiên được dùng ở trên với postalCodeGroups cho Khu vực 1 được cập nhật từ 94035 thành 94036:
{
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1,
"transitTimeTable": {
"postalCodeGroupNames": [
"Region1",
"Region2",
"all other locations"
],
"rows": [
{
"values": [
{
"minTransitTimeInDays": 1,
"maxTransitTimeInDays": 2
}
]
},
{
"values": [
{
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 3
}
]
},
{
"values": [
{
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 5
}
]
}
]
}
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "0",
"currency": "USD"
}
},
"name": "Standard Shipping"
}
],
"eligibility": "All scenarios"
},
{
"name": "Expedited",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 2,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "9.99",
"currency": "USD"
}
},
"name": "Expedited"
}
],
"eligibility": "All scenarios"
}
],
"postalCodeGroups": [
{
"name": "Region1",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94036",
"postalCodeRangeEnd": "94070"
}
]
},
{
"name": "Region2",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94071",
"postalCodeRangeEnd": "94082"
}
]
}
]
}
Sau đây là một phản hồi JSON mẫu:
{
"accountId": "1111",
"services": [
{
"name": "Standard Shipping",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1,
"transitTimeTable": {
"postalCodeGroupNames": [
"Region1",
"Region2",
"all other locations"
],
"rows": [
{
"values": [
{
"minTransitTimeInDays": 1,
"maxTransitTimeInDays": 2
}
]
},
{
"values": [
{
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 3
}
]
},
{
"values": [
{
"minTransitTimeInDays": 3,
"maxTransitTimeInDays": 5
}
]
}
]
}
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "0",
"currency": "USD"
}
},
"name": "Standard Shipping"
}
],
"eligibility": "All scenarios"
},
{
"name": "Expedited",
"active": true,
"deliveryCountry": "US",
"currency": "USD",
"deliveryTime": {
"minTransitTimeInDays": 2,
"maxTransitTimeInDays": 2,
"minHandlingTimeInDays": 0,
"maxHandlingTimeInDays": 1
},
"rateGroups": [
{
"singleValue": {
"flatRate": {
"value": "9.99",
"currency": "USD"
}
},
"name": "Expedited"
}
],
"eligibility": "All scenarios"
}
],
"postalCodeGroups": [
{
"name": "Region1",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94036",
"postalCodeRangeEnd": "94070"
}
]
},
{
"name": "Region2",
"country": "US",
"postalCodeRanges": [
{
"postalCodeRangeBegin": "94071",
"postalCodeRangeEnd": "94082"
}
]
}
]
}
Sử dụng điểm đến lấy hàng
Để biết thêm thông tin về đơn đặt hàng tự đến lấy/đến lấy tại điểm đến lấy hàng, bao gồm cả điểm khác biệt giữa đơn đặt hàng tự đến lấy/đến lấy tại điểm đến lấy hàng và đơn đặt hàng giao hàng tận nhà, cũng như thông tin cụ thể về đơn đặt hàng tự đến lấy/đến lấy tại điểm đến lấy hàng cần được xử lý, hãy xem hướng dẫn về Đơn đặt hàng tự đến lấy/đến lấy tại điểm đến lấy hàng.
Giao hàng trong ngày
Bạn có thể sử dụng Content API for Shopping để thiết lập dịch vụ vận chuyển giao hàng trong ngày nếu có kho hàng tại địa phương.
Dịch vụ vận chuyển giao hàng trong ngày có local_delivery là shipmentType. Hiện tại, tất cả dịch vụ vận chuyển local_delivery đều được coi là dịch vụ giao hàng trong ngày. Bạn không thể thay đổi thông tin deliveryTime cho dịch vụ giao hàng tại địa phương.
Sử dụng shippingsettings.update để thiết lập dịch vụ giao hàng trong ngày cho các sản phẩm trong kho hàng tại địa phương.
Dưới đây là một mẫu nội dung yêu cầu thêm dịch vụ giao hàng trong ngày cho tất cả các cửa hàng trong tài khoản của bạn:
Cập nhật tất cả các giá trị trong mẫu sau trước khi sử dụng trong quá trình triển khai.
{
"accountId":"accountId",
"services":[
{
"name": "Local Delivery",
"active":true,
"shipmentType":"local_delivery",
"deliveryCountry":"US",
"currency":"USD",
"rateGroups":[
{
"singleValue":{
"flatRate":{
"value":"0",
"currency":"USD"
}
}
}
],
"eligibility":"All scenarios",
"storeConfig":{
"storeServiceType":"all stores",
"storeCodes":[
],
"cutoffConfig":{
"storeCloseOffsetHours":2,
"no_delivery_post_cutoff":true
},
"serviceRadius":{
"value":4,
"unit":"Miles"
}
}
}
]
}Giao hàng ngày hôm sau
Theo mặc định, những đơn đặt hàng được đặt sau hạn chót giao hàng trong ngày sẽ được lên lịch giao hàng vào ngày tiếp theo. Để tắt tính năng giao hàng vào ngày tiếp theo, hãy đặt no_delivery_post_cutoff thành true. Nếu bạn tắt dịch vụ giao hàng vào ngày tiếp theo, thì dịch vụ vận chuyển của bạn sẽ chỉ xuất hiện trước thời gian ngừng nhận đơn đặt hàng mỗi ngày.
Dịch vụ giao hàng vào ngày tiếp theo chỉ được cung cấp khi shipmentType là local_delivery.
Thử nghiệm
Vì tất cả các mục đều đang được sản xuất, nên bạn cần cẩn thận để tránh thay đổi bất kỳ thông tin quan trọng nào trên các mục đang hoạt động, đặc biệt là với phương thức update() vì đây là phương thức duy nhất thay đổi các giá trị hiện có.