> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/it/references/order-reference.md). # Riferimento per gli ordini Di seguito sono descritte le proprietà possibili in una richiesta di sincronizzazione standard come indicato in [Sincronizzazione dei dati degli ordini tramite API](/retail-media-interface/integration/it/data-api/order-data-1/syncing-order-data-via-api.md). ## Elementi della richiesta | Proprietà | Descrizione | Obbligatorio/opzionale | Esempio | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `gtin` | Questo è il codice per identificare il prodotto nell'ordine. | Obbligatorio | `9891998566P` | | `id` |

Questo è l'identificatore dell'ordine nel sistema del retailer.

Se non fornito, Epsilon Retail Media genererà un identificatore.

| Opzionale. | `3h30e938-c158-4d78-a0af-b48bbwfrcss4` | | `orderDate` |

Questa è la data o la data e l'ora dell'ordine. Deve essere nel formato dello standard ISO-8601 e deve essere un timestamp preciso e completo, ad es. 2019-03-14T15:06:17+10:00.

Deve essere in formato UTC o con fuso orario regolato come nell'esempio sopra.

| Obbligatorio | `2021-12-02T15:00:00Z` | | `catalogId` |

L'ID del catalogo per cui si stanno sincronizzando gli ordini. Utile per la sincronizzazione multi-retailer tramite API.
Non applicabile per la sincronizzazione tramite file.

| Opzionale | `6adb93d0-7he4-4d4e-9b47-e5d3714c976a` | | `orderItems` | Un array di tutti gli elementi inviati all'interno dell'ordine. | Obbligatorio | `[
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": "1.00",
"totalOrderItemPriceAfterDiscounts": "3.00"
}
]` | | `quantity` | La quantità di prodotti ordinati | Obbligatorio | `3` | | `regularUnitPrice` | Il prezzo unitario regolare del prodotto nell'ordine. | Opzionale | `2.99` | | `sessionId` | Questo è un ID generato e gestito da te che identifica la sessione di un utente. Epsilon Retail Media può utilizzarlo per l'attribuzione degli acquisti. | Obbligatorio in un'integrazione standard | `5cat7-9964-4f` | | `totalOrderItemPriceAfterDiscounts` | Questo è il prezzo totale dei prodotti comprensivo di sconti. Ad es. se un elemento dell'ordine contiene 3 articoli con un prezzo di 2.00, il valore sarà `6.00`. | Opzionale | `5.98` | | `sellerId` |

L'Id univoco del venditore. Obbligatorio solo se si stanno integrando venditori di un marketplace. Può essere lasciato vuoto per i prodotti non di marketplace.

Ci sono requisiti aggiuntivi per integrare seller\_ids, si prega di fare riferimento a sellerId del Marketplace per maggiori informazioni.

| Opzionale | `73nns-32sxr-32ss` Personalizzato per integrazione | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/it/references/order-reference.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.