Panoramica delle impostazioni di spedizione

La risorsa shippingsettings consente di recuperare e aggiornare le impostazioni di spedizione del tuo account.

Nota: la risorsa shippingsettings non funziona per le impostazioni di spedizione create tramite collegamento degli account o caricamento manuale della cronologia relativa al monitoraggio degli ordini. Queste impostazioni di spedizione non verranno restituite, modificate o eliminate dalle chiamate a questo endpoint.

Google può aggiornare automaticamente i tempi di consegna stimati per alcuni prodotti. Per maggiori informazioni, consulta la pagina Abilitare i miglioramenti automatici.

Leggere, scrivere o aggiornare le impostazioni di spedizione

Per utilizzare il servizio di spedizione dell'API Merchant Center:

1. Effettua una richiesta GET per recuperare le impostazioni di spedizione complete del tuo account.
2. Modifica le impostazioni di spedizione.
3. Effettua una richiesta INSERT con le impostazioni di spedizione modificate.

ETag

Etag è un token codificato per evitare aggiornamenti asincroni. L'etag cambia ogni volta che viene modificata una delle impostazioni di spedizione. Gli utenti devono copiare l'etag che hanno ottenuto dalla richiesta GET al corpo della richiesta INSERT.

Se i dati delle impostazioni di spedizione cambiano tra la richiesta GET e la richiesta INSERT, ricevi un messaggio di errore che richiede un'altra richiesta GET per recuperare il token etag più recente. Devi chiamare la richiesta GET per recuperare il nuovo token etag e copiare il nuovo token etag nel corpo della richiesta INSERT.

Aggiungi le tue impostazioni di spedizione

Utilizza shippingsettings.insert per aggiungere o aggiornare le impostazioni di spedizione per il tuo account. Ecco una richiesta di esempio che aggiorna maxTransitDays in 7 per un servizio di spedizione denominato GSA Shipping - Free Ship Over $49,99, nell'account 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"
        }
      ]
    }
  ]
}

Importante: il corpo della richiesta INSERT deve contenere l'intero corpo della risorsa shippingsettings anche se stai semplicemente aggiornando un singolo attributo, in quanto qualsiasi valore NULL o valore mancante nel corpo della richiesta comporta l'annullamento dei valori esistenti.

Imposta warehouse

Il seguente esempio JSON mostra come utilizzare il servizio per le impostazioni di spedizione del commerciante per gestire le informazioni sul magazzino per il tuo account commerciante:

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

Sostituisci quanto segue:

• {street_address}: parte a livello stradale dell'indirizzo del magazzino.
• {city}: città, paese o comune in cui si trova il magazzino.
• {administrative_area}: la suddivisione amministrativa del paese. Ad esempio, uno stato.
• {postal_code}: il codice postale.
• {region_code}: il codice paese nella stringa.
• {minutes}: minuti parte dell'orario limite entro il quale deve essere effettuato un ordine per essere elaborato nello stesso giorno dal magazzino.
• {handling_days}: il numero di giorni impiegati dal magazzino per imballare e spedire un articolo.

La risorsa warehouses è un elenco di warehouse. Ogni magazzino può essere indicato in base ai tempi di consegna basati sul magazzino del servizio di spedizione fino al giorno warehouse.name.

Gestire i warehouse

Ecco come utilizzare l'API Merchant Center per gestire i tuoi magazzini:

1. Effettua una richiesta GET per recuperare tutti i shippingsettings e i magazzini esistenti.

2. Copia shippingsettings dalla richiesta GET alla richiesta UPDATE.

   Nota: se non copi tutti i shippingsettings esistenti, questi verranno eliminati dal tuo account nella richiesta INSERT.

3. Completa i warehouse se vuoi utilizzarli nella sezione warehouses per la richiesta INSERT.

4. Effettua una richiesta UPDATE che contenga le risorse shippingsettings e warehouses.

Ecco un esempio di corpo della richiesta INSERT con warehouse per Warehouse 1 aggiornato da New 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"
        }
      ]
    }
  ]
}

Aggiungi la consegna in giornata

Puoi utilizzare l'API Content for Shopping per configurare i servizi di spedizione con consegna in giornata se hai un inventario locale. I servizi di spedizione con consegna in giornata hanno local_delivery come shipment_type. Al momento tutti i servizi di spedizione di local_delivery sono considerati consegne in giornata.

Non puoi modificare le informazioni su delivery_time per le consegne locali. Utilizza shippingsettings.insert per configurare la consegna in giornata per i tuoi prodotti di inventario locale.

Ecco un esempio di corpo della richiesta che aggiunge un servizio di consegna in giornata a tutti i negozi per il tuo account:

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

Aggiungi la consegna il giorno successivo

Per impostazione predefinita, gli ordini emessi dopo l'orario limite per la consegna in giornata vengono programmati per la consegna il giorno successivo. Per disattivare la consegna il giorno successivo, imposta il campo no_delivery_post_cutoff su true. Se disattivi la consegna il giorno successivo, i tuoi servizi di spedizione sono visibili ogni giorno solo prima dell'orario limite.

La consegna il giorno successivo è disponibile solo quando shipment_type costa local_delivery.