사전 준비
테스트 API 키 발급
개발자센터 > API 키 메뉴에서 테스트 키를 생성합니다.테스트 키는 test_로 시작하며, 모든 발행 요청이 가상으로 처리됩니다. 공동인증서 등록
볼타 설정 > 공동인증서에서 공동인증서를 등록합니다.테스트 환경에서는 테스트 인증서를 사용할 수 있어 실제 공동인증서가 없어도 연동 테스트가 가능합니다.
첫 번째 API 호출
테스트 API 키와 customerKey를 준비했다면, 아래 curl 명령으로 세금계산서를 발행해보세요.
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
-H "Authorization: Basic $(echo -n 'test_YOUR_API_KEY:' | base64)" \
-H "Customer-Key: YOUR_CUSTOMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"date": "2025-01-15",
"purpose": "RECEIPT",
"supplier": {
"identificationNumber": "1234567890",
"organizationName": "공급자 상호",
"representativeName": "홍길동",
"manager": {
"email": "[email protected]"
}
},
"supplied": {
"identificationNumber": "0987654321",
"organizationName": "공급받는자 상호",
"representativeName": "김철수",
"managers": [
{
"email": "[email protected]"
}
]
},
"items": [
{
"date": "2025-01-15",
"name": "테스트 품목",
"unitPrice": 10000,
"quantity": 1,
"supplyCost": 10000,
"tax": 1000
}
]
}'
test_YOUR_API_KEY와 YOUR_CUSTOMER_KEY를 실제 값으로 교체하세요. date 필드는 발행 마감일 이내의 날짜로 설정해야 하며, 잘 모르겠다면 오늘 날짜를 사용해보세요.
응답 확인
발행 요청이 성공하면 issuanceKey가 반환됩니다.
{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}
다음 단계
