로그인이 필요합니다.

개발가이드(ver2.0)

상품가공 계획 개요

완성된 가공품을 만들기 위해서는 먼저 상품가공 계획을 등록해야 합니다.
등록된 상품가공 계획은 사방넷 풀필먼트 > 상품 > 상품가공에서 확인할 수 있습니다.
물류사는 등록된 가공계획을 확인한 뒤, 가공지시하여 완성된 가공품을 만듭니다.
가공지시 API는 추후 업데이트를 통해 지원 할 예정입니다.

사방넷 풀필먼트 매뉴얼 : 상품가공 바로가기 ▶

지원 method

상품가공 계획 기본 Object 구조

데이터필드 자료형 설명
assembly_plan_uid integer 가공계획 ID
shipping_product_id integer 가공품 (출고상품 ID)
member_id integer 고객사 ID
product_name string(100) 가공품명
plan_datetime string(20) 등록일

YYYYMMDD 형식

target_date string(8) 목표일

YYYYMMDD 형식

complete_datetime string(20) 완료일

YYYYMMDD 형식

plan_quantity integer 계획 수량
complete_quantity integer 완료 수량
working_quantity integer 작업중 수량
incomplete_quantity integer 미완료 수량

상품가공 계획 등록(단일)

Request URI /v2/assembly/assembly_plan
Method POST
권한 고객사, 물류사

Request Param

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

물류사 권한인 경우 필수

assembly_product_uid integer 가공품 ID

필수

quantity integer 계획수량

필수

target_date string(8) 목표일

YYYYMMDD 형식, 기본값 : 오늘 날짜

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response assembly_product_uid integer 가공품 ID
assembly_plan_uid integer 가공계획 ID

Request Sample

{
  "member_id": "70",
  "assembly_product_uid": "100",
  "quantity": 5,
  "target_date": "20220525"
}

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "assembly_product_uid": "100",
    "assembly_plan_uid": "282"
  }
}

상품가공 계획 등록(벌크)

Request URI /v2/assembly/assembly_plans
Method POST
권한 고객사, 물류사

Request Param

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

물류사 권한인 경우 필수

request_data_list

요청 데이터 리스트,
최대 100개

assembly_product_uid integer 가공품 ID

필수

quantity integer 계획수량

필수

target_date string(8) 목표일

YYYYMMDD 형식, 기본값 : 오늘 날짜

Response Param

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

(처리 완료 데이터 리스트)

assembly_plan_uid integer 가공계획 ID
assembly_product_uid integer 가공품 ID

Request Sample

{
    "member_id" : "70",
    "request_data_list" : [
        {
            "assembly_product_uid" : "70",
            "quantity" : "5",
            "target_date" : "20220527"
        },
        {
            "assembly_product_uid" : "98",
            "quantity" : "3",
            "target_date" : "20220528"
        }
    ]
}

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "processed_count": 2,
        "processed_data_list": [
            {
                "assembly_product_uid": "70",
                "assembly_plan_uid": "292"
            },
            {
                "assembly_product_uid": "98",
                "assembly_plan_uid": "293"
            }
        ]
    }
}

상품가공 계획 삭제(단일)

Request URI /v2/assembly/assembly_plan/{가공계획 ID}
Method DELETE
권한 고객사, 물류사
설명 가공지시 내역이 있는 경우 삭제 불가

Response Param

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

Request Sample

/v2/assembly/assembly_plan/90

Response Sample

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

상품가공 계획 조회(단일)

Request URI /v2/assembly/assembly_plan/{가공계획 ID}
Method GET
권한 고객사, 물류사

Response Param

데이터필드 자료형 설명
code string(4) 응답코드
message string(100) 응답메시지
response assembly_plan_uid integer 가공계획 ID
shipping_product_id integer 가공품 (출고상품 ID)
member_id integer 고객사 ID
product_name string(100) 가공품명
plan_datetime string(20) 등록일

YYYYMMDD 형식

target_date string(8) 목표일

YYYYMMDD 형식

complete_datetime string(20) 완료일

YYYYMMDD 형식

plan_quantity integer 계획 수량
complete_quantity integer 완료 수량
working_quantity integer 작업중 수량
incomplete_quantity integer 미완료 수량

Request Sample

/v2/assembly/assembly_plan/297

Response Sample

{
    "code": "9999",
    "message": "ok",
    "response": {
        "assembly_plan_uid": "297",
        "shipping_product_id": "43837",
        "member_id": "70",
        "product_name": "가공품완성품",
        "plan_datetime": "2022-05-26 17:54:48",
        "target_date": "20220527",
        "complete_datetime": "",
        "plan_quantity": "1",
        "complete_quantity": "0",
        "working_quantity": 0,
        "incomplete_quantity": 1
    }
}

상품가공 계획 조회(벌크)

Request URI /v2/assembly/assembly_plans
Method GET
권한 고객사, 물류사

Request Param

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

물류사 권한인 경우 필수

shipping_product_ids array 배열 가공품 (출고상품 ID)
plan_date string(8) 가공 등록일

YYYYMMDD 형식

complete_date string(8) 가공 완료일

YYYYMMDD 형식

page integer 페이지 번호

Response Param

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

(처리 데이터 리스트)

assembly_plan_uid integer 가공계획 ID
shipping_product_id integer 가공품 (출고상품 ID)
member_id integer 고객사 ID
product_name string(100) 가공품명
plan_datetime string(20) 등록일

YYYYMMDD 형식

target_date string(8) 목표일

YYYYMMDD 형식

complete_datetime string(20) 완료일

YYYYMMDD 형식

plan_quantity integer 계획 수량
complete_quantity integer 완료 수량
working_quantity integer 작업중 수량
incomplete_quantity integer 미완료 수량

Request Sample

/v2/assembly/assembly_plans?member_id=70&assembly_product_uids=91&assembly_product_uids=92&plan_date=20220518

Response Sample

{
  "code": "9999",
  "message": "ok",
  "response": {
    "total_count": 4,
    "total_page": 2,
    "current_page": 1,
    "data_list": [
      {
        "shipping_product_id": "41837",
        "member_id": "70",
        "product_name": "혼술 셋트",
        "plan_datetime": "2022-05-10 14:24:56",
        "target_date": "20220511",
        "complete_datetime": "",
        "plan_quantity": "5",
        "complete_quantity": "0",
        "working_quantity": 0,
        "incomplete_quantity": 5
      },
      {
        "shipping_product_id": "43797",
        "member_id": "70",
        "product_name": "파우치",
        "plan_datetime": "2022-05-04 10:24:05",
        "target_date": "20220520",
        "complete_datetime": "",
        "plan_quantity": "1",
        "complete_quantity": "0",
        "working_quantity": 0,
        "incomplete_quantity": 1
      }
    ]
  }
}
Top