현금영수증 발행
현금영수증 발행 요청은 비동기입니다. API가 202 Accepted와 issuanceKey를 먼저 반환합니다. 처리 중이거나 발행 결과 확인이 필요한 요청은 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다. 상태 조회에서 ISSUED를 확인하거나 CASH_RECEIPT_ISSUED 웹훅을 받아 최종 발행 결과를 확인하세요.
수취인 유형(recipient.type)과 발급수단(recipient.value) 입력 방식, 금액과 검증 규칙은 현금영수증 발행 가이드를 참고하세요.
{
"issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
헤더
1~255자의 요청자 관리번호를 입력하세요. 이 값은 멱등키로 사용합니다. 같은 API 키와 요청자 관리번호로 요청 내용과 유형까지 동일하게 다시 호출하면 API가 기존 접수 건의 issuanceKey를 담은 202 Accepted 응답을 반환합니다. 요청 내용이나 유형이 다르면 409 Conflict와 IDEMPOTENCY_CONFLICT를 반환합니다. 상태를 다시 조회할 때 이 값을 clientReferenceId에 입력하세요. 인증 가이드
1 - 255\S본문
현금영수증 발행 요청 본문
품목명(20자 이하)
1 - 20"서비스 이용료"
현금영수증을 발급하는 공급자 정보입니다.
Show child attributes
Show child attributes
수취인(발급 대상) 정보입니다. type에 맞춰 value를 입력하세요. 자세한 규칙은 현금영수증 발행 가이드를 참고하세요.
- Option 1
- Option 2
- Option 3
Show child attributes
Show child attributes
발행 금액입니다. 각 항목과 총액(supplyAmount + vatAmount + taxFreeAmount)은 9,999,999,999 이하여야 하며, 총액은 0보다 커야 합니다.
Show child attributes
Show child attributes
응답
API가 발행 요청을 접수했습니다.
현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으니 문자열 전체를 그대로 저장하세요.
"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
{
"issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}