이카운트 오픈 API로는 주문서, 판매, 구매 같은 전표를 이카운트에 넣을 수 있고, 품목과 발주서, 재고현황은 꺼내 올 수 있습니다. API 세부 매뉴얼은 이카운트에 로그인해야 볼 수 있어요.
이 글에는 이카운트가 공개한 API 목록을 입력과 조회로 나눈 표와, 클로드 코드로 연결할 때 지키는 순서를 정리했습니다. 경북 영천의 자동차 엔진 부품 제조기업 오토탑의 수주 자동화를 설계하며 실제로 부딪힌 제약도 함께 적었어요.
이카운트 오픈 API는 무엇인가요?
이카운트 오픈 API는 회사가 쓰는 다른 시스템과 이카운트를 연동하도록 API 개발 정보를 공개하는 서비스입니다. 이카운트 오픈 API 안내 페이지에는 활용 예가 세 가지 나와 있어요.
- 자체 쇼핑몰 주문 자료를 이카운트 주문서로 자동 생성
- 키오스크나 자사 앱 매출을 이카운트 판매전표로 등록
- 이카운트 재고현황과 품목 리스트를 자사 웹사이트로 전송
API를 쓴다고 추가 비용이 발생하지는 않는다고 합니다.
스마트스토어, 쿠팡, 카페24 같은 온라인 쇼핑몰 주문이라면 API를 따로 개발하지 않아도 돼요. 이카운트 쇼핑몰 관리 기능으로 연동되거든요. 쇼핑몰 주문 때문에 API를 알아보고 계셨다면 그 기능부터 확인해 보세요.
어떤 API를 쓸 수 있나요?
| 구분 | 입력 (이카운트에 넣기) | 조회 (이카운트에서 꺼내 오기) |
|---|---|---|
| 거래처/품목 | 거래처등록, 품목등록 | 품목 |
| 영업 | 견적서, 주문서, 판매 | |
| 구매 | 구매 | 발주서 |
| 생산 | 작업지시서, 생산불출, 생산입고 | |
| 회계 | 매출/매입 | |
| 근태 | 출/퇴근 | |
| 쇼핑몰 | 주문서 | |
| 출력물 | 재고현황, 창고별재고현황 | |
| 게시판 | 게시글 |
입력 API가 열세 가지, 조회 API가 네 가지입니다. 이카운트에 전표를 넣는 쪽은 영업부터 생산, 회계까지 넓게 열려 있고, 꺼내 오는 쪽은 품목과 재고 중심이에요.
표에는 거래처 조회가 없습니다. 거래처는 등록만 할 수 있어서, 발주서의 거래처 이름을 이카운트 코드로 바꾸는 작업에서는 따로 방법이 필요합니다.
연동 가능한 메뉴는 고객사 의견을 반영해 계속 추가할 예정이라고 해요. 연결을 시작하기 전에 공식 페이지 표를 한 번 더 확인하시는 게 좋습니다.
클로드 코드로는 어떤 순서로 연결하나요?
매뉴얼과 API 테스트부터 확인합니다
API 세부 매뉴얼은 공개 페이지가 아니라 이카운트에 로그인한 뒤에 볼 수 있습니다. 가입한 회사라면 API 테스트 기능으로 연동이 제대로 되는지 미리 검증할 수 있어요.
오토탑 교육에서도 작업 폴더를 하나 만들고 필요한 파일만 넣으라고 권했는데요, API 연결도 마찬가지입니다. 쓰려는 API의 매뉴얼 내용만 골라 폴더에 넣어 두면 클로드 코드가 그 범위 안에서 코드를 씁니다.
조회 API로 먼저 연결합니다
조회는 이카운트 데이터를 읽어 오기만 하니까, 실행이 잘못돼도 전표가 새로 생기지 않습니다. 처음 연결하는 회사라면 재고현황이나 품목 조회로 매번 엑셀로 내려받던 자료를 대신 받아 오는 것부터 해 보세요.
오토탑 수주 자동화에서도 품목은 조회 API로 받아 올 수 있었습니다. 발주서의 품번을 이카운트 품목코드와 맞출 때 쓰는 목록이에요.
입력 API는 사람이 확인한 뒤에 씁니다
주문서나 판매 입력 API를 실행하면 그 자리에서 이카운트 전표가 만들어집니다. 그래서 클로드 코드가 정리한 값은 먼저 담당자가 보는 검토표로 내보내고, 확인이 끝난 건만 입력 API로 보내도록 설계해요.
오토탑 수주도 지금은 담당자가 확인한 업로드 엑셀을 직접 이카운트에 올리는 단계까지 만들었습니다. 검산을 통과한 건만 주문서 API로 보내는 단계는 설계까지 해 둔 상태예요.
거래처 조회가 없으면 어떻게 하나요?
오토탑 수주 자동화를 설계하면서 부딪힌 제약이 거래처였습니다. 발주서에 적힌 거래처 이름을 이카운트 거래처코드로 바꿔야 하는데, API에서 거래처는 등록만 되고 꺼내 올 수는 없거든요.
오토탑에서는 거래처 목록을 이카운트에서 엑셀 파일로 받아 작업 폴더에 두고 쓰는 방식으로 풀었습니다. 처음에 일부만 담긴 샘플 목록을 쓰면 맞출 이름이 없어 확인할 칸이 많이 나오니, 등록된 거래처 전체를 받아 두세요.
API보다 엑셀 업로드가 먼저인 경우도 있어요!
오토탑 수주처럼 고객사가 보낸 발주서 PDF가 출발점이라면 API보다 먼저 할 일이 있습니다. PDF를 읽어 거래처와 품목을 맞추고, 확인할 칸을 표시한 업로드 엑셀을 만드는 일이에요. 이카운트 저장은 담당자가 그 엑셀을 확인한 뒤 웹자료올리기로 직접 합니다.
| 지금 상황 | 먼저 볼 방법 |
|---|---|
| 자체 쇼핑몰, 자사 앱, 키오스크처럼 다른 시스템과 이카운트가 계속 데이터를 주고받는다 | 오픈 API |
| 스마트스토어, 쿠팡, 카페24 주문을 이카운트로 가져온다 | 이카운트 쇼핑몰 관리 기능 |
| 매주 이카운트에서 재고나 품목을 엑셀로 내려받아 보고서를 만든다 | 조회 API |
| 발주서 PDF나 메신저로 받은 파일을 보고 사람이 한 건씩 입력한다 | 엑셀 업로드 자동화 (담당자 확인 후 저장) |
저는 이카운트 API를 연결할 때 꺼내 오는 일로 먼저 익숙해지고, 넣는 일은 사람이 확인하는 단계를 거친 뒤에 여는 순서가 맞다고 봅니다. 지금 매주 이카운트에서 엑셀로 내려받아 다시 정리하는 자료가 있다면, 그 자료부터 조회 API로 받아 오게 만들어 보세요!
함께 읽으면 좋은 글
API로 업무를 연결한 사례
① 클로드 코드로 대시보드에서 문자 발송 자동화하기: 솔라피 API 연동한 업무 자동화 사례
② 계약서 검토부터 전자서명까지, 대시보드/슬랙에서 계약 발송 업무 자동화
자동화를 시작하기 전에
③ 클로드 코드 사용법부터 업무 자동화 사례까지, 단계별로 읽는 AI네버슬립 글 모음
④ 클로드 강의/교육 전에, 고객사 샘플 데이터를 요청하는 이유
제조기업 강의 사례
⑤ 경북 제조기업 클로드 코드 기업 교육 사례: 오토탑 이카운트 포함 부서별 업무 자동화
⑥ 클로드코드로 제조기업 품질관리부터 경리업무 등 개선하기: 클로드 코드 원데이 클래스 후기
