L’ID dell’ordine nel tuo negozio, fino a 255 caratteri. I numeri vengono salvati come stringhe. Salvato come external_id. Puoi inviarlo anche come external_id o order_id.

L’indirizzo email dell’acquirente. Salvato in minuscolo. Emailit lo usa per trovare il contatto e per attribuire l’ordine a un’email inviata a quell’indirizzo. È accettato anche customer.email.

Il contatto dell’acquirente (con_...). Se nessun contatto ha questo ID, Emailit cerca il contatto tramite email.

Il nome dell’acquirente, fino a 191 caratteri. Usato quando Emailit crea il contatto. È accettato anche customer.first_name.

Il cognome dell’acquirente, fino a 191 caratteri. Usato quando Emailit crea il contatto. È accettato anche customer.last_name.

placed (predefinito), paid, fulfilled, canceled o refunded. La prima volta che un ordine ha paid, fulfilled, canceled o refunded, Emailit imposta il corrispondente paid_at, fulfilled_at, canceled_at o refunded_at all’ora attuale. Gli ordini annullati non rientrano nei ricavi.

Codice ISO 4217 di tre lettere. Il valore predefinito è la valuta del workspace nelle impostazioni e-commerce. Gli importi non vengono mai convertiti: i report raggruppano i ricavi per valuta.

Totale dell’ordine. Obbligatorio per un nuovo ordine senza articoli. Se manca, Emailit calcola la somma dei totali degli articoli, meno discount, più shipping e tax, e mai sotto 0.

Gli importi sono numeri o stringhe numeriche, non possono essere negativi e vengono salvati con al massimo 4 cifre decimali.

Importo prima di sconto, spedizione e imposte. Il valore predefinito è la somma dei totali degli articoli, quando l’ordine ha articoli.

Importo dello sconto, come numero positivo.

Importo della spedizione.

Importo delle imposte.

Importo rimborsato. Il valore predefinito è 0, oppure total quando status è refunded. I ricavi sono total meno refunded_amount.

Fino a 20 codici coupon o codici sconto usati nell’ordine. Un codice che corrisponde a un codice coupon del workspace, senza distinzione tra maiuscole e minuscole, viene contrassegnato come utilizzato da questo ordine. Sono accettati anche coupon_code e discount_codes.

L’ID del carrello o del checkout nel tuo negozio da cui proviene l’ordine. Il carrello con questo ID diventa converted.

Quando è stato effettuato l’ordine: una data e ora ISO 8601 o un timestamp Unix in secondi (funzionano anche i millisecondi). Il valore predefinito è l’ora attuale. Non può essere più di 24 ore nel futuro. È accettato anche created_at.

Fino a 250 righe dell’ordine. È accettato anche line_items. Ogni articolo ha:

• product_id (string o number): l’ID del prodotto nel tuo negozio. Gli articoli senza title, url, image_url o categories li prendono dal catalogo. È accettato anche id.

• variant_id, sku (string): fino a 255 caratteri.

• title (string): fino a 500 caratteri. Obbligatorio quando l’articolo non ha product_id né sku. È accettato anche name.

• quantity (integer): 1 o più. Il valore predefinito è 1.

• price (number o string): il prezzo unitario. Il valore predefinito è 0. È accettato anche unit_price.

• total (number o string): il totale della riga. Il valore predefinito è price per quantity.

• categories (string[]): fino a 50 nomi di categoria.

• url, image_url (string): URL http o https.

Dati chiave-valore tuoi, fino a 16 KB in JSON. Negli aggiornamenti, le chiavi che invii vengono unite all’oggetto salvato.

Predefinito true: quando nessun contatto corrisponde a contact_id o email, Emailit ne crea uno da email, first_name e last_name e genera contact.created. Il nuovo contatto non è iscritto a nessuna lista, quindi le campagne non lo raggiungono. Imposta false per non creare mai un contatto: in questo caso l’ordine viene collegato solo a un contatto già esistente.

Imposta true insieme ad audience_id quando l’acquirente ha accettato di ricevere comunicazioni di marketing. Emailit iscrive allora il contatto a quella lista, a meno che il contatto non ne faccia già parte. Predefinito false.

La lista (aud_...) a cui iscrivere l’acquirente quando accepts_marketing è true. Se la lista non esiste o è stato raggiunto il limite di iscritti del piano, l’ordine viene comunque salvato e il contatto non viene iscritto.

L’email di campagna (eml_...) da cui proviene l’acquirente, se il tuo negozio la traccia. Usato solo per i nuovi ordini, e vengono letti solo gli ID che iniziano con eml_. L’ordine viene attribuito a questa email quando è un’email di campagna del workspace e ha un clic entro la finestra dei clic prima dell’ordine oppure è stata inviata entro quella finestra. Altrimenti Emailit attribuisce l’ordine come di consueto. È accettato anche attribution.email_id.

L’ID dell’ordine (ord_...) o l’ID dell’ordine nel tuo negozio (external_id). Codifica nell’URL gli ID del negozio che contengono caratteri speciali.

Sempre order.

ID dell’ordine in Emailit (ord_...).

L’ID dell’ordine nel tuo negozio: l’id che hai inviato.

Il contatto dell’acquirente (con_...), oppure null quando l’ordine non è collegato a un contatto.

L’indirizzo email dell’acquirente, in minuscolo.

placed, paid, fulfilled, canceled o refunded.

Codice ISO 4217 di tre lettere degli importi.

Somma degli articoli prima di sconto, spedizione e imposte.

Importo dello sconto.

Importo della spedizione.

Importo delle imposte.

Totale dell’ordine. Nei report i ricavi sono total meno refunded_amount, e gli ordini annullati non contano.

Importo rimborsato finora. 0 quando non è stato rimborsato nulla.

Codici coupon o codici sconto usati nell’ordine.

L’ID del carrello o del checkout nel tuo negozio da cui proviene l’ordine.

Come l’ordine è arrivato a Emailit: api, js (lo script di tracciamento) o import (importazione in blocco).

Quando è stato effettuato l’ordine, in ISO 8601 UTC.

Quando Emailit ha salvato per la prima volta l’ordine con quello stato. Viene impostato una sola volta e non viene azzerato quando lo stato cambia di nuovo.

L’email a cui è attribuito l’ordine, oppure null. Viene impostata una sola volta, quando l’ordine viene salvato per la prima volta. Vedi Come gli ordini vengono attribuiti alle email.

• email_id (string): l’email a cui è attribuito l’ordine.

• campaign_id, campaign_name (string o null): la sua campagna.

• variant_id (string o null): la versione del test A/B (cvr_...) che ha ricevuto l’acquirente.

• automation_id, automation_name (string o null): la sua automazione.

• type (string): click o open.

• touched_at (string o null): quando è avvenuto il clic o l’apertura.

Righe dell’ordine. Ognuna ha product_id (l’ID del prodotto nel tuo negozio), variant_id, sku, title, quantity, unit_price, total, categories, url e image_url.

Dati chiave-valore tuoi.

Quando Emailit ha salvato l’ordine e quando è cambiato l’ultima volta, in ISO 8601 UTC.

L’ID dell’ordine (ord_...) o l’ID dell’ordine nel tuo negozio.

placed, paid, fulfilled, canceled o refunded. La prima volta che l’ordine passa a paid, fulfilled, canceled o refunded, il corrispondente paid_at, fulfilled_at, canceled_at o refunded_at viene impostato all’ora attuale. Gli ordini annullati non rientrano nei ricavi.

Importo totale rimborsato finora, non l’importo di questo rimborso. Non può essere negativo. I ricavi sono total meno refunded_amount. Se imposti status su refunded senza refunded_amount e prima non era stato rimborsato nulla, l’intero total viene considerato rimborsato.

Chiavi da unire ai metadati dell’ordine. Fino a 16 KB in JSON.

Numero di pagina per la paginazione (minimo: 1, predefinito: 1).

Numero di ordini da restituire (minimo: 1, massimo: 100, predefinito: 25).

Corrispondenza sull’ID dell’ordine nel tuo negozio o sull’indirizzo email dell’acquirente, senza distinzione tra maiuscole e minuscole.

Solo gli ordini di questo contatto (con_...).

Solo gli ordini con questo indirizzo email dell’acquirente, senza distinzione tra maiuscole e minuscole.

Solo gli ordini con questo stato: placed, paid, fulfilled, canceled o refunded.

Solo gli ordini attribuiti a questa campagna (cmp_...).

Solo gli ordini attribuiti a questa automazione (aut_...).

true per gli ordini attribuiti a un’email, false per quelli che non lo sono.

Solo gli ordini effettuati a partire da questo momento. Una data o una data e ora ISO 8601; qualsiasi altro valore restituisce 422.

Solo gli ordini effettuati fino a questo momento compreso. Una data o una data e ora ISO 8601; qualsiasi altro valore restituisce 422.

all (predefinito) richiede che corrispondano tutti i filtri key.condition. Con or basta che ne corrisponda uno. Vedi Filtri e ordinamento.

Chiave di ordinamento: placed_at (predefinito), total o created_at.

Direzione dell’ordinamento: asc o desc (predefinito).

Da 1 a 1000 ordini, ognuno con i campi di Crea o aggiorna un ordine.

Predefinito true: nessuna attribuzione e nessun evento degli ordini. Imposta false per trattare gli ordini come ordini inviati uno alla volta: i nuovi ordini vengono attribuiti alle email e generano order.placed, gli ordini aggiornati generano order.updated.

Numero di nuovi ordini.

Numero di ordini già salvati che sono stati aggiornati.

Ordini che non sono stati salvati. Ogni elemento ha l’index dell’ordine nel tuo array orders ed errors, con chiavi che sono percorsi di campo come orders.4.currency. Un ordine che ha superato la convalida ma non è stato possibile salvare ha l’errore could not be stored sotto orders.<index>.

L’ID dell’ordine (ord_...) o l’ID dell’ordine nel tuo negozio.