로그인이 필요합니다.
클라우드 서비스 보급·확산 사업 공급기업 선정! 이용료 최대 80% 지원

개발가이드(ver2.0)

발주 개요

발주등록 시 필수값을 입력해야 합니다.
등록한 발주를 수정할 경우엔 발주 진행상태가 order_status=1인 경우에만 가능합니다.

사방넷 풀필먼트 매뉴얼 : 발주등록 바로가기 ▶

지원 method

발주 기본 Object 구조

데이터필드 자료형 설명
order_id integer 발주 ID
member_id integer 고객사 ID

물류사 권한인 경우 필수

order_code string(20) 오더코드
company_order_code string(100) 주문번호

필수
- API로 발주 등록/수정하는 경우, 주문번호 중복될 수 없음
- 단, 발주 진행상태가 출고취소라면 해당 발주 건의 주문번호와 동일한 주문번호로 등록 가능함
- (참고) 사방넷 풀필먼트에서 발주 등록/수정하는 경우엔 주문번호 중복 가능함

shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4.당일배송
코드정보 shipping_type_code 참고

order_status integer 발주 진행상태

1.출고요청전, 3.출고요청, 5.송장등록완료, 7.출고완료, 9.출고취소
코드정보 order_status_code 참고

order_date DATETIME 발주등록일시

YYYY-MM-DD HH24:MI:SS 형식

request_shipping_dt string(8) 출고희망일

필수(과거 날짜 입력 불가), YYYYMMDD 형식

buyer_name string(100) 주문자명
receiver_name string(100) 받는분 이름

필수

tel1 string(20) 받는분 전화번호 1

필수

tel2 string(20) 받는분 전화번호 2
zipcode string(20) 받는분 우편번호
shipping_address1 string(150) 받는분 주소1

필수

shipping_address2 string(150) 받는분 주소2
shipping_message string(150) 배송 메시지
channel_id integer 발주타입 ID
memo1 string(500) 관리메모1
memo2 string(500) 관리메모2
memo3 string(500) 관리메모3
memo4 string(500) 관리메모4
memo5 string(500) 관리메모5
order_item_list childDataObject order_item_object 구성 ▶

필수 판매상품 리스트

order_item_object 구조

데이터필드 자료형 설명
sales_product_id integer 판매상품 ID

필수

quantity integer 주문수량

필수

item_cd1 string(50) 상품별메모1
item_cd2 string(50) 상품별메모2
item_cd3 string(50) 상품별메모3

발주 등록(단일)

Request URI /v2/request/order
Method POST
권한 고객사, 물류사

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

company_order_code string(100) 주문번호

필수
- API로 발주 등록/수정하는 경우, 주문번호 중복될 수 없음
- 단, 발주 진행상태가 출고취소라면 해당 발주 건의 주문번호와 동일한 주문번호로 등록 가능함
- (참고) 사방넷 풀필먼트에서 발주 등록/수정하는 경우엔 주문번호 중복 가능함

shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4.당일배송
코드정보 shipping_type_code 참고

request_shipping_dt string(8) 출고희망일

필수(과거 날짜 입력 불가), YYYYMMDD 형식

buyer_name string(100) 주문자명
receiver_name string(100) 받는분 이름

필수

tel1 string(20) 받는분 전화번호 1

필수

tel2 string(20) 받는분 전화번호 2
zipcode string(20) 받는분 우편번호
shipping_address1 string(150) 받는분 주소1

필수

shipping_address2 string(150) 받는분 주소2
shipping_message string(150) 배송 메시지
channel_id integer 발주타입 ID
memo1 string(500) 관리메모1
memo2 string(500) 관리메모2
memo3 string(500) 관리메모3
memo4 string(500) 관리메모4
memo5 string(500) 관리메모5
order_item_list childDataObject order_item_object 구성 ▶

필수

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response order_id integer 발주 ID
company_order_code string(100) 주문번호
order_code string(20) 오더코드

Request Sample

{
  "member_id": 70,
  "company_order_code": "20211122-02",
  "shipping_method_id": 1,
  "request_shipping_dt": "20211127",
  "receiver_name": "홍길동",
  "buyer_name": "구매자명",
  "tel1": " 02-123-41234",
  "tel2": " 02-456-789",
  "zipcode": "087-789",
  "shipping_address1": "서울시 강서구 마곡동",
  "shipping_address2": "마곡747타워 1209호",
  "shipping_message": "배송메시지",
  "channel_id": "37",
  "memo1": "memo1",
  "memo2": "memo2",
  "memo3": "",
  "memo4": "",
  "memo5": "",
  "order_item_list": [
    {
      "sales_product_id": "51715",
      "quantity": "1",
      "item_cd1": "111",
      "item_cd2": "222",
      "item_cd3": "3333"
    },
    {
      "sales_product_id": "51722",
      "quantity": "2",
      "item_cd1": "111",
      "item_cd2": "222",
      "item_cd3": "3333"
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
  "order_code": "O20211125-00001",
  "company_order_code" : "IFS-0124",
  "order_id": 182357
  }
 }

발주 등록(벌크)

Request URI /v2/request/orders
Method POST
권한 고객사, 물류사
비고 최대 100개 까지

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

request_data_list company_order_code string(100) 주문번호

필수
- API로 발주 등록/수정하는 경우, 주문번호 중복될 수 없음
- 단, 발주 진행상태가 출고취소라면 해당 발주 건의 주문번호와 동일한 주문번호로 등록 가능함
- (참고) 사방넷 풀필먼트에서 발주 등록/수정하는 경우엔 주문번호 중복 가능함

shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4.당일배송
코드정보 shipping_type_code 참고

request_shipping_dt string(8) 출고희망일

필수 (과거 날짜 입력 불가), YYYYMMDD 형식

buyer_name string(100) 주문자명
receiver_name string(100) 받는분 이름

필수

tel1 string(20) 받는분 전화번호 1

필수

tel2 string(20) 받는분 전화번호 2
zipcode string(20) 받는분 우편번호
shipping_address1 string(150) 받는분 주소1

필수

shipping_address2 string(150) 받는분 주소2
shipping_message string(150) 배송 메시지
channel_id integer 발주타입 ID
memo1 string(500) 관리메모1
memo2 string(500) 관리메모2
memo3 string(500) 관리메모3
memo4 string(500) 관리메모4
memo5 string(500) 관리메모5
order_item_list childDataObject order_item_object 구성 ▶

필수

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response processed_data_list

처리 완료 데이터 리스트

order_id integer 발주 ID
company_order_code string(100) 주문번호
order_code string(20) 오더코드
processed_count integer 처리 갯수

Request Sample

{
  "member_id": "70",
  "request_data_list": [
    {
      "company_order_code": "20211124-01",
      "shipping_method_id": 1,
      "request_shipping_dt": "20211130",
      "receiver_name": "정보배",
      "buyer_name": "구매자명",
      "tel1": " 02-123-41234",
      "tel2": " 02-456-789",
      "zipcode": "087-789",
      "shipping_address1": "서울시 강서구 마곡동",
      "shipping_address2": "마곡747타워 1209호",
      "shipping_message": "배송메시지",
      "channel_id": "36",
      "memo1": "memo1",
      "memo2": "memo2",
      "memo3": "",
      "memo4": "",
      "memo5": "",
      "order_item_list": [
        {
          "sales_product_id": "51663",
          "quantity": "1",
          "item_cd1": "111",
          "item_cd2": "222",
          "item_cd3": "3333"
        },
        {
          "sales_product_id": "53740",
          "quantity": "2",
          "item_cd1": "111",
          "item_cd2": "222",
          "item_cd3": "3333"
        }
      ]
    },
    {
      "company_order_code": "20211124-03",
      "shipping_method_id": 1,
      "request_shipping_dt": "20211130",
      "receiver_name": "정보배",
      "buyer_name": "구매자명",
      "tel1": " 02-123-41234",
      "tel2": " 02-456-789",
      "zipcode": "087-789",
      "shipping_address1": "서울시 강서구 마곡동",
      "shipping_address2": "마곡747타워 1209호",
      "shipping_message": "배송메시지",
      "channel_id": 57,
      "memo1": "memo1",
      "memo2": "memo2",
      "memo3": "",
      "memo4": "",
      "memo5": "",
      "order_item_list": [
        {
          "sales_product_id": "53783",
          "quantity": "1",
          "item_cd1": "111",
          "item_cd2": "222",
          "item_cd3": "3333"
        },
        {
          "sales_product_id": "51665",
          "quantity": "2",
          "item_cd1": "111",
          "item_cd2": "222",
          "item_cd3": "3333"
        }
      ]
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
  "processed_data_list": [
  {
  "order_code": "O20211124-00001",
  "company_order_code" : "IFS-0124",
  "order_id": 182381
  },
  {
  "order_code": "O20211124-00002",
  "company_order_code" : "IFS-0125",
  "order_id": 182382
  },
  {
  "order_code": "O20211124-00003",
  "company_order_code" : "IFS-0126",
  "order_id": 182383
  }
  ],
  "processed_count": 3
  }
 }

발주 수정

Request URI /v2/request/order/{발주ID}
Method PUT
권한 고객사, 물류사
비고 발주 진행상태(order_status)가 1인 경우에만 수정 가능
코드정보 order_status_code 참고

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

company_order_code string(100) 주문번호

필수
- API로 발주 등록/수정하는 경우, 주문번호 중복될 수 없음
- 단, 발주 진행상태가 출고취소라면 해당 발주 건의 주문번호와 동일한 주문번호로 등록 가능함
- (참고) 사방넷 풀필먼트에서 발주 등록/수정하는 경우엔 주문번호 중복 가능함

shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4.당일배송
코드정보 shipping_type_code 참고

request_shipping_dt string(8) 출고희망일

필수 (과거 날짜 입력 불가), YYYYMMDD 형식

buyer_name string(100) 주문자명
receiver_name string(100) 받는분 이름

필수

tel1 string(20) 받는분 전화번호 1

필수

tel2 string(20) 받는분 전화번호 2
zipcode string(20) 받는분 우편번호
shipping_address1 string(150) 받는분 주소1

필수

shipping_address2 string(150) 받는분 주소2
shipping_message string(150) 배송 메시지
channel_id integer 발주타입 ID
memo1 string(500) 관리메모1
memo2 string(500) 관리메모2
memo3 string(500) 관리메모3
memo4 string(500) 관리메모4
memo5 string(500) 관리메모5
order_item_list childDataObject order_item_object 구성 ▶

필수

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지

Request Sample

{
  "company_order_code": "20211124-v3",
  "shipping_method_id": 2,
  "request_shipping_dt": "20211124",
  "channel_id": 37,
  "receiver_name": "정보배2",
  "buyer_name": "구매자명2",
  "tel1": " 02-123-4120",
  "tel2": " 02-456-7890",
  "zipcode": "087-780",
  "shipping_address1": "서울시 강서구 마곡동2",
  "shipping_address2": "마곡747타워 1209호2",
  "shipping_message": "배송메시지@@2",
  "memo1": "memo1@2",
  "memo2": "memo2@2",
  "memo3": "@@2",
  "memo4": "2",
  "memo5": "2",
  "order_item_list": [
    {
      "sales_product_id": "51715",
      "quantity": "5",
      "item_cd1": "11@222",
      "item_cd2": "2@222",
      "item_cd3": "33@222"
    },
    {
      "sales_product_id": "51722",
      "quantity": "5",
      "item_cd1": "11@222",
      "item_cd2": "22@222",
      "item_cd3": "33@222"
    }
  ]
}

Response Sample

{
  "code": "9999",
  "message": "ok"
 }

발주 조회(단일)

Request URI /v2/request/order/{발주ID}
Method GET
권한 고객사, 물류사

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response dataObject 발주 기본 Object 구성 ▶

Request Sample

/v2/request/order/181764

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "member_id": 2,
        "tel1": "01011112222",
        "tel2": "01033334444",
        "shipping_method_id": 1,
        "company_order_code": "20220516-00001",
        "buyer_name": "홍길동",
        "request_shipping_dt": "20220614",
        "order_code": "O20220614-00003",
        "zipcode": "07807",
        "order_status": 5,
        "order_date": "2022-06-14 07:58:59",
        "memo5": "",
        "memo4": "",
        "shipping_address2": "1207호",
        "memo3": "",
        "shipping_address1": "서울 강서구 공항대로 168 (마곡동, 747)",
        "memo2": "",
        "memo1": "",
        "order_item_list": [
            {
                "sales_product_id": 2,
                "quantity": 1,
                "item_cd1": "",
                "item_cd2": "",
                "item_cd3": ""
            },
            {
                "sales_product_id": 3,
                "quantity": 1,
                "item_cd1": "",
                "item_cd2": "",
                "item_cd3": ""
            }
        ],
        "receiver_name": "홍길동",
        "order_id": 771,
        "channel_id": 1,
        "shipping_message": ""
    }
}

발주 조회(벌크)

Request URI /v2/request/orders
Method GET
권한 고객사, 물류사

Request Param

데이터필드 자료형 설명
member_id integer 고객사 ID

물류사 권한인 경우 필수

order_code string(20) 오더코드
company_order_codes string(100) 주문번호

최대 100개까지

shipping_method_id integer 배송방식

1.택배, 2.직송, 3.새벽배송, 4. 당일배송
코드정보 shipping_type_code 참고

order_status integer 발주 진행상태

코드정보 order_status_code 참고

order_dt string(8) 발주 등록일

YYYYMMDD 형식

request_shipping_dt string(8) 출고 희망일

YYYYMMDD 형식

channel_id integer 발주타입

발주타입 참고

page integer 페이지 번호

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response total_count integer 전체 갯수
total_page integer 전체 페이지수
current_page integer 현재 페이지 번호
data_list

처리 데이터 리스트

dataList 발주 기본 Object 구성 ▶

Request Sample

/v2/request/orders?member_id=2&request_shipping_dt=20220614&order_code=O20220613-00001&shipping_method_id=1&order_status=5&channel_id=0&order_dt=20220613

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "data_list": [
            {
                "order_id": 768,
                "member_id": 2,
                "order_code": "O20220613-00001",
                "company_order_code": "",
                "shipping_method_id": 1,
                "order_status": 5,
                "order_date": "2022-06-13 13:46:02",
                "request_shipping_dt": "20220614",
                "channel_id": 0,
                "buyer_name": "홍길동",
                "receiver_name": "홍길동",
                "tel1": "01011112222",
                "tel2": "",
                "zipcode": "",
                "shipping_address1": "서울시 강서구 공항대로 168",
                "shipping_address2": "1207호",
                "shipping_message": "",
                "memo1": "",
                "memo2": "",
                "memo3": "",
                "memo4": "",
                "memo5": "",
                "order_item_list": [
                    {
                        "sales_product_id": 1,
                        "quantity": 1,
                        "item_cd1": "",
                        "item_cd2": "",
                        "item_cd3": ""
                    }
                ]
            }
        ],
        "total_count": 1,
        "total_page": 1,
        "current_page": 1
    }
}
Top