sayren Docs
주문 상품 처리

주문상품 변경 목록 조회

마지막 변경 시각 범위(최대 24시간)로 주문상품을 변경 시각 오름차순으로 조회한다. 연동사가 변경분을 주기적으로 가져가는 용도다. 스코프 `order:r`. 테스트 결제(샌드박스 결제) 주문은 `testPayment: true`다. 실제로 돈이 오가지 않았으므로 상품을 발송하지 않도록 주의한다. `testPayment` 쿼리로 테스트 결제만(`true`)·실결제만(`false`) 볼 수 있다. 주문상품의 `testPayment`는 소속 주문의 값이다. method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다(`payment.approvedMethod` — 매출 리포트·스토어프론트·환불 원장과 같은 값). 간편결제면 `payment.easyPayProvider`에 간편결제사가 함께 온다.

GET
/v1/order-items

마지막 변경 시각 범위(최대 24시간)로 주문상품을 변경 시각 오름차순으로 조회한다. 연동사가 변경분을 주기적으로 가져가는 용도다. 스코프 order:r.

테스트 결제(샌드박스 결제) 주문은 testPayment: true다. 실제로 돈이 오가지 않았으므로 상품을 발송하지 않도록 주의한다. testPayment 쿼리로 테스트 결제만(true)·실결제만(false) 볼 수 있다. 주문상품의 testPayment는 소속 주문의 값이다.

method는 호환용이며 간편결제를 CARD로 표시한다. 실제 수단은 approvedMethod를 본다(payment.approvedMethod — 매출 리포트·스토어프론트·환불 원장과 같은 값). 간편결제면 payment.easyPayProvider에 간편결제사가 함께 온다.

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Query Parameters

lastChangedFrom*string

마지막 변경 시각 조회 시작 (ISO 8601, 포함). 필수

lastChangedTo?string

마지막 변경 시각 조회 끝 (ISO 8601, 포함). 생략하면 시작부터 24시간. 기간은 최대 24시간

lastChangedType?string

마지막 변경 유형 필터

Value in"ORDER.PAID""ORDER.CONFIRMED""ORDER.DISPATCHED""ORDER.DELIVERED""ORDER.PURCHASE_DECIDED""CLAIM.CANCEL_REQUESTED""CLAIM.RETURN_REQUESTED""CLAIM.EXCHANGE_REQUESTED""CLAIM.COMPLETED""ORDER.ADDRESS_CHANGE_REQUESTED"
page?string

페이지 번호 (1부터, 기본 1)

size?string

페이지 크기 (기본 100, 최대 300)

testPayment?string

테스트 결제(샌드박스 결제) 필터. true면 테스트 결제만, false면 실결제만, 생략하면 전부입니다

Value in"true""false"

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X GET 'https://api.sayren.io/v1/order-items?lastChangedFrom=string' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "page": 0,    "size": 0,    "totalElements": 0,    "totalPages": 0,    "contents": [      {        "orderItemId": "string",        "orderItemNo": null,        "orderId": "string",        "status": "PAYMENT_WAITING",        "claimStatus": "CANCEL_REQUESTED",        "productId": "string",        "productName": "string",        "optionId": "string",        "optionName": "string",        "optionSelections": [],        "customInputs": [],        "stay": {          "checkIn": "string",          "checkOut": "string",          "nights": [            {              "date": "string",              "price": 0            }          ]        },        "sellerCode": "string",        "fulfillmentSnapshot": {          "type": "SHIPPING",          "shipping": {            "bundleKey": "string",            "returnAddressId": "string"          },          "method": "string",          "pickupLocation": {            "locationId": "string",            "name": "string",            "address": "string",            "phone": "string",            "hours": "string"          }        },        "quantity": 0,        "canceledQuantity": 0,        "activeQuantity": 0,        "unitPrice": 0,        "discountAmount": 0,        "totalPrice": 0,        "couponDiscountAmount": 0,        "pointAllocation": 0,        "hold": {          "reason": "string",          "expectedDispatchDate": "string"        },        "fulfillment": null,        "autoDecisionDate": "string",        "sellerMemo": "string",        "orderedAt": "string",        "lastChangedAt": "string",        "lastChangedType": "ORDER.PAID",        "testPayment": true      }    ]  },  "error": null}