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.

Nota

Le informazioni contenute nel dizionario dei dati sono verificate per la versione 2022-01 delle API di Shopify. Per informazioni ed esempi più aggiornati, consulta la documentazione di riferimento dell'Admin API REST.

Customer : proprietà della risorsa

La tabella seguente elenca alcune informazioni utili sulle proprietà della risorsa Customer dell'Admin API REST.

Dati relativi a proprietà importanti della risorsa Customer di 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 }
email	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	zero single_opt_in confirmed_opt_in unknown Default: NULL	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	disabled invited abilitato rifiutato Default: disabled	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.

Dati relativi a proprietà importanti della risorsa CustomerAddress di REST

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.

Dati relativi a proprietà importanti della risorsa Order di 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	cliente frode scorte rifiutato other Default: NULL	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	accept_language browser_height browser_ip browser_width session_hash user_agent	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
email		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	in attesa authorized partially_paid pagato partially_refunded refunded Default: NULL	Lo stato dei pagamenti associati all'ordine. Può essere impostato solo al momento della creazione dell'ordine.	stringa	varchar(255)	read-only
fulfillment_status	evasi inevaso zero parziale restocked Default: unfulfilled	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	check-out diretto manuale offsite express gratis	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	true false Default: 0	Indica se le imposte sono incluse nel subtotale dell'ordine.	boolean	tinyint(1)
test	true false Default: 0	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.

Dati relativi a proprietà importanti della risorsa Product di 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	web global	Indica se il prodotto è pubblicato sul canale POS.	stringa
stato	attivo archiviato bozza di ordine Default: active	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.

Dati relativi a proprietà importanti della risorsa ProductImage di REST

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.

Dati relativi a proprietà importanti della risorsa ProductVariant di REST

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	manuale { handle of fulfillment service } Default: manual	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	shopify zero { handle of fulfillment service } Default: NULL	Il servizio logistico che monitora il numero di articoli disponibili per la variante di prodotto.		varchar(255)
inventory_policy	deny continue Predefinito: deny	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	g kg oz lb Default: NULL	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)