입고예정 개요
출고상품 기준으로 입고예정 등록하며, 입고작업이 시작되지 않았다면 입고예정 수정할 수 있습니다.
등록된 입고예정으로 입고작업을 완료했다면, 예정대비입고현황 조회 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.입고취소 |
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 에는 리턴되지 않음 |
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.취소 |
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 |
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.입고취소 |
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 |
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.입고취소 |
receiving_type | integer | 입고분류 1.입고예정검수, 3.개별입고, 5.간편입고, 7.전수검사, 9.엑셀입고 |
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.입고취소 |
||
receiving_plan_id | integer | 입고예정ID | ||
receiving_type | integer | 입고분류 1.입고예정검수, 3.개별입고, 5.간편입고, 7.전수검사, 9.엑셀입고 |
||
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": "입고메모 테스트용"
}
]
}
}