---
title: "현금영수증 발급"
method: POST
path: "/if/cash-receipt/issue"
tags: ["erp-cash-receipt-controller"]
---

# 현금영수증 발급

`POST /if/cash-receipt/issue`

## Request

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

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

## Request body

- ReqIssueCashReceipt
  - `apikey` string, required: 파트너 연동을 위한 고유키
  - `merchant` string, required: 파트너 매장 코드
  - `member` string, required: 파트너 사용자 코드
  - `bill` ReqCashReceipt
    - `bill_id` string, required: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
    - `hash` string, required: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성
    - `price` string, required: 현금영수증 금액 {supply_price} + {tax}
    - `supply_price` string, required: 공급가액 -price에서 tax를 뺀 값을 입력 -tax가 0인 경우 price와 동일하게 입력
    - `tax` string, required: 세금 -세금이 없는 경우 0 입력
    - `issuance_number` string, required: 현금영수증 발급 요청 번호 -현금영수증 발급 시 사용 -자진발급시 "0100001234"
    - `trader` string, required: 현금영수증 발급 구분 개인:0, 사업자:1

## Response `200`

성공

- IssueCashReceipt
  - `code` string: 응답 코드
  - `msg` string: 응답 메세지
  - `apikey` string: 파트너 연동을 위한 고유키
  - `member` string: 파트너 매장 코드
  - `merchant` string: 파트너 사용자 코드
  - `bill_id` string: 청구서 ID 문자/숫자 20자리 (중복불가) -개발: 사업자번호 + 10자리 자유롭게 사용 -운영: 20자리 자유롭게 사용
  - `hash` string: 통신 암호 키 {phone} 값이 설정된 경우 {bill_id} + "," + {phone} + "," + {price} 값으로 Hash 생성 {phone} 값이 설정되어 있지 않은 경우 {bill_id} + "," + {price} 값으로 Hash 생성
  - `trader` string: 현금영수증 발급 구분 개인:0, 사업자:1
  - `appr_cash_num` string: 현금영수증 발급 승인번호
  - `issuance_number` string: 현금영수증 발급 요청 번호 -현금영수증 발급 시 사용 -자진발급시 "0100001234"

---

[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)