Configurações de frete

A shippingsettings você pode recuperar e atualizar as configurações de frete dos seus serviços (MCA) e todas as subcontas associadas a ela.

As MCAs geralmente são usadas por integradores, agregadores e parceiros de canal que gerenciar lojas on-line e serviços de API para vários comerciantes. Comerciantes que têm Várias lojas ou marcas on-line que são vendidas em sites distintos também podem escolher ter subcontas em uma única MCA.

O Google pode atualizar automaticamente o tempo de entrega estimado de alguns produtos. Consulte Ativar notificações de IA generativa para saber mais detalhes.

shippingsettings.list

A chamada shippingsettings.list retorna todas as informações de recursos de frete de uma conta ou todas as subcontas, se você estiver lidando com uma MCA.

URL de exemplo para o método shippingsettings.list:

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings

Veja a seguir um exemplo de resposta JSON que mostra as configurações de frete para subcontas 1111 e 2222 de uma 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

A chamada shippingsettings.get permite que uma MCA receba o frete informações de configurações de uma única subconta ou de uma conta independente as informações de status da própria conta.

Use a seguinte chamada para obter as configurações de frete em que merchantId é o número da MCA e accountId é a subconta. Se a conta do Merchant Center não for de múltiplos clientes, shippingsettings.get ainda pode devolver as informações de configurações de frete. Neste caso, use o mesmo número de conta do Merchant Center para merchantId e Parâmetros accountId.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

Confira a seguir um exemplo de resposta JSON para uma subconta com um Standard e o serviço de frete Expedited configurado na MCA usada para o Chamada do 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

A chamada shippingsettings.update permite que uma MCA atualize o informações das configurações de frete para uma única subconta ou para uma conta independente.

PUT https://shoppingcontent.googleapis.com/content/v2.1/merchantId/shippingsettings/accountId

Confira a seguir um exemplo de corpo de solicitação JSON para atualizar o maxTransitTimeInDays para 7 para o serviço de frete GSA Shipping - Free Ship Over $49.99 de subconta com o ID 2222, no ID de mercado da MCA de 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"
     
}
   
]
 
}
}

Veja a seguir um exemplo de corpo de resposta JSON:

{
 
"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

A chamada shippingsettings.custombatch recupera ou atualiza as configurações de frete informações de diversas subcontas de uma conta de múltiplos clientes.

A solicitação JSON inclui o merchantId do número da MCA, o accountId da subconta, um batchId exclusivo, e o method definido como get para recuperar as configurações de frete e update para modificar o frete configurações.

POST https://shoppingcontent.googleapis.com/content/v2.1/shippingsettings/batch

O corpo da solicitação JSON de exemplo a seguir tem duas partes:

  1. O batchId=1 usado para recuperar as configurações de frete do ID da conta 1111.
  2. O batchId=2, usado para atualizar o maxTransitTimeInDays para 8 para Serviço de frete GSA Shipping - Free Ship Over $49.99. Essa configuração era alterado de 7 para o ID da conta 2222 mostrado no corpo da resposta anterior exemplo para shippingsettings.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"
         
}
       
]
     
}
   
}
 
]
}

Veja a seguir um exemplo de corpo de resposta JSON:

{
 
"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

A chamada shippingsettings.getsupportedcarriers permite que uma MCA ou uma conta independente para saber as operadoras compatíveis.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedCarriers

Veja a seguir um exemplo de corpo de resposta JSON:

{
 
"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

A chamada shippingsettings.getsupportedholidays permite que uma MCA ou uma conta independente para recuperar feriados compatíveis.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/supportedHolidays

Confira a seguir um exemplo de resposta JSON:

{
 
"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"
 
}
 
]
}

Definir grupos de CEPs

Embora seja conveniente criar regiões no Merchant Center, use a API Content manter contas em várias regiões que mudam com frequência.

O serviço de configurações de frete permite definir, receber e atualizar configurações e regiões de frete. Na API, são chamadas de postalCodeGroups.

"postalCodeGroups": [
 
{
   
"name": "string,
   
"country": string,
   
"postalCodeRanges": [
     
{
       
"postalCodeRangeBegin": string,
       
"postalCodeRangeEnd": string
     
}
   
]
 
}
]

Como na interface, postalCodeGroups é uma lista simples de códigos postais, intervalos de endereços IP, prefixos de códigos postais ou intervalos de prefixos.

Como as regiões são recuperadas e definidas com as configurações de frete, somente preenchendo o postalCodeGroups usando o Configurações de frete recurso exclui os serviços de frete.

Veja a seguir a maneira correta de configurar regiões usando a API:

  1. Faça uma chamada get para recuperar todos os serviços de frete e postalCodeGroups (regiões).
  2. Copie os serviços de frete da chamada get para update.
  3. Remova a entrada a seguir do corpo da solicitação se você não usa o transporte público. rótulos de horário no seu serviço de frete:

    "transitTimeLabels": [
       
    "all other labels"
    ],
  4. Preencha as regiões na seção postalCodeGroups para a chamada update.

  5. Faça a chamada update com os serviços de frete e postalCodeGroups seções preenchidas.

Veja a seguir um exemplo de corpo de solicitação de chamada update do primeiro exemplo de get usado acima com postalCodeGroups para a Região 1 atualizado de 94035 para 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"
       
}
     
]
   
}
 
]
}

Confira a seguir um exemplo de resposta JSON:

{
 
"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"
   
}
   
]
 
}
 
]
}

Usar pontos de coleta/retirada

Para mais informações sobre pedidos para retirada/ponto de coleta, incluindo como eles diferem dos pedidos de entrega em casa e quais informações específicas de retirada precisam ser processados, consulte a Guia de pontos de retirada/coleta.

Entrega no mesmo dia

Use a API Content for Shopping para configurar os serviços de entrega no mesmo dia se você tiver produtos locais inventário.

Os serviços de frete de entrega no mesmo dia têm local_delivery como shipmentType. No momento, todos os serviços de frete de local_delivery são considerados entregas no mesmo dia. Não é possível mudar as informações de deliveryTime para entregas locais.

Usar shippingsettings.update se quiser configurar a entrega no mesmo dia para seus produtos de inventário local.

Veja um exemplo de corpo de solicitação que adiciona um serviço de entrega no mesmo dia a todas as lojas para sua conta:

Atualize todos os valores no exemplo a seguir antes de usá-los na sua implementação.

{
   
"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"
           
}
         
}
     
}
   
]
}

Entrega no dia seguinte

Os pedidos feitos após o horário limite para entrega no mesmo dia estão programados para a próxima por padrão. Para desativar a entrega no dia seguinte, defina no_delivery_post_cutoff para true. Se você desativar a entrega no dia seguinte, seu os serviços de frete só ficam visíveis antes do horário limite todos os dias.

A entrega no dia seguinte só vai estar disponível quando shipmentType for local_delivery.

Teste

Como todos os itens estão em produção, tenha cuidado para evitar alterações nada importante em itens ativos, especificamente com a update(). porque esse é o único que altera os valores existentes.