Vai al contenuto
ShopentlyLearn
Italiano

Ordini

Leggi riepiloghi e dettagli degli ordini, poi aggiorna lo stato dell’ordine o del pagamento.

Operazioni

GETElenca · Stati — Ordini/api/v1/order-statuses

Esempio di richiestaEsempio di risposta

GETElenca — Ordini/api/v1/orders

Esempio di richiestaEsempio di risposta

GETRecupera — Ordini/api/v1/orders/{order_id}

Esempio di richiestaEsempio di risposta

PATCHAggiorna · Stato del pagamento — Ordini/api/v1/orders/{order_id}/payment-status

Esempio di richiestaEsempio di risposta

PATCHAggiorna · Stato — Ordini/api/v1/orders/{order_id}/status

Esempio di richiestaEsempio di risposta

Principi

Elenco e dettagli degli ordini includono delivery.dates. Le date YYYY-MM-DD sono pianificate e non confermano la spedizione. Le date attuali hanno priorità; gli ordini precedenti usano la stima salvata. I valori cancellati o sconosciuti sono null. I dettagli includono anche tutte le righe e le immagini dei prodotti.

Ottieni gli identificativi degli stati validi da /api/v1/order-statuses. Stato dell’ordine e del pagamento hanno endpoint PATCH e permessi distinti. Cambiare lo stato registrato del pagamento non addebita una carta e non esegue un rimborso tramite il fornitore di pagamenti.

Scritture sicure

Permessi e piani

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Date di spedizione e consegna: YYYY-MM-DD; null. Fuso orario della spedizione: IANA.

Ordine · Totali

Importi e aliquote provengono dall’ordine salvato, comprese le correzioni delle righe. I dati storici mancanti sono null e non vengono sostituiti con le aliquote attuali del catalogo. Gli importi restano stringhe decimali.

  • tax_country_code · Paese fiscale · Dati registrati dell’ordine · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Una unità · Prima degli sconti; lines[].original_total_* · Prima degli sconti; lines[].total_* · Dopo gli sconti.
  • lines[].discount_* · Sconti; manual_discount · Sconto manuale; percentage "10" = 10%.
  • delivery.net / tax / gross · Dopo gli sconti; delivery.original_* · Prima degli sconti; delivery.discount_* · Sconti.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Sconosciuto: null; zero noto: 0.
  • totals · Totali; tax_breakdown.groups · Gruppi fiscali; Imposta non assegnata = order.tax − Σ groups.tax; ±.

L’elenco restituisce riepiloghi. Recupera GET /api/v1/orders/{order_id} per ogni risultato per esportare tutti i dettagli finanziari. I tentativi GET sono limitati e rispettano Retry-After. L’esportazione per data di creazione non sincronizza correzioni successive.

payment.amount è il totale dell’ordine. Lo stato del pagamento non determina importi pagati, rimborsati o ancora dovuti.

Schemi dei dati

Guide

Esportare gli ordini