웰컴 품고 / 견적
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 구성 예시는 아래를 참조해 주세요.
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", "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", "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": "주문 수량", "pdfUrl": "받는분 개인화된 출력물이 있는 경우 공개 URL", // optional ”price”: “주문금액”, //optional ”settlementPrice”: “결제금액", //optional ”settlementGroupPrice: “총결제금액 (제공분)”, //optional
{ "id": 688762 }
JSON
복사
결과 예시
id: 등록된 임시 주문서 고유 번호
등록 완료 후 접수 처리되지 않은 임시 주문서는 핸디봇 주문 접수 화면에서 조회할 수 있습니다.