주문 상품 처리
제공 처리 일괄
배송 없는 주문상품(`MANUAL`)을 제공 완료(`DELIVERED`)로 바꾼다(이슈 #48). 항목별 부분 성공이고 주문상품마다 `ORDER.DELIVERED`·`ORDER.FULFILLED` 웹훅이 나간다. 스코프 `order:rw`.
POST
배송 없는 주문상품(MANUAL)을 제공 완료(DELIVERED)로 바꾼다(이슈 #48). 항목별 부분 성공이고 주문상품마다 ORDER.DELIVERED·ORDER.FULFILLED 웹훅이 나간다. 스코프 order:rw.
accessTokenheader
AuthorizationBearer <token>Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)
X-Store-Id*string대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다
idempotency-key?string멱등키. 같은 키로 다시 보내면 처음 결과를 돌려주고 한 번만 적용한다. 재시도에는 같은 키를 쓴다
Length
length <= 255application/json- body
orderItemIds*array<string>Items
1 <= items <= 100note?string구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다
Length
length <= 1000성공
application/json- response
meta*data*error*|nullcurl -X POST 'https://api.sayren.io/v1/order-items/fulfill' \ -H 'X-Store-Id: string' \ -H 'Content-Type: application/json' \ -d '{ "orderItemIds": [ "string" ]}'{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "succeeded": [ "string" ], "failed": [ { "id": "string", "productId": "string", "orderItemId": "string", "code": "string", "message": "string" } ] }, "error": null}