품고 가이드
home
이용/연동 가이드
home
🛍️

임시 주문서 1건 등록

PUT https://api.poomgo.com/open-api/oms/temp-order
Plain Text
복사
임시 주문서란?
1.
품고나우에서 임시 주문서는 출고 작업 전 수집되는 주문 정보입니다.
2.
품고나우 물류 담당자가 N개의 임시 주문서를 확인 후 접수 처리하는 시점에 주문서 원장이 생성되며 출고 작업이 시작됩니다.
3.
접수 이후에 임시 주문서는 삭제되며 접수된 주문 정보는 주문서 원장 목록에서 확인할 수 있습니다.
4.
입력 데이터 유형 - dealName과 mappingData 방식 중 택일
a.
품고나우는 dealName(필수), dealOptionName(선택) 값으로 주문서에 포함된 품목 * 수량 구성을 판단할 수 있습니다.
i.
딜은 품고나우 UI에서 임시 주문서 등록 전/후에 입력 가능
b.
Deal을 활용하지 않고 정확한 resourceId를 지정해서 접수할 수도 있습니다.
i.
resourceId는 품목 목록 API의 결과에서 확인할 수 있습니다.
ii.
mappingData 구성 예시는 아래를 참조해 주세요.
5.
해외 출고 건의 경우 "productUrl" , "countryCode" 의 값을 필수로 넣어야 합니다.
a.
productUrl는 실제 상품이 판매되고 있는 URL 정보를 기입해주셔야합니다.
b.
countryCode는 일본향인 경우 “JP”로 기입이 필요합니다.(현재 품고의 경우 임시 주문서 등록건은 일본향만 제공되고 있습니다.)
curl -X PUT "https://api.poomgo.com/open-api/oms/temp-order" -H "accept: application/json" -H "Authorization: KEY" -H "Content-Type: application/json" -d "{\"channelAccountId\":0,\"orderCode\":\"string\",\"name\":\"string\",\"mobile\":\"string\",\"address\":\"string\",\"postcode\":\"string\",\"deliveryMessage\":\"string\",\"description\":\"string\"}"
Shell
복사
{ "channelAccountId": 6107, "orderCode": "20201208_000001", "name": "김지민", "mobile": "01033445566", "address": "서울특별시 마포구 양화로 147 4층", "postcode": "03995", "productUrl": "test.com",// optional "countryCode": "JP",// optional "deliveryMessage": "문 사이에 놓아 주세요.", "description": "포장 시 조심해 주세요.", "dealName": "열린 통신 12월 선물 세트", "dealOptionName": null, "quantity": 2, "pdfUrl": "https://some.thing.com/a.pdf", // optional "paperBarcode": "ABC123" // optional }
JSON
복사
입력 데이터 유형 1 - 호출 파라미터 예시
{ "channelAccountId": 6107, "orderCode": "20201208_000001", "name": "김지민", "mobile": "01033445566", "address": "서울특별시 마포구 양화로 147 4층", "postcode": "03995", "productUrl": "test.com",// optional "countryCode": "JP",// optional "deliveryMessage": "문 사이에 놓아 주세요.", "description": "포장 시 조심해 주세요.", "mappingData": [ { "resourceId": 3194, "quantity": 1 }, { "resourceId": 5129, "quantity": 2 } ], "pdfUrl": "https://some.thing.com/a.pdf" // optional }
JSON
복사
입력 데이터 유형 2 - 호출 파라미터 예시
"channelAccountId": 판매처 계정 고유 번호, "orderCode": "판매처 주문 번호", "name": "받는분", "mobile": "받는분 연락처", "address": "받는분 주소", "postcode": "받는분 우편번호", "deliveryMessage": "배송메시지", "description": "출고 시 처리메모", "dealName": "판매처 주문명", "dealOptionName": "판매처 주문명 보조", "quantity": "주문 수량", "productUrl" : “상품 URL”, // optional "countryCode" : “도착 국가”, // optional "pdfUrl": "받는분 개인화된 출력물이 있는 경우 공개 URL", // optional ”price”: “주문금액”, //optional ”settlementPrice”: “결제금액", //optional ”settlementGroupPrice: “총결제금액 (제공분)”, //optional
{ "id": 688762 }
JSON
복사
결과 예시
id: 등록된 임시 주문서 고유 번호
등록 완료 후 접수 처리되지 않은 임시 주문서는 품고나우 주문 접수 화면에서 조회할 수 있습니다.