API의 상세 스키마 정보는 최신 셀러 API Swager 문서에서 참고 부탁드립니다.
일반적인 주문 수집 상황을 가정하여 활용하실 API 등을 리스팅 해두었습니다.
상품 연동 : 상품 생성/수정 & 승인
상품 승인까지 완료되어야 앱에 노출됩니다.
# 상품 생성/수정
PUT /seller/product-proposals
# 상품 승인
POST /seller/product-proposals/{proposalId}/submit
Plain Text
복사
•
퀸잇에서 응답으로 productProposalId 이 요청 Body 내에 있는 경우 수정으로 판단합니다. 없을 경우, mallProductCode 기준으로 판단하고 있습니다.
•
1번 응답에서 발급되는 productProposalId 를 API path 에 넣어 승인 API 를 호출해주시면 서비스에 반영됩니다.
주문 수집 : 배송관리 > 주문처리 대기 중인 주문 조회
GET /seller/orders/search-by-delivery/paged?
Plain Text
복사
요청 파라미터 중 deliveryState=WAIT 이 필수여야 합니다.
셀러어드민에서 쓰고있는 파라미터는 아래와 같습니다.
•
page=1&size=20&startAt=2023-10-29&endAt=2024-01-29&deliveryState=WAIT&orderBy=ASC
주문 수집 : 주문처리 대기에서 주문확인 처리
PUT /seller/orders/lines/delivery-state
Plain Text
복사
# 샘플
{
"requests": [
{
"orderId": "ORD24012911001019124",
"orderLineId": "ORD24012911001019124R02R03",
"deliveryStateEnum": "PREPARING" # 배송 준비 중
}
]
}
Plain Text
복사
주문수집 : 송장 등록 및 배송 중으로 변경
PUT /seller/orders/lines/tracking-info
PUT /seller/orders/lines/delivery-state # IN_DELIVERY 로 전달
Plain Text
복사
주문수집 : 주문취소
주문취소의 경우 deliveryStateEnum 가 WAIT 또는 PRPARING 에서만 가능합니다.
POST /seller/orders/ORD24012911281719124/lines/cancel
Plain Text
복사
반품 티켓 수집 : 반품관리 > 요청된 상태 티켓 조회
굿스플로 자동 승인 기능을 활용하는 셀러인 경우에는 승인 처리 따로 하실 필요없습니다.
GET /seller/orders/lines/return/tickets
Plain Text
복사
요청 파라미터 중 ticketState=SUBMITTED 이 필수로 주셔야 합니다.
셀러 어드민에서 활용 중인 파라미터 샘플입니다.
•
page=1&size=10&startAt=2023-10-29&endAt=2024-01-29&orderBy=ASC&ticketState=SUBMITTED
교환 티켓 수집 : 교환관리 > 요청된 상태 티켓 조회
굿스플로 자동 승인 기능을 활용하는 셀러인 경우에는 승인 처리 따로를 하실 필요 없습니다.
GET /seller/orders/exchange-tickets
Plain Text
복사
요청 파라미터 중 processState=REQUESTED 이 필수로 주셔야 합니다.
셀러 어드민에서 활용 중인 파라미터 샘플입니다.
•
processState=REQUESTED&page=1&size=10&startAt=2023-10-29&endAt=2024-01-29&orderBy=ASC
취소 티켓 수집 : 취소관리 > 요청된 상태 티켓 조회
GET /seller/orders/lines/cancel/tickets
Plain Text
복사
요청 파라미터 중 ticketState=SUBMITTED 이 필수로 전달주셔야 합니다.
셀러 어드민에서 활용 중인 파라미터 샘플입니다.
•
page=1&size=10&startAt=2023-10-29&endAt=2024-01-29&orderBy=ASC&ticketState=SUBMITTED