> ## Documentation Index > Fetch the complete documentation index at: https://docs.bolta.io/llms.txt > Use this file to discover all available pages before exploring further. # 매출 동기화 요청 > 대시보드에서 연동한 매출 전부의 수집을 요청합니다. API가 `202 Accepted`로 접수만 하고 수집은 비동기로 진행합니다. 볼타가 매출을 주기적으로 수집하므로, 방금 국세청에 올라간 문서가 급할 때만 요청하세요. 수집 상태를 조회하는 경로는 없습니다. 저장한 cursor로 `GET /v1/revenues`를 이어 받으세요. 사업자마다 30분에 1번, 24시간에 12번까지 요청할 수 있고, 매입 동기화와 한도를 따로 셉니다. `409`와 `422`로 거절한 요청은 한도를 차감하지 않습니다. 테스트 키는 수집하지 않고 접수 응답만 반환합니다. [매출/매입 내역 조회 가이드](/docs/api-introduction/revenue-expense) ## OpenAPI ````yaml /openapi.yaml post /v1/revenues:sync openapi: 3.1.0 info: title: 볼타 API description: > 볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증 가이드](/docs/api-introduction/authentication) | [사용 사례](/docs/api-introduction/usecase-b2b) version: 1.0.0 servers: - url: https://xapi.bolta.io description: 볼타 API 서버 security: - basicAuth: [] tags: - name: 세금계산서 발행 description: > 전자(세금)계산서를 정발행하거나 수정발행합니다. [발행 금액 계산](/docs/api-introduction/issuance-guide) | [수정발행 유형](/docs/api-introduction/amendment-guide) - name: 세금계산서 조회 description: > 전자(세금)계산서의 발행 결과와 요청 처리 상태를 조회하고, 발행 완료한 세금계산서의 PDF를 내려받습니다. [세금계산서 PDF 조회 가이드](/docs/api-introduction/tax-invoice-pdf) - name: 세금계산서 역발행 description: > 전자(세금)계산서 역발행 요청 및 관리. [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple) - name: 현금영수증 description: > 현금영수증을 발행하거나 취소하고 처리 상태를 조회합니다. [현금영수증 발행 가이드](/docs/api-introduction/cash-receipt-guide) | [현금영수증 웹훅](/docs/api-introduction/webhook-cash-receipt) - name: 사업자등록 상태 조회 description: > 사업자등록번호의 등록 상태와 과세유형을 단건 또는 최대 100건 일괄로 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) - name: 매출/매입 내역 조회 description: > 볼타에 쌓인 내 사업자의 매출과 매입 세금계산서를 바뀐 순서로 조회하고 수집을 요청합니다. 볼타에서 발행한 문서와 홈택스에서 수집한 문서가 모두 실립니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 홈택스 연동은 볼타 대시보드에서 먼저 하세요. [매출/매입 내역 조회 가이드](/docs/api-introduction/revenue-expense) - name: 입출금내역 조회 description: > 볼타에 연결한 내 사업자의 입출금 계좌와 입출금내역을 조회하고 동기화를 요청합니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 볼타 대시보드에서 먼저 연결하세요. [입출금내역 조회 가이드](/docs/api-introduction/bank-account-transactions) - name: 예금주 조회 description: > 은행코드와 계좌번호로 예금주명을 조회합니다. 한 계좌씩 묻는 경로와 최대 100개를 한 번에 묻는 경로가 있습니다. 예금주를 돌려준 계좌마다 50포인트를 차감합니다. [예금주 조회 가이드](/docs/api-introduction/bank-account-holder) - name: 서류 발급 description: > 홈택스 국세 증명 서류와 법인등기사항전부증명서를 발급하고 원본 PDF를 내려받습니다. 홈택스 서류는 API 키가 속한 사업자의 서류만 발급하며, 볼타 대시보드에 공동인증서를 등록해야 합니다. 법인등기는 `corporationNumber`의 법인 등기부를 발급하고 공동인증서가 필요 없습니다. 지원하는 법인 종류는 주식회사, 유한회사, 합명회사, 합자회사, 유한책임회사, 사단법인, 재단법인, 의료법인, 협동조합(사회적협동조합 포함), 기타법인(특허법인 등)입니다. 한 건에 홈택스 서류 500포인트, 법인등기 열람용 1,000포인트, 제출용 1,500포인트를 차감합니다. [서류 발급 가이드](/docs/api-introduction/document-issuance) - name: 발급자 description: > 세금계산서 발행 주체인 발급자를 등록하고 관리합니다. 발행 방식에 따라 공동인증서 필요 여부가 다릅니다. [용어 정리](/docs/api-introduction/glossary) | [대리 정발행](/docs/api-introduction/usecase-delegated) | [위수탁 발행](/docs/api-introduction/usecase-brokered) - name: 인증서 description: > 발급자 공동인증서 등록 및 관리. [인증서 등록](/docs/api-introduction/certificate-registration) paths: /v1/revenues:sync: post: tags: - 매출/매입 내역 조회 summary: 매출 동기화 요청 description: > 대시보드에서 연동한 매출 전부의 수집을 요청합니다. API가 `202 Accepted`로 접수만 하고 수집은 비동기로 진행합니다. 볼타가 매출을 주기적으로 수집하므로, 방금 국세청에 올라간 문서가 급할 때만 요청하세요. 수집 상태를 조회하는 경로는 없습니다. 저장한 cursor로 `GET /v1/revenues`를 이어 받으세요. 사업자마다 30분에 1번, 24시간에 12번까지 요청할 수 있고, 매입 동기화와 한도를 따로 셉니다. `409`와 `422`로 거절한 요청은 한도를 차감하지 않습니다. 테스트 키는 수집하지 않고 접수 응답만 반환합니다. [매출/매입 내역 조회 가이드](/docs/api-introduction/revenue-expense) responses: '202': description: 접수 완료 content: application/json: schema: $ref: '#/components/schemas/RevenueExpenseSyncResponse' examples: 접수: x-parity-id: accepted summary: 30분 뒤에 다시 요청할 수 있는 접수 응답 value: acceptedAt: '2026-09-18T03:00:00Z' nextAvailableAt: '2026-09-18T03:30:00Z' headers: {} '401': description: API 키 인증 실패. 응답 본문이 없습니다. '402': description: >- 스탠다드 플랜 미만을 구독 중입니다. 응답의 `code`는 `PLAN_UPGRADE_REQUIRED`입니다. 볼타 대시보드의 결제 메뉴에서 플랜을 업그레이드한 뒤 다시 호출하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- 같은 경로의 수집이 이미 진행 중입니다. 볼타의 정기 수집도 포함합니다. 응답의 `code`는 `SYNC_IN_PROGRESS`입니다. 수집이 끝난 뒤 다시 요청하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: >- 매출을 가져올 연동이 대시보드에 없습니다. 응답의 `code`는 `NO_SOURCE_CONNECTED`입니다. 볼타 대시보드에서 홈택스 매출 연동을 먼저 하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- 30분 간격이나 24시간 12번 한도를 넘었습니다. 응답의 `code`는 `SYNC_RATE_LIMITED`입니다. `Retry-After` 이후에 다시 요청하세요. headers: Retry-After: description: 재시도까지 남은 시간(초) schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: 서버 내부 오류. 응답의 `code`는 `INTERNAL_SERVER_ERROR`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: > 동기화 요청을 지금 판정할 수 없습니다. 응답의 `code`는 `SYNC_UNAVAILABLE`입니다. 잠시 후 다시 요청하세요. 일시적인 내부 API 통신 오류일 때는 `SERVICE_UNAVAILABLE`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: RevenueExpenseSyncResponse: type: object description: 동기화 요청 접수 결과 properties: acceptedAt: type: string format: date-time description: 요청을 접수한 시각(UTC) nextAvailableAt: type: string format: date-time description: 30분 간격 제한에 걸리지 않는 다음 요청 시각(UTC). 24시간 12번 한도는 반영하지 않습니다. required: - acceptedAt - nextAvailableAt ErrorResponse: type: object description: API 요청 실패 시 반환되는 에러 응답 properties: code: type: string description: 에러 타입 식별자 message: type: string description: 에러 설명 traceId: type: string description: 요청 추적 식별자 required: - code - message - traceId securitySchemes: basicAuth: type: http scheme: basic description: >- API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요. ````