发票申请文档 - Powered by MinDoc

简要描述：

发票申请接口文档

接口版本：

版本号	制定人	制定日期	修订日期
1.0.0	杨铝杰	2019-07-16	2019-07-16

请求URL:

https://fp.xrtpay.cn/make_invoice

请求方式：

POST

请求头：

参数名	是否必须	类型	说明
Content-Type	是	String	请求类型： application/json

请求参数:

参数名	是否必须	类型	说明
material	是	String	1.纸质票 2.电子票
type	是	String	发票类型1.普通票 2.专用票
order_date	是	String	订单支付日期yyyyMMdd
order_id	是	String	订单号
buyer_name	是	String	购买方名称
buyer_tax_code	是	String	购买方税号
buyer_addr	否	String	购买方地址
buyer_phone	否	String	购买方电话
buyer_bank	否	String	购买方开户行
buyer_bank_no	否	String	购买方银行帐户
amount	是	String	开票金额，单位元
good_details	否	String	商品明细
remark	否	String	备注信息
notify_url	是	String	异步通知地址
notify_mobile	是	String	通知人手机号，与邮箱二选一
notify_email	是	String	通知人邮箱，与手机号二选一
mch_no	是	String	商户号
sign	是	String	加密后的密钥

商品明细:

商品明细 goodsDetail 的格式是 JSONArray，把每件商品的描述作为一个 JSONObject 加
入 JSONArray。单件商品描述信息包括一下，每项参数以 key-value 方式存入 JSONObject。

参数	名称	类型	参数说明	是否心填
index	行号	Int	行号，从 1 开始	是
attribute	发票行性质	String(1)	正常行 1: 折扣行 2: 被折扣行	是
discountIndex	折行对应行号	Int	(有折扣，必填)	否
name	商品名称	String	折扣行与被折扣行一致	否
sn	商品编码	String	参考商品编码	是
taxRate	税率	Int		是
priceIncludingTax	含税总价格	double	单位为元折扣行为负数	是
quantity	数量	double	默认为 1.0	否
unit	单位	String		否
model	规格型号	String		否
freeTaxType	免税类型	String	空:正常非零税率 0:出口退税 1:免税 2:不征税 3:普通零税率	否
preferPolicyFlag	是否使用优惠政策	String	0:否 1:是	否
vatSpecial	增值税特殊管理	String	取值参考‘优惠政策’小节	否

优惠政策:

商品明细中的免税类型、是否使用优惠政策、增值税特殊管理和税率等的取值可参考如下，最终以税局出具的商品和服务税收分类与编码文档为准。

免税类型 freeTaxType	空	0	1	2	3
是否使用优惠政策 preferPolicyFlag	0:增值税特殊管理为空 1:增值税特殊管理不为空	1	1	1	0
增值税特殊管理 vatSpecial	空超税负 3%即征即退超税负 8%即征即退超税负 12%即征即退简易征收按 3%简易征收按 5%简易征收按 5%简易征收减按1.5%计征即征即退 30% 即征即退 50% 即征即退 70% 即征即退 100% 50%先征后退 100%先征后退稀土产品	出口退税	免税	不征税	空
税率 taxRate	6 10 16	0	0	0	0

返回示例:

正确时返回:

{
  "retCode": "0000",
  "retMsg": "处理成功",
  "dataDetail": {
    "amount": "1",
    "buyerAccount": "",
    "buyerAddress": "",
    "buyerBank": "",
    "buyerName": "",
    "buyerTaxCode": "",
    "buyerTelephone": "",
    "checkCode": "0801b",
    "checker": "陈雪君",
    "cipherCode": "009b8e2b73af4b981c2706c5c0012b13de0a43c4dc5fa24ab207aa61290d60801b",
    "deductionAmount": "0.0",
    "deviceNo": "",
    "drawer": "曾冬",
    "errMsg": "开票申请成功！",
    "goods_detail": "null",
    "invalid": 1,
    "invoiceCode": "144031909110",
    "invoiceMaterial": "ELECTRONIC",
    "invoiceNo": "13366762",
    "invoiceType": "PLAIN",
    "issueDate": "2019-12-06 19:10:45",
    "mch_no": "861105550114065",
    "merOrderDate": "20191206",
    "merOrderId": "5345336573573464456",
    "merWxAppId": "",
    "merWxOrderId": "",
    "msgId": "32393935653735362d336334392d343761622d623537662d6235336661306430",
    "notifyEmail": "",
    "notifyMerEmail": "",
    "notifyMobileNo": "",
    "notifyUrl": "",
    "payee": "黄婉芯",
    "pdfPreviewUrl": "https://fapiao.chinaums.com/fapiao-portal/preview.do?qrCodeId=20191206f80716afdb714c0484fa6b9007c2efe3",
    "pdfUrl": "https://fapiao.chinaums.com/p/20191206f80716afdb714c0484fa6b9007c2efe3",
    "qrCode": "https://fapiao.chinaums.com/fapiao-portal/preview.do?qrCodeId=20191206f80716afdb714c0484fa6b9007c2efe3",
    "qrCodeId": "20191206f80716afdb714c0484fa6b9007c2efe3",
    "remark": "",
    "responseTimestamp": "2019-12-06 19:10:45",
    "sellerAccount": "755920511910506",
    "sellerAddress": "深圳市罗湖区东门街道城东社区深南东路2010号奥康德大厦8层801室",
    "sellerBank": "招商银行股份有限公司深圳布吉支行",
    "sellerName": "深圳市信瑞泰支付服务有限公司",
    "sellerTaxCode": "91440300080139255R",
    "sellerTelphone": "",
    "srcReserve": "",
    "status": "ISSUED",
    "storeId": "",
    "storeName": "深圳市信瑞泰支付服务有限公司",
    "taxMethod": "NORMAL",
    "totalPrice": "0.009433962264150943",
    "totalPriceIncludingTax": "0.01",
    "totalTax": "0.0005660377358490566",
    "userNotifyUrl": "www.xrtpay.cn"
  }
}

错误时返回:

{
    "retcode": "500",
    "errmsg": "系统错误"
}

返回参数说明:

参数名	类型	说明
retCode	String	0000为成功，其他失败
retMsg	String	返回消息
dataDetail	Json Object	返回数据详情
mchNo	String	商户号
status	String	PENDING:待开具 ISSUING:开具中 ISSUED:已开具 REVERSING:红冲中 REVERSED:已红冲 CLOSED:已关闭
invoiceMaterial	String	发票材质，纸质发票：PAPER 电子发票：ELECTRONIC
invoiceType	String	发票类型，普通发票：PLAIN 增值税专用发票：VAT
invoiceNo	String	发票号码
invoiceCode	String	发票代码
checkCode	String	校验码
cipherCode	String	密码区
issueDate	String	开票日期
merchantName	String	银商商户名称
merchantId	String	银商商户号
terminalId	String	银商商户终端号
orderId	String	订单号
merOrderDate	String	订单日期 yyyyMMdd
buyerName	String	买方名称
buyerTaxCode	String	买方纳税人识别号
buyerAddress	String	买方地址
buyerTelephone	String	买方电话
buyerBank	String	买方开户行
buyerAccount	String	买方银行账号
sellerName	String	卖方名称
sellerTaxCode	String	卖方纳税人识别号
sellerAddress	String	卖方地址
sellerTelphone	String	卖方电话
sellerBank	String	卖方开户行
sellerAccount	String	卖方账号
payee	String	收款人
checker	String	复核人
drawer	String	开票人
taxMethod	String	征税方式，NORMAL：普通征税 DEDUCTION：差额征税
deductionAmount	String	扣除额，单位元
totalPriceIncludingTax	String	扣除额，单位元
totalTax	String	税额
totalPrice	String	不含税总金额
goodsDetail	String	商品明细
notifyMobileNo	String	消费者手机号
notifyEmail	String	消费者邮箱
notifyUrl	String	商户通知地址
qrcodeId	String	二维码唯一标识
qrcode	String	领票二维码
pdfUrl	String	pdf下载链接
pdfPreviewUrl	String	pdf预览链接
errMsg	String	开票结果信息
sign	String	签名

备注:

更多返回错误代码请看首页的错误代码描述

文档更新时间: 2019-12-09 15:25 作者：EricYang