- Recurso: ShippingSettings
- 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
- Métodos
Recurso: ShippingSettings
La configuración de envío de la cuenta de comerciante
Representación JSON |
---|
{ "name": string, "services": [ { object ( |
Campos | |
---|---|
name |
Identificador. Es 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. Es una lista de almacenes a los que se puede hacer referencia en |
etag |
Obligatorio. Este campo se usa para evitar problemas asíncronos. Asegúrate de que los datos de configuración de envío no hayan cambiado entre la llamada de Get y la llamada de Insert. El usuario debe seguir los siguientes pasos:
|
Servicio
Servicio de envío
Representación JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campos | |
---|---|
delivery |
Obligatorio. Es el código de territorio de CLDR de los países a los que se aplica el servicio. |
rate |
Opcional. Definiciones de grupos de tarifas de envío Solo el último puede tener un |
loyalty |
Opcional. Programas de lealtad a los que se limita este servicio de envío |
service |
Obligatorio. Es el nombre del servicio de 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. |
currency |
Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con el de los precios de los grupos de tarifas. |
delivery |
Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto. |
shipment |
Es el tipo de ubicaciones a las que este servicio envía pedidos. |
minimum |
Es el valor mínimo del pedido para este servicio. Si se establece, indica que los clientes deberán gastar, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede establecer junto con minimumOrderValueTable. |
minimum |
Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro en tienda. No se puede establecer junto con minimumOrderValue. |
store |
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local. |
DeliveryTime
Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.
Representación JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campos | |
---|---|
warehouse |
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 establece, no se debe configurar ningún otro campo relacionado con el tiempo en tránsito en [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
min |
Es la cantidad mínima de días hábiles que se tarda en el envío. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Se debe configurar |
max |
Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. Debe ser mayor o igual que |
cutoff |
Definición del horario límite de los días hábiles. Si no se configura, la hora límite se establecerá de forma predeterminada a las 8 a.m. (PST). |
min |
Es la cantidad mínima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. "minHandlingDays" y "maxHandlingDays" deben configurarse o no al mismo tiempo. |
max |
Es la cantidad máxima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. Debe ser mayor o igual que |
transit |
Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de fila y columna Se puede configurar |
handling |
Son los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se supondrán los días hábiles de lunes a viernes. |
transit |
Son los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se supondrán los días hábiles de lunes a viernes. |
CutoffTime
Definición del horario límite de los días hábiles.
Representación JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
minute |
Obligatorio. Es el minuto del horario límite hasta el que se debe realizar un pedido para que se procese el mismo día. |
time |
Obligatorio. Identificador de zona horaria. Por ejemplo, "Europe/Zurich". |
TransitTable
Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de fila y columna Se puede configurar minTransitDays
, maxTransitDays
o transitTimeTable
, pero no ambos.
Representación JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Campos | |
---|---|
postal |
Obligatorio. Es una lista de nombres de regiones |
transit |
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 un postalCodeGroupNames
y las columnas (valores) a un transitTimeLabels
.
Representación JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[] |
Obligatorio. Es el intervalo de tiempo en tránsito (mínimo-máximo) en días hábiles. |
TransitTimeValue
Es el intervalo de tiempo en tránsito (mínimo-máximo) en días hábiles.
Representación JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Campos | |
---|---|
min |
Es el intervalo mínimo del tiempo en tránsito en días hábiles. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. |
max |
Debe ser mayor o igual que |
BusinessDayConfig
Son los días hábiles del almacén.
Representación JSON |
---|
{
"businessDays": [
enum ( |
Campos | |
---|---|
business |
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 de tránsito en deliveryTime
.
Representación JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Campos | |
---|---|
carrier |
Obligatorio. Operador, como |
carrier |
Obligatorio. Servicio de operador, como |
warehouse |
Obligatorio. Es el nombre del almacén. Debe coincidir con [warehouse][ShippingSetting.warehouses.name] |
RateGroup
Definiciones de grupos de tarifas de envío Solo el último puede tener un applicableShippingLabels
vacío, lo que significa "todo lo demás". El otro applicableShippingLabels
no debe superponerse.
Representación JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campos | |
---|---|
applicable |
Obligatorio. Es 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. Es una lista de tablas secundarias a las que hace referencia |
carrier |
Opcional. Es una lista de tarifas de operadores a las que se puede hacer referencia con |
single |
Es el valor del grupo de tarifas (por ejemplo, tarifa plana de USD 10). Solo se puede configurar si no se establecen |
main |
Una tabla que define el grupo de tarifas, cuando |
name |
Opcional. Es el nombre del grupo de tarifas. Si se establece, debe ser único dentro del servicio de envío. |
Valor
Es el valor único de un grupo de tarifas o el valor de la celda de una tabla de grupos de tarifas. Se debe configurar exactamente uno de los siguientes valores: noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
.
Representación JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Campos | |
---|---|
no |
Si es verdadero, el producto no se puede enviar. Debe ser verdadero cuando se establece y solo se puede establecer si no se establecieron todos los demás campos. |
flat |
Una tarifa plana Solo se puede configurar si no se establecieron todos los demás campos. |
price |
Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, |
carrier |
Es el nombre de una tarifa de la empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede configurar si no se establecieron todos los demás campos. |
subtable |
Es el nombre de una tabla secundaria. Solo se puede establecer en celdas de 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 conforman la tabla. Debe tener la misma longitud que |
name |
Es el nombre de la tabla. Obligatorio para las tablas secundarias, se ignora para la tabla principal. |
row |
Obligatorio. Encabezados de las filas de la tabla. |
column |
Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla solo tiene una dimensión. |
Encabezados
Es una lista no vacía de encabezados de fila o columna 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 de precios de los pedidos inclusivos. El valor del último precio puede ser infinito si se establece price amountMicros = -1. Por ejemplo, |
weights[] |
Obligatorio. Es una lista de límites superiores del peso del pedido inclusivo. El valor del último peso puede ser infinito si se establece price amountMicros = -1. Por ejemplo, |
number |
Obligatorio. Es una lista de los límites superiores inclusivos de la cantidad de elementos. El último valor puede ser |
postal |
Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser |
locations[] |
Obligatorio. Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se establecieron todos los demás campos. |
Peso
Es el peso representado como el valor en cadena y la unidad.
Representación JSON |
---|
{
"unit": enum ( |
Campos | |
---|---|
unit |
Obligatorio. La unidad de peso. Los valores aceptables son: kg y lb |
amount |
Obligatorio. Es el peso representado como un número en micros (1 millón de micros equivale a la unidad estándar de la moneda, por ejemplo, 1 kg = 1000000 micros). Este campo también se puede establecer como infinito si se establece en -1. Este campo solo admite -1 y valores positivos. |
WeightUnit
La unidad de peso.
Enumeraciones | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unidad no especificada |
POUND |
unidad de lb. |
KILOGRAM |
unidad de kg. |
LocationIdSet
Es una lista de conjuntos de IDs de ubicación. No debe estar vacío. Solo se puede configurar si no se establecieron todos los demás campos.
Representación JSON |
---|
{ "locationIds": [ string ] } |
Campos | |
---|---|
location |
Obligatorio. Es una lista no vacía de IDs de ubicación. Todos 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. Es la lista de celdas que conforman la fila. Debe tener la misma longitud que |
CarrierRate
Es una lista de tarifas de operadores a las que se puede hacer referencia con mainTable
o singleValue
. Los servicios de operadores admitidos se definen en https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
Representación JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Campos | |
---|---|
name |
Obligatorio. Es el nombre de la tarifa del transportista. Debe ser único por cada grupo de tarifas. |
carrier |
Obligatorio. Servicio de operador, como |
carrier |
Obligatorio. Servicio de operador, como |
origin |
Obligatorio. Es el origen de envío para esta tarifa del transportista. |
percentage |
Opcional. Es el modificador multiplicativo de la tarifa de envío como un número en notación decimal. Puede ser negativo. Por ejemplo, |
flat |
Opcional. Es un modificador aditivo de la 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 |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. |
LOCAL_DELIVERY |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde una tienda local cercana. |
COLLECTION_POINT |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. El pedido se envía desde un punto de recolección. |
MinimumOrderValueTable
Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro en tienda.
Representación JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campos | |
---|---|
store |
Obligatorio. Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del 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
Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del 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 | |
---|---|
store |
Opcional. Es una lista de códigos de tienda únicos o vacía para la opción de todo. |
value |
Es el valor mínimo del pedido para las tiendas determinadas. |
StoreConfig
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local.
Representación JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Campos | |
---|---|
store |
Opcional. Es una lista de códigos de tienda que proporcionan entrega local. Si está vacío, |
store |
Indica si todas las tiendas, o las seleccionadas, que figuran en la ficha de este comercio ofrecen entrega local. |
cutoff |
Las configuraciones relacionadas con la entrega local finalizan por el día. |
service |
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local. |
StoreServiceType
Indica si todas las tiendas o las tiendas seleccionadas que enumera el comercio ofrecen entrega local.
Enumeraciones | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
No se especificó el tipo de servicio de la tienda. |
ALL_STORES |
Indica si todas las tiendas, actuales y futuras, que enumera este comercio proporcionan entrega local. |
SELECTED_STORES |
Indica que solo las tiendas que se indican en storeCodes son aptas para la entrega local. |
CutoffConfig
Las configuraciones relacionadas con la entrega local finalizan por el día.
Representación JSON |
---|
{
"localCutoffTime": {
object ( |
Campos | |
---|---|
local |
Hora en la que finaliza la entrega local del día. |
store |
Solo es válido con la entrega local. Representa la hora límite como la cantidad de horas antes del cierre de la tienda. Este campo y |
no |
Los comercios pueden inhabilitar la opción de mostrar la entrega local en n+1 días cuando 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, si configuras este campo como |
LocalCutoffTime
Hora en la que finaliza la entrega local del día.
Representación JSON |
---|
{ "hour": string, "minute": string } |
Campos | |
---|---|
hour |
Hora límite para realizar pedidos de entrega local para que se procesen el mismo día. |
minute |
Los pedidos de entrega local en minutos deben realizarse antes de esta hora para que se procesen el mismo día. |
Distancia
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local.
Representación JSON |
---|
{
"value": string,
"unit": enum ( |
Campos | |
---|---|
value |
Es el valor de número entero de la distancia. |
unit |
La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros. |
Unidad
La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros.
Enumeraciones | |
---|---|
UNIT_UNSPECIFIED |
Unidad no especificada |
MILES |
Unidad en millas |
KILOMETERS |
Unidad en kilómetros |
LoyaltyProgram
Programa de lealtad que proporciona un comercio.
Representación JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Campos | |
---|---|
loyalty |
Opcional. Es el nivel del programa de lealtad de este servicio de envío. |
program |
Es la etiqueta del programa de lealtad establecida 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
Es un subconjunto de un programa de lealtad de comercios.
Representación JSON |
---|
{ "tierLabel": string } |
Campos | |
---|---|
tier |
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 hacer 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 controla el inventario.
Representación JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campos | |
---|---|
name |
Obligatorio. El nombre del almacén Debe ser único en la cuenta. |
shipping |
Obligatorio. Es la dirección de envío del almacén. |
cutoff |
Obligatorio. Es la hora del día más tardía a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén. |
handling |
Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se aplica a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo. |
business |
Son los días hábiles del almacén. Si no se establece, será de lunes a viernes de forma predeterminada. |
Dirección
Es la dirección de envío del almacén.
Representación JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Campos | |
---|---|
street |
Es la 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). |
administrative |
Obligatorio. Es la subdivisión administrativa principal del país. Por ejemplo, un estado como California ("CA") o una provincia como Quebec ("QC"). |
postal |
Obligatorio. Código postal (por ejemplo, “94043”). |
region |
Obligatorio. Código de país de CLDR (por ejemplo, “US”). |
WarehouseCutoffTime
Es la hora del día más tardía a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén.
Representación JSON |
---|
{ "hour": integer, "minute": integer } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora del horario 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. Es el minuto del horario límite hasta el cual 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. |
Métodos |
|
---|---|
|
Recupera información de la configuración de envío. |
|
Reemplaza la configuración de envío de un comercio por la configuración de envío de la solicitud. |