ERP-서드파티 API 연결
ERP에서 서드파티로: CRM, 물류, 세무, 신원
REST, SOAP, 웹훅, iPaaS로 귀사 ERP와 주변 서비스를 연결하고, 재시도와 경보를 갖춥니다.
블루프린트
옆으로 스크롤하여 전체 그림을 확인하십시오.
ERP에서 서드파티로: 하나의 플랫폼, 여러 파트너
비즈니스 이벤트는 ERP에서 한 번만 나가고, 통합 플랫폼이 각 파트너가 기대하는 형식으로 전달합니다. 콜백도 같은 경로로 돌아옵니다. 재시도 후에도 실패한 메시지는 데드레터 대기열로 보내고 페이로드를 첨부해 경보를 발생시킵니다.
- 기본 흐름
- 비동기
- 예외 경로
9단계로 된 흐름
단계별 흐름
- ERP에서 통합 플랫폼로: 비즈니스 이벤트, REST · OData · webhook 사용 (기본 흐름).
- 통합 플랫폼에서 CRM로: 고객 및 주문, REST/JSON 사용 (기본 흐름).
- 통합 플랫폼에서 물류 및 운송사로: 배송 예약, REST/JSON 사용 (기본 흐름).
- 물류 및 운송사에서 통합 플랫폼로: 추적 이벤트, webhook 사용 (비동기).
- 통합 플랫폼에서 전자 인보이스 및 세무 플랫폼로: 승인 처리할 인보이스, SOAP/XML · REST 사용 (기본 흐름).
- 통합 플랫폼에서 KYC 및 신원 제공업체로: 신원 확인, REST/JSON 사용 (기본 흐름).
- KYC 및 신원 제공업체에서 통합 플랫폼로: 확인 결과, webhook 사용 (비동기).
- 통합 플랫폼에서 데드레터 대기열 및 경보로: 재시도 후 실패, 데드레터 대기열로 (예외 경로).
- 데드레터 대기열 및 경보에서 지원 팀로: 페이로드와 오류를 포함한 경보 (예외 경로).
개요
이것은 귀사 ERP와 주변 서비스 사이의 흐름입니다. CRM, 운송사와 물류 사업자, 전자 인보이스와 세무 플랫폼, 신원 확인 및 KYC 사업자가 해당됩니다. 각 파트너는 자체 API와 포맷, 자체 장애 유형을 가지며, 보통 별도 프로젝트로 진행됩니다.
참조 설계는 ERP의 비즈니스 이벤트를 한 번만 통합 플랫폼으로 보내고, 플랫폼이 각 파트너가 기대하는 형식으로 REST, SOAP, 웹훅 또는 거래 파트너가 요구하는 경우 AS2 기반 EDI로 전달합니다. 추적 이벤트나 확인 결과 같은 콜백도 같은 플랫폼을 통해 돌아옵니다.
파트너의 장애는 비상 사태가 아니라 정상적인 이벤트입니다. 일시적 실패는 재시도합니다. 재시도 후에도 실패한 메시지는 데드레터 대기열로 보내고, 페이로드와 오류를 담은 경보가 지원 팀에 도달해 수정 후 재처리할 수 있게 합니다.
흐름 방식
ERP가 이벤트 발행
고객, 주문, 인보이스가 변경되면 ERP가 API, OData 서비스 또는 웹훅을 통해 하나의 비즈니스 이벤트를 통합 플랫폼에 발행합니다.
CRM 최신 상태 유지
플랫폼이 CRM의 계정, 연락처, 주문을 갱신하므로 영업 및 서비스 팀이 ERP가 보유한 정보를 확인할 수 있습니다.
배송 예약
출고 준비된 주문을 운송사 또는 물류 사업자 API로 예약하고, 라벨과 참조 번호를 돌려받습니다.
추적 정보 수신
운송사가 웹훅으로 추적 및 배송 완료 이벤트를 보내면, 플랫폼이 ERP의 주문을 갱신합니다.
인보이스 승인 처리
인보이스를 당국이 요구하는 형식으로 전자 인보이스 또는 세무 플랫폼에 보내고, 승인 처리 상태를 인보이스에 함께 저장합니다.
신원 확인
신규 고객이나 공급업체를 KYC 또는 신원 확인 사업자에 보내고, 계정 활성화 전에 웹훅으로 결과를 받습니다.
실패 시 동작
파트너 일시 불가
점점 늘어나는 지연 시간으로 호출을 재시도합니다. 모든 쓰기 작업에 멱등성 키를 사용하므로 재시도해도 두 번째 배송이나 인보이스가 생성되지 않습니다.
재시도 후에도 메시지 실패
페이로드와 파트너 오류를 담아 데드레터 대기열로 보내고 지원 팀에 경보를 발송합니다. 수정이 끝나면 대기열에서 재처리합니다.
파트너 API 변경
각 파트너의 테스트 환경에 대해 계약 테스트를 실행해 변경을 탐지합니다. 사전 공지된 변경은 파트너의 마감 전에 일정을 잡아 테스트합니다.
데이터 거절
세무 번호 누락처럼 비즈니스 사유로 데이터를 거절하는 파트너의 오류는 ERP 레코드로 반환되어 담당자가 수정할 수 있습니다.
표준 및 시스템
- 통합
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- 신원 및 접근
- OAuth 2.0
질문과 답변
어떤 서드파티 서비스를 연결할 수 있습니까?
문서화된 API나 파일 인터페이스가 있는 서비스라면 모두 가능합니다. CRM 플랫폼, 운송사와 물류 사업자, 마켓플레이스, 전자 인보이스와 세무 플랫폼, 급여, KYC 및 신원 확인 사업자, AS2로 EDI 문서를 교환하는 거래 파트너 등이 대표적입니다. 계획을 확정하기 전에 각 파트너의 API, 제한, 테스트 환경을 검토합니다.
이를 위해 통합 플랫폼이 필요합니까?
여러 파트너를 하나의 ERP에 연결하면 MuleSoft, Boomi, Azure Logic Apps 같은 플랫폼이나 메시지 대기열 기반의 맞춤형 서비스 세트가 매핑, 재시도, 모니터링을 한곳에 모아 줍니다. 파트너가 한두 곳이라면 직접 연결로 충분할 수 있습니다. 라이선스 비용을 포함한 장단점을 귀사 상황에 맞춰 제시합니다.
전자 인보이스 및 세무 승인 처리 플랫폼과 연결할 수 있습니까?
가능합니다. 이제 많은 국가가 정해진 형식으로 정부 또는 인증 플랫폼을 통해 인보이스를 발행하거나 승인 처리하도록 요구합니다. 우리는 귀사 국가가 요구하는 플랫폼이나 인증 사업자와 ERP를 통합하고, 승인 처리 상태와 식별자를 각 인보이스에 저장하며 거절도 처리합니다. 적용되는 규정은 귀사의 세무 자문이 확인합니다.
수신 웹훅은 어떻게 보호합니까?
모든 수신 웹훅은 처리 전에 검증합니다. 파트너가 메시지에 서명하면 서명으로, 그렇지 않으면 토큰·출처·타임스탬프 검사로 확인합니다. 페이로드는 계약에 따라 검증하고, 파트너가 같은 이벤트를 여러 번 보내도 한 번만 처리합니다.
파트너에 장애가 나면 어떻게 됩니까?
나머지 흐름은 계속 작동합니다. 해당 파트너용 메시지는 재시도 후 대기열에 보관되고 지원 팀에 경보가 가며, 유실되는 것은 없습니다. 파트너가 복구되면 대기열의 메시지를 순서대로 재처리합니다. 대시보드에서 어느 파트너가 영향을 받았고 몇 건이 대기 중인지 확인할 수 있습니다.
구축한 커넥터의 소유권은 누구에게 있습니까?
귀사를 위해 구축한 작업물의 지식재산권은 첫 커밋부터 귀사의 것입니다. 마지막에 양도 절차를 거치지 않습니다. 커넥터는 소스 코드, 테스트, 문서와 함께 인도되므로 귀사 팀이나 다른 공급업체가 유지보수할 수 있습니다. 이전부터 존재한 XSIS 도구는 당사에 남으며 귀사에 라이선스됩니다. 파트너 API와 통합 플랫폼 라이선스는 해당 벤더의 조건을 따릅니다.
계약이 아니라 대화로 시작하십시오.
구축하거나 연결하거나 보호할 대상을 알려 주십시오. 아키텍트가 함께 검토한 뒤 시작 지점을 제안합니다.
다음 단계
일정 협의
팀이 이메일로 연락해 세션 시간을 협의합니다.
사전 컨설팅 세션
무료 30분 온라인 사전 컨설팅 세션에서 목표, 시스템, 제약 조건을 함께 검토합니다.
준비도 검토
무료 48시간 준비도 검토에서 프린시펄 아키텍트가 프로젝트를 6개 항목의 준비 완료 정의에 비추어 점검하고 적합한 트랙을 권고합니다.
트랙 선택
범위가 준비된 프로젝트는 영업일 기준 3~5일 이내 구속력 있는 제안서를 받습니다. 개념 단계 프로젝트는 블루프린트 스튜디오에서 시작합니다. 장애가 있거나 문서화되지 않았거나 통합이 필요한 운영 시스템은 1~2주 진단으로 시작합니다. 블루프린트 스튜디오와 진단은 각각 고정 비용이며 제안서에 명시됩니다.