ERP 연동 — API 통합

3단계 온보딩

1. 1 · 키 및 샌드박스권한이 분리된 테스트 키와 운영 키를 발급받습니다(발행 전용, 수집 전용, 둘 다).
2. 2 · 프로그래밍 대신 필드 매핑귀사의 내보내기 형식(CSV, IDoc 유형, JSON)이 품목 행을 포함해 서버 측에서 인보이스 모델로 매핑됩니다. 무엇이든 발행되기 전에 드라이런(dry-run)으로 결과를 미리 확인합니다.
3. 3 · 테스트 문서 → 승인 → 운영 전환샌드박스 문서가 실제 검증을 거치고, 모든 것이 맞으면 운영 키를 활성화합니다. 연동 상태(키, 매핑, 최초 문서)는 언제든 조회할 수 있습니다.

상시 운영에서의 신뢰성

• 멱등성: 동일한 문서 번호를 두 번 전송해도 → 문서는 하나, 중복은 없습니다. 타임아웃 후 재전송도 안전합니다.
• 정직한 오류: 잘못된 문서는 구체적인 규칙 위반과 함께 오류로 반환됩니다 — '어떻게든 되겠지' 식의 침묵은 없습니다.
• 테넌트 분리 및 세그먼트: ERP 키는 ERP 테넌트에서만 작동합니다. 웹 계정은 API 접근 권한이 없으며, 그 반대도 마찬가지입니다.
• 완전한 아카이브: API로 처리된 문서도 8년간 변경 불가 상태로 GoBD 아카이브에 보관됩니다 — 귀사의 ERP가 이 기능을 직접 갖출 필요가 없습니다.

머신 인터페이스의 보안

API 키는 해시되어 저장되며(평문은 생성 시 한 번만 표시됨), 권한(발행 전용, 수집 전용)과 환경(샌드박스/운영)을 가지고, 언제든 교체할 수 있습니다. 모든 호출은 테넌트에 귀속되고 기록됩니다. 웹 화면과 머신 API는 엄격히 분리된 접근 경로입니다.

호출 예시

POST /v1/erp/invoices · Authorization: Bearer <API-Key>
{"number":"RE-2026-1042","buyer":{"name":"Kunde GmbH","country":"DE","vat_id":"DE…"},"lines":[{"name":"Seefracht","net_price":2500,"service_type":"intl_transport"}]}
응답: {"status":"VALID","number":"RE-2026-1042", …} — 또는 정확한 검증 오류.

자주 묻는 질문

연동은 기술적으로 이렇게 작동합니다

귀사의 시스템은 API 키 인증을 사용하는 가벼운 REST API를 호출합니다: 인보이스 데이터를 JSON(헤더, 파트너, 품목, 세금 및 지급 정보)으로 전달하면, CoolHanX가 이를 바탕으로 EN 16931을 준수하는 XRechnung을 생성하고, BR-DE에 대해 검증하고, 누락 없는 연속 번호를 부여하고, GoBD 기준으로 아카이브한 뒤 상태를 회신합니다. 발행은 멱등적입니다: 동일한 참조로 재호출해도 이중 인보이스가 생성되지 않습니다.

ERP 데이터에서 검증된 전자 인보이스까지

1. 1 · 매핑 설정귀사의 필드명을 EN 16931 BT(Business Term)에 한 번 매핑합니다 — 운영 전환 전에 온보딩 단계에서 샌드박스 테스트 실행과 함께 진행합니다.
2. 2 · 데이터 전송귀사의 ERP가 인보이스 데이터셋으로 API를 호출합니다.
3. 3 · 검증 및 발행CoolHanX가 검증하고, 번호를 부여하고, 아카이브합니다 — 오류 시에는 번호를 소비하지 않고 구체적인 BR-DE 코드를 반환합니다.
4. 4 · 상태 회신결과(VALID/오류), 인보이스 번호, 아카이브 참조가 귀사의 시스템으로 회신됩니다.

온보딩, 샌드박스, 가격

ERP 고객에게는 운영 전환 전에 매핑과 발행을 안전하게 테스트할 수 있는 샌드박스가 제공됩니다. 견적은 문서량과 연동 작업량에 따라 정해집니다 — 정액 요금 대신 적합한 견적을 드리니, 문의해 주시기 바랍니다.

관련 주제

우리가 연동하는 ERP 시스템과 포맷

인보이스 데이터를 내보낼 수 있는 것이라면 무엇이든 연동됩니다 — 포맷 작업은 우리의 서버 측 매핑이 담당합니다. 검증된 방식은 다음과 같습니다:

어떤 프로그래밍 언어로도 연동 가능

이 인터페이스는 API 키를 사용하는 가벼운 REST API입니다 — Python, PHP, Java, C#, Node.js 또는 curl로 직접 연동할 수 있습니다. 인보이스 데이터를 JSON으로 전송하면, CoolHanX가 생성하고, 검증하고, 번호를 부여하고, 아카이브한 뒤 상태를 회신합니다. SDK 강제도, 독점 라이브러리도 없습니다.

curl -X POST https://…/v1/erp/invoices -H 'Authorization: Bearer <API-Key>' -H 'Content-Type: application/json' -d '{…}'