> 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/cs/data-api/order-data-1/syncing-order-data-via-file.md).

# Synchronizace údajů o objednávkách pomocí souboru

Epsilon Retail Mediaf podporuje pro data o objednávkách pouze formát TSV. Níže uvedená tabulka popisuje názvy sloupců v souboru TSV a jejich popisy.

{% hint style="warning" %}
Při synchronizaci prostřednictvím TSV `order_id` musí být poskytnuty v po sobě jdoucím pořadí, což zajistí, že pokud je zakoupeno více produktů, budou připsány ke stejnému `order_Id` ve stejný čas.

Pokud jsou `order_id`roztříštěné, následné produkty v objednávce nebudou připsány.
{% endhint %}

## Názvy sloupců a popisy pro zákaznická data v souborech TSV

| Název sloupce          | Povinné/volitelné | Datový typ | Popis                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------- | ----------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | Povinné           | Text       | <p>Toto je identifikátor objednávky v systému prodejce.<br><br>MUSÍ\*\* být seřazeno podle orderId.</p>                                                                                                                                                                                                                                                                                                                                                       |
| `order_date`           | Povinné           | Text       | <p>Toto je datum nebo datum a čas objednávky. Musí být ve formátu standardu ISO-8601 a musí se jednat o přesné, úplné časové razítko, např. <code>2019-03-14T15:06:17+10:00</code><br>Musí být buď v upraveném časovém pásmu (+10:00 pro UTC+10), nebo v čase UTC.</p>                                                                                                                                                                                        |
| `product_code`         | Povinné           | Text       | Toto je kód pro identifikaci produktu v objednávce.                                                                                                                                                                                                                                                                                                                                                                                                           |
| `quantity`             | Povinné           | Číslo      | <p>Toto je množství produktu v objednávce.<br><br>Toto <strong>MUSÍ</strong> být celé číslo.</p>                                                                                                                                                                                                                                                                                                                                                              |
| `regular_unit_price`   | Volitelné         | Číslo      | <p>Toto je běžná jednotková cena produktu v objednávce.<br><br>Pokud je uvedena, <strong>MUSÍ</strong> to být číslo.</p>                                                                                                                                                                                                                                                                                                                                      |
| `price_with_discounts` | Povinné           | Číslo      | Toto je celková cena produktů se slevami. **MUSÍ** to být číslo, např. pokud položka objednávky obsahuje 3 položky s cenou 2,00, hodnota bude `6`.                                                                                                                                                                                                                                                                                                            |
| `customer_id`          | Volitelné         | Text       | Toto je identifikátor zákazníka objednávky.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `session_id`           | Povinné.          | Text       | Toto je vygenerované ID, které máte pod kontrolou a které identifikuje relaci uživatele. Epsilon Retail Media to může použít pro atribuci nákupů.                                                                                                                                                                                                                                                                                                             |
| `seller_id`            | Volitelné         | Text       | <p>Unikátní ID prodejce. <strong>Vyžadováno pouze v případě onboardingu prodejců na tržišti (marketplace)</strong>. U produktů mimo tržiště lze ponechat prázdné.<br><br>Poskytnutí tohoto údaje, pokud neprobíhá onboarding dodavatelů z tržiště, může vést k problémům s atribucí.<br><br>Pro integraci seller\_ids existují další požadavky, podívejte se prosím na <a href="/pages/GdINTwW9yWYQ9HlXJRpi">Marketplace sellerId</a> pro více informací.</p> |

Příklad souboru TSV pro zákazníky si můžete prohlédnout v tabulce níže. Podobně jako u produktových a zákaznických dat jsou hrubá data textovým souborem, ale jsou reprezentována v tabulce, abychom je mohli snadno číst.

| `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" %}
Pokud si nejste jisti termíny uvedenými v této části, navštivte prosím referenční stránku.
{% 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/cs/data-api/order-data-1/syncing-order-data-via-file.md?ask=<question>&goal=<endgoal>
```

`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.