스프레드시트에서 API로 청구서 만들기

이미 스프레드시트나 Notion 데이터베이스에 일을 정리해 두었다면, 한 행을 다시 입력하지 않고 QuoteBill 계정의 청구서나 견적서로 만들 수 있습니다. 이를 위한 작은 API가 있습니다. 모든 세부 내용은 영어 안내 문서에 있고, 이 글은 그 요약입니다. 필요한 것 이메일 인증을 마친 QuoteBill 계정, 그리고 일반 웹 요청을 보낼 수 있는 도구가 필요합니다. Make, Zapier(Webhooks by Zapier), n8n(HTTP Request), 스크립트가 그렇습니다. QuoteBill은 이 제품들의 공식 파트너가 아니며, 각 도구 안의 단계는 바뀔 수 있습니다. 1. 키 만들기 회사 설정에서 API 키를 찾아 키 이름(예: Make: Google Sheets)을 적고, 유효기간(30일, 90일, 365일)을 고른 뒤 키 만들기를 누르세요. 키는 만들 때 한 번만 보입니다. QuoteBill은 키의 해시만 보관하므로, 잃어버린 키는 복구하지 않고 새로 만듭니다. 활성 키는 다섯 개까지 둘 수 있어서 작업 흐름마다 키를 따로 쓸 수 있습니다. 2. 키를 안전하게 보관하기 키는 비밀번호처럼 다루세요. 도구에 자격 증명 기능이 있으면 거기에 넣고, 작업 흐름마다 다른 키를 쓰고, 키가 들어 있는 작업 흐름은 공유하거나 내보내지 마세요. 더 이상 쓰지 않는 키는 폐기하세요. 비밀번호를 바꿔도 키가 자동으로 폐기되지는 않습니다. 유출된 키는 폐기할 때까지 문서 초안을 만들고, 고객 정보를 포함한 문서를 읽을 수 있습니다. 3. 요청 하나 보내기 키가 있으면 요청 하나로 내 클라우드 문서에 청구서, 견적서, 프로포마 인보이스, 영수증, 크레딧 노트, 발주서, 납품서, 작업 지시서, 상업송장 중 하나의 초안이 만들어집니다. 문서 종류, 고객 이름, 항목을 보내면 되고 국가, 통화, 언어, 날짜는 선택 사항입니다. 응답에는 편집기에서 문서를 여는 주소, 문서 번호, 합계가 들어 있습니다. 요청에 Idempotency-Key를 실으면 재시도해도 초안이 두 개 만들어지지 않습니다. 같은 키로 내 문서 목록을 불러오고 문서 하나를 읽을 수도 있습니다. 4. 편집기에서 확인하고 보내기 초안은 편집기에서 열리므로 직접 확인하고 보내면 됩니다. 대신 보내 주는 일은 없습니다. 작업 흐름 예 구글 시트에 새 행이 생기면 도구가 시작됩니다. 행의 열에서 고객 이름, 설명, 수량, 단가를 가져와 요청을 보냅니다. 응답에 편집기 주소가 들어 있으니 시트에 다시 적어 둘 수 있습니다. Notion 데이터베이스는 그 도구 중 하나가 데이터베이스를 읽어 API를 호출하는 구성을 안내 문서에서 설명합니다. 일부러 하지 않는 일 계약서를 보내거나 서명받는 일, 이메일 발송, 문서 수정과 삭제, 계정이나 회사 설정 변경, 다른 사람의 데이터 읽기는 할 수 없습니다. 웹훅은 아직 없습니다. 한도는 키 하나당 분당 60회, 하루 5,000회이고, 계정 하나당 새 문서는 하루 500개까지입니다. API로 만든 문서도 직접 저장한 문서처럼 클라우드 문서 한도에 포함됩니다. 안내 문서 - API 안내(영어): https://quotebill.com/en/developers/ - AI 어시스턴트로 연결하기: https://quotebill.com/ko/guides/connect-ai-assistants/