ERP 연동 개발 전 확인할 데이터·API·검수 기준
ERP 연동 개발은 데이터를 한 번 전송하는 기능만으로 완료되지 않습니다. 어느 시스템이 원본인지, 오류가 나면 누가 어떻게 복구하는지, 같은 데이터를 다시 받았을 때 무엇을 해야 하는지 정해야 합니다. 아래 내용은 발주 검토 가이드이며 특정 ERP 제품의 API 제공 여부나 고객사의 납품 결과를 보장하는 설명이 아닙니다.
퍼스트핍 · 최종 업데이트:
1. API 이용 가능 범위와 테스트 환경 확인
사용 중인 ERP 제품명과 버전, 계약한 기능, API 제공 범위부터 확인합니다. 조회는 가능하지만 생성·수정이 제한될 수 있고, 연동 권한이나 별도 이용료가 필요한 경우도 있으므로 공급사에 확인하세요.
운영 데이터를 바꾸지 않고 테스트할 환경과 계정을 준비합니다. 호출량 제한, 인증 만료, 응답 형식, 점검 시간과 담당 창구를 정리하면 연동 가능 여부를 먼저 판단할 수 있습니다.
2. 어느 시스템의 값을 기준으로 삼을지 정의
거래처·상품·사원·계정과목 코드의 대응표를 만듭니다. 두 시스템의 이름이 같아도 코드가 다를 수 있고, 한쪽에서 필수인 값이 다른 쪽에는 없을 수 있습니다.
예를 들어 주문은 플랫폼이 원본이고 세금·회계 마감 정보는 ERP가 원본이라면 수정 주체가 다릅니다. 양쪽에서 같은 값을 수정할 때의 우선순위와 반영 지연을 문서로 정하세요.
3. 중복 전송과 부분 실패를 처리하는 방법
네트워크가 끊기면 전송이 실패했는지, 저장은 됐지만 응답만 사라졌는지 구분하기 어려울 수 있습니다. 거래를 식별하는 고유 키와 처리 이력을 사용해 재요청이 중복 데이터를 만들지 않도록 설계합니다.
100건 중 일부만 실패했을 때 성공한 건까지 다시 넣지 않도록 건별 상태를 기록합니다. 오류 사유, 재시도 횟수와 담당자 확인 후 재처리할 수 있는 관리 기능도 개발 범위에 포함하세요.
4. 데이터 이관과 운영 전환 검수
과거 데이터 전체가 필요한지, 기준정보와 미완료 거래만 필요한지 결정합니다. 이관 대상과 제외 항목을 정한 뒤 샘플 이관으로 코드·날짜·금액 형식을 먼저 검증합니다.
전환 시에는 양쪽 시스템의 건수·합계·미처리 목록을 비교하고 불일치 항목을 설명할 수 있어야 합니다. 전환 중 쓰기 작업을 언제 멈출지, 문제가 생기면 어떤 상태로 되돌릴지와 책임자를 정합니다.
견적 요청 전 체크리스트
- ERP 제품·버전·계약 기능과 API 문서
- 테스트 계정·허용 호출량·인증 방식
- 코드 매핑과 데이터별 원본 시스템
- 재시도·중복 방지·오류 재처리 범위
- 이관 대상·합계 검증·전환과 복구 계획
연동 항목 수만으로 견적을 비교하면 예외 처리와 운영 도구가 빠질 수 있습니다. 대표적인 정상·실패 시나리오를 함께 전달하고, 각 시나리오가 어느 산출물과 검수 항목에 들어가는지 확인하세요.