- Representación JSON
- Servicio
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Día hábil
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Tabla
- Encabezados
- Peso
- WeightUnit
- LocationIdSet
- Fila
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distancia
- Unidad
- LoyaltyProgram
- LoyaltyProgramTiers
- Depósito
- Dirección
- WarehouseCutoffTime
La [configuración de envío](https://support.google.com/merchants/answer/6069284) de la cuenta del comerciante.
Representación JSON |
---|
{ "name": string, "services": [ { object ( |
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la configuración de envío. Formato: |
services[] |
Opcional. La lista de servicios de la cuenta de destino. |
warehouses[] |
Opcional. Una lista de almacenes a los que se puede hacer referencia en |
etag |
Obligatorio. Este campo se utiliza para evitar problemas asíncronos. Asegúrate de que los datos de la configuración de envío no hayan cambiado entre las llamadas get y insert. El usuario debe seguir estos pasos:
|
Servicio
Servicio de envío.
Representación JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campos | |
---|---|
deliveryCountries[] |
Obligatorio. Es el código de territorio CLDR de los países a los que se aplica el servicio. |
rateGroups[] |
Opcional. Definiciones de grupos de tarifas de envío Solo la última puede tener un |
loyaltyPrograms[] |
Opcional. Programas de lealtad a los que se limita este servicio de envío. |
serviceName |
Obligatorio. Es el nombre del servicio en formato libre. Debe ser único en la cuenta de destino. |
active |
Obligatorio. Es un valor booleano que expone el estado activo del servicio de envío. |
currencyCode |
Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con los precios de los grupos de tarifas. |
deliveryTime |
Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto. |
shipmentType |
Es el tipo de ubicaciones a las que este servicio envía pedidos. |
minimumOrderValue |
Es el valor mínimo de pedido de este servicio. Si se establece, indica que los clientes deberán invertir, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede establecer junto conminimumOrderValueTable. |
minimumOrderValueTable |
Tabla de los valores de pedido mínimos por tienda para el tipo de entrega de retiro. No se puede establecer junto conminimumOrderValue. |
storeConfig |
Es una lista de tiendas en las que se entregan tus productos. Esto solo es válido para el tipo de envío con entrega local. |
DeliveryTime
Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.
Representación JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campos | |
---|---|
warehouseBasedDeliveryTimes[] |
Opcional. Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se configura, no se debe establecer ningún otro campo relacionado con el tiempo en tránsito en [tiempo de entrega][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
minTransitDays |
Es la cantidad mínima de días hábiles en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Se debe configurar |
maxTransitDays |
Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Debe ser mayor o igual que |
cutoffTime |
Definición de la hora límite de los días hábiles. Si no se configura, se establecerá la hora límite de forma predeterminada a las 8 a.m. PST. |
minHandlingDays |
Indica la cantidad mínima de días hábiles invertidos antes de que se envíe un pedido. 0 significa envío el mismo día, 1 significa envío al día siguiente. |
maxHandlingDays |
Es la cantidad máxima de días hábiles invertidos antes de que se envíe un pedido. 0 significa envío el mismo día, 1 significa envío al día siguiente. Debe ser mayor o igual que |
transitTimeTable |
Tabla de tiempo en tránsito, que corresponde a la cantidad de días hábiles que se pasaron en tránsito según las dimensiones de filas y columnas. Se puede configurar |
handlingBusinessDayConfig |
Los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se asumirán los días hábiles de lunes a viernes. |
transitBusinessDayConfig |
Los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se asumirán los días hábiles de lunes a viernes. |
CutoffTime
Definición de la hora límite de los días hábiles.
Representación JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
minute |
Obligatorio. Minuto del horario límite hasta el que se debe realizar un pedido para que se procese el mismo día. |
timeZone |
Obligatorio. Identificador de la zona horaria Por ejemplo, "Europa/Zúrich". |
TransitTable
Tabla de tiempo en tránsito, que corresponde a la cantidad de días hábiles que se pasaron en tránsito según las dimensiones de filas y columnas. Se puede configurar minTransitDays
, maxTransitDays
o transitTimeTable
, pero no ambos.
Representación JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Campos | |
---|---|
postalCodeGroupNames[] |
Obligatorio. Una lista de nombres de regiones |
transitTimeLabels[] |
Obligatorio. Es una lista de etiquetas de tiempo en tránsito. El último valor puede ser |
rows[] |
Obligatorio. Si solo hay un conjunto de dimensiones de |
TransitTimeRow
Si solo hay un conjunto de dimensiones de postalCodeGroupNames
o transitTimeLabels
, hay varias filas, cada una con un valor para esa dimensión. Si hay dos dimensiones, cada fila corresponde a una postalCodeGroupNames
y las columnas (valores) a una transitTimeLabels
.
Representación JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[] |
Obligatorio. Es el intervalo de tiempo en tránsito (mín.-máx.) en días hábiles. |
TransitTimeValue
Es el intervalo de tiempo en tránsito (mín.-máx.) en días hábiles.
Representación JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Campos | |
---|---|
minTransitDays |
Intervalo de tiempo mínimo en tránsito en días hábiles. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. |
maxTransitDays |
Debe ser mayor o igual que |
BusinessDayConfig
Días hábiles del depósito
Representación JSON |
---|
{
"businessDays": [
enum ( |
Campos | |
---|---|
businessDays[] |
Obligatorio. Días hábiles normales. No puede estar vacío. |
Día de semana
Enumeraciones | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe establecer ningún otro campo relacionado con el tiempo en tránsito en deliveryTime
.
Representación JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Campos | |
---|---|
carrier |
Obligatorio. Proveedor, como |
carrierService |
Obligatorio. Servicio del operador, como |
warehouse |
Obligatorio. Nombre del almacén. Debería coincidir con [warehouse][ShippingSetting.warehouses.name]. |
RateGroup
Definiciones de grupos de tarifas de envío Solo la última puede tener un applicableShippingLabels
vacío, que significa "todo lo demás". Los otros applicableShippingLabels
no deben superponerse.
Representación JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campos | |
---|---|
applicableShippingLabels[] |
Obligatorio. Una lista de etiquetas de envío que definen los productos a los que se aplica este grupo de tarifas. Esta es una disyunción: solo una de las etiquetas debe coincidir para que se aplique el grupo de tarifas. Solo puede estar vacío para el último grupo de tarifas de un servicio. |
subtables[] |
Opcional. Una lista de tablas secundarias a las que hace referencia |
carrierRates[] |
Opcional. Una lista de tarifas de empresas de transporte a las que se puede hacer referencia mediante |
singleValue |
Es el valor del grupo de tarifas (por ejemplo, una tarifa plana de USD 10). Solo se puede establecer si no se configuran |
mainTable |
Una tabla que define el grupo de tarifas, cuando |
name |
Opcional. Nombre del grupo de tarifas. Si se configura debe ser único dentro del servicio de envío. |
Valor
El valor único de un grupo de tarifas o el valor de la celda de la tabla de un grupo de tarifas. Se debe establecer exactamente uno de los siguientes valores: noShipping
, flatRate
, pricePercentage
, carrier_rateName
o subtable_name
.
Representación JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Campos | |
---|---|
noShipping |
Si es "true", el producto no se puede enviar. Debe ser verdadera cuando se establece; solo se puede establecer si no se establecen todos los demás campos. |
flatRate |
Una tarifa plana. Solo se puede establecer si no están configurados todos los demás campos. |
pricePercentage |
Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, |
carrierRate |
Es el nombre de la tarifa de una empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede establecer si no están configurados todos los demás campos. |
subtable |
Es el nombre de una tabla secundaria. Solo se puede establecer en las celdas de la tabla (por ejemplo, no para valores individuales) y solo si no se configuran todos los demás campos. |
Tabla
Una tabla que define el grupo de tarifas, cuando singleValue
no es lo suficientemente expresivo.
Representación JSON |
---|
{ "rows": [ { object ( |
Campos | |
---|---|
rows[] |
Obligatorio. Es la lista de filas que constituyen la tabla. Debe tener la misma longitud que |
name |
Nombre de la tabla. Obligatorio para las tablas secundarias; se ignora para la tabla principal. |
rowHeaders |
Obligatorio. Encabezados de las filas de la tabla. |
columnHeaders |
Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla tiene solo una dimensión. |
Encabezados
Una lista no vacía de encabezados de filas o columnas de una tabla. Se debe establecer exactamente uno de los siguientes valores: prices
, weights
, num_items
, postalCodeGroupNames
o location
.
Representación JSON |
---|
{ "prices": [ { object ( |
Campos | |
---|---|
prices[] |
Obligatorio. Una lista de los límites superiores del precio del pedido inclusivo. El valor del último precio puede ser infinito si se establece la cantidad de precios en micros = -1. Por ejemplo, |
weights[] |
Obligatorio. Una lista de los límites superiores del peso de orden inclusivo. El último valor del peso puede ser infinito si se establece priceMicros = -1. Por ejemplo, |
numberOfItems[] |
Obligatorio. Una lista de los límites superiores de la cantidad inclusiva de elementos. El último valor puede ser |
postalCodeGroupNames[] |
Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser |
locations[] |
Obligatorio. Es una lista de conjuntos de ID de ubicación. No puede estar vacío. Solo se puede establecer si no están configurados todos los demás campos. |
Peso
El peso representado como el valor en la cadena y en la unidad.
Representación JSON |
---|
{
"unit": enum ( |
Campos | |
---|---|
unit |
Obligatorio. La unidad de peso. Los valores aceptables son: kg y lb. |
amountMicros |
Obligatorio. El peso representado como un número en micros (1 millón de micros equivale a la unidad estándar monetaria de uno, por ejemplo, 1 kg = 1,000,000 micros). Este campo también se puede establecer como infinito si se establece en -1. Este campo solo admite -1 y valor positivo. |
WeightUnit
La unidad de peso.
Enumeraciones | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unidad sin especificar |
POUND |
lb. |
KILOGRAM |
kg. |
LocationIdSet
Es una lista de conjuntos de ID de ubicación. No puede estar vacío. Solo se puede establecer si no están configurados todos los demás campos.
Representación JSON |
---|
{ "locationIds": [ string ] } |
Campos | |
---|---|
locationIds[] |
Obligatorio. Una lista no vacía de IDs de ubicación. Todas deben ser del mismo tipo de ubicación (por ejemplo, estado). |
Fila
Incluye una lista de celdas.
Representación JSON |
---|
{
"cells": [
{
object ( |
Campos | |
---|---|
cells[] |
Obligatorio. Lista de celdas que constituyen la fila. Debe tener la misma longitud que |
CarrierRate
Una lista de tarifas de empresas de transporte a las que se puede hacer referencia mediante mainTable
o singleValue
.
Representación JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Campos | |
---|---|
name |
Obligatorio. Indica el nombre de la tarifa de la empresa de transporte. Debe ser único por grupo de tarifas. |
carrier |
Obligatorio. Servicio del operador, como |
carrierService |
Obligatorio. Servicio del operador, como |
originPostalCode |
Obligatorio. Origen de envío para esta tarifa de empresa de transporte. |
percentageAdjustment |
Opcional. Modificador de tarifa de envío multiplicativa como un número en notación decimal. Puede ser negativo. Por ejemplo, |
flatAdjustment |
Opcional. Modificador aditivo de tarifa de envío. Puede ser negativo. Por ejemplo, |
ShipmentType
Es el tipo de envío del servicio de envío.
Enumeraciones | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Este servicio no especificó el tipo de envío. |
DELIVERY |
Este servicio envía los pedidos a una dirección elegida por el cliente. |
LOCAL_DELIVERY |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde una tienda local cercana. |
COLLECTION_POINT |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde un punto de recolección. |
MinimumOrderValueTable
Tabla de los valores de pedido mínimos por tienda para el tipo de entrega de retiro.
Representación JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campos | |
---|---|
storeCodeSetWithMovs[] |
Obligatorio. Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de pedido (MOV) Se requieren al menos dos conjuntos y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda. |
StoreCodeSetWithMov
Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de pedido. Se requieren al menos dos conjuntos y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda.
Representación JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Una lista de códigos de tienda únicos o vacía para la genérica. |
value |
Es el valor mínimo de pedido para las tiendas determinadas. |
StoreConfig
Es una lista de tiendas en las que se entregan tus productos. Esto solo es válido para el tipo de envío con entrega local.
Representación JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Una lista de códigos de tienda que ofrecen entrega local. Si está vacío, |
storeServiceType |
Indica si todas las tiendas o las tiendas seleccionadas que aparecen en este comercio ofrecen entrega local. |
cutoffConfig |
Las configuraciones relacionadas con la entrega local finalizan el día. |
serviceRadius |
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío con entrega local. |
StoreServiceType
Indica si todas las tiendas, o las tiendas seleccionadas, indicadas por el comercio, ofrecen entrega local.
Enumeraciones | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
No se especificó el tipo de servicio de tienda. |
ALL_STORES |
Indica si todas las tiendas, actuales y futuras, de este comercio, ofrecen servicio de entrega local. |
SELECTED_STORES |
Indica que solo las tiendas que aparecen en storeCodes son aptas para la entrega local. |
CutoffConfig
Las configuraciones relacionadas con la entrega local finalizan el día.
Representación JSON |
---|
{
"localCutoffTime": {
object ( |
Campos | |
---|---|
localCutoffTime |
Hora a la que finaliza la entrega local ese día. |
storeCloseOffsetHours |
Solo es válido con la entrega de entregas locales. Representa el horario límite como la cantidad de horas antes del cierre de la tienda. Este campo y |
noDeliveryPostCutoff |
Los comercios pueden inhabilitar la opción de entrega local n + 1 día si tienen un servicio de envío configurado para la entrega local en n días. Por ejemplo, si el servicio de envío define la entrega el mismo día y ya pasó la hora límite, establecer este campo en |
LocalCutoffTime
Hora a la que finaliza la entrega local ese día.
Representación JSON |
---|
{ "hour": string, "minute": string } |
Campos | |
---|---|
hour |
Los pedidos con entrega local a la hora deben realizarse hasta el mismo día para que se procesen. |
minute |
Los pedidos con entrega local de minutos deben hacerse antes para que se procesen el mismo día. |
Distancia
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío con entrega local.
Representación JSON |
---|
{
"value": string,
"unit": enum ( |
Campos | |
---|---|
value |
Valor entero de la distancia. |
unit |
La unidad puede variar según el país, se parametriza para incluir millas y kilómetros. |
Unidad
La unidad puede variar según el país, se parametriza para incluir millas y kilómetros.
Enumeraciones | |
---|---|
UNIT_UNSPECIFIED |
Unidad sin especificar |
MILES |
Unidad en millas |
KILOMETERS |
Unidad en kilómetros |
LoyaltyProgram
Programa de lealtad proporcionado por un comercio.
Representación JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Campos | |
---|---|
loyaltyProgramTiers[] |
Opcional. Es el nivel del programa de lealtad de este servicio de envío. |
programLabel |
Es la etiqueta del programa de lealtad que se estableció en la configuración de tu programa de lealtad en Merchant Center. Este atributo secundario permite que Google asigne tu programa de lealtad a las ofertas aptas. |
LoyaltyProgramTiers
Subconjunto de un programa de lealtad de comercios.
Representación JSON |
---|
{ "tierLabel": string } |
Campos | |
---|---|
tierLabel |
El atributo secundario etiqueta de nivel [tierLabel] diferencia los beneficios del nivel de oferta entre cada nivel. Este valor también se establece en la configuración del programa en Merchant Center y es obligatorio para realizar cambios en la fuente de datos, incluso si tu programa de lealtad solo tiene 1 nivel. |
Almacén
Un almacén de entrega, que almacena y maneja inventario Siguiente etiqueta: 7
Representación JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campos | |
---|---|
name |
Obligatorio. El nombre del almacén Debe ser único en la cuenta. |
shippingAddress |
Obligatorio. Dirección de envío del almacén. |
cutoffTime |
Obligatorio. El último momento del día en que se puede aceptar un pedido y comenzar a procesarse. Los pedidos posteriores se procesarán al día siguiente. La hora se basa en el código postal del almacén. |
handlingDays |
Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se encuentra a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo. |
businessDayConfig |
Días hábiles del depósito Si no la estableces, será de lunes a viernes de forma predeterminada. |
Dirección
Dirección de envío del almacén.
Representación JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Campos | |
---|---|
streetAddress |
Parte de la dirección a nivel de la calle Por ejemplo: |
city |
Obligatorio. Ciudad, pueblo o comuna. También puede incluir localidades o sublocalidades dependientes (por ejemplo, vecindarios o suburbios). |
administrativeArea |
Obligatorio. Subdivisión administrativa de nivel superior del país. Por ejemplo, puede ser un estado como California ("CA") o una provincia como Quebec ("QC"). |
postalCode |
Obligatorio. Es el código postal (por ejemplo, “94043”). |
regionCode |
Obligatorio. Código de país de CLDR (por ejemplo, “US”). |
WarehouseCutoffTime
El último momento del día en que se puede aceptar un pedido y comenzar a procesarse. Los pedidos posteriores se procesarán al día siguiente. La hora se basa en el código postal del almacén.
Representación JSON |
---|
{ "hour": integer, "minute": integer } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora límite hasta la que se debe realizar un pedido para que el almacén lo procese el mismo día. La hora se basa en la zona horaria del almacén. |
minute |
Obligatorio. Minuto del horario límite hasta el que se debe realizar un pedido para que el almacén lo procese el mismo día. El minuto se basa en la zona horaria del almacén. |