> 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/data-api/order-data-1/syncing-order-data-via-file.md).
# Sincronizzazione dei dati sugli ordini tramite file
Epsilon Retail Mediaf supporta solo il formato TSV per i dati degli ordini. La tabella seguente descrive i nomi delle colonne in un file TSV e le relative descrizioni.
{% hint style="warning" %}
Durante la sincronizzazione tramite TSV, `order_id` devono essere forniti in ordine sequenziale, assicurando che se vengono acquistati più prodotti, questi vengano attribuiti allo stesso `order_Id` allo stesso tempo.
Se `order_id`gli 's sono frammentati, i prodotti successivi nell'ordine non verranno attribuiti.
{% endhint %}
## Nomi delle colonne e descrizioni per i dati dei clienti nei file TSV
| Nome colonna | Obbligatorio/facoltativo | Tipo di dato | Descrizione |
| ---------------------- | ------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id` | Obbligatorio | Testo | Questo è l'identificatore dell'ordine nel sistema del retailer.
DEVE\*\* essere ordinato per orderId.
|
| `order_date` | Obbligatorio | Testo | Questa è la data o la data e l'ora dell'ordine. Deve essere nel formato dello standard ISO-8601 e deve essere un timestamp completo e preciso, ad es. 2019-03-14T15:06:17+10:00
Deve essere con fuso orario regolato (+10:00 per UTC+10) o in ora UTC.
|
| `product_code` | Obbligatorio | Testo | Questo è il codice per identificare il prodotto nell'ordine. |
| `quantity` | Obbligatorio | Numero | Questa è la quantità del prodotto nell'ordine.
Questo DEVE essere un numero intero.
|
| `regular_unit_price` | Facoltativo | Numero | Questo è il prezzo unitario regolare del prodotto nell'ordine.
Se fornito, DEVE essere un numero.
|
| `price_with_discounts` | Obbligatorio | Numero | Questo è il prezzo totale dei prodotti con gli sconti. **DEVE** essere un numero, ad es. se una voce d'ordine contiene 3 articoli con un prezzo di 2.00, il valore sarà `6`. |
| `customer_id` | Facoltativo | Testo | Questo è l'identificatore del cliente dell'ordine. |
| `session_id` | Obbligatorio. | Testo | Questo è un ID generato e controllato da te che identifica la sessione di un utente. Epsilon Retail Media può usarlo per l'attribuzione degli acquisti. |
| `seller_id` | Facoltativo | Testo | L'ID univoco del venditore. Richiesto solo in caso di onboarding di venditori del marketplace. Può essere lasciato vuoto per i prodotti non del marketplace.
Fornire questo dato quando non si effettua l'onboarding di fornitori del marketplace può causare problemi di attribuzione.
Ci sono requisiti aggiuntivi per integrare i seller\_ids, si prega di fare riferimento a sellerId del Marketplace per maggiori informazioni.
|
Un esempio di file TSV per i clienti è visibile nella tabella seguente. In modo simile ai dati sui prodotti e sui clienti, i dati grezzi sono un file di testo, ma sono rappresentati in una tabella per poterli leggere facilmente.
| `order_id` | `order_date` | `product_code` | `quantity` | `regular_unit_price` | `price_with_discounts` | `customer_id` | `session_id` | `seller_id` |
| ---------- | --------------------------- | -------------- | ---------- | -------------------- | ---------------------- | ------------- | ------------------------------------------ | --------------- |
| 1343321 | `2019-03-15T17:06:17+00:06` | 357480 | `1` | `469` | `469` | 4234 | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA | wde3e-sadet-d43 |
| 1343321 | `2019-03-15T17:06:17+00:06` | 4153234 | `4` | `47.95` | `191.8` | 4234 | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA | |
| 1343321 | `2019-03-15T17:06:17+00:06` | 73553 | `1` | `6` | `6` | 4234 | Z2YcoG5Pqe1uTCsz3Lk5WE3sBmExNjI4NjAxNDA | |
| 6845359 | `2019-03-15T17:06:17+00:06` | 74549 | `3` | `6` | `18` | 2462 | 4fy5MPixTU-cKAWimSlHsLkfrUZCV1NfNzM1NTM= | |
| 6845360 | `2019-03-15T17:06:17+00:06` | 76542 | `2` | `11` | `22` | 4281 | IDI0Ks\_vmSyeLUmDaa1UCCGJ\_chCV1NfNzM1NTM= | |
{% hint style="info" %}
Se non sei sicuro dei termini descritti in questa sezione, visita la pagina di riferimento.
{% endhint %}
---
# 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/data-api/order-data-1/syncing-order-data-via-file.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.