🏭 이카운트 ERP 연동
이카운트 ERP 의 품목과 재고를 서플라이 CRM 으로 가져오는 화면입니다. 판매실적은 이카운트에서 내려받은 엑셀로 올립니다.
메뉴 위치: 관리자 → 연동 → 이카운트 ERP
ERP: 판매 · 구매 · 재고 · 회계 같은 회사 운영 데이터를 관리하는 시스템입니다.
📦 무엇을 어떻게 가져오나
| 데이터 | 가져오는 방법 | CRM 에서 보이는 곳 |
|---|---|---|
| 품목 (품목코드 · 품목명 · 규격 · 단위 · 판가) | 이카운트 OpenAPI | 제품 카탈로그, 견적 품목 선택 |
| 창고별 재고 | 이카운트 OpenAPI | 견적 품목의 재고 N 배지, 제품 카탈로그의 재고 열 |
| 판매실적 | 이카운트에서 내려받은 판매현황 · 주문서현황 엑셀을 데이터 → 가져오기 에 올림 | 매출 대시보드, 고객사 거래 이력 |
판매 · 주문서 · 견적서 · 거래처는 이카운트가 입력용으로만 API 를 열어 두었습니다. 그래서 이카운트에서 CRM 쪽으로는 API 로 가져올 수 없고, 엑셀 파일을 올려 가져옵니다. 구독 등급과는 관계없습니다.
⚠️ CRM 에서 이카운트로 쓰는 데이터는 없습니다. 전표를 만들거나 품목 · 재고 · 거래처를 고치지 않습니다. 재고 값도 CRM 에서는 읽기만 합니다.
🔗 연결하기
- 이카운트에서 OpenAPI 인증키를 발급받습니다. 이카운트 Self-Customizing → 정보관리 → API인증키발급 에 있습니다.
- 연결 자격 카드에 회사코드(COM_CODE) · 사용자ID(USER_ID) · 인증키(API_CERT_KEY) 를 넣습니다. Zone 은 넣지 않아도 됩니다. 로그인할 때 자동으로 확인합니다.
- 접속 환경을 인증키 종류에 맞춰 고릅니다. 정식 인증키는 운영, 테스트용 인증키는 테스트(샌드박스) 입니다.
- [저장하고 연결] 을 누릅니다. 인증키는 서버에서 암호화해 보관하고, 화면에는 「●●●●●● (저장됨)」으로만 보입니다.
- [연결 확인] 을 누릅니다. 로그인이 확인되면 상태 배지가 연결됨 으로 바뀝니다.
인증키를 바꿀 때는 접속 환경도 함께 맞춘 뒤 [자격 다시 저장] 을 누릅니다. 정식 인증키를 넣고 접속 환경을 테스트로 두면 연결되지 않습니다.
🔄 품목과 재고 맞추기
- [품목 동기화] 를 누르면 품목과 재고를 가져옵니다. 끝나면 「새로 N건 · 갱신 N건 · 그대로 N건」이 보입니다.
- 이카운트는 조회를 10분에 1회 만 허용합니다. 그 안에 다시 누르면 버튼에 남은 시간이 보입니다.
- 자동으로 맞추기 를 켜면 매시 15분에 품목과 재고를 저절로 맞춥니다. 기본은 꺼져 있고, 켜도 [품목 동기화] 는 그대로 쓸 수 있습니다.
- 마지막으로 맞춘 시각은 마지막 동기화 칸에 보입니다.
- 자동 동기화가 계속 실패하면 화면 위에 안내가 뜨고, 24시간 넘게 실패하면 연동 상태가 오류 로 바뀝니다. [연결 확인] 으로 자격을 확인한 뒤 [품목 동기화] 를 눌러 보세요. 성공하면 안내가 사라집니다.
📊 판매실적 올리기
- 이카운트에서 판매현황이나 주문서현황을 기간별로 엑셀로 내려받습니다.
- 연동 화면의 주문 · 판매 자료 올리기 카드에서 [판매실적 올리기] 를 누릅니다. 데이터 → 가져오기 로 이동합니다.
- 엑셀을 올립니다. 같은 달을 다시 올리면 그 달 전체를 새 파일 내용으로 바꿉니다. 중복이 쌓이지 않습니다.
올린 판매실적은 매출 대시보드와 고객사 거래 이력에 들어갑니다. 사명이 바뀐 거래처는 정규화한 이름으로 묶어 집계합니다. 품목 · 거래처 자료도 같은 화면에서 엑셀로 올릴 수 있습니다.
🤝 거래처와 고객사 잇기
판매실적의 거래처가 CRM 고객사에 이어져야 고객사 화면에 실적이 붙습니다.
- 표기만 다른 같은 회사는 저절로 이어집니다. 예를 들어 「(주)예시기업」과 「예시기업 주식회사」입니다.
- 이어지지 않은 거래처는 고객관리 대시보드의 「고객사와 이어지지 않아 빠진 거래처 N곳」 에 모입니다. 눌러서 하나씩 고객사에 잇거나, 고객사로 새로 만듭니다.
- 한 번 이어 두면 다음에 올리는 판매실적도 그 고객사로 들어갑니다.
🧾 견적에서 보이는 것
- 견적에 품목을 넣으면 자동완성에 재고 N 배지가 함께 나옵니다. 창고를 합친 수량이고, 음수도 그대로 보입니다.
- 이카운트에서 온 품목에는 출처가 표시됩니다.
- 그 고객사에 예전에 어떤 단가로 팔았는지 견적 · 판매실적 · 카탈로그 세 원장을 나란히 놓고 봅니다.
⏏️ 연동 해제
[해제] 를 누르면 가져온 ERP 품목을 화면에서 숨기고 동기화를 멈춥니다. 직접 등록한 품목은 그대로 두고, 가져온 품목 · 재고 데이터도 지우지 않습니다. 다시 연동하면 숨긴 품목이 되살아납니다.
🩺 연결 확인이 실패할 때
실패의 대부분은 자격을 잘못 입력해서가 아니라 아래 셋 가운데 하나입니다. 서로 다른 문제라서, 하나를 풀어도 다른 것이 남을 수 있습니다.
| 증상 | 뜻 | 해야 할 일 |
|---|---|---|
| 「테스트용 인증키입니다」 | 발급받은 키가 테스트용이라 운영 데이터에 접근할 수 없습니다. IP를 등록해도 열리지 않습니다 | 정식 인증키를 발급받습니다(아래 순서) |
| 「[x.x.x.x] 허용되지 않은 IP입니다」 | 호출한 서버의 IP가 허용 목록에 없습니다 | 이카운트 API인증키발급 → [IP등록] 에 그 IP를 등록합니다 |
| 정식 인증키인데 연결되지 않음 | 접속 환경이 테스트(샌드박스)로 남아 있습니다 | 접속 환경을 운영 으로 바꾸고 [자격 다시 저장] 을 누릅니다 |
⭐ 오류 메시지가 호출한 서버의 IP를 그대로 알려 줍니다. 등록할 IP를 모를 때는 [연결 확인] 을 한 번 눌러 보고, 메시지 대괄호 안의 주소를 그대로 등록하면 됩니다.
📜 정식 인증키를 받는 순서
신청만으로는 발급되지 않습니다.
- 테스트 인증키를 발급받습니다. 유효기간이 있습니다.
- 그 키에 허용 IP를 등록합니다.
- 테스트 키로 실제 API를 호출합니다. 이카운트가 요청 내용을 보고 API별로 「검증」 여부를 판정합니다(
API인증현황화면에서 확인). - 검증을 통과한 API에 대해 정식 인증키를 발급받습니다.
⚠️ 3번의 호출은 서플라이가 합니다. 고객사에서는 1 · 2 · 4번을 진행하고 자격과 IP 등록만 준비해 주시면 됩니다.
⚠️ 테스트 키를 연달아 다시 발급하면 예고 없이 차단될 수 있습니다. IP 등록을 먼저 끝낸 뒤 호출을 시작하세요.
🚀 다음 단계
👉 이카운트와 CRM 이 각각 무엇을 맡는지는 이카운트와 함께 쓰는 CRM에, 다른 연동은 연동 메뉴 구조에 있습니다.