Esta página foi traduzida pela API Cloud Translation.

Visão geral das configurações de frete

O recurso shippingsettings permite recuperar e atualizar as configurações de frete da sua conta.

O Google pode atualizar automaticamente o tempo de entrega estimado de alguns produtos. Para mais informações, consulte Ativar melhorias automáticas.

Ler, gravar ou atualizar as configurações de frete

Para usar o serviço de frete da API Merchant, faça o seguinte:

Faça uma solicitação GET para recuperar as configurações de frete completas da sua conta.
Modifique as configurações de frete.
Faça uma solicitação INSERT com as configurações de frete modificadas.

ETag

Etag é um token codificado para evitar atualizações assíncronas. A etag muda quando qualquer um dos dados de configurações de frete é alterado. Os usuários precisam copiar a ETag recebida da solicitação GET para o corpo da solicitação INSERT.

Se os dados das configurações de frete mudarem entre as solicitações GET e INSERT, você receberá uma mensagem de erro solicitando outra solicitação GET para recuperar o token ETag mais recente. É necessário chamar a solicitação GET para recuperar o novo token ETag e copiá-lo para o corpo da solicitação INSERT.

Adicione suas configurações de frete

Use shippingsettings.insert para adicionar ou atualizar as configurações de frete da sua conta. Veja um exemplo de solicitação que atualiza o maxTransitDays para 7 em um serviço de frete chamado Frete do GGS - Frete grátis acima de US $49,99, na conta 10.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

Definir warehouses

O exemplo JSON a seguir mostra como usar o serviço de configurações de frete do comerciante para gerenciar as informações do depósito da sua conta de comerciante:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

Substitua:

{street_address}: parte da rua do endereço do armazém.
{city}: cidade ou município onde o armazém está localizado.
{administrative_area}: a subdivisão administrativa do país. Por exemplo, um estado.
{postal_code}: o código postal ou CEP.
{region_code}: o código do país na string.
{minutes}: minutos parte do horário limite em que um pedido precisa ser feito para ser processado no mesmo dia pelo armazém.
{handling_days}: o número de dias que esse armazém leva para empacotar e enviar um item.

O recurso warehouses é uma lista de warehouses. Cada armazém pode ser indicado pelo tempo de entrega baseado em armazém do serviço de frete por meio de warehouse.name.

Gerencie seus armazéns

Saiba como usar a API Merchant para gerenciar seus warehouses:

Faça uma solicitação GET para recuperar todos os shippingsettings e armazéns existentes.
Copie o shippingsettings da solicitação GET para a solicitação UPDATE.

Observação :se você não copiar todos os shippingsettings atuais, eles serão excluídos da sua conta na solicitação INSERT.
Preencha os warehouses se quiser usá-los na seção warehouses para a solicitação INSERT.
Faça uma solicitação UPDATE que contenha os recursos shippingsettings e warehouses.

Confira um exemplo de corpo da solicitação INSERT com warehouse para o Warehouse 1 atualizado de Nova York para Mountain View:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

Adicionar entrega no mesmo dia

Use a API Content for Shopping para configurar serviços de frete de entrega no mesmo dia se você tiver inventário local. Os serviços de frete com entrega no mesmo dia têm local_delivery como shipment_type. Neste momento, todos os serviços de frete local_delivery são considerados entregas no mesmo dia.

Não é possível mudar as informações do delivery_time para entregas locais. Use shippingsettings.insert para configurar a entrega no mesmo dia dos seus produtos de inventário local.

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

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

Adicionar entrega no dia seguinte

Por padrão, os pedidos feitos após o horário limite para entrega no mesmo dia são programados para entrega no dia seguinte. Para desativar a entrega no dia seguinte, defina o campo no_delivery_post_cutoff como "true". Se você desativar a entrega no dia seguinte, seus serviços de frete só ficarão visíveis antes do horário limite todos os dias.

A entrega no dia seguinte está disponível apenas quando o shipment_type é local_delivery.