> 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/references/order-reference.md).
# 주문 참조
아래는 다음 문서에 개요가 설명된 표준 동기화 요청에서 가능한 속성을 설명합니다: [API를 통해 주문 데이터 동기화](/retail-media-interface/integration/ko/data-api/order-data-1/syncing-order-data-via-api.md).
## 요청 항목
| 속성 | 설명 | 필수/선택 | 예시 |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gtin` | 주문에서 제품을 식별하는 코드입니다. | 필수 | `9891998566P` |
| `id` | 소매업체 시스템의 주문 식별자입니다.
제공되지 않은 경우, Epsilon Retail Media 이(가) 식별자를 생성합니다.
| 선택 사항. | `3h30e938-c158-4d78-a0af-b48bbwfrcss4` |
| `orderDate` | 주문 날짜 또는 날짜와 시간입니다. ISO-8601 표준 형식이어야 하며 정확한 전체 타임스탬프여야 합니다(예: 2019-03-14T15:06:17+10:00).
UTC 시간이거나 위 예시와 같이 시간대가 조정되어야 합니다.
| 필수 | `2021-12-02T15:00:00Z` |
| `catalogId` | 주문을 동기화하려는 카탈로그 ID입니다. API를 통한 다중 소매업체 동기화에 유용합니다.
파일 동기화에는 적용되지 않습니다.
| 선택 사항 | `6adb93d0-7he4-4d4e-9b47-e5d3714c976a` |
| `orderItems` | 주문 내에 제출된 모든 항목의 배열입니다. | 필수 | `[
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": "1.00",
"totalOrderItemPriceAfterDiscounts": "3.00"
}
]` |
| `quantity` | 주문된 제품의 수량 | 필수 | `3` |
| `regularUnitPrice` | 주문 내 제품의 정가 단가입니다. | 선택 사항 | `2.99` |
| `sessionId` | 사용자 세션을 식별하기 위해 귀하가 제어하는 생성된 ID입니다. Epsilon Retail Media 을(를) 구매 기여도에 사용할 수 있습니다. | 표준 연동 시 필수 | `5cat7-9964-4f` |
| `totalOrderItemPriceAfterDiscounts` | 할인이 적용된 제품의 총 가격입니다. 예: 주문 항목에 가격이 2.00인 항목이 3개 포함된 경우 값은 다음과 같습니다. `6.00`. | 선택 사항 | `5.98` |
| `sellerId` | 판매자의 고유 ID입니다. 마켓플레이스 판매자를 온보딩하는 경우에만 필요합니다. 비 마켓플레이스 제품의 경우 비워 둘 수 있습니다.
seller\_ids를 연동하기 위한 추가 요구사항이 있습니다. 다음을 참조하세요: 마켓플레이스 sellerId 자세한 정보는 다음을 참조하세요.
| 선택 사항 | `73nns-32sxr-32ss` 연동별 맞춤 설정 |
---
# 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/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.