핵심 개념
Maybox와 연동할 때 알아야 할 업무 개념을 설명합니다. 각 문서에서 개념의 정의, 다른 개념과의 관계, 상태나 수량이 바뀌는 시점, 연동할 때 지켜야 할 규칙을 찾아볼 수 있습니다.
상품·입고·재고·출고의 관계
고객사별 연동 계정인증하여 해당 고객사 데이터에 접근 ↓
이벤트 · 웹훅 도착·입고·출고의 변경을 확인하고 최신 상태 조회고객사와 연동 계정데이터가 구분되는 범위와 API를 호출하는 계정·인증 정보의 관계
상품과 SKU고객사 상품 코드와 Maybox ID, 상품 정보·규격·실측의 차이
도착과 입고도착 기록·입고 요청·입고 완료 수량·입고 종료의 차이
재고와 예약현재고·가용·예약 수량의 정의와 계산 관계, 수량이 변하는 시점
출고 요청과 완료출고 완료 수량·부분 완료·요청 전체 완료와 인계 계획의 관계
이벤트와 웹훅변경 기록·전달 방식·최신 상태 조회와 누락 복구의 관계
개념 사이의 관계
섹션 제목: “개념 사이의 관계”- Maybox는 상품·입고·재고·출고를 고객사별로 구분합니다. 연동 계정은 연결된 고객사의 API를 호출합니다.
- SKU는 입고할 상품, 재고 수량, 출고할 상품을 연결하는 기준입니다.
- 도착 기록은 물건이 도착한 사실이고, 입고 요청은 들어올 상품과 예정 수량입니다. 창고가 처리한 입고 완료 수량만큼 현재고가 늘며 입고 종료는 별도로 확인합니다.
- 예약은 출고에 사용할 수량을 확보합니다. 출고 요청이 미사용 예약 수량을 확보하고, 출고 완료 수량만큼 현재고와 예약 수량이 줄어듭니다. 일부 완료와 요청 전체 완료는 구분합니다.
- 이벤트는 업무의 변경 기록입니다. 웹훅이나 이벤트 API로 변경을 확인한 뒤 해당 업무 API로 최신 상태를 조회합니다.
처음부터 큰 흐름을 읽고 싶다면 전체 업무 흐름을 살펴보세요. 상품 100개를 입고하고 20개를 예약한 뒤 12개를 출고하는 예제로 개념들을 연결합니다.