ORCA Open API

외부 시스템에서 ORCA MES 수주를 안전하게 등록하기 위한 개발자 가이드입니다.

MES Pro 이상 요금제부터 사용 가능합니다

인증

연동관리에서 발급한 Customer API key를 Authorization: Bearer 헤더로 전달합니다. key 원문은 생성 직후 한 번만 표시됩니다.

Idempotency

모든 수주 등록 요청에는 Idempotency-Key가 필요합니다. 같은 외부 주문의 재시도는 새 수주를 만들지 않습니다.

수주 등록 v1

POST /v1/sales-orders

오류 처리

인증 실패, 만료·폐기 key, vendor/item 미매핑과 rate limit은 안정적인 error code와 HTTP 상태로 반환됩니다.