오토메타 로봇서비스 개발 가이드

오토메타 커머스 백엔드가 비스캣 로봇 관제(코어)와 연동해 주문→배송·수거를 처리하기 위한 개발 가이드입니다. 아이파크홈 앱 주문은 오토메타를 경유해 비스캣으로 진입하며, 비스캣이 작성·제공하는 10종 API를 기준으로 합니다.

이 가이드 구성

1. 연동 개요

주문 흐름은 아이파크홈 앱 → 오토메타 커머스 백엔드 → 비스캣 코어입니다. 앱은 코어와 직접 통신하지 않고, 오토메타가 미션 진입점이 됩니다. 사용자 표출 알림도 코어 → 오토메타 → 앱·월패드 경로로 역전파됩니다.

2. 역할 분담 (R&R)

구분비스캣오토메타
주문 진입배차 요청 수신·미션 생성·로봇 점유앱 주문을 받아 비스캣 API 호출
PIN사용자 PIN(랜덤 4자리) 생성·검증, 라이프사이클 관리점주 PIN(고정 4자리)을 배차 요청에 동봉
상태 통지매장 도착·출발·도착·하차 등 상태를 콜백으로 발신콜백 수신 → 앱·월패드 표출
알림 문구이벤트 코드만 전달 (예: NOTI_ETA_5MIN)코드 → 사용자 표출 문구 관리

PIN 정책 (5/22 확정)

점주 PIN은 고정 4자리로 오토메타가 배차 요청(#2)에 동봉합니다. 사용자 PIN은 랜덤 4자리로 비스캣이 생성해 배차 응답으로 회신합니다. 박스 4칸 할당은 관제가 주문 수량 기반으로 결정하며, 주문 수량이 4칸을 초과하면 배차가 거부됩니다.

3. 선결 조건·협의 항목