볼테나 ERP 외부연동 API
API by Boltena · rest
- 모든 요청에 x-api-key 헤더로 발급받은 키를 넣습니다. 키에 회사 정보가 담겨 있어 회사코드를 따로 보내지 않습니다. - 호출 주소는 모든 고객이 같습니다(회사별 주소가 따로 있지 않습니다) — 어느 회사인지는 키가 정합니다. 전용 서버(온프렘)로 쓰시는 경우에만 계약된 주소를 사용하세요. - 외부연동은 연동(CONN) 모듈 계약이 있어야 열립니다. 계약이 해지되면 기준정보 내려받기(GET)와 이미 보낸 자료의 취소(DELETE)는 계속 되지만, 새로 보내는 것(POST)과 AI 비서 연결(MCP) 은 닫힙니다 — 이미 보낸 자료를 정리할 길은 항상 열어 두되, AI 조회는 이 모듈이 제공하는 기능 자체이기 때문입니다. - 장부 자료 자체는 계약과 무관합니다. AI 조회가 닫혀도 재고·매출·미수채권·시산표는 제품 화면에서 계속 보시고 엑셀로 내보낼 수 있습니다 — 잠기는 것은 자료가 아니라 AI 가 읽는 통로입니다. - 보내는 쪽 고유번호(extRef)를 반드시 남겨 두세요. 통신이 끊겨 같은 자료를 다시 보내도 중복이 생기지 않고, 나중에 취소할 때도 이 번호로 찾습니다. - 기준정보는 ERP 가 원본입니다. 외부에서 품목·거래처를 만들거나 고치는 API 는 열려 있지 않습니다(한 장부 원칙). - 호출 한도는 분당 600회입니다(초과 시 429). - AI 비서 연결(MCP): 같은 키로 POST /api/ext/mcp 에 연결하면 Claude·ChatGPT 같은 AI 비서가 재고·매출·미수채권·수주/발주 잔량·시산표를 직접 조회합니다. 조회 전용이며 입력·수정·삭제 도구는 제공하지 않습니다. - 키를 발급할 때 그 키의 AI 조회 범위를 지정할 수 있습니다(미지정이면 전체). 범위 밖 도구는 tools/list 에 나오지 않고, 이름을 알고 호출해도 데이터 없이 사유만 돌아옵니다. 발급 후 범위 변경은 불가하며 새 키를 발급합니다. - MCP 조회는 감사 기록에 남습니다 — 어느 키가 언제 어떤 자료를 읽었는지 제품의 사용현황…
Endpoint: https://app.boltena.com/
Verification: observed. Source: crawl.
Capabilities (8)
- 근태 보내기
- 설비 비가동 보내기
- 설비 비가동 취소
- 기준정보 내려받기
- AI 비서 연결(MCP)
- 연결 확인
- 생산실적 보내기
- 생산실적 취소