Maybox 연동 가이드
고객사 시스템에서 입고를 요청하고, 재고를 확인하고, 출고 결과를 받아보세요. Maybox API는 고객사의 업무 요청을 창고 작업으로 연결하고, 웹훅은 도착·입고·출고의 변경을 알려줍니다.
개념의 정의·관계·규칙은 핵심 개념에서, 요청·응답의 전체 필드는 API 레퍼런스에서 찾아볼 수 있습니다.
고객사 시스템과 창고의 역할
섹션 제목: “고객사 시스템과 창고의 역할”고객사 시스템은 상품과 입출고 요청, 주문별 재고 배정, 고객 알림을 담당합니다. Maybox는 창고의 물리 재고와 예약 수량, 작업 상태와 결과를 관리합니다.
실물 확인과 입고·출고 처리는 창고에서 수행합니다. 고객사 시스템은 API로 업무를 요청하고, 조회와 웹훅으로 완료 수량과 진행 상황을 확인합니다.
- 상품과 입고 — 고객사가 SKU와 입고 예정 수량을 제출합니다. 창고가 도착한 상품의 수량을 기록하면 고객사는 요청된 등록 내용을 확인하고, 이후 입고 완료 수량을 조회합니다.
- 재고와 출고 — 고객사가 가용 수량을 조회하고 예약한 뒤 출고를 요청합니다. 출고 완료 수량과 남은 수량을 조회합니다.
- 변경 수신 — 웹훅을 받으면 최신 상태를 API로 조회합니다. 주기적인 재고 대조와 누락 이벤트 복구도 함께 운영합니다.
입고·출고는 여러 번에 나눠 처리할 수 있습니다. 입고 완료 수량만큼 현재고가 늘고, 출고 완료 수량만큼 현재고와 예약이 줄어듭니다. 완료 수량과 요청 전체의 종료 여부는 별도로 확인합니다. 새로 예약할 수 있는 수량은 재고 API의 가용 수량을 기준으로 판단합니다.
필요한 업무부터 연결하세요
섹션 제목: “필요한 업무부터 연결하세요”지원 범위와 연결 조건
섹션 제목: “지원 범위와 연결 조건”| 업무 | 요청하거나 조회할 수 있는 내용 |
|---|---|
| 상품·입고 | SKU 등록과 이력, 입고 예정 수량 제출, 등록·입고 완료 수량과 사진 조회, 요청된 등록 내용 확인 |
| 도착 | 해당 고객사가 조회할 수 있는 도착 기록·사진 조회, 같은 고객사의 입고 요청과 연결 |
| 재고·예약 | 현재고·가용·예약 수량, 조건별 현재고·유통기한 조회, 수량 예약과 미사용 예약 해제 |
| 출고 | 출고 요청·완료 수량 조회, 인계 준비 지시·인계 계획 등록, 포장·팔레트·개별 인계 결과 조회 |
| 운송장·실측 | 창고에 등록된 국내 운송장 번호, 상품의 최신 실측, 별도 실측 요청과 결과 조회 |
| 변경 알림 | 도착·입고·출고 웹훅, 이벤트 API를 통한 누락 복구 |
주문·발주·결제, 배송사 예약·배송 추적·라벨 발급은 고객사 시스템에서 연결합니다. 운송장 조회는 창고에 기록된 번호를 제공하며 배송사의 기능을 대신하지 않습니다.
연동 검토용 초안 · 현재 제공하는 API를 기준으로 대표 흐름을 안내합니다. 실제 연결 시 대상 업무와 테스트 환경을 Maybox 담당자와 협의합니다. 기준일: 2026년 11월 13일.
처음 연결한다면 연결 준비 요청 항목을 확인하세요. 구현 중에는 인증과 공통 규칙, 오류와 재시도를 함께 참고할 수 있습니다.