🛍️

임시 주문서 1건 등록

PUT https://api.poomgo.com/open-api/oms/temp-order
Plain Text
복사

임시 주문서란?

핸디봇에서 임시 주문서는 출고 작업 전 수집되는 주문 정보입니다.

핸디봇 물류 담당자가 N개의 임시 주문서를 확인 후 접수 처리하는 시점에 주문서 원장이 생성되며 출고 작업이 시작됩니다.

접수 이후에 임시 주문서는 삭제되며 접수된 주문 정보는 주문서 원장 목록에서 확인할 수 있습니다.

입력 데이터 유형 - dealName과 mappingData 방식 중 택일

핸디봇은 dealName(필수), dealOptionName(선택) 값으로 주문서에 포함된 품목 * 수량 구성을 판단할 수 있습니다.

딜은 핸디봇 UI에서 임시 주문서 등록 전/후에 입력 가능

Deal을 활용하지 않고 정확한 resourceId를 지정해서 접수할 수도 있습니다.

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 - 호출 파라미터 예시

{
  "id": 688762
}
JSON
복사
결과 예시

id: 등록된 임시 주문서 고유 번호

등록 완료 후 접수 처리되지 않은 임시 주문서는 핸디봇 주문 접수 화면에서 조회할 수 있습니다.

"channelAccountId": 판매처 계정 고유 번호, "orderCode": "판매처 주문 번호", "name": "받는분", "mobile": "받는분 연락처", "address": "받는분 주소", "postcode": "받는분 우편번호", "deliveryMessage": "배송메시지", "description": "출고 시 처리메모", "dealName": "판매처 주문명", "dealOptionName": "판매처 주문명 보조", "quantity": "주문 수량", "pdfUrl": "받는분 개인화된 출력물이 있는 경우 공개 URL", // optional ”price”: “주문금액”, //optional ”settlementPrice”: “결제금액", //optional ”settlementGroupPrice: “총결제금액 (제공분)”, //optional