suflyCRM

CRM 가이드 · 연동·데이터 · 최종 수정 2026-10-17

🏭 이카운트 ERP 연동

이카운트 ERP 의 품목과 재고를 서플라이 CRM 으로 가져오는 화면입니다. 판매실적은 이카운트에서 내려받은 엑셀로 올립니다.

메뉴 위치: 관리자 → 연동 → 이카운트 ERP

ERP: 판매 · 구매 · 재고 · 회계 같은 회사 운영 데이터를 관리하는 시스템입니다.


📦 무엇을 어떻게 가져오나

데이터가져오는 방법CRM 에서 보이는 곳
품목 (품목코드 · 품목명 · 규격 · 단위 · 판가)이카운트 OpenAPI제품 카탈로그, 견적 품목 선택
창고별 재고이카운트 OpenAPI견적 품목의 재고 N 배지, 제품 카탈로그의 재고 열
판매실적이카운트에서 내려받은 판매현황 · 주문서현황 엑셀을 데이터 → 가져오기 에 올림매출 대시보드, 고객사 거래 이력

판매 · 주문서 · 견적서 · 거래처는 이카운트가 입력용으로만 API 를 열어 두었습니다. 그래서 이카운트에서 CRM 쪽으로는 API 로 가져올 수 없고, 엑셀 파일을 올려 가져옵니다. 구독 등급과는 관계없습니다.

⚠️ CRM 에서 이카운트로 쓰는 데이터는 없습니다. 전표를 만들거나 품목 · 재고 · 거래처를 고치지 않습니다. 재고 값도 CRM 에서는 읽기만 합니다.


🔗 연결하기

  1. 이카운트에서 OpenAPI 인증키를 발급받습니다. 이카운트 Self-Customizing → 정보관리 → API인증키발급 에 있습니다.
  2. 연결 자격 카드에 회사코드(COM_CODE) · 사용자ID(USER_ID) · 인증키(API_CERT_KEY) 를 넣습니다. Zone 은 넣지 않아도 됩니다. 로그인할 때 자동으로 확인합니다.
  3. 접속 환경을 인증키 종류에 맞춰 고릅니다. 정식 인증키는 운영, 테스트용 인증키는 테스트(샌드박스) 입니다.
  4. [저장하고 연결] 을 누릅니다. 인증키는 서버에서 암호화해 보관하고, 화면에는 「●●●●●● (저장됨)」으로만 보입니다.
  5. [연결 확인] 을 누릅니다. 로그인이 확인되면 상태 배지가 연결됨 으로 바뀝니다.

인증키를 바꿀 때는 접속 환경도 함께 맞춘 뒤 [자격 다시 저장] 을 누릅니다. 정식 인증키를 넣고 접속 환경을 테스트로 두면 연결되지 않습니다.


🔄 품목과 재고 맞추기

  • [품목 동기화] 를 누르면 품목과 재고를 가져옵니다. 끝나면 「새로 N건 · 갱신 N건 · 그대로 N건」이 보입니다.
  • 이카운트는 조회를 10분에 1회 만 허용합니다. 그 안에 다시 누르면 버튼에 남은 시간이 보입니다.
  • 자동으로 맞추기 를 켜면 매시 15분에 품목과 재고를 저절로 맞춥니다. 기본은 꺼져 있고, 켜도 [품목 동기화] 는 그대로 쓸 수 있습니다.
  • 마지막으로 맞춘 시각은 마지막 동기화 칸에 보입니다.
  • 자동 동기화가 계속 실패하면 화면 위에 안내가 뜨고, 24시간 넘게 실패하면 연동 상태가 오류 로 바뀝니다. [연결 확인] 으로 자격을 확인한 뒤 [품목 동기화] 를 눌러 보세요. 성공하면 안내가 사라집니다.

📊 판매실적 올리기

  1. 이카운트에서 판매현황이나 주문서현황을 기간별로 엑셀로 내려받습니다.
  2. 연동 화면의 주문 · 판매 자료 올리기 카드에서 [판매실적 올리기] 를 누릅니다. 데이터 → 가져오기 로 이동합니다.
  3. 엑셀을 올립니다. 같은 달을 다시 올리면 그 달 전체를 새 파일 내용으로 바꿉니다. 중복이 쌓이지 않습니다.

올린 판매실적은 매출 대시보드와 고객사 거래 이력에 들어갑니다. 사명이 바뀐 거래처는 정규화한 이름으로 묶어 집계합니다. 품목 · 거래처 자료도 같은 화면에서 엑셀로 올릴 수 있습니다.


🤝 거래처와 고객사 잇기

판매실적의 거래처가 CRM 고객사에 이어져야 고객사 화면에 실적이 붙습니다.

  • 표기만 다른 같은 회사는 저절로 이어집니다. 예를 들어 「(주)예시기업」과 「예시기업 주식회사」입니다.
  • 이어지지 않은 거래처는 고객관리 대시보드의 「고객사와 이어지지 않아 빠진 거래처 N곳」 에 모입니다. 눌러서 하나씩 고객사에 잇거나, 고객사로 새로 만듭니다.
  • 한 번 이어 두면 다음에 올리는 판매실적도 그 고객사로 들어갑니다.

🧾 견적에서 보이는 것

  • 견적에 품목을 넣으면 자동완성에 재고 N 배지가 함께 나옵니다. 창고를 합친 수량이고, 음수도 그대로 보입니다.
  • 이카운트에서 온 품목에는 출처가 표시됩니다.
  • 그 고객사에 예전에 어떤 단가로 팔았는지 견적 · 판매실적 · 카탈로그 세 원장을 나란히 놓고 봅니다.

⏏️ 연동 해제

[해제] 를 누르면 가져온 ERP 품목을 화면에서 숨기고 동기화를 멈춥니다. 직접 등록한 품목은 그대로 두고, 가져온 품목 · 재고 데이터도 지우지 않습니다. 다시 연동하면 숨긴 품목이 되살아납니다.


🩺 연결 확인이 실패할 때

실패의 대부분은 자격을 잘못 입력해서가 아니라 아래 셋 가운데 하나입니다. 서로 다른 문제라서, 하나를 풀어도 다른 것이 남을 수 있습니다.

증상뜻해야 할 일
「테스트용 인증키입니다」발급받은 키가 테스트용이라 운영 데이터에 접근할 수 없습니다. IP를 등록해도 열리지 않습니다정식 인증키를 발급받습니다(아래 순서)
「[x.x.x.x] 허용되지 않은 IP입니다」호출한 서버의 IP가 허용 목록에 없습니다이카운트 API인증키발급 → [IP등록] 에 그 IP를 등록합니다
정식 인증키인데 연결되지 않음접속 환경이 테스트(샌드박스)로 남아 있습니다접속 환경을 운영 으로 바꾸고 [자격 다시 저장] 을 누릅니다

⭐ 오류 메시지가 호출한 서버의 IP를 그대로 알려 줍니다. 등록할 IP를 모를 때는 [연결 확인] 을 한 번 눌러 보고, 메시지 대괄호 안의 주소를 그대로 등록하면 됩니다.

📜 정식 인증키를 받는 순서

신청만으로는 발급되지 않습니다.

  1. 테스트 인증키를 발급받습니다. 유효기간이 있습니다.
  2. 그 키에 허용 IP를 등록합니다.
  3. 테스트 키로 실제 API를 호출합니다. 이카운트가 요청 내용을 보고 API별로 「검증」 여부를 판정합니다(API인증현황 화면에서 확인).
  4. 검증을 통과한 API에 대해 정식 인증키를 발급받습니다.

⚠️ 3번의 호출은 서플라이가 합니다. 고객사에서는 1 · 2 · 4번을 진행하고 자격과 IP 등록만 준비해 주시면 됩니다.

⚠️ 테스트 키를 연달아 다시 발급하면 예고 없이 차단될 수 있습니다. IP 등록을 먼저 끝낸 뒤 호출을 시작하세요.


🚀 다음 단계

👉 이카운트와 CRM 이 각각 무엇을 맡는지는 이카운트와 함께 쓰는 CRM에, 다른 연동은 연동 메뉴 구조에 있습니다.