甬易支付文档中心

主题

开票状态查询 ​

接口描述 ​

商户通过调用该接口查询汇总手续费的开票状态及发票文件下载地址。

请求URL ​

  • /invoice/status/inquiry

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是string应用ID202415629590370906
signature是string签名
transNonce是string32请求流水号43e2c287-24b1-4cd1-b3d2-e40e7840cc40
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
merchantNo是string商户编号XS240820000054
gatherFeeId是string汇总手续费ID202401001

请求报文示例 ​

json
{
  "appId": "202415629590370906",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "merchantNo": "XS241026000093",
  "gatherFeeId": "202401001"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13响应时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例
gatherMonth是string汇总月份2024-01
gatherFeeId是string汇总ID202401001
gatherFeeAmount是string汇总手续费金额10000
gatherStatus是string状态：I-未开票，P-开票中，F-开票失败，S-开票成功，A-开票申请中I
pdfUrl否string发票PDF下载地址
ofdUrl否string发票OFD下载地址
xmlUrl否string发票XML下载地址

响应示例 ​

json
{
  "code": "00000000",
  "message": "成功",
  "signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
  "transDate": "1731469621597",
  "transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
  "gatherMonth": "2024-01",
  "gatherFeeId": "202401001",
  "gatherFeeAmount": "10000",
  "gatherStatus": "S",
  "pdfUrl": "https://example.com/invoice/202401001.pdf",
  "ofdUrl": "https://example.com/invoice/202401001.ofd",
  "xmlUrl": "https://example.com/invoice/202401001.xml"
}

备注 ​