아래에서는 API를 통한 주문 데이터 동기화에 기술된 대로 표준 동기화 요청에서 사용 가능한 속성을 간략히 설명합니다.
항목 요청
| 속성 | 설명 | 필수/선택 | 예시 |
|---|---|---|---|
gtin | 주문에서 제품을 식별하기 위한 코드입니다. | 필수 입력 항목입니다 | 9891998566P |
id | 소매업체의 시스템에 있는 주문의 식별자입니다. 식별자가 제공되지 않으면 CitrusAd가 식별자를 생성합니다. | (선택 사항) | 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입니다. CitrusAd는 이를 구매 속성에 사용할 수 있습니다. | 표준 통합에 필요합니다. | 5cat7-9964-4f |
totalOrderItemPriceAfterDiscounts | 할인된 제품의 총 가격으로 예를 들어 주문 항목에 가격이 2.00인 3개의 항목이 포함된 경우 값은 다음과 같습니다. 6.00. | 선택 사항 | 5.98 |
sellerId | 판매자의 고유 Id입니다. 마켓플레이스 판매자를 온보딩하는 경우에만 필요합니다. 마켓플레이스 제품이 아닌 경우 비워 둘 수 있습니다. seller_id를 통합하기 위한 추가 요건이 있습니다. 자세한 내용은 Marketplace sellerId를 참조하십시오. | 선택 사항 | 73nns-32sxr-32ss 통합별 사용자 정의 |