---
title: "현금영수증 발행"
method: POST
path: "/cash-receipt/issue"
tags: ["현금영수증 ERP 연동 (발행/취소/조회)"]
---

# 현금영수증 발행

`POST /cash-receipt/issue`

## Request

- The document declares no server URL.
- Auth: none declared

현금영수증을 발급합니다.

## Request body

- CashReceiptIssueRequest: 현금 영수증 발생 요청 DTO
  - `apiKey` string, required: 파트너 연동을 위한 고유키
  - `member` string, required: 파트너 사용자 코드
  - `merchant` string, required: 파트너 매장 코드
  - `cashReceipt` IssueCashReceiptInfo
    - `billId` string, required: 청구서 ID 문자/숫자 20자리 (중복불가) - 개발: 사업자번호 + 10자리 자유롭게 사용 - 운영: 20자리 자유롭게 사용
    - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우: {bill_id} + "," + {phone} + "," + {price} 로 Hash 생성 {phone} 값이 없는 경우: {bill_id} + "," + {price} 로 Hash 생성 SHA-256으로 생성합니다
    - `price` string, required: 결제 금액
    - `supplyPrice` string, required: 공급가액 보내지 않을 경우 사업장의 면,과세 정책을 따라갑니다.
    - `tax` string, required: 세액 보내지 않을 경우 사업장의 면,과세 정책을 따라갑니다.
    - `issuanceNumber` string, required: 현금영수증 발행 요청 번호
    - `trader` string, required: 현금영수증 발급 구분 개인:0, 사업자:1

## Response `200`

성공

- BaseResponseCashReceiptIssueResponse: 공통 API 응답 포맷 (api.spec: code/message/data)
  - `code` string: 응답 코드
  - `message` string: 응답 메시지
  - `data` CashReceiptIssueResponse: 현금영수증 발행 응답
    - `apiKey` string: 파트너 연동을 위한 고유키
    - `member` string: 파트너 매장 코드
    - `merchant` string: 파트너 사용자 코드
    - `billId` string: 청구서 ID
    - `hash` string: 요청 시 전달된 해시값
    - `trader` string: 현금영수증 발급 구분 (소득공제/지출증빙)
    - `apprCashNum` string: 현금영수증 승인번호
    - `issuanceNumber` string: 현금영수증 발급 요청 번호 (휴대폰/주민번호/사업자번호)

---

[API](https://skmtc.dev/payssam/apis/payssam-api.md) - [All operations](https://skmtc.dev/payssam/apis/payssam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payssam/apis/payssam-api/revisions/73517f9ba4e2?raw)