이카운트 API로는 외부 프로그램의 거래처, 품목, 견적서, 주문서, 판매, 발주서, 구매, 생산, A/S 접수와 수리, 회계 전표, 출퇴근 기록, 쇼핑몰 주문을 이카운트에 넣을 수 있고, 품목, 발주서, 재고현황, 창고별재고현황은 이카운트에서 꺼내 올 수 있습니다. API 사용료는 따로 없지만 이카운트는 연동에 필요한 정보만 공개하므로 개발은 회사가 직접 하거나 개발 업체에 맡깁니다. 스마트스토어, 쿠팡, 카페24 같은 쇼핑몰 주문은 API를 개발하지 않아도 이카운트 쇼핑몰관리 메뉴로 연결됩니다.
이 글은 이카운트 공식 소개 페이지와 고객센터 FAQ를 기준으로 API 기능과 API 종류, 연동 순서, 개발을 맡는 쪽, API로 안 되는 일을 한곳에 모았습니다. 연동 방식을 API, 화면 자동화(RPA), 엑셀 업로드 중에서 고르는 기준과 실제 프로젝트 기록은 중원랩스의 연동 사례와 방식 선택 기준에서 다룹니다.
핵심 요약
- 정의: 이카운트 오픈 API는 회사가 사용하는 다른 시스템과 이카운트를 잇는 연동 개발용 정보를 이카운트가 외부에 공개한 서비스입니다.
- 비용: 기본 사용료에 포함된 기능이라 API를 사용한다고 추가 결제가 생기지 않습니다.
- 방향: 넣는 쪽(입력)은 영업, 구매, 생산, 회계, 근태 등 여러 메뉴에 열려 있고, 꺼내 오는 쪽(조회)은 품목, 발주서, 재고현황, 창고별재고현황으로 좁습니다.
- 순서: 마스터ID로 테스트 인증키를 발급받고, 사용할 API를 테스트 주소로 검증한 뒤, 정식 인증키를 받아 운영 주소로 바꿉니다.
- 개발: 이카운트가 대신 개발해 주지 않습니다. 사내 개발자가 하거나 외부 개발 업체에 맡깁니다.
- 쇼핑몰: 쇼핑몰관리에 연결 가능한 쇼핑몰로 등록된 곳은 API 개발 없이 주문을 모아 전표로 만듭니다.
이카운트 오픈 API는 어떤 서비스인가요?
이카운트 오픈 API란 무엇인가요?
다른 프로그램과 이카운트 사이에서 자료를 주고받도록 이카운트가 연동 규격을 공개한 공식 통로입니다.
자체 쇼핑몰, 회사 홈페이지, 키오스크, 자체 앱처럼 이카운트 밖에서 생긴 자료를 사람이 다시 입력하지 않고 이카운트 전표로 받는 데 사용합니다. 이카운트 소개 페이지는 세 가지 예를 듭니다. 자체 쇼핑몰 주문을 주문서로 만드는 경우, 키오스크나 앱의 매출을 판매전표로 등록하는 경우, 이카운트의 재고현황과 품목 정보를 홈페이지나 쇼핑몰로 보내는 경우입니다. 어떤 메뉴에 API가 있는지와 요청 형식은 이카운트에 로그인한 뒤 Self-Customizing > 정보관리 > API인증키발급 화면에서 아래쪽 [API매뉴얼]을 열어 확인합니다. 이 매뉴얼은 주소를 입력해 열 수 없고, 설정관리자로 지정한 ID만 엽니다.
이카운트 API를 사용하면 추가 비용이 드나요?
이카운트 FAQ는 API를 기본 사용료에 포함된 기능으로 안내하므로 추가 비용이 들지 않습니다.
따로 결제하지 않고, 마스터ID로 테스트 인증키를 발급받아 바로 테스트를 시작합니다. 비용이 생긴다면 연동 프로그램을 만드는 개발 쪽입니다. 사내에서 개발하면 사람의 시간이, 외부에 맡기면 개발 업체와 정한 비용이 듭니다.
이카운트 API로 어떤 자료를 넣고 꺼낼 수 있나요?
이카운트 API 종류는 어떻게 나뉘나요?
외부 자료를 이카운트에 등록하는 입력 API와 이카운트 자료를 외부로 보내는 조회 API로 나뉩니다.
이카운트 소개 페이지는 입력을 '수신', 조회를 '송신'으로도 적습니다. 아래 표는 소개 페이지의 제공 API 목록에 FAQ에서 따로 확인한 창고이동입력을 더한 것입니다.
| 구분 | 입력 API (외부 → 이카운트) | 조회 API (이카운트 → 외부) |
|---|---|---|
| 거래처, 품목 | 거래처등록, 품목등록 | 품목 |
| 영업 | 견적서, 주문서, 판매 | 없음 |
| 구매 | 발주서, 구매 | 발주서 |
| 생산 | 작업지시서, 생산불출, 생산입고 | 없음 |
| 재고 | 창고이동입력 | 재고현황, 창고별재고현황 |
| A/S | A/S접수, A/S수리 | 없음 |
| 회계 | 일반전표, 입금보고서, 매출/매입 전표 | 없음 |
| 근태 | 출/퇴근 | 없음 |
| 쇼핑몰 | 주문서 | 없음 |
| 게시판 | 게시글 | 없음 |
표 1. 이카운트 오픈 API 제공 메뉴 (이카운트 소개 페이지와 FAQ 기준 정리)
표에서 알 수 있듯이 넣는 쪽은 넓고 꺼내 오는 쪽은 좁습니다. 영업 메뉴는 입력만 제공되어 판매, 주문서 내역을 API로 다시 읽어 오지는 못합니다. 거래처등록 API도 새 거래처를 등록할 뿐, 등록된 거래처 목록을 돌려주지는 않습니다.

API 기능을 업무에 붙이면 어떤 모습이 되나요?
외부에서 생긴 거래는 입력 API로 받고, 외부 화면에 보여 줄 기준 정보와 재고는 조회 API로 가져갑니다.
예를 들어 생산 현장 프로그램에 쌓인 실적을 생산입고로 넣으면 담당자가 실적표를 보며 다시 입력하던 일이 줄어듭니다. 근태 단말기 기록은 출/퇴근 API로, 다른 프로그램에서 정리한 매출 자료는 매출/매입 API로 받습니다. 반대로 회사 홈페이지나 자체 쇼핑몰에 남은 수량을 보여 주려면 창고별재고현황 조회 API를 정해진 간격으로 불러옵니다. 품목조회 API는 화면에서 조회할 때와 같이 1만 건까지 돌려주므로, 품목이 많다면 품목구분이나 품목코드 범위로 나눠 부릅니다.
이카운트 API 연동은 어떤 순서로 진행하나요?
테스트 인증키부터 운영 적용까지 몇 단계인가요?
준비, 테스트 인증키 발급, 테스트 검증, 정식 인증키 발급, 운영 적용의 다섯 단계입니다.
- 준비 (마스터ID): API를 관리할 사용자ID를 Self-Customizing > 사용자관리 > 관리자설정의 설정관리자로 지정합니다. 그래야 그 ID로 [API매뉴얼]을 열고 연결할 메뉴의 요청 형식을 확인합니다. 연동 프로그램이 돌아갈 서버의 IP도 API인증키발급 하단 [IP등록]에 넣습니다. 최대 20개까지 등록되고, 등록한 IP에서만 호출이 됩니다.
- 테스트 인증키 발급 (마스터ID): Self-Customizing > 정보관리 > API인증키발급 > [API인증현황]에서 하단 [키발급]을 누르고, 알림 창에서 확인한 뒤 사용할 ID를 고르고 내용을 적어 전송합니다. 테스트 인증키는 3번까지 바로 나오고, 4번째부터는 이카운트 담당자의 승인을 거칩니다.
- 테스트 검증 (개발 담당): 매뉴얼에 나온 테스트 주소(Test URL)로 Zone API, 로그인 API, 검증할 메뉴의 API를 차례로 호출합니다. 호출이 성공하면 그 메뉴는 검증이 끝납니다. 매뉴얼 화면의 API직접실행(사전테스트)은 동작을 미리 보는 기능이라 눌러도 검증으로 잡히지 않습니다.
- 정식 인증키 발급 (마스터ID): 검증이 끝나면 API인증키발급 하단 [키발급]에서 정식 인증키를 받습니다. 정식 인증키의 유효기간은 1년입니다.
- 운영 적용 (개발 담당): 호출 주소를 테스트 주소에서 매뉴얼의 Request URL로 바꾸고, 정식 인증키로 같은 순서를 밟아 실제 자료를 주고받습니다.

검증은 모든 API를 한꺼번에 받아야 하나요?
검증은 요청한 메뉴에만 적용되므로 사용할 API만 받으면 됩니다.
처음에는 판매 API만 검증했다가 나중에 품목등록 API를 추가로 사용하려면, 테스트 인증키로 품목등록을 다시 검증합니다. 어떤 메뉴가 검증되었는지는 [API인증현황]에서 확인합니다. 이카운트는 별도 테스트 서버나 테스트 코드를 제공하지 않으므로, 검증용으로 보낼 자료는 실제 회사 자료와 구분되게 준비해 두는 것이 안전합니다.
운영 중에는 어떤 한도를 지켜야 하나요?
호출 한 번에 300건, 하루 5,000건, 한 시간에 연속 오류 30건이 공식 한도입니다.
한 번에 보내는 양이 한도를 넘으면 처음 호출한 때부터 1시간, 하루 한도를 넘으면 24시간이 지나야 다시 호출됩니다. 한도를 늘려 주는 기능은 없습니다. 그래서 주문은 여러 건을 묶어 보내고, 실패한 요청을 곧바로 반복해 보내지 않도록 프로그램을 짭니다. 정식 인증키가 만료되는 달에는 1일 오전에 마스터ID로 메신저 알림이 오니, 갱신 담당자를 미리 정해 둡니다.
이카운트 API 개발은 누가 하나요?
이카운트가 연동 프로그램을 만들어 주나요?
이카운트는 연동에 필요한 데이터 정보만 제공하고, 개발은 고객이 직접 하도록 안내합니다.
이카운트는 클라우드 ERP라서 회사별 맞춤 개발도 하지 않습니다. 따라서 사내에 개발자가 있으면 매뉴얼의 요청 형식과 변수를 보고 직접 만들고, 없으면 외부 개발 업체에 맡깁니다. 이카운트 FAQ는 대행 업체를 추천하지 않는다고 밝히고 있어서, 맡길 곳은 회사가 직접 찾아 확인해야 합니다.
개발을 맡기기 전에 회사가 정할 것은 무엇인가요?
어떤 메뉴로 어떤 자료를 보낼지, 실패한 건은 누가 확인할지를 먼저 정합니다.
개발자가 묻는 내용은 대부분 업무 쪽 결정입니다. 연결할 프로그램이 어떤 자료를 내보내는지, 그 자료를 이카운트의 어느 메뉴에 넣을지, 품목코드와 거래처코드는 어느 쪽 기준으로 맞출지, 실패한 건을 누가 어디서 보고 다시 처리할지가 정해져야 개발 범위가 나옵니다. 마스터ID와 설정관리자 ID를 누가 관리하는지, 인증키를 갱신할 사람이 누구인지도 이때 함께 적어 둡니다.
API 개발 없이 연결되는 것은 무엇인가요?
스마트스토어, 쿠팡, 카페24 주문도 API 개발이 필요한가요?
이카운트가 이미 연결해 둔 쇼핑몰은 재고I > 쇼핑몰관리에서 등록만 하면 API 개발 없이 주문을 불러옵니다.
이카운트 쇼핑몰관리 소개 페이지는 스마트스토어, 쿠팡, 옥션, 11번가, G마켓, 카페24, 고도몰 등 30여 개 쇼핑몰과 샵링커, 플레이오토 같은 통합관리솔루션을 연동 목록에 올려 두고 있습니다. 진행 순서는 다음과 같습니다.
- 쇼핑몰 쪽 인증키 발급: 쇼핑몰마다 방법이 달라서, 쇼핑몰관리/상품생성설정 화면 오른쪽 위 도움말에서 쇼핑몰 이름으로 연동 매뉴얼을 찾아 따라 합니다.
- 쇼핑몰 등록: 쇼핑몰관리 메뉴의 쇼핑몰관리/상품생성설정 화면에서 [신규]를 눌러 쇼핑몰 정보를 넣고 저장합니다. 진행상태가 인증완료로 바뀌면 연결된 것입니다.
- 주문 수집: 주문관리진행단계 화면 아래 [주문수집] 버튼으로 신규주문과 주문확인 상태의 주문을 불러옵니다.
- 전표 생성: 수집한 주문을 ERP전송으로 주문서나 판매전표로 만듭니다.
쇼핑몰별로 주고받는 범위는 다릅니다. 주문확인, 배송처리, 취소와 반품 처리, 상품등록 중 어디까지 되는지는 쇼핑몰관리/상품생성설정 하단 [쇼핑몰별제공기능]에서 쇼핑몰마다 확인합니다.

목록에 없는 자사몰은 어떻게 연결하나요?
엑셀로 주문을 올리거나, 쇼핑몰 주문 API를 개발합니다.
어느 쪽이든 먼저 쇼핑몰관리/상품생성설정에서 [신규]로 개인쇼핑몰을 하나 등록합니다. 개발 없이 하려면 재고I > 쇼핑몰관리 > 주문관리 > 주문확인처리의 [웹자료올리기]에서 엑셀 서식을 내려받아 주문을 채워 올립니다. 개발한다면 쇼핑몰 주문 API로 그 쇼핑몰코드에 주문을 보냅니다. 다만 이 API는 주문 수집용이라 쇼핑몰 쪽 재고를 맞춰 주지는 않으므로, 재고를 보여 줘야 한다면 재고현황 조회 API를 따로 사용합니다.
이카운트 API가 닿지 않는 업무는 무엇인가요?
API가 없는 업무는 어떻게 처리하나요?
매뉴얼에 없는 메뉴는 API로 다룰 수 없고, 이카운트가 회사별로 따로 만들어 주지도 않습니다.
| 하고 싶은 일 | API 제공 여부 | 대신 사용하는 방법 |
|---|---|---|
| 판매, 주문서 내역을 외부로 꺼내 오기 | 판매조회, 주문서조회 API 없음 | 판매조회, 판매현황 화면에서 엑셀로 내려받기 |
| 등록된 거래처 목록 받아 오기 | 거래처조회 API 없음 | 거래처 자료를 엑셀로 내려받기 |
| 품목의 재고수량 넣기 | 지원하지 않음 | 품목등록 API로 품목을 만든 뒤 엑셀자료올리기로 재고수량 올리기 |
| 재고변동표, 재고II의 WMS 메뉴 연결 | 제공하지 않음 | [API매뉴얼] 하단 [오픈API메뉴 추가제안]으로 요청 |
| 이카운트에서 자료가 바뀌는 순간 외부로 알림 받기(웹훅) | 제공하지 않음 | 필요한 조회 API를 정해진 간격으로 호출 |
| API로 보낸 판매전표를 기존 주문서와 연결 | 지원하지 않음 | 연결이 필요한 전표는 ERP 화면에서 직접 생성 |
표 2. 이카운트 API로 처리되지 않는 일과 대안 (이카운트 FAQ 기준 정리)
판매입력 API로 판매를 넣을 때는 출하지시서가 자동으로 생기지 않습니다. 판매입력 화면에서 한 건씩 저장할 때만 자동 생성됩니다. 판매전표의 전잔, 후잔 미수금 잔액도 API로 넣은 전표에서는 자동 계산되지 않아, 필요하면 판매조회에서 전표를 열어 다시 저장합니다. 이런 차이 때문에 API가 닿지 않는 업무는 엑셀 업로드나 화면 자동화로 나누어 맡기기도 합니다. 업무별로 어느 방식이 맞는지는 API, RPA, 엑셀 선택 기준을 담은 사례 글에서 확인하세요.
자주 묻는 질문
이카운트 API는 누가 인증키를 발급받나요?
마스터ID로 로그인해 발급받습니다. 매뉴얼을 보거나 개발을 맡을 직원의 ID는 설정관리자로 지정해 두고, 인증키 자체는 마스터ID 소유자가 발급하고 관리합니다. 외부 개발 업체와 일할 때도 인증키를 누구에게 어떤 범위로 넘기는지 문서로 남겨 두면 담당자가 바뀌어도 관리가 이어집니다.
정식 인증키 유효기간이 지나면 어떻게 되나요?
API 연동이 멈춥니다. 정식 인증키는 1년 동안 유효하고, 기간이 지나면 그 키로는 연동이 되지 않습니다. 만료되는 달 1일 오전에 마스터ID로 메신저 알림이 오므로, 그 알림을 받을 사람과 새 키를 프로그램에 넣을 사람을 미리 정해 둡니다.
필요한 메뉴에 API가 없으면 기다리면 되나요?
언제 생길지 알 수 없어서 기다리기만 하기는 어렵습니다. [API매뉴얼] 하단 [오픈API메뉴 추가제안]으로 요청하면 이카운트가 같은 요청이 얼마나 들어오는지 보고 추가를 검토합니다. 그사이에는 엑셀자료올리기나 웹자료올리기로 처리하거나 화면 자동화를 알아봅니다.
확인한 공식 안내
- 이카운트 오픈 API 소개: 제공 API 목록과 비용
- 이카운트 쇼핑몰관리 소개: 연동 가능한 쇼핑몰
- 이카운트 FAQ: 오픈 API 개발은 고객이 직접
- 이카운트 FAQ: 테스트 인증키와 정식 인증키 발급
- 이카운트 FAQ: API 호출 허용량
- 이카운트 FAQ: 조회 API 제공 범위
이카운트 API와 이어지는 중원랩스 글
연결할 업무가 정해졌다면 범위부터 함께 보세요
API 연동은 개발보다 범위를 정하는 일이 더 오래 걸립니다. 중원랩스는 연결하려는 프로그램이 내보내는 자료와 이카운트에서 받을 메뉴를 나란히 놓고, 공식 API로 되는 부분과 다른 방법이 필요한 부분을 먼저 나눕니다. 연결할 프로그램 이름, 주고받을 자료 예시 파일 한두 개, 지금 그 자료를 입력하는 담당자와 입력 주기를 알려 주시면 첫 상담에서 어디까지 API로 갈지 정합니다.
