发票开票

发票开票接口,商户配置好开发票所需必要参数之后,商户业务系统调用此接口开发票。

接口说明

适用对象:特约商户

请求URL:https://pay.jeepay.vip/api/invoice/open

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
商户开票单号 mchOrderNo String(30) 20160427210604000490 商户生成的开票单号,保证唯一
开票方式 invoiceWay byte 2 开票方式: 2-获取开票链接
含税开票金额 amount int 100 含税开票金额,单位分
客户端IP clientIp String(128) 210.73.10.148 客户端IPV4地址
开票链接有效期 expiredDay int 3 开票方式为2时,可设置开票链接有效期,设置区间1~999天,默认4天
购方信息 buyerInfo String(256) {} 购方信息,json格式字符串,详见购方信息说明
销方信息 sellerInfo String(256) {} 销方信息,json格式字符串,保留字段
商品信息 goodsList String(256) [{}] 商品信息,json格式字符串,保留字段
渠道参数 channelExtra String(256 {} 特定渠道发起的额外参数,json格式字符串.保留字段
备注 remark String(256) 开票备注 备注
请求时间 reqTime long 1622016572190 请求接口时间,13位时间戳
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法
签名类型 signType String(32) MD5 签名类型,目前只支持MD5或RSA2方式

购方信息说明

字段名 变量名 必填 类型 示例值 描述
购方名称 buyerName String(20) 张三 购方开票名称
购方税号 taxNo String(128) abcde12345 购方开票税号,企业抬头必传
购方地址 address String(20) 河北省沧州市解放西路华商大厦 购方地址
购方固定电话 telphone String(20) 0317-xxx 购方固定电话
开户行 bankName String(20) 中国农业银行 开户行
开户账号 bankAccount String(20) 62xxxxx 开户账号
交付手机 pushPhone String(20) 131xxxx 交付手机,交付邮箱和交付手机需必传其一
交付邮箱 pushEmail String(20) xx@xx.xx 交付邮箱,交付邮箱和交付手机需必传其一

请求示例数据

{
    "buyerInfo": "{\"buyerName\":\"张三\",\"pushPhone\":\"12966668888\",\"taxNo\":\"556418D585E5FHG3Q\"}",
    "amount": 100,
    "mchOrderNo": "1715412578007",
    "invoiceWay": 2,
    "appId": "653b67b90d14f66aa119a518",
    "clientIp": "110.244.120.23",
    "sign": "1F98058E61DAA86AC909462C59F574AE",
    "signType": "MD5",
    "reqTime": "1715412578",
    "mchNo": "M1698391993",
    "version": "1.0"
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态 code int 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String(128) 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
签名信息 sign String(32) 7C165045B92700E60693423D32AD6446 对data内数据签名,如data为空则不返回
返回数据 data String(512) {} 返回下单数据,json格式数据

data数据格式

字段名 变量名 必填 类型 示例值 描述
发票单号 invoiceOrderId String(30) FP1789196148628787202 支付系统发票单号
商户开票单号 mchOrderNo String(30) 1715412578007 返回商户传入的开票单号
开票状态 state int 2 开票状态: 0-订单生成 1-开票中 2-开票成功 3-开票失败 4-开票任务关闭 5-已冲红 6-已作废
开票链接地址 channelInvoiceQrcodeUrl String(128) http://www.jeequan.com/pay.html 开票链接地址
开票链接失效时间 expiredTime String(30) 2024-05-15 00:00:00 开票链接失效时间
渠道错误码 errCode String ACQ.PAYMENT_AUTH_CODE_INVALID 上游渠道返回的错误码
渠道错误描述 errMsg String Business Failed 失败 上游渠道返回的错误描述

返回示例数据

{
    "code": 0,
    "data": {
        "channelInvoiceQrcodeUrl": "https://openapi.tianquetech.com/merchant/makeInvoice.html?id=NTNmZTBlODU4YWFkNDFhN2EwYzA1ODM3ZTk4Yzc2MTU=",
        "expiredTime": "2024-05-15 00:00:00",
        "invoiceOrderId": "FP1789196148628787202",
        "mchOrderNo": "1715412578007",
        "state": 1
    },
    "msg": "SUCCESS",
    "sign": "7C165045B92700E60693423D32AD6446"
}

查询开票详情

商户通过该接口查询开票状态和成功开票时的详细信息,支付网关会返回最新的数据

接口说明

适用对象:特约商户

请求URL:https://pay.jeepay.vip/api/invoice/query

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
发票单号 invoiceOrderId String(30) FP1789129338202107906 支付网关生成的发票单号,与mchOrderNo二者传一即可
商户开票单号 mchOrderNo String(30) 1715412578007 商户开票单号,与invoiceOrderId二者传一即可
请求时间 reqTime long 1622016572190 请求接口时间,13位时间戳
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法
签名类型 signType String(32) MD5 签名类型,目前只支持MD5或RSA2方式

请求示例数据

{
    "appId": "653b67b90d14f66aa119a518",
    "sign": "FFDF7695ECF250BD68D432CE26326BC8",
    "signType": "MD5",
    "reqTime": "1715413704",
    "mchNo": "M1698391993",
    "version": "1.0",
    "invoiceOrderId": "FP1770009488532013057"
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态 code int 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String(128) 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
签名信息 sign String(32) CCD9083A6DAD9A2DA9F668C3D4517A84 对data内数据签名,如data为空则不返回
返回数据 data String(512) {} 返回下单数据,json格式数据

data数据格式

字段名 变量名 必填 类型 示例值 描述
发票单号 invoiceOrderId String(30) P12021022311124442600 支付系统发票单号
商户号 mchNo String(30) M1621873433953 商户号
商户开票单号 mchOrderNo String(30) 20160427210604000490 返回商户传入的开票单号
含税开票金额 amount int 100 含税开票金额,单位分
税额 feeAmount BigDecimal 1 开票税额,单位分
开票状态 state int 2 开票状态:0-订单生成,1-开票中,2-开票成功,3-开票失败,4-开票任务关闭,5-已冲红,6-已作废
渠道发票单号 channelInvoiceOrderNo String 20160427210604000490 对应渠道发票单号
购方信息 buyerInfo String(256) {} 购方信息json字符串,具体字段见下方说明
发票详细信息 invoiceInfo String(256) {} 发票详细信息json字符串,具体字段见下方说明
商品信息 goodsList String(256) [{}] 商品信息,jsonArray字符串,具体字段见下方说明
开票链接地址 channelInvoiceQrcodeUrl String(128) http://www.jeequan.com/pay.html 开票链接地址
开票链接失效时间 expiredTime String(30) 2024-05-15 00:00:00 开票链接失效时间
渠道错误码 errCode String 1002 渠道下单返回错误码
渠道错误描述 errMsg String 134586944573118714 渠道下单返回错误描述
备注 remark String(256) 134586944573118714 备注
创建时间 createdAt long 1622016572190 订单创建时间,13位时间戳

购方信息说明

字段名 变量名 必填 类型 示例值 描述
购方名称 buyerName String(20) 张三 购方开票名称
购方税号 taxNo String(128) abcde12345 购方开票税号
购方地址 address String(20) 河北省沧州市解放西路华商大厦 购方地址
购方固定电话 telphone String(20) 0317-xxx 购方固定电话
开户行 bankName String(20) 中国农业银行 开户行
开户账号 bankAccount String(20) 62xxxxx 开户账号
交付手机 pushPhone String(20) 131xxxx 交付手机
交付邮箱 pushEmail String(20) xx@xx.xx 交付邮箱

发票详细信息说明,开票成功时返回响应信息

字段名 变量名 必填 类型 示例值 描述
发票代码 invoiceCode String(30) 张三 发票代码
发票号码 invoiceNo String(30) abcde12345 发票号码
数电发票号码 digitInvoiceNo String(30) abcde12345 数电发票号码
发票密文 invoiceCipher String(256) xxx 发票密文
发票下载地址 einvoiceUrl String(20) http 发票下载地址,访问可下载发票
红字发票号码 redInvoiceNo String(20) xxxxx 红字发票号码

商品信息说明

字段名 变量名 必填 类型 示例值 描述
商品ID goodsId String(64) 65f951200d14521d34c0757b 商品唯一ID
商品名称 goodsName String(64) 玉米 商品名称
税收分类编码 goodsCode String(32) 1010101030000000000 税收分类编码
税收分类简称 goodsClassify String(20) xxx 税收分类简称
商品单价 goodsPrice BigDecimal 2.00000000 商品单价,单位元
商品数量 goodsNum BigDecimal 0.1050 商品数量
商品小计 totalPrice String(20) 0.21 商品小计,单位元
商品税率 goodsTaxRate String(20) 9 商品税率,枚举值: 0, 1, 3, 5, 6, 9, 13,分别对应: 0%, 1%, 3%…
商品税额 goodsTaxAmount BigDecimal 0.00 商品税额,单位元
零税率标识 freeTaxMark byte 0 零税率标识, 0-无 1-出口免税和其他免税优惠政策 2-不征增值税 3-普通零税率
规格型号 goodsSpecification String(20) xxx 规格型号
计量单位 goodsUnit String(20) 计量单位
特殊票种标记 invoiceSpecialMark String(20) 00 特殊票种标记,00:普通发票 01:不动产租赁服务发票 02:农业发票 03:建筑服务发票 06:抵扣通行费 07:其他通行费 08:成品油

返回示例数据

{
    "code": 0,
    "data": {
        "amount": 21,
        "buyerInfo": "{\"buyerName\":\"河北计全科技有限公司\",\"pushPhone\":\"132xxxxxxxx\",\"taxNo\":\"91XXXXXXXXX\"}",
        "channelInvoiceOrderNo": "fa143b2231d34d2b935ef8aff176db47",
        "channelInvoiceQrcodeUrl": "",
        "feeAmount": 0E-10,
        "goodsList": "[{\"freeTaxMark\":0,\"goodsClassify\":\"玉米\",\"goodsCode\":\"1010101030000000000\",\"goodsId\":\"65f951200d14521d34c0757b\",\"goodsName\":\"玉米\",\"goodsNum\":0.1050,\"goodsPrice\":2.00000000,\"goodsTaxAmount\":0.00,\"goodsTaxRate\":9,\"goodsUnit\":\"斤\",\"invoiceSpecialMark\":\"00\",\"totalPrice\":0.21}]",
        "invoiceInfo": "{\"einvoiceUrl\":\"http://fp.baiwang.com/fp/d?d=2197F8FAF1E5110FE0DB7C8145DDB9F76E93D2EE951BAE52F104FC59AA25FC8A\",\"invoiceCode\":\"011077890011\",\"invoiceNo\":\"06569890\"}",
        "invoiceOrderId": "FP1770009488532013057",
        "state": 2
    },
    "msg": "SUCCESS",
    "sign": "3A8FF74B7C86BCA234BEB77C814B29A2"
}

获取全电账号管理URL

商户调用此接口获取全电账号管理URL,进行全电账号的登录、认证。

接口说明

适用对象:特约商户

请求URL:https://pay.jeepay.vip/api/invoice/elecUrl

请求方式:GET

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
请求时间 reqTime long 1622016572190 请求接口时间,13位时间戳
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法
签名类型 signType String(32) MD5 签名类型,目前只支持MD5或RSA2方式

请求示例数据

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
  "signType": "MD5",
  "reqTime": "1622011236571",
  "version": "1.0"
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态 code int 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String(128) 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
签名信息 sign String(32) CCD9083A6DAD9A2DA9F668C3D4517A84 对data内数据签名,如data为空则不返回
返回数据 data String(512) {} 返回下单数据,json格式数据

data数据格式

字段名 变量名 必填 类型 示例值 描述
渠道用户ID etaxUserUrl String https://i.baiwang.com/pi/etax_user?ak=49bf723a3fed4c4783eb32dbea3bba0f&sk=raujsiowem41233DF3223 全电账号管理url,通过此链接可以进行全电账号的登录、认证
渠道错误码 errCode String 1002 渠道返回错误码
渠道错误描述 errMsg String 认证失败 渠道返回错误描述

完整跳转URL示例

{
    "etaxUserUrl":"https://i.baiwang.com/pi/etax_user?ak=49bf723a3fed4c4783eb32dbea3bba0f&sk=raujsiowem41233DF3223"
}

返回码

code 描述
0 成功
9999 异常,具体错误详见msg字段
文档更新时间: 2024-05-15 19:14   作者:大森林