Skip to main content
ORCA
MES
KR

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 상태로 반환됩니다.