내 소프트웨어 안에서 QuoteBill 쓰기
회계 앱·ERP·업무 도구에 QuoteBill을 붙이는 네 가지 방법: API, 임베드, 소스 공개 커넥터, AI 어시스턴트 연결. 무료이며 한계도 솔직하게 적었습니다.
이런 분을 위한 페이지입니다
QuoteBill은 견적서·청구서 같은 업무 문서를 만드는 서비스이며 무료입니다. 이 페이지는 견적서나 청구서 가까이에 있는 소프트웨어를 만들거나 운영하면서 그 안에서 QuoteBill을 쓰고 싶은 분을 위한 안내입니다. 시작하는 데 제휴나 계약은 필요 없습니다.
- 고객의 문서를 정돈된 양식에서 시작하게 하거나 스프레드시트·스크립트로 자동화하려는 회계사·세무사·기장 담당자.
- 자기 화면 안에서 문서, 계산기, 양식을 보여 주고 싶은 장부·회계 앱.
- 웹 주소를 호출하거나 스크립트를 실행할 수 있는 ERP와 직접 설치형 도구(Odoo, ERPNext, Invoice Ninja가 예입니다).
- 고객과 주문 항목을 이미 갖고 있는 프리랜서·소상공인용 도구.
- 고객사를 위해 이 연동을 설정해 주는 에이전시와 개발자.
QuoteBill은 이 페이지에 이름이 나온 어떤 제품과도 제휴·보증·등재 관계가 아니며, 파트너 지위도 없습니다. 제품 이름은 그 제품이 할 수 있는 일을 사실대로 설명하기 위해서만 씁니다.
연결하는 네 가지 방법
네 방법은 각각 따로 쓸 수 있습니다. 내 제품에서 바꿀 수 있는 부분에 맞는 것을 고르세요.
API
서버, 스크립트, 자동화 도구에서 웹 요청을 보낼 수 있다면
- 할 수 있는 일
- 개인 키로 서버나 스크립트에서 내 문서를 만들고 읽습니다. POST /v1/calculate가 문서의 합계를 계산하고, OpenAPI 파일이 /openapi.json에 공개되어 있습니다.
- 필요한 것
- 무료 QuoteBill 계정, 설정에서 만든 API 키, 헤더를 붙여 HTTPS 요청을 보낼 수 있는 서버나 자동화 도구. 안내서는 영어입니다.
상태 지금 사용할 수 있습니다.
임베드
페이지에 코드 조각을 붙여 넣을 수 있다면
- 할 수 있는 일
- 내 페이지에 붙여 넣는 프레임이나 코드: 엑셀·워드 다운로드가 있는 템플릿, VAT·GST 계산기, 통화 환산기, 문서 합계, 템플릿 찾기. 모두 안내 페이지에 모아 두었습니다.
- 필요한 것
- iframe이나 코드를 넣을 수 있는 웹 페이지. 키도 계정도 필요 없습니다.
상태 지금 사용할 수 있습니다.
커넥터
n8n, 구글 시트, 워드프레스, Zapier, Make를 쓴다면
- 할 수 있는 일
- 이미 쓰는 도구용 소스 공개 코드와 글로 적은 레시피: JavaScript SDK, n8n 노드, 구글 시트 스크립트, Zapier·Make 레시피, 워드프레스 플러그인, 그리고 Odoo·ERPNext·Akaunting·Invoice Ninja용 레시피. 레시피는 실제 설치본에서 시험하지 않았습니다.
- 필요한 것
- 해당 도구, API 키, 내려받은 코드를 직접 설치할 의지.
상태 내려받아 쓸 수 있습니다. 어떤 마켓플레이스에도 올라 있지 않습니다. 아직 n8n, 구글 시트, 워드프레스 안에서 실행해 보지 않았습니다.
AI 어시스턴트(MCP)
사용자가 이미 ChatGPT나 Claude에 부탁한다면
- 할 수 있는 일
- AI 앱에 말로 부탁해 문서 초안을 만들고, 샘플 계약서를 읽고, 세금을 계산하고, 통화를 환산합니다.
- 필요한 것
- 무료 QuoteBill 계정과 커넥터를 받는 AI 앱(웹의 Claude, ChatGPT 등). 로그인하고 허용을 선택합니다.
상태 지금 사용할 수 있습니다.
10분 안에 시작하기
방법마다 세 단계입니다.
API
- 로그인하고 이메일 주소를 확인한 뒤 회사 설정에서 API 키를 만드세요(유효 기간 30·90·365일). 키는 한 번만 보이니 바로 복사하세요.
- 서버나 스크립트에서 GET /v1/ping과 Authorization: Bearer 뒤에 키를 붙인 헤더로 확인합니다. 키를 웹 페이지에 넣지 마세요.
- POST /v1/documents로 초안을 만들고, 응답의 editor_url을 열어 문서를 확인하고 보내세요. 안내서에 모든 항목과 한도가 있습니다.
임베드
- 보여 주고 싶은 것의 공개 페이지(템플릿 페이지, VAT·GST 계산기, 통화 환산기)를 엽니다.
- 페이지가 제공하는 코드를 복사해, iframe을 허용하는 내 페이지에 붙여 넣습니다.
- 휴대폰 너비에서 확인하세요. 프레임에는 QuoteBill로 돌아가는 출처 링크가 있으며 어떤 설정으로도 없앨 수 없습니다.
템플릿 · VAT·GST 계산기 · 통화 환산기 · 임베드 안내
커넥터
- 단계 아래의 링크에서 내 도구용 꾸러미를 내려받으세요. 소스 공개 코드이며 어떤 디렉터리에도 올라 있지 않습니다.
- 압축을 풀어 n8n, 구글 시트, 워드프레스, Zapier, Make에 직접 설치하거나 SDK를 프로젝트에 추가하고, 설정에서 만든 API 키를 넣습니다. Odoo, ERPNext, Akaunting, Invoice Ninja는 글로 적은 레시피를 따르세요.
- 테스트 문서를 하나 만들어 editor_url을 열어 본 다음에 실제 업무 흐름에 쓰세요.
JavaScript SDK (zip) · n8n 노드 (zip) · 구글 시트 스크립트 (zip) · 워드프레스 플러그인 (zip) · Zapier·Make·회계 소프트웨어 레시피 (zip)
AI 어시스턴트(MCP)
- 내 AI 앱의 안내를 열고 커넥터 주소 https://quotebill.com/mcp 를 복사합니다.
- AI 앱에서 사용자 지정 커넥터를 추가하고 그 주소를 넣은 뒤 연결을 선택합니다.
- QuoteBill에 로그인해 허용을 선택하고, 견적서 초안 작성이나 VAT 계산처럼 말로 부탁하세요.
솔직한 한계
연동을 도와드립니다
무언가를 만들면서 그 안에서 QuoteBill을 쓰고 싶다면 메시지를 보내 주세요. 소프트웨어가 하는 일, 쓰는 사람, 연결하고 싶은 방법을 적어 주시면 됩니다. 지금 가능한 것과 불가능한 것을 알려 드립니다.
자주 묻는 질문
제휴 계약을 맺어야 하나요?
아니요. API, 임베드, AI 연결은 무료 QuoteBill 계정(임베드는 계정도 필요 없음)으로, QuoteBill 이용약관과 위의 한도 안에서 쓸 수 있습니다.
플러그인 없이 내 소프트웨어가 QuoteBill을 호출할 수 있나요?
헤더를 붙여 HTTPS 요청을 보낼 수 있다면 가능합니다. API는 HTTPS 위의 일반 JSON이며, 많은 도구에서 HTTP 요청, 웹훅 동작, 사용자 지정 API 호출이라는 이름으로 제공됩니다. 키는 서버에만 두세요.
QuoteBill 문서를 내 앱 안에서 보여 줄 수 있나요?
지금은 두 가지입니다. 템플릿·계산기 임베드, 또는 API가 돌려주는 editor_url(QuoteBill 편집기에서 초안을 엽니다). 문서 합계와 템플릿 찾기 임베드도 있습니다.
내 소프트웨어에서 사용자가 계약서에 서명할 수 있나요?
API로는 안 됩니다. API는 계약서를 만들거나 보내지 않습니다. 전자계약은 QuoteBill 안에서 작동합니다. 회원이 계약서를 만들고 서명 링크를 보내면 상대방이 계정 없이 서명합니다. QuoteBill은 인증된 전자서명 서비스가 아닙니다.
Xero, QuickBooks, Odoo 같은 마켓플레이스에 QuoteBill 앱이 있나요?
아니요. 지금은 어떤 마켓플레이스에도 올라 있지 않고, 어떤 업체의 인증이나 보증도 받지 않았습니다. 이 페이지의 커넥터는 마켓플레이스 앱이 아니라 소스 공개 코드입니다.
한도에 닿으면 어떻게 되나요?
분당 60회 또는 하루 5,000회를 넘는 요청은 기다릴 초를 알려 주는 429 응답을 받고, 하루 500개를 넘는 문서는 다음 UTC 날짜까지 거절됩니다. 더 필요하면 문의 페이지로 무엇을 만드는지 알려 주세요. 변경을 약속할 수는 없습니다.
Odoo, ERPNext, Akaunting, Invoice Ninja, n8n, Google Sheets, Zapier, Make, WordPress, Xero, QuickBooks, Claude, ChatGPT는 각 소유자의 제품이자 상표입니다. QuoteBill은 이들과 제휴·보증·등재 관계가 아니며 파트너 지위도 없습니다. 해당 제품의 단계는 바뀔 수 있습니다.