이카운트 API 연동,
어디까지 되는지
이카운트를 쓰는 회사에서 「우리도 카카오톡으로 재고를 볼 수 있느냐」는 문의를 받습니다. 답은 「바로 되는 것이 있고, 조건이 붙는 것이 있다」입니다. 이 페이지는 그 경계를 그대로 적어 둔 것입니다.
이카운트가 공식 홈페이지 오픈 API 안내에 공개해 둔 목록을 2026년 9월 17일에 확인했고, 그 목록에 있는 것만 「바로 된다」고 적었습니다. 목록에 없는 항목은 「안 된다」가 아니라 「다른 길이 필요하다」고 적었습니다. 저희가 확인하지 못한 것도 그대로 밝혀 두었습니다.
세 줄로 먼저 말씀드리면
- 1
이카운트는 외부 프로그램과 이어 쓸 수 있는 오픈 API를 공식으로 열어 두고 있고, 이 API를 쓰는 데 추가 비용은 없습니다.
- 2
다만 아무나 가져다 쓸 수 있는 것은 아닙니다. 쓰시는 회사가 자기 이카운트 화면에서 인증키를 발급해 주어야 저희가 접근할 수 있습니다.
- 3
그래서 되는 범위는 이카운트가 공개한 항목까지입니다. 그 밖의 항목은 아래 「두 가지 길」을 씁니다.
이카운트가 공개해 둔 API 목록
이카운트 공식 홈페이지 오픈 API 안내를 2026년 9월 17일에 확인한 내용입니다. 「꺼내기」가 붙은 줄이 조회로 가져올 수 있는 항목입니다.
| 업무 영역 | 기능 | 방향 |
|---|---|---|
| 기준 정보 | 거래처 등록 | 넣기 |
| 기준 정보 | 품목 등록 · 품목 조회 | 넣기 · 꺼내기 |
| 영업 | 견적서 · 주문서 · 판매 입력 | 넣기 |
| 구매 | 발주서 조회 · 구매 입력 | 꺼내기 · 넣기 |
| 생산 | 작업지시서 · 생산 불출 · 생산 입고 입력 | 넣기 |
| 회계 | 매출 입력 · 매입 입력 | 넣기 |
| 근태 | 출근 · 퇴근 입력 | 넣기 |
| 쇼핑몰 | 주문서 입력 | 넣기 |
| 출력물 | 재고 현황 · 창고별 재고 현황 조회 | 꺼내기 |
| 그룹웨어 | 게시글 입력 | 넣기 |
「넣기」는 이카운트에 적어 넣는 것, 「꺼내기」는 이카운트에서 읽어 오는 것입니다.
연결하려면 준비할 것 네 가지
- 1
회사 코드
이카운트 로그인 화면에 있는 값입니다.
- 2
연동용 사용자 ID
쓰시던 직원 계정 말고 연동 전용으로 하나 만드시기를 권합니다.
- 3
API 인증키
이카운트 화면 [Self-Customizing > 정보관리 > API인증키발급]에서 쓰시는 회사가 직접 발급합니다. 저희가 대신 만들어 드릴 수 없습니다.
- 4
지역(Zone)
저희가 자동으로 조회합니다. 준비하지 않으셔도 됩니다.
인증키는 유효 기간이 1년이고 연장 버튼으로 늘립니다. 만료된 채로 오래 두면 새로 발급해야 합니다.
바로 되는 것
아래는 이카운트가 API를 열어 둔 항목입니다. 저희가 이미 만들어 둔 기능 목록이 아니라, 저희가 붙이는 일이 정해지는 범위입니다.
꺼내 오기
읽어서 보여 드리는 일
재고 현황과 창고별 재고 현황, 품목 정보, 발주서를 꺼내 옵니다. 「지금 이 품목 재고 얼마예요」, 「2창고 재고 뽑아 주세요」 같은 질문을 카카오톡에서 바로 받는 화면을 만들 수 있습니다.
적어 넣기
이카운트에 적는 일
판매, 구매, 생산 불출, 생산 입고, 작업지시서, 견적서, 주문서, 거래처, 품목, 매출, 매입, 출퇴근을 적습니다.
단, 저희는 사람이 화면에서 확인 버튼을 누른 뒤에만 적습니다. 잘못 들은 숫자가 그대로 넘어가지 않게 하기 위한 것입니다.
공개 목록에 없는 항목은 두 가지 길이 있습니다
위 목록에 없는 화면의 값, 예를 들어 미수금 현황이나 손익 같은 항목은 공개 안내에 실린 API로는 바로 꺼내 오지 못합니다. 이럴 때 쓰는 길이 둘입니다.
가. 이카운트에 공개를 요청합니다
쓰시는 회사 이름으로 이카운트에 해당 항목 공개를 요청하는 방법입니다.
나. 내려받은 자료를 회사 안에 쌓아 두고 읽습니다
이카운트에서 정해진 시각에 내려받은 자료를 쓰시는 회사 서버에 쌓아 두고, 저희 봇이 그 자료를 읽습니다. 이 방법은 항목 제한이 없고, 자료가 회사 밖으로 나가지 않습니다.
할 수 없는 것과 저희 방침
이카운트 프로그램 자체를 고치는 일
이카운트 프로그램 자체를 쓰시는 회사에 맞게 고치는 일은 할 수 없습니다. 이카운트는 여러 회사가 같은 프로그램을 나눠 쓰는 구조라 개별 수정이 되지 않습니다. 이것은 저희뿐 아니라 누구도 마찬가지입니다.
저희 방침
저희는 이카운트가 허용한 범위 안에서만 만듭니다. 몇 년을 쓰실 시스템이라면 그 편이 맞다고 봅니다.
설계할 때 감안하는 제한
- 로그인은 자주 부르면 막힙니다. 한 번 받은 이용권을 다시 쓰도록 만듭니다.
- 목록을 한꺼번에 꺼내는 호출과 자료를 적는 호출도 간격을 두어야 합니다.
- 정확한 수치는 이카운트가 공개 문서로 밝히지 않았습니다. 인증키를 받은 뒤 시험 서버에서 재어 보고 확정합니다.(추정하지 않고, 확인하지 못한 항목으로 남겨 둡니다)
자료가 회사 밖으로 나가지 않게 하는 방법
| 걱정 | 저희 방식 |
|---|---|
| 자료가 밖으로 새지 않나 | 봇은 쓰시는 회사 안(내부망)에 설치합니다. 이카운트에서 읽은 자료는 회사 밖으로 나가지 않습니다. |
| 외부 AI를 쓰면 내용이 학습되지 않나 | 회사 안에 언어모델을 직접 설치해 쓰는 방식도 됩니다. 이 경우 인터넷과 아예 끊어 놓고 쓸 수 있습니다. 다만 장비와 구축 비용이 따로 듭니다. |
| 실수로 자료가 바뀌지 않나 | 처음에는 조회만 되는 계정으로 연결합니다. 적는 기능은 필요하다고 정하신 뒤에 엽니다. |
저희가 확인하지 못한 것
이카운트 공식 API 매뉴얼 전문은 이카운트에 로그인해야 열립니다. 위 목록은 이카운트 공식 홈페이지의 오픈 API 안내에서 확인한 것입니다. 그래서 이 페이지에 적은 범위는 「공개 안내에 실린 것」이고, 그 목록에 없다고 해서 이카운트가 주지 않는다는 뜻은 아닙니다.
항목마다 어떤 값을 넣고 어떤 값이 나오는지는 쓰시는 회사 인증키를 받은 뒤 시험 서버에서 하루면 확인됩니다. 그 전까지는 저희도 단정하지 않습니다.
처음 하실 일
| 누가 | 할 일 | 걸리는 시간 |
|---|---|---|
| 쓰시는 회사 | 이카운트 API 인증키 발급 | 5분 |
| 우정소프트웨어 | 시험 서버에서 실제 되는 항목을 확인하고 목록으로 회신 | 1일 |
| 함께 | 되는 항목 가운데 하나로 시범 운영 | 협의 |
함께 읽으면 좋은 글
어떤 항목이 필요한지만 알려 주세요
가장 자주 확인하시는 항목 한두 가지를 말씀해 주시면, 그것이 위 공개 목록 안에 있는지부터 갈라 말씀드립니다. 목록 밖이면 두 가지 길 가운데 어느 쪽이 맞는지 같이 봅니다.
이카운트 연동 문의하기이카운트는 (주)이카운트의 상표입니다. 이 페이지는 우정소프트웨어가 공개된 자료를 정리한 것이며 이카운트와 제휴 관계가 아닙니다. 내용은 이카운트 공식 홈페이지 오픈 API 안내를 2026년 9월 17일에 확인한 기준이며, 이카운트 정책에 따라 바뀔 수 있습니다.