이카운트 연동 수발주, 처음부터 끝까지 세팅 가이드
이카운트는 있는데 주문은 카톡·엑셀인 회사라면, 연동 “기능”보다 “순서”부터 잡으면 실패가 줄어듭니다. 세팅·실패 포인트·단계 확대 체크리스트로 정리했습니다.
Qnector

AI 요약
- 이카운트 연동 수발주는 ERP를 대체하는 게 아니라, 주문·재고 구간을 API로 잇는 작업입니다.
- Zone·인증 → 품목·창고 → 재고 → 주문 반영 순으로 가면 시행착오가 적습니다.
- C-Portal과 목적이 다릅니다. 실패는 대개 코드·세션·단위·키 혼선에서 납니다.
이카운트 연동 수발주를 검토할 때 많은 회사가 “기능이 있나?”부터 묻습니다. 상담에서 막히는 지점은 기능 목록보다 세팅 순서인 경우가 많습니다.
“연동은 했는데 품목 코드가 안 맞아요.”
“테스트는 됐는데 운영에서 세션이 끊겨요.”
“C-Portal이랑 API 연동이 같은 건 줄 알았어요.”
이 글은 C-Portal 설명(가이드)·제품 비교(비교 글)가 아니라, 연동을 처음부터 끝까지 붙이는 실무 순서에 초점을 둡니다.


세팅 전에 준비할 것
- 회사코드(COM_CODE), 사용자 ID, API Key(또는 Test Key)
- Zone 값(회사코드로 Zone API에서 확인)
- 품목·창고·거래처 코드가 ERP에 정리돼 있는지
- 주문 단위(박스/EA)·단가 정책 문서화
- 자동화 범위(접수만 / 재고까지 / 전표까지)
코드가 엑셀마다 다르면, 연동보다 마스터 정리가 먼저입니다.
처음부터 끝까지 — 권장 세팅 순서
- Zone 확인 — 호출 도메인(테스트/운영)을 정합니다.
- 로그인·세션 — COM_CODE, USER_ID, API_CERT_KEY, Zone으로 세션을 받고 만료 정책을 공유합니다.
- 품목 매핑 — ERP 품목 코드와 주문 화면 품목을 1:1로 맞춥니다.
- 창고·재고 — 거래처에 보여줄 창고와 동기화 주기를 정합니다.
- 거래처·단가 — 거래처 코드와 단가·노출 품목을 맞춥니다.
- 주문 접수 — 알림 → 확인·처리 흐름을 엽니다.
- ERP 반영 — 주문·출고 데이터를 이카운트 전송까지 연결합니다.
- 모니터링 — 실패 로그를 누가 볼지 정합니다.


자주 실패하는 포인트 4가지
① 키·Zone·도메인 혼선
Test Key로 운영을 호출하거나, Zone과 다른 도메인으로 호출하면 원인 찾기가 길어집니다.
② 세션 만료 후 재로그인 없이 연속 호출
세션 정책을 팀에 공유하지 않으면 “어제는 됐는데 오늘은 안 됨”이 반복됩니다.
③ 품목명만 같고 코드가 다름
엑셀 병합 잔재가 대표적입니다. 이름 매칭이 아니라 코드 1:1이 기준입니다.
④ C-Portal과 API 연동을 같은 작업으로 착각
C-Portal은 ERP 안 거래처 포털, 연동 수발주는 주문 데이터가 ERP까지 이어지는 구조입니다. 목적이 다릅니다.
주문 → 이카운트 반영 체크리스트
| 항목 | 확인 |
|---|---|
| 품목 코드 | 주문 품목 = ERP PROD_CODE |
| 창고 코드 | 출고·재고 창고가 매핑됨 |
| 수량·단위 | 박스/EA 환산 규칙이 문서화됨 |
| 거래처 코드 | 구매자 = ERP 거래처 |
| 전송 시점 | 접수 즉시 / 출고 확정 후 중 선택 |
| 실패 시 | 재시도·담당자 알림 경로가 있음 |

단계적으로 넓히는 방법 (체크리스트)
한 번에 주문·재고·전표·결제·알림을 다 붙이면 실패 원인을 찾기 어렵습니다.
- □ 주문 접수 + 알림 — 사람이 하던 취합이 줄었는지
- □ 품목·재고 동기화 — 품절 CS가 줄었는지
- □ 이카운트 전송/전표 — 저녁 재입력이 줄었는지
- □ (선택) 결제·구매자 ERP
각 단계에서 “엑셀 작업이 줄었는지”만 보면 다음 단계 판단이 빨라집니다. 큰 그림은 B2B 주문관리 가이드와 같습니다.
마무리
이카운트 연동 수발주의 핵심은 화려한 API 목록이 아니라, 코드 정렬 → 주문 흐름 → ERP 반영 → 모니터링 순서입니다. C-Portal만으로 충분한지는 비교 글을 보세요.
현재 이카운트 사용 방식(품목·창고·주문 채널)만 알려주시면 상담에서 세팅 범위부터 같이 잡을 수 있습니다. 요금 안내·도입 사례도 참고하세요.
자주 묻는 질문
- 이카운트 API 연동에 Test Key와 API Key 차이가 있나요?
- 있습니다. Test Key는 테스트용 URL(sboapi)로 호출하고, 정식 API Key는 oapi 계열로 호출합니다. 테스트에서 정상 호출을 확인한 뒤 정식 키로 전환하는 흐름이 일반적입니다.
- C-Portal만 켜면 연동 수발주가 끝나나요?
- 아닙니다. C-Portal은 ERP 안에서 거래처 포털을 여는 기능에 가깝고, 주문 데이터가 API로 ERP까지 이어지는 구조와는 목적이 다릅니다.
- 품목·재고부터 맞춰야 하나요, 주문부터 맞춰야 하나요?
- 품목 코드·창고·단가 기준을 먼저 맞추는 편이 안전합니다. 주문을 먼저 붙이면 “품목이 없어서 실패”가 반복됩니다.
- 연동 세팅에 보통 얼마나 걸리나요?
- 품목·창고·거래처 데이터가 정리돼 있으면 수일~수 주, 코드 체계가 흩어져 있으면 데이터 정리에 더 걸립니다.
- 실패가 자주 나는 구간은 어디인가요?
- Zone/세션 만료, 품목 코드 불일치, 창고 미매핑, 박스/EA 단위 차이, Test Key로 운영 호출이 흔합니다. 본문 실패 포인트 네 가지를 먼저 보세요.
함께 보면 좋은 글
써보면서 이해하는 게 가장 빠릅니다
현재 주문 채널·이카운트 사용 방식만 알려주셔도, 우리 회사에 맞는 수발주 흐름을 함께 잡아 드립니다.
