🏭 이카운트 ERP 연동
이카운트 ERP 계정을 sufly® CRM에 연결해 두는 화면입니다.
메뉴 위치 - 관리자 → 연동 → ERP (이카운트) 탭
ERP - 판매·구매·재고·회계 등 회사 운영 데이터를 관리하는 전사 시스템입니다.
⚠️ 현재 단계에서는 "연결 설정과 연결 확인"까지 제공됩니다. 판매·구매·품목·거래처 데이터의 실제 동기화는 다음 단계에서 제공될 예정이므로, 지금은 연결을 미리 준비해 두는 개념으로 이해하세요.
🔗 연결하기
- 이카운트에서 OpenAPI 자격을 발급받습니다 - 회사코드(COM_CODE)·사용자ID(USER_ID)·인증키(API_CERT_KEY) 3가지가 필요합니다.
- ERP 탭의 연결 자격 카드에 세 값을 입력합니다. Zone은 입력할 필요 없습니다(로그인 시 자동 확인).
- [저장하고 연결]을 클릭합니다. 인증키는 서버에서 암호화되어 보관됩니다.
- 상태 카드의 [연결 확인]을 클릭합니다. 로그인이 검증되면 "연결 성공"이 표시되고 상태 배지가 연결됨으로 바뀝니다.
상단 카드에는 연결 상태 배지(연결됨 / 미연결 / 오류)와 저장된 자격 정보가 표시됩니다.
인증키는 저장 후 화면에 다시 표시되지 않습니다(●●●●●● 저장됨으로만 표시). 자격을 바꾸려면 인증키를 다시 입력해 재저장해야 합니다.
인증키 발급 위치: 이카운트 Self-Customizing → 정보관리 → API인증키발급
🩺 연결 확인이 실패할 때
실패의 대부분은 자격을 잘못 입력해서가 아니라 아래 둘입니다. 서로 다른 문제이고, 하나를 풀어도 다른 하나가 남습니다.
| 이카운트가 돌려주는 말 | 뜻 | 해야 할 일 |
|---|---|---|
| "테스트용 인증키입니다" | 발급받은 키가 테스트용이라 운영 데이터에 접근할 수 없습니다. IP를 등록해도 열리지 않습니다 | 정식 인증키를 발급받아야 합니다(아래 순서) |
| "[x.x.x.x] 허용되지 않은 IP입니다" | 호출한 서버의 IP가 허용 목록에 없습니다 | 이카운트 API인증키발급 → [IP등록]에 그 IP를 등록합니다 |
⭐ 오류 메시지가 호출자 IP를 그대로 알려 줍니다. 등록할 IP를 모를 때는 연결 확인을 한 번 눌러 보고, 메시지 대괄호 안의 주소를 그대로 등록하면 됩니다.
📜 정식 인증키를 받는 순서
신청만으로는 발급되지 않습니다.
- 테스트 인증키를 발급받습니다(유효기간이 있습니다).
- 그 키에 허용 IP를 등록합니다.
- 테스트 키로 실제 API를 호출합니다 - 이카운트가 요청 내용을 검토해 API별로 '검증' 여부를 판정합니다(
API인증현황화면에서 확인). - 검증을 통과한 API에 대해 정식 인증키를 발급받습니다.
⚠️ 3번의 호출은 연동을 만드는 쪽에서 수행합니다. 고객사에서는 1·2·4를 진행하고 자격과 IP 등록만 준비해 주시면 됩니다.
⚠️ 테스트 키를 연달아 재발급하면 예고 없이 차단될 수 있습니다. IP 등록을 먼저 끝낸 뒤 호출을 시작하세요.
🚀 다음 단계
👉 다른 연동은 연동 메뉴 구조에서 확인하세요.