입고예정 개요

예정등록에 의해 상품을 입고처리한다면 먼저 입고예정을 등록합니다.
출고상품 기준으로 입고예정 등록하며, 입고작업이 시작되지 않았다면 입고예정 수정할 수 있습니다.
등록된 입고예정으로 입고작업을 완료했다면, 예정대비입고현황 조회 API로 조회합니다.
모든 입고작업내역을 조회할 경우, 입고작업내역 조회 API로 조회합니다.

사방넷 풀필먼트 매뉴얼: 입고예정 바로가기 ▶, 예정대비 입고현황 바로가기 ▶, 입고작업내역조회 바로가기 ▶

지원 method

입고예정 등록
입고예정 수정
입고예정 취소
입고예정 조회(단일)
입고예정 조회(벌크)
예정대비입고현황 조회
입고작업내역 조회(벌크)

입고예정 기본 Object 구조

데이터필드	자료형	설명
receiving_plan_id	integer	입고예정 ID
member_id	integer	고객사 ID 물류사 권한인 경우 필수
receiving_plan_code	string(20)	입고예정코드
plan_date	string(8)	입고예정일자 필수, YYYYMMDD 형식
plan_status	integer	입고예정 진행상태 1.입고예정, 2.입고검수중, 3.입고완료, 4.입고취소 코드정보 plan_status_code 참고
complete_dt	string(8)	완료일 YYYYMMDD 형식
memo	string(250)	입고예정메모
add_info1	string(50)	추가정보1
add_info2	string(50)	추가정보2
add_info3	string(50)	추가정보3
add_info4	string(50)	추가정보4
add_info5	string(50)	추가정보5
plan_product_list	childDataObject	plan_product_object 구성 ▶ 필수, 입고예정 리스트

plan_product_object 구조

데이터필드	자료형	설명
shipping_product_id	integer	출고상품 ID 필수
quantity	integer	예정수량 필수
receiving_plan_product_id	integer	입고 예정 상품 ID 조회시만 출력
plan_product_status	integer	입고예정 상품 입고상태 - 상태코드는 자동 생성되나 response data object 에는 리턴되지 않음 - 입고예정 조회에서만 노출 - 코드정보 plan_product_status_code 참고
expire_date	string(8)	유통기한 YYYYMMDD 형식, 유통기한을 사용하는 상품인 경우에만 입력
make_date	string(8)	제조일자 YYYYMMDD 형식, 제조일자를 사용하는 상품인 경우에만 입력

receiving_plan_product_object 구조

데이터필드	자료형	설명
receiving_plan_product_id	integer	입고예정상품 ID
shipping_product_id	integer	출고상품 ID
plan_quantity	integer	예정수량
plan_product_status	integer	입고예정 상품 입고상태 1.미입고, 3.부분입고, 5.입고완료, 9.취소 코드정보 plan_status_code 참고
receiving_quantity	integer	입고수량

입고예정 등록(단일)

Request URI	/v2/inventory/receiving_plan
Method	POST
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
receiving_plan_code	string(20)	입고예정코드
plan_date	string(8)	입고예정일자 필수, YYYYMMDD 형식
memo	string(250)	입고예정메모
add_info1	string(50)	추가정보1
add_info2	string(50)	추가정보2
add_info3	string(50)	추가정보3
add_info4	string(50)	추가정보4
add_info5	string(50)	추가정보5
plan_product_list	childDataObject	plan_product_object 구성 ▶ 필수, 입고예정 리스트

Response Param

데이터필드		자료형	설명
code		string(4)	응답코드
message		string(100)	응답메시지
response	receiving_plan_id	integer	입고예정 ID
response	receiving_plan_code	string(100)	입고예정코드

Request Sample

{
  "member_id": "70",
  "receiving_plan_code": "20211123_v1",
  "plan_date": "20211130",
  "memo": "memo-002",
  "add_info1": "추가정보 1",
  "add_info2": "추가정보2추가정보2",
  "add_info3": "추가정보 3",
  "add_info4": "추가정보 4",
  "add_info5": "추가정보5",
  "plan_product_list": [
  {
  "shipping_product_id": "43778",
  "quantity": "10",
  "expire_date": "20221030",
  "make_date": "20210830"
  },
  {
  "shipping_product_id": "43778",
  "quantity": "20",
  "expire_date": "20221230",
  "make_date": "20210901"
  },
  {
  "shipping_product_id": "41668",
  "quantity": "70",
  "expire_date": "20231230",
  "make_date": "20201010"
  }
  ]
 }

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
  "receiving_plan_code": "20211110_1",
  "receiving_plan_id": "506"
  }
}

입고예정 수정

Request URI	/v2/inventory/receiving_plan/{입고예정ID}
Method	PUT
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
plan_date	string(8)	입고예정일자 필수, YYYYMMDD 형식
memo	string(250)	입고예정메모
add_info1	string(50)	추가정보1
add_info2	string(50)	추가정보2
add_info3	string(50)	추가정보3
add_info4	string(50)	추가정보4
add_info5	string(50)	추가정보5
plan_product_list	childDataObject	plan_product_object 구성 ▶ 필수

Response Param

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

Request Sample

{
  "member_id":70
  "plan_date": "20211125",
  "memo": "memo-002",
  "add_info1": "add_info1",
  "add_info2": "add_info2",
  "add_info3": "add 3",
  "add_info4": "",
  "add_info5": "",
  "plan_product_list": [
  {
  "shipping_product_id": "43778",
  "quantity": "11",
  "expire_date": "20221130",
  "make_date": "20210830"
  },
  {
  "shipping_product_id": "41668",
  "quantity": "55",
  "expire_date": "20231230",
  "make_date": "20201010"
  }
  ]
 }

Response Sample

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

입고예정 취소

Request URI	/v2/inventory/receiving_plan/cancel/{입고예정ID}
Method	PUT
권한	고객사, 물류사
비고	입고 진행상태가 예정등록인 경우에만 가능

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수

Response Param

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

Request Sample

/v2/inventory/receiving_plan/cancel/716?member_id=70

Response Sample

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

입고예정 조회(단일)

Request URI	/v2/inventory/receiving_plan/{입고예정ID}
Method	GET
권한	고객사, 물류사

Response Param

데이터필드	자료형	설명
code	string(4)	응답코드
message	string(100)	응답메시지
response	dataObject	입고예정 Object 구성 ▶

Request Sample

/v2/inventory/receiving_plan/489

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
  "receiving_plan_id": "489",
  "member_id": "70",
  "receiving_plan_code": "20211125_1",
  "plan_date": "20211031",
  "plan_status": "1",
  "complete_dt": "",
  "memo": "memo-002",
  "add_info1": "add_info1 1",
  "add_info2": "add_info2",
  "add_info3": "add 3",
  "add_info4": "",
  "add_info5": "",
  "plan_product_list": [
  {
  "plan_product_status": 1,
  "quantity": 55,
  "expire_date": "20231230",
  "make_date": "",
  "shipping_product_id": 41668
  },
  {
  "plan_product_status": 1,
  "quantity": 22,
  "expire_date": "20221231",
  "make_date": "20210901",
  "shipping_product_id": 43778
  }
  ]
  }
 }

입고예정 조회(벌크)

Request URI	/v2/inventory/receiving_plans
Method	GET
권한	고객사, 물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 물류사 권한인 경우 필수
receiving_plan_code	string(20)	입고예정코드
plan_date	string(8)	입고예정일자 YYYYMMDD 형식
plan_status	integer	입고예정 진행상태 1.입고예정, 2.입고검수중, 3.입고완료, 4.입고취소 코드정보 plan_status_code 참고
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/inventory/receiving_plans?member_id=70&receiving_plan_code=&plan_date=20210910&plan_status=1&page=1

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 2,
    "total_page": 1,
    "current_page": 1,
    "data_list": [
      {
        "receiving_plan_id": "462",
        "member_id": "70",
        "receiving_plan_code": "2",
        "plan_date": "20210910",
        "plan_status": "1",
        "complete_dt": "",
        "memo": "",
        "add_info1": "",
        "add_info2": "",
        "add_info3": "",
        "add_info4": "",
        "add_info5": "",
        "plan_product_list": [
          {
            "plan_product_status": 1,
            "quantity": 1,
            "expire_date": "20210902",
            "make_date": "",
            "shipping_product_id": 41670
          }
        ]
      },
      {
        "receiving_plan_id": "446",
        "member_id": "70",
        "receiving_plan_code": "22223",
        "plan_date": "20210910",
        "plan_status": "1",
        "complete_dt": "",
        "memo": "",
        "add_info1": "",
        "add_info2": "",
        "add_info3": "",
        "add_info4": "",
        "add_info5": "",
        "plan_product_list": [
          {
            "plan_product_status": 1,
            "quantity": 1,
            "expire_date": "",
            "make_date": "",
            "shipping_product_id": 41669
          }
        ]
      }
    ]
  }
}

예정대비입고현황 조회

Request URI	/v2/inventory/receiving_plan_result/{입고예정ID}
Method	GET
권한	고객사, 물류사

Response Param

데이터필드		자료형	설명
code		string(4)	응답코드
message		string(100)	응답메시지
response	receiving_plan_id	integer	입고예정 ID
response	receiving_plan_product	childDataObject	receiving_plan_product_object 구조 ▶

Request Sample

/v2/inventory/receiving_plan_result/553

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
  "receiving_plan_id": "553",
  "receiving_plan_product": [
  {
  "receiving_plan_product_id": "2269",
  "shipping_product_id": "43790",
  "plan_quantity": "1",
  "plan_product_status": "5",
  "receiving_quantity": 1
  },
  {
  "receiving_plan_product_id": "2270",
  "shipping_product_id": "43791",
  "plan_quantity": "1",
  "plan_product_status": "1",
  "receiving_quantity": 0
  }
  ]
  }
 }

입고작업내역 조회(벌크)

Request URI	/v2/inventory/receiving_works
Method	GET
권한	물류사

Request Param

데이터필드	자료형	설명
member_id	integer	고객사 ID 필수
start_dt	string(8)	작업시작일 필수, YYYYMMDD 형식
end_dt	string(8)	작업종료일 필수, YYYYMMDD 형식
work_type	integer	작업구분 1.입고, 3.적치, 5.회송, 7.반품입고, 9.입고취소 코드타입 work_type_code 참고
receiving_type	integer	입고분류 1.입고예정검수, 3.개별입고, 5.간편입고, 7.전수검사, 9.엑셀입고 코드타입 receving_type_code 참고
receiving_plan_id	integer	입고예정ID
shipping_product_ids	array	출고상품ID 최대 100개
page	integer	페이지번호

Response Param

데이터필드			자료형	설명
code			string(4)	응답코드
message			string(100)	응답메시지
response	total_count		integer	전체 갯수
	total_page		integer	전체 페이지수
	current_page		integer	현재 페이지 번호
	data_list 처리 데이터 리스트	receiving_work_history_id	integer	입고작업 히스토리 ID
		work_date	datetime	작업일시 YYYY-MM-DD HH24:MI:SS 형식
		work_type	integer	작업구분 1.입고, 3.적치, 5.회송, 7.반품입고, 9.입고취소 코드타입 work_type_code 참고
		receiving_plan_id	integer	입고예정ID
		receiving_type	integer	입고분류 1.입고예정검수, 3.개별입고, 5.간편입고, 7.전수검사, 9.엑셀입고 코드타입 receving_type_code 참고
		shipping_product_id	integer	출고상품 ID
		quantity	integer	입고수량
		make_date	string(8)	제조일자 YYYYMMDD 형식
		expire_date	string(8)	유통기한 YYYYMMDD 형식
		location_id	integer	로케이션ID
		box_quantity	integer	박스 수
		pallet_quantity	integer	팔레트 수
		worker_member_id	integer	작업자 member_id
		work_memo	string(1000)	메모

Request Sample

/v2/inventory/receiving_works?member_id=70&start_dt=20211201&end_dt=20211227&work_type=1&receiving_type=1&shipping_product_ids%5B1%5D=41668&shipping_product_ids%5B2%5D=41669

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "total_count": 2,
        "total_page": 1,
        "current_page": 1,
        "data_list": [
            {
                "receiving_work_history_id": "83",
                "work_date": "2022-01-20 11:00:01",
                "work_type": "1",
                "receiving_plan_id": "5",
                "receiving_type": "1",
                "shipping_product_id": "5",
                "quantity": "10",
                "make_date": "",
                "expire_date": "20220326",
                "location_id": "2",
                "box_quantity": "1",
                "pallet_quantity": "1",
                "worker_member_id": "1",
                "work_memo": "입고메모 테스트용2"
            },
            {
                "receiving_work_history_id": "82",
                "work_date": "2022-01-20 10:59:45",
                "work_type": "1",
                "receiving_plan_id": "5",
                "receiving_type": "1",
                "shipping_product_id": "4",
                "quantity": "1",
                "make_date": "",
                "expire_date": "",
                "location_id": "2",
                "box_quantity": "1",
                "pallet_quantity": "1",
                "worker_member_id": "1",
                "work_memo": "입고메모 테스트용"
            }
        ]
    }
}

개발가이드(ver2.0)

입고예정 개요

지원 method

입고예정 기본 Object 구조

plan_product_object 구조

receiving_plan_product_object 구조

입고예정 등록(단일)

Request Param

Response Param

Request Sample

Response Sample

입고예정 수정

Request Param

Response Param

Request Sample

Response Sample

입고예정 취소

Request Param

Response Param

Request Sample

Response Sample

입고예정 조회(단일)

Response Param

Request Sample

Response Sample

입고예정 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample

예정대비입고현황 조회

Response Param

Request Sample

Response Sample

입고작업내역 조회(벌크)

Request Param

Response Param

Request Sample

Response Sample