운영 연결 준비

기본 가이드를 구현한 뒤, 협의한 연동 테스트 환경에서 상품 등록부터 입고 완료 수량 조회·예약·출고 완료 수량 조회까지 Maybox 담당자와 한 번 진행합니다. 고객사 개발 담당자는 API·수신기 결과를, 창고 담당자는 실제 작업과 수량을 대조합니다.

업무 결과를 함께 확인

• 입고: 고객사 시스템의 입고 번호와 Maybox ID의 연결 관계, 예정·등록·입고 완료 수량을 대조합니다. 일부 수량이 먼저 완료돼도 요청은 OPEN일 수 있고, 예정 수량보다 적게 받고 CLOSED로 종료할 수 있음을 확인합니다. 등록 내용이 바뀌면 최신 버전과 확인 요청을 다시 조회·검토하는지 검증합니다.
• 출고: 요청·출고 완료·남은 수량을 대조하고 부분 완료와 요청 전체의 COMPLETED를 구분합니다. 출고된 수량만큼 현재고와 예약이 함께 줄어드는지 확인합니다. 예약 부족·출고 생성 실패를 처리하고, 취소 뒤 불필요한 미사용 예약 수량의 해제를 판단하는지도 확인합니다.
• 가용 수량: 입고 완료 수량을 모두 새로 예약할 수 있다고 가정하지 않습니다. 자동 예약을 사용한 입고와 이미 예약한 물량의 출고에서 가용 수량을 대조합니다.
• 중복 방지: 같은 키·입력으로 재전송하거나 응답이 끊긴 상황에서 입고·예약·출고가 중복 생성되지 않는지 대조합니다.

수신과 복구를 확인

• 서명 오류를 반영하지 않고 중복·역순 수신을 처리하는지 확인합니다.
• 수신한 이벤트를 저장한 뒤 처리 프로그램을 재시작해도 처리 대기 중인 이벤트를 이어서 처리하는지 확인합니다.
• 초기 동기화 중 변경과 수신 중지 기간의 변경을 API로 복구하고 현재 상태와 대조합니다.

테스트한 시나리오, 고객사 시스템의 입출고 번호와 Maybox ID의 연결 관계, 기대한 수량과 실제 결과, 실패·복구 확인 내용을 정리해 양측 담당자와 공유합니다. API 인증 정보·서명 키·불필요한 개인정보는 검증 기록에 포함하지 않습니다.

운영 연결 정보를 맞추기

운영 API 인증 정보·서명 키·수신 URL을 테스트 설정과 구분합니다. 대상 업무, 데이터량과 호출 빈도, 입고 등록 내용 확인 담당, 인계 방식과 추가 지시, 양측 기술·창고 담당자와 장애 연락 경로를 함께 확인합니다.

고객사 시스템의 입출고 번호와 Maybox ID의 연결 관계, 처리 결과를 아직 확인하지 못한 API 요청, 마지막 이벤트 조회 커서, 마지막 수신·처리 성공 시각을 저장해 장애 뒤 재개할 수 있게 합니다.

다음 단계

검증 결과와 운영 연결 희망 일정을 기존 Maybox 담당자에게 전달해 주세요. 남은 업무 조건과 운영 설정, 창고 작업 진행 방법을 양측이 확인한 뒤 연결합니다. 아직 테스트를 시작하지 않았다면 연결 준비 요청 항목부터 확인하세요.