Descripción general de la configuración de envío

El ShippingSettings te permite recuperar y actualizar la configuración de envío de tu cuenta.

Nota: El recurso shippingsettings no funciona para la configuración de envío que se creó. mediante la vinculación de cuentas o la carga manual del historial de seguimiento de pedidos. Los que las opciones de envío no se devolverán, modificarán ni borrarán con las llamadas a extremo.

Google puede actualizar automáticamente el tiempo de entrega estimado de algunos productos. Para obtener más información, consulta Habilita las actualizaciones automáticas mejoras continuas.

Lee, escribe o actualiza la configuración de envío

Para usar el servicio de envío de la API de Merchant Center, sigue estos pasos:

1. Haz una solicitud GET para recuperar la configuración de envío completa de tu de servicio predeterminada.
2. Modifica la configuración de envío.
3. Realiza una solicitud INSERT con la configuración de envío modificada.

ETag

Etag es un token codificado para evitar las actualizaciones asíncronas. La ETag cambia cuando algún cambio en la configuración de envío. Los usuarios deben copiar la ETag que que se obtiene de la solicitud GET al cuerpo de la solicitud INSERT.

Si los datos de la configuración de envío cambian entre la solicitud de GET y el INSERT recibirás un mensaje de error en el que se te solicitará otra solicitud de GET para recuperar el token de ETag más reciente Debes llamar a la solicitud de GET a Recupera el nuevo token de ETag y cópialo en la solicitud INSERT cuerpo.

Agrega tu configuración de envío

Usa shippingsettings.insert para agregar o actualizar la configuración de envío de tu de servicio predeterminada. A continuación, se muestra una solicitud de ejemplo que actualiza maxTransitDays a 7 para una Servicio de envío llamado Envío deGSA: envío gratuito de más de USD 49.99, bajo la cuenta

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

Importante: El cuerpo de la solicitud INSERT debe contener el cuerpo completo de los recursos de el recurso shippingsettings, incluso si solo estás actualizando un único , ya que cualquier valor NULL o faltante en el cuerpo de la solicitud generará valores existentes que se anulen.

Establecer almacenes

En el siguiente ejemplo de JSON, se indica cómo usar la configuración de envío del comercio para administrar la información del almacén de tu cuenta 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"
      ]
    }
  }
]

Reemplaza lo siguiente:

• {street_address}: Es la parte de la dirección del almacén a nivel de la calle.
• {city}: Es la ciudad, el pueblo o el comuna donde se encuentra el almacén.
• {administrative_area}: Es la subdivisión administrativa de la país. Por ejemplo, un estado.
• {postal_code}: Es el código postal.
• {region_code}: Es el código de país en la cadena.
• {minutes}: Parte de los minutos del horario límite hasta el que un el pedido debe realizarse para que el almacén lo procese el mismo día.
• {handling_days}: Es la cantidad de días que tarda esto. almacén para empacar y enviar un artículo.

El recurso warehouses es una lista de almacenes. Cada almacén puede ser según el tiempo de entrega en el almacén del servicio de envío warehouse.name

Administra tus almacenes

Aquí te mostramos cómo usar la API de Merchant Center para administrar tus almacenes:

1. Realiza una solicitud GET para recuperar todos tus archivos shippingsettings existentes y y almacenes de datos.

2. Copia el shippingsettings de la solicitud GET a la solicitud UPDATE.

   Nota: Si no copias todos los objetos shippingsettings existentes, se borrarán. de tu cuenta en la solicitud INSERT.

3. Propaga los almacenes si deseas usarlos en la sección warehouses. para la solicitud INSERT.

4. Realiza una solicitud UPDATE que contenga shippingsettings y warehouses. de Google Cloud.

A continuación, se muestra un cuerpo de solicitud de INSERT de muestra con el almacén actualizado para el Warehouse 1 de Nueva York a 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"
        }
      ]
    }
  ]
}

Agregar entrega en el mismo día

Puedes usar Content API for Shopping para configurar el envío con entrega el mismo día. y servicios si tienes un inventario local. Los servicios de envío con entrega el mismo día tienen local_delivery como su shipment_type. Todos los gastos de envío de local_delivery de servicios se consideran entregas en el mismo día.

No puedes cambiar la información de delivery_time para las entregas locales. Usa shippingsettings.insert para configurar la entrega el mismo día para tu inventario local productos.

Este es un ejemplo de cuerpo de solicitud que agrega un servicio de entrega el mismo día a todas las tiendas. para tu cuenta:

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

Agregar entrega al día siguiente

Los pedidos realizados después del horario límite de entrega el mismo día están programados para la siguiente con entrega diaria de forma predeterminada. Para desactivar la entrega al día siguiente, configura la no_delivery_post_cutoff como verdadero. Si desactivas la entrega al día siguiente, solo pueden ver los servicios de envío antes de la hora límite todos los días.

La entrega al día siguiente solo está disponible cuando shipment_type local_delivery

Más información

Para obtener más información sobre cómo migrar desde Content API for Shopping, consulta Cómo migrar los envíos. administración de configuración.