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

# 파일을 통한 주문 데이터 동기화

Epsilon Retail Mediaf는 주문 데이터에 대해 TSV 형식만 지원합니다. 아래 표는 TSV 파일의 열 이름과 설명입니다.

{% hint style="warning" %}
TSV를 통해 동기화할 때 `order_id` 순차적으로 제공되어야 하며, 여러 상품이 구매된 경우 동일한 `order_Id` 에 동시에 기여되도록 해야 합니다.

만약 `order_id`가 파편화되면 주문의 이후 상품은 기여되지 않습니다.
{% endhint %}

## TSV 파일의 고객 데이터에 대한 열 이름 및 설명

| 열 이름                   | 필수/선택 | 데이터 유형 | 설명                                                                                                                                                                                                                                                                                                  |
| ---------------------- | ----- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | 필수    | 텍스트    | <p>리테일러 시스템에서 주문의 식별자입니다.<br><br>반드시\*\* orderId 순으로 정렬되어야 합니다.</p>                                                                                                                                                                                                                                 |
| `order_date`           | 필수    | 텍스트    | <p>주문의 날짜 또는 날짜와 시간입니다. ISO-8601 표준 형식이어야 하며 정밀하고 전체 타임스탬프여야 합니다(예: <code>2019-03-14T15:06:17+10:00</code><br>시간대가 조정되거나(+10:00은 UTC+10) UTC 시간이어야 합니다.</p>                                                                                                                                         |
| `product_code`         | 필수    | 텍스트    | 주문 내 상품을 식별하기 위한 코드입니다.                                                                                                                                                                                                                                                                             |
| `quantity`             | 필수    | 숫자     | <p>주문 내 상품의 수량입니다.<br><br>이 값은 <strong>반드시</strong> 정수여야 합니다.</p>                                                                                                                                                                                                                                   |
| `regular_unit_price`   | 선택    | 숫자     | <p>주문 내 상품의 정가 단가입니다.<br><br>제공되는 경우 <strong>반드시</strong> 숫자여야 합니다.</p>                                                                                                                                                                                                                             |
| `price_with_discounts` | 필수    | 숫자     | 할인이 적용된 상품의 총 가격입니다. **반드시** 숫자여야 합니다. 예를 들어 주문 항목에 가격이 2.00인 항목이 3개 포함되어 있으면 값은 다음과 같습니다. `6`.                                                                                                                                                                                                     |
| `customer_id`          | 선택    | 텍스트    | 주문 고객의 식별자입니다.                                                                                                                                                                                                                                                                                      |
| `session_id`           | 필수.   | 텍스트    | 사용자 세션을 식별하기 위해 귀하가 제어하는 생성된 id입니다. Epsilon Retail Media 구매 기여 분석에 이것을 사용할 수 있습니다.                                                                                                                                                                                                                  |
| `seller_id`            | 선택    | 텍스트    | <p>판매자의 고유 ID입니다. <strong>마켓플레이스 판매자를 온보딩하는 경우에만 필요합니다</strong>. 마켓플레이스 상품이 아닌 경우 비워둘 수 있습니다.<br><br>마켓플레이스 공급업체를 온보딩하지 않을 때 이것을 제공하면 기여 분석 문제가 발생할 수 있습니다.<br><br>seller\_ids를 연동하기 위한 추가 요구 사항이 있습니다. 다음을 참조하세요. <a href="/pages/nH7z4TMRIIEa3XlAV7Wk">마켓플레이스 sellerId</a> 자세한 정보는 다음을 참조하세요.</p> |

고객용 TSV 파일의 예는 아래 표에서 확인할 수 있습니다. 상품 데이터 및 고객 데이터와 유사하게 원시 데이터는 텍스트 파일이지만, 쉽게 읽을 수 있도록 표로 표시됩니다.

| `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" %}
이 섹션에 기술된 용어가 확실하지 않은 경우 참조 페이지를 방문하세요.
{% 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/ko/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.