Dizionario dei dati di migrazione del negozio
Il dizionario dei dati di migrazione del negozio include informazioni sulle risorse Customer
, Order
e Product
dell'Admin API REST. Il dizionario rappresenta un riferimento aggiuntivo per i Partner esperti che effettuano la migrazione di negozi a Shopify.
Customer
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa Customer
dell'Admin API REST.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo | Accesso al campo | Campo obbligatorio cruciale |
---|---|---|---|---|---|---|
accepts_marketing | Default: 0 | Indica se il cliente ha accettato di ricevere materiale di marketing. | Boolean | tinyint(1) | Y | |
accepts_marketing_ updated_at |
La data e l'ora in formato ISO 8601 in cui il cliente ha accettato di ricevere materiale di marketing via email o vi si è opposto. | DateTime | Indirizzi | Un elenco degli indirizzi associati al cliente. | [{ Address }] | |
valuta | Il codice di tre lettere in formato ISO 4217 della valuta utilizzata dal cliente per il pagamento del suo ultimo ordine. | String | Shop's currency | read-only | ||
created_at | Default: NULL | La data e l'ora in formato ISO 8601 in cui il cliente è stato aggiunto al negozio. | DateTime | datetime | read-only | |
default_address | L'indirizzo predefinito del cliente. | { Address } | ||||
Default: NULL | L'indirizzo email univoco del cliente. | String | varchar(255) | |||
first_name | Default: NULL | Il nome del cliente. | String | varchar(255) | ||
ID | Default: NULL | Un identificatore univoco a livello globale (questo valore si incrementa automaticamente). | Integer | bigint(20) | Y | |
last_name | Default: NULL | Il cognome del cliente. | String | varchar(255) | ||
last_order_id | Default: NULL | L'ID dell'ultimo ordine del cliente. | Integer | bigint(20) | read-only | |
last_order_name | Default: NULL | Il nome dell'ultimo ordine del cliente. | String | read-only | ||
metafield | Default: NULL | Restituisce un metafield che appartiene alla risorsa in base allo spazio dei nomi e alla chiave. | { Metafield } | |||
marketing_opt_ in_level |
|
Il livello di consenso esplicito per l'iscrizione al marketing (come descritto dalle linee guida sulle best practice di M3AAWG) indicato dal cliente quando ha accettato di ricevere materiale di marketing via email. | String, enum | |||
multipass_identifier | Default: NULL | Un identificatore univoco del cliente utilizzato per l'accesso con Multipass. | String | varchar(255) | ||
Nota | Default: NULL | Una nota sul cliente. | String | mediumtext | ||
orders_count | Default: 0 | Il numero totale di ordini effettuati dal cliente nel negozio. | Integer | int(11) | read-only | |
Telefono | Default: NULL | Il numero di telefono (formato E.164) univoco (nel negozio) per questo cliente. | String | varchar(255) | ||
sms_marketing_ consent |
Default: NULL | Lo stato attuale del marketing via SMS per il numero di telefono del cliente. | String | |||
state |
|
Lo stato dell'account del cliente nel negozio. | String, enum | varchar(255) | read-only | |
tag | Default: NULL | Un elenco separato da virgole costituito da un massimo di 250 tag aggiunti al cliente. | String | 255 per tag | ||
tax_exempt | Default: 0 | Indica se il cliente ha diritto all'esenzione dalle imposte sui propri ordini. | Boolean | tinyint(1) | Y | |
tax_exemptions | Consulta la risorsa Customer per un elenco completo dei valori. | L'elenco di esenzioni fiscali applicate al cliente. | String | |||
total_spent | Default: 0 | L'importo totale speso dal cliente per tutti gli ordini, indicato nella valuta del negozio. Se utilizzi più valute, l'importo viene mostrato nella valuta predefinita senza il tasso di cambio. | Number | decimal(21,3) | read-only | |
updated_at | La data e l'ora dell'ultimo aggiornamento del cliente, basate sul fuso orario del negozio. | DateTime | datetime | read-only | ||
verified_email | Default: 1 | Indica se il cliente ha verificato il suo indirizzo email. Il valore predefinito è true se il cliente viene creato tramite l'API o il pannello di controllo Shopify. | Boolean | tinyint(1) | read-only |
CustomerAddress
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa CustomerAddress
dell'Admin API REST. Non sono presenti campi obbligatori cruciali per questa risorsa.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo | Accesso al campo |
---|---|---|---|---|---|
address1 | Default: NULL | Gli indirizzi di posta del cliente, 100 per account cliente. | String | varchar(255) | |
address2 | Default: NULL | Un campo aggiuntivo per l'indirizzo di posta del cliente. | String | varchar(255) | |
city | Default: NULL | La città, la località o il borgo del cliente. | String | varchar(255) | |
company | Default: NULL | L'azienda del cliente. | String | varchar(255) | |
Nazione | Default: NULL | Paese del cliente. | String | varchar(255) | |
first_name | Default: NULL | Il nome del cliente. | String | varchar(255) | |
country_code | Il codice paese di due lettere corrispondente al paese del cliente. | String | read-only | ||
country_name | Il nome normalizzato del paese del cliente. | String | |||
last_name | Default: NULL | Il cognome del cliente. | String | varchar(255) | |
name | Nome e cognome del cliente. | String | |||
Telefono | Default: NULL | Il numero di telefono del cliente a questo indirizzo. | String | varchar(255) | |
province | Default: NULL | Il nome dell'area geografica del cliente. In genere, una provincia, uno stato o una prefettura. | String | varchar(255) | |
province_code | Il codice di due lettere dell'area geografica del cliente. | String | read-only | ||
CAP | Default: NULL | Il codice postale del cliente, noto anche come CAP, ZIP, Eircode, ecc. | String | varchar(255) |
Order
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa Order
dell'Admin API REST.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo | Accesso al campo | Campo obbligatorio cruciale |
---|---|---|---|---|---|---|
app_id | Default: NULL | L'ID dell'app che ha creato l'ordine. | numero intero | bigint(20) | read-only | |
billing_address | Default: NULL | L'indirizzo di posta associato al metodo di pagamento. Questo indirizzo è un campo facoltativo che non sarà disponibile per gli ordini che non richiedono un metodo di pagamento. | numero intero | bigint(20) | ||
browser_ip | L'indirizzo IP del browser utilizzato dal cliente quando ha effettuato l'ordine. Sia IPv4 che IPv6 sono supportati. | stringa | varchar(255) | read-only | ||
buyer_accepts_marketing | Default: 0 | Indica se il cliente ha accettato di ricevere aggiornamenti via email dal negozio. | boolean | tinyint(1) | ||
cancel_reason |
|
La ragione per cui l'ordine è stato annullato. | stringa | varchar(255) | ||
cancelled_at | Default: NULL | La data e l'ora in cui l'ordine è stato annullato. Restituisce null se l'ordine non viene annullato. | date | datetime | read-only | |
cart_token | Default: NULL | Un valore univoco per fare riferimento al carrello associato all'ordine. | stringa | varchar(255) | read-only | |
checkout_token | Default: NULL | Un valore univoco per fare riferimento al check-out associato all'ordine. | stringa | varchar(64) | read-only | |
client_details |
|
Informazioni sul browser utilizzato dal cliente quando ha effettuato l'ordine: accept_language: le lingue e le impostazioni locali accettate dal browser. browser_height: l'altezza dello schermo del browser in pixel, se disponibile. browser_ip: l'indirizzo IP del browser. browser_width: la larghezza dello schermo del browser in pixel, se disponibile. session_hash: un hash della sessione. user_agent: dettagli del client di navigazione, inclusi il software e le versioni operative. |
object | read-only | ||
closed_at | Default: NULL | La data e l'ora (formato ISO 8601) in cui l'ordine è stato chiuso. Restituisce null se l'ordine non viene chiuso. | date | datetime | read-only | |
created_at | Default: NULL | La data e l'ora (formato ISO 8601) di creazione dell'ordine in Shopify generate automaticamente. Il valore di questa proprietà non può essere modificato. | date | datetime(6) | read-only | |
valuta | Default: NULL | Il codice di tre lettere (formato ISO 4217) della valuta del negozio. | stringa | char(3) | ||
current_subtotal_price | Il prezzo subtotale attuale dell'ordine nella valuta del negozio. Il valore di questo campo riflette le modifiche, i resi e i rimborsi degli ordini. | stringa | varchar(255) | read-only | ||
current_subtotal_price_set | Il prezzo subtotale attuale dell'ordine nelle valute del negozio e di presentazione. I valori di importo associati a questo campo riflettono le modifiche, i resi e i rimborsi degli ordini. | object | read-only | |||
current_total_discounts | Gli sconti totali attuali dell'ordine nella valuta del negozio. Il valore di questo campo riflette le modifiche, i resi e i rimborsi degli ordini. | stringa | varchar(255) | read-only | ||
current_total_discounts_set | Gli sconti totali attuali dell'ordine nelle valute del negozio e di presentazione. I valori di importo associati a questo campo riflettono le modifiche, i resi e i rimborsi degli ordini. | object | read-only | |||
current_total_duties_set | I dazi totali attuali applicati all'ordine nelle valute del negozio e di presentazione. I valori di importo associati a questo campo riflettono le modifiche, i resi e i rimborsi degli ordini. | object | read-only | |||
current_total_price | Il prezzo totale attuale dell'ordine nella valuta del negozio. Il valore di questo campo riflette le modifiche, i resi e i rimborsi degli ordini. | stringa | varchar(255) | read-only | ||
current_total_price_set | Il prezzo totale attuale dell'ordine nelle valute del negozio e di presentazione. I valori di importo associati a questo campo riflettono le modifiche, i resi e i rimborsi degli ordini. | object | read-only | |||
current_total_tax | Le imposte totali attuali applicate all'ordine nelle valute del negozio e di presentazione. Il valore di questo campo riflette le modifiche, i resi o i rimborsi degli ordini. | stringa | varchar(255) | read-only | ||
current_total_tax_set | Le imposte totali attuali applicate all'ordine nelle valute del negozio e di presentazione. I valori di importo associati a questo campo riflettono le modifiche, i resi e i rimborsi degli ordini. | object | read-only | |||
cliente | Default: NULL | Informazioni sul cliente. L'ordine potrebbe non avere un cliente e le app non devono dipendere dall'esistenza di un oggetto cliente. Questo valore potrebbe essere nullo se l'ordine è stato creato tramite Shopify POS. | numero intero | bigint(20) | ||
customer_locale | Default: NULL | Il codice della lingua composto da due o tre lettere, seguito eventualmente da un modificatore di area geografica. | stringa | varchar(255) | read-only | |
discount_applications | Un elenco ordinato di applicazioni di sconto in pila. La proprietà discount_applications include tre tipi: discount_code, manual e script. Condividono tutti e tre una struttura comune e presentano attributi specifici del tipo. |
matrice | read-only | |||
discount_codes | Un elenco di sconti applicati all'ordine. | matrice | ||||
Indirizzo email del cliente. | varchar(255) | |||||
estimated_taxes | Indica se le imposte sull'ordine sono stimate. Tra il momento in cui un cliente effettua un ordine e il momento in cui l'ordine viene spedito, possono cambiare diversi fattori e ciò potrebbe influire sul calcolo delle imposte. Questa proprietà restituisce false quando le imposte sull'ordine sono finalizzate e non sono soggette a modifiche. | boolean | tinyint(1) | |||
financial_status |
|
Lo stato dei pagamenti associati all'ordine. Può essere impostato solo al momento della creazione dell'ordine. | stringa | varchar(255) | read-only | |
fulfillment_status |
|
Lo stato dell'ordine in termini di voci evase. | stringa | varchar(255) | ||
evasione ordini | Una matrice di evasioni associate all'ordine. | matrice | ||||
ID | Default: NULL | L'ID dell'ordine, utilizzato per scopi API. È diverso dalla proprietà order_number, che è l'ID utilizzato dal proprietario del negozio e dal cliente. | numero intero | bigint(20) | read-only | |
landing_site | Default: NULL | L'URL della pagina visualizzata dall'acquirente quando è entrato nel negozio. | stringa | varchar(4096) | read-only | |
line_items | Un elenco di oggetti voce, ciascuno dei quali contiene informazioni su una voce dell'ordine. | matrice | Y | |||
location_id | Default: NULL | L'ID della sede fisica in cui è stato elaborato l'ordine. Se devi fare riferimento alla sede rispetto a un ordine, utilizza la risorsa FulfillmentOrder. | numero intero | bigint(20) | ||
name | Default: NULL | Il nome dell'ordine, generato combinando la proprietà order_number con il prefisso e il suffisso dell'ordine stabiliti nelle impostazioni generali del merchant. Si tratta di un valore diverso dalla proprietà ID, che è l'ID dell'ordine utilizzato dall'API. Questo campo può anche essere impostato dall'API su qualsiasi valore di stringa. | stringa | varchar(255) | ||
Nota | Default: NULL | Una nota facoltativa che il proprietario del negozio può allegare all'ordine. | stringa | |||
note_attributes | Default: NULL | Ulteriori informazioni aggiunte all'ordine. Viene visualizzato nella sezione Ulteriori dettagli della pagina dei dettagli di un ordine. Ogni elemento della matrice deve contenere un hash con chiavi del nome e del valore. | stringa | |||
numero | Default: NULL | La posizione dell'ordine nel conteggio degli ordini del negozio. I numeri sono sequenziali e partono da 1. | numero intero | int(11) | read-only | |
order_number | La posizione dell'ordine nel conteggio degli ordini del negozio a partire dal numero 1001. I numeri degli ordini sono sequenziali. | numero intero | bigint(20) | read-only | ||
order_status_url | L'URL che punta alla pagina web dello stato dell'ordine, se applicabile. | stringa | varchar(255) | read-only | ||
original_total_duties_set | I dazi totali originali applicati all'ordine nelle valute del negozio e di presentazione. | object | read-only | |||
payment_gateway_names | Default: NULL | L'elenco dei canali di pagamento utilizzati per l'ordine. |
varchar(255) | read-only | ||
payment_terms | Default: NULL | I termini e le condizioni in base ai quali deve essere elaborato un pagamento. | object | bigint(20) | read-only | |
Telefono | Default: NULL | Il numero di telefono del cliente per la ricezione di notifiche via SMS. | stringa | varchar(255) | ||
presentment_currency | Default: NULL | La valuta di presentazione utilizzata per mostrare i prezzi al cliente. | stringa | char(3) | ||
processed_at | Default: NULL | La data e l'ora (formato ISO 8601) di elaborazione di un ordine. Questo valore è la data che viene visualizzata nei tuoi ordini e che viene utilizzata nei report di analisi. Se stai importando ordini da un'app o da un'altra piattaforma, puoi impostare processed_at su una data e un'ora nel passato che corrispondano al momento della creazione dell'ordine originale. | date | datetime(6) | ||
processing_method |
|
Il metodo di elaborazione del pagamento. | stringa | varchar(255) | read-only | |
referring_site | Default: NULL | Il sito web nel quale il cliente ha cliccato su un link che conduce al negozio. | stringa | varchar(4096) | ||
rimborsi | Un elenco dei rimborsi applicati all'ordine. | matrice | read-only | |||
shipping_address | Default: NULL | L'indirizzo di posta al quale sarà spedito l'ordine. Questo indirizzo è facoltativo e non sarà disponibile per gli ordini che non richiedono la spedizione. | numero intero | bigint(20) | ||
shipping_lines | Una matrice di oggetti, ciascuno dei quali descrive una modalità di spedizione utilizzata. | matrice | ||||
source_name | Default: NULL | Il luogo di origine dell'ordine. Può essere impostato solo durante la creazione dell'ordine e non è scrivibile in seguito. I valori dei canali Shopify sono protetti e non possono essere assegnati da altri client API: web, pos, shopify_draft_order, iphone e android. Gli ordini creati tramite l'API possono essere assegnati a qualsiasi altra stringa a tua scelta. Se non specificato, ai nuovi ordini viene assegnato il valore dell'ID della tua app. | stringa | varchar(255) | ||
subtotal_price | Il prezzo dell'ordine nella valuta del negozio dopo gli sconti, ma prima di spedizione, dazi, imposte e mance. | numero intero | bigint(20) | |||
subtotal_price_set | Il subtotale dell'ordine nelle valute del negozio e di presentazione dopo gli sconti, ma prima di spedizione, dazi, imposte e mance. | object | ||||
tag | I tag allegati all'ordine, formattati come stringa di valori separati da virgole. I tag sono brevi descrittori aggiuntivi, comunemente utilizzati per filtrare ed effettuare ricerche. Il limite di lunghezza di ogni singolo tag è di 40 caratteri. | stringa | varchar(4096) | |||
tax_lines | Una matrice di oggetti di riga delle imposte, ciascuno dei quali descrive un'imposta applicabile all'ordine. Ogni oggetto ha le seguenti proprietà: Quando crei un ordine tramite l'API, le righe delle imposte possono essere specificate nell'ordine o nelle voci, ma non in entrambi. Le righe delle imposte specificate nell'ordine sono suddivise tra le voci imponibili nell'ordine creato. |
matrice | ||||
taxes_included |
|
Indica se le imposte sono incluse nel subtotale dell'ordine. | boolean | tinyint(1) | ||
test |
|
Indica se si tratta di un ordine di prova. | boolean | tinyint(1) | read-only | |
token | Default: NULL | Un valore univoco per fare riferimento all'ordine. | stringa | varchar(32) | read-only | |
total_discounts | Default: 0 | Gli sconti totali applicati al prezzo dell'ordine nella valuta del negozio. | stringa | decimal(21,3) | ||
total_discounts_set | Gli sconti totali applicati al prezzo dell'ordine nelle valute del negozio e di presentazione. | object | ||||
total_line_items_price | Default: 0 | La somma di tutti i prezzi delle voci nella valuta del negozio. | stringa | decimal(21,3) | ||
total_line_items_price_set | Il totale di tutti i prezzi delle voci nelle valute del negozio e di presentazione. | object | ||||
total_outstanding | Default: 0 | L'importo totale in sospeso dell'ordine nella valuta del negozio. | stringa | decimal(21,3) | ||
total_price | Default: 0 | La somma di tutti i prezzi, gli sconti, le spedizioni, le imposte e le mance delle voci dell'ordine nella valuta del negozio. Deve essere positivo. | stringa | decimal(21,3) | ||
total_price_set | Il prezzo totale dell'ordine nelle valute del negozio e di presentazione. | object | ||||
total_shipping_price_set | Il prezzo di spedizione totale dell'ordine, esclusi sconti e resi, nelle valute del negozio e di presentazione. Se taxes_included è impostato su true, total_shipping_price_set include le imposte. | object | ||||
total_tax | Default: 0 | La somma di tutte le imposte applicate all'ordine nella valuta del negozio. Deve essere positivo. | stringa | decimal(21,3) | ||
total_tax_set | L'imposta totale applicata all'ordine nelle valute del negozio e di presentazione. | object | ||||
total_tip_received | La somma di tutte le mance dell'ordine nella valuta del negozio. | numero intero | bigint(20) | read-only | ||
total_weight | Default: 0 | La somma di tutti i pesi delle voci dell'ordine in grammi. La somma non viene modificata quando gli articoli vengono rimossi dall'ordine. | numero intero | bigint(20) unsigned | ||
updated_at | La data e l'ora (formato ISO 8601) dell'ultima modifica dell'ordine. | date | datetime(6) | read-only | ||
user_id | Default: NULL | L'ID dell'utente che ha effettuato l'accesso a Shopify POS e ha elaborato l'ordine, se applicabile. | numero intero | bigint(20) |
Product
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa Product
dell'Admin API REST.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo | Accesso al campo | Campo obbligatorio cruciale |
---|---|---|---|---|---|---|
body_html | Default: NULL | Una descrizione del prodotto. Supporta la formattazione HTML. | stringa | mediumtext | ||
created_at | Default: NULL | La data e l'ora (formato ISO 8601) di creazione dell'ordine. | date | datetime | read-only | |
handle | Default: NULL | stringa | varchar(255) | |||
ID | Default: NULL | Un numero intero a 64 bit senza segno utilizzato come identificatore univoco del prodotto. Ciascun ID è univoco all'interno del sistema Shopify. Nessun prodotto avrà lo stesso ID di un altro, anche se appartengono a negozi diversi. | numero intero | bigint(20) | read-only | Y |
immagini | Un elenco di oggetti immagine del prodotto, ciascuno dei quali rappresenta un'immagine associata al prodotto. | [{ product_image }] | ||||
opzioni | Le proprietà di prodotto personalizzate. Ad esempio, Dimensione, Colore e Materiale. Ogni prodotto può avere fino a tre opzioni e ogni valore di opzione può contenere fino a 255 caratteri. Le varianti di prodotto sono composte da combinazioni di valori di opzione. Non è possibile creare opzioni senza valori. Per creare nuove opzioni, è necessario creare anche una variante con un valore di opzione associato. | matrice | ||||
product_type | Default: NULL | Una classificazione del prodotto utilizzata per filtrare ed effettuare ricerche nei prodotti. | stringa | varchar(255) | ||
published_at | Default: NULL | La data e l'ora (formato ISO 8601) di pubblicazione del prodotto. Può essere impostato su null per annullare la pubblicazione del prodotto dal canale del Negozio online. | date | datetime | ||
published_scope |
|
Indica se il prodotto è pubblicato sul canale POS. | stringa | |||
stato |
|
Lo stato del prodotto. | stringa | varchar(32) | ||
tag | Una stringa di tag separati da virgole utilizzati per il filtraggio e la ricerca. Un prodotto può avere fino a 250 tag. Ogni tag può contenere fino a 255 caratteri. | stringa | ||||
template_suffix | Default: NULL | Il suffisso del modello Liquid utilizzato per la pagina del prodotto. Se questa proprietà viene specificata, la pagina del prodotto utilizza un modello chiamato "product.suffix.liquid", dove "suffix" è il valore di questa proprietà. Se questa proprietà è "" o null, la pagina di prodotto utilizza il modello predefinito "product.liquid". | stringa | varchar(255) | ||
title | Default: NULL | Il nome del prodotto. | stringa | varchar(255) | ||
updated_at | Default: NULL | La data e l'ora (formato ISO 8601) dell'ultima modifica del prodotto. Il valore updated_at di un prodotto può cambiare per diversi motivi. Ad esempio, se viene effettuato un ordine per un prodotto per il quale è impostato il monitoraggio delle scorte, la rettifica delle scorte viene conteggiata come aggiornamento. | date | datetime | read-only | |
varianti | Una matrice di varianti di prodotto, ognuna delle quali rappresenta una versione diversa del prodotto. La proprietà di posizione è di sola lettura. La posizione delle varianti è indicata dall'ordine in cui sono elencate. | matrice | ||||
fornitore | Default: NULL | Il nome del fornitore del prodotto. | stringa | varchar(255) |
ProductImage
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa ProductImage
dell'Admin API REST. Non sono presenti campi di sola lettura o campi obbligatori cruciali per questa risorsa.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo |
---|---|---|---|---|
created_at | Default: NULL | La data e l'ora di creazione dell'immagine del prodotto. L'API restituisce questo valore nel formato ISO 8601. | date | datetime |
height | Default: NULL | La dimensione dell'altezza dell'immagine determinata al caricamento. | smallint(4) unsigned | |
ID | Default: NULL | Un identificatore numerico univoco per l'immagine del prodotto. (auto_increment) | numero intero | bigint(20) |
position | Default: 0 | L'ordine dell'immagine del prodotto nell'elenco. La prima immagine del prodotto si trova alla posizione 1 ed è l'immagine "principale" del prodotto. | smallint(5) unsigned | |
product_id | Default: NULL | L'ID del prodotto associato all'immagine. | bigint(20) | |
src | Specifica la posizione dell'immagine del prodotto. Questo parametro supporta i filtri URL utilizzabili per recuperare le copie modificate dell'immagine. Ad esempio, aggiungi _small al nome del file per recuperare una copia dell'immagine ridimensionata a 100 x 100 px (ad esempio, ipod-nano_small.png) o aggiungi _2048x2048 per recuperare una copia dell'immagine con risoluzione 2048 x 2048 px (ad esempio, ipod-nano_2048x2048.png). | |||
updated_at | Default: NULL | La data e l'ora dell'ultima modifica dell'immagine del prodotto. L'API restituisce questo valore nel formato ISO 8601. | date | datetime |
variant_ids | Una matrice di ID variante associati all'immagine. | |||
width | Default: NULL | La dimensione della larghezza dell'immagine determinata al caricamento. | smallint(4) unsigned |
ProductVariant
: proprietà della risorsa
La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa ProductVariant
dell'Admin API REST. Non sono presenti campi obbligatori cruciali per questa risorsa.
Proprietà | Valori | Descrizione | Tipo di dati | Lunghezza campo | Accesso al campo |
---|---|---|---|---|---|
codice a barre | Default: NULL | Il numero del codice a barre, UPC o ISBN del prodotto. | varchar(255) | ||
compare_at_price | Default: NULL | Il prezzo originale dell'articolo prima di una rettifica o di un'offerta. | decimal(20,2) | ||
created_at | Default: NULL | La data e l'ora di creazione della variante di prodotto in formato ISO 8601. | date | datetime | |
fulfillment_service |
|
Il servizio logistico associato alla variante di prodotto. | varchar(255) | ||
grammi | Il peso della variante di prodotto in grammi. | ||||
ID | Default: NULL | L'identificatore numerico univoco della variante di prodotto. Questo valore si incrementa automaticamente. | bigint(20) | ||
image_id | Default: NULL | L'identificatore numerico univoco dell'immagine di un prodotto. L'immagine deve essere associata allo stesso prodotto della variante. | bigint(20) | ||
inventory_item_id | L'identificatore univoco della voce di inventario, utilizzato nell'API di scorte per richiedere informazioni sulle scorte. | ||||
inventory_management |
|
Il servizio logistico che monitora il numero di articoli disponibili per la variante di prodotto. | varchar(255) | ||
inventory_policy |
|
L'eventuale possibilità dei clienti di ordinare la variante di prodotto anche quando è esaurita. | varchar(40) | ||
inventory_quantity | Default: 1 | Un aggregato delle scorte presenti in tutte le sedi. Per rettificare le scorte in una sede specifica, utilizza la risorsa InventoryLevel. | int(11) | read-only | |
option | Le proprietà personalizzate utilizzate dal proprietario di un negozio per definire le varianti di prodotto. Puoi definire tre opzioni per una variante di prodotto: option1, option2, option3. Valore predefinito: Default Title. Il campo del titolo è una concatenazione dei campi option1, option2 e option3. L'aggiornamento dei campi di opzione aggiorna il campo del titolo. | ||||
position | Default: 0 | L'ordine della variante di prodotto nell'elenco delle varianti di prodotto. La prima posizione nell'elenco è 1. La posizione delle varianti è indicata dall'ordine in cui sono elencate. | smallint(5) unsigned | read-only | |
presentment_prices | Un elenco dei prezzi di presentazione e dei prezzi di confronto della variante in ciascuna delle valute di presentazione abilitate del negozio. Ogni oggetto di prezzo ha le seguenti proprietà: -currency_code: il codice di tre lettere (formato ISO 4217) di una delle valute di presentazione abilitate del negozio. -amount: il prezzo o il prezzo di confronto della variante nella valuta di presentazione. Richiede l'intestazione "X-Shopify-Api-Features": "include-presentment-prices". |
read-only | |||
prezzo | Default: 0 | Il prezzo della variante di prodotto. | decimal(20,2) | ||
product_id | Default: NULL | L'identificatore numerico univoco del prodotto. | bigint(20) | ||
requires_shipping | Default: 1 | Questa proprietà è deprecata. Al suo posto, utilizza la proprietà "requires_shipping" sulla risorsa InventoryItem. | boolean | tinyint(1) | |
SKU | Un identificatore univoco per la variante di prodotto nel negozio. Necessario per collegarsi a un FulfillmentService. | varchar(255) | |||
tax_code | Questo parametro si applica solo ai negozi che hanno installato l'app Avalara AvaTax. Specifica il codice imposta Avalara per la variante di prodotto. | ||||
imponibile | Default: 1 | L'eventuale applicazione di un'imposta quando viene venduta la variante di prodotto. | boolean | tinyint(1) | |
title | Il titolo della variante di prodotto. Il campo del titolo è una concatenazione dei campi option1, option2 e option3. Puoi aggiornare il titolo solo in modo indiretto utilizzando i campi option. | varchar(255) | read-only | ||
updated_at | Default: NULL | La data e l'ora dell'ultima modifica della variante di prodotto. Viene restituito nel formato ISO 8601. | date | datetime | |
weight | Il peso della variante di prodotto nel sistema di unità di misura specificato con weight_unit. | ||||
weight_unit |
|
L'unità di misura applicabile al peso della variante di prodotto. Se non specifichi un valore per weight_unit, verrà applicata l'unità di misura predefinita del negozio. | varchar(2) |