주문

작업

작동 방식

주문 목록과 상세 정보에는 delivery.dates가 포함됩니다. YYYY-MM-DD 날짜는 예정이며 실제 발송을 확인하지 않습니다. 현재 날짜가 우선하며 이전 주문은 저장된 예상치를 사용합니다. 삭제되거나 알 수 없는 값은 null입니다. 상세 정보에는 모든 주문 항목과 상품 이미지도 포함됩니다.

유효한 상태 식별자는 /api/v1/order-statuses 에서 가져오세요. 주문 상태와 결제 상태는 별도의 PATCH 엔드포인트와 권한을 사용합니다. 기록된 결제 상태를 변경해도 카드 결제나 결제 서비스 제공자를 통한 환불은 실행되지 않습니다.

안전한 쓰기

권한과 요금제

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. 발송일 및 예상 배송일: YYYY-MM-DD; null. 발송 시간대: IANA.

주문 · 합계

금액과 세율은 항목 수정 사항을 포함한 저장된 주문에서 가져옵니다. 과거 데이터가 없으면 null이며 현재 카탈로그 세율로 채우지 않습니다. 금액은 십진수 문자열로 유지합니다.

• tax_country_code · 과세 국가 · 저장된 주문 데이터 · ISO 3166-1 alpha-2; null.
• lines[].unit_* · 한 단위 · 할인 전; lines[].original_total_* · 할인 전; lines[].total_* · 할인 후.
• lines[].discount_* · 할인; manual_discount · 수동 할인; percentage "10" = 10%.
• delivery.net / tax / gross · 할인 후; delivery.original_* · 할인 전; delivery.discount_* · 할인.
• tax_rate: "0.23" = 23%; "0" ≠ null. 알 수 없음: null; 확인된 0: 0.
• totals · 합계; tax_breakdown.groups · 세금 그룹; 미배분 세액 = order.tax − Σ groups.tax; ±.

목록은 요약을 반환합니다. 각 결과에 대해 GET /api/v1/orders/{order_id}를 조회하여 전체 금액 명세를 내보내세요. GET 재시도는 제한되며 Retry-After를 따릅니다. 생성일 기준 내보내기는 이후 수정 사항을 동기화하지 않습니다.

payment.amount는 주문 총액입니다. 결제 상태로 결제액, 환불액 또는 미결제액을 확정할 수 없습니다.