在线调试台
不用装任何东西。填上开灵给你的密钥,选一个接口,点「发送请求」,当场就能看到工商银行的真实返回。app_secret 只在你自己的浏览器里参与签名计算,不会传给任何人。
第一步 · 填密钥
默认填的是演示密钥,只返回样例数据、不会真调工行。换成开灵给你的正式密钥即可真调。
第二步 · 选接口
POST /api/v1/rinv/invoice/create数据类
第三步 · 填参数
已按文档示例预填好,直接发也行。留空的字段不会发送。
你侧订单号(全流程唯一,查结果、红冲、作废都用它)
收款散户ID。对应工行的「收方编号」outVendorId —— 反向开票里收钱的是散户
企业子商户编号。对应工行的「付方编号」outUserId —— 付钱的是回收企业。不传或传空时自动取后台「工行参数」里为贵司配置的值,所以一般不用传
企业税号
交易渠道:01 PC / 02 移动端 / 03 H5
★发票类型:01=增值税专用发票 / 02=普通发票。工行「开票时必输」,由你按实际业务选择。收购发票(农产品/报废产品)专票、普票两种场景都有,我方不设默认、不代填,你传什么就是什么,不传即不上送
支付渠道:不传时默认 05=公对私结算(工行确认本场景固定用 05)。走 05 时机构编码 verifiedCode 与 U盾 ukeyId 都不用传
★支付标识,钱怎么付,与 payChannel 是两件事:不传时默认 1=推送至企业网银,由网银经办工号完成付款与确认;2=直接支付;0=其他。走 1 时必须同时传 payerName 与 payerAcctNum
★票种:不传时默认 04=报废产品收购发票。农产品收购请显式传 01。与 specificElements 成对(04↔24、01↔16),传其中一个另一个会自动推导
平台经营模式:不传时默认 02=非平台自营(回收企业自己是买方、开灵只是技术服务商)。01=平台自营 / 03=反向开票助手
区域代码。工行只在 merBusiModel=01 平台自营时要求必输,默认的 02 模式下不必传,我方也不代填;确需上送时自行传值(01 模式下不传则自动取后台为贵司配置的 proTaxAuthCode)
付款完成后回跳地址
★票面备注,最多 450 字。写什么就印在发票的「备注」栏里(合同号、结算单号、产地等)。也可以写成 remark,两个名字都认
★谁来点确认:不传时默认 1=企业代散户确认(确认动作在企业网银经办工号处完成,散户不用再点,工行直接显示「订单已受理」);要改回散户本人确认,显式传 0
★谁去交税(只有再生资源/报废产品收购能用):不传或 1=企业委托扣缴(默认,企业付全款,工行代扣税后把净额打给散户);0=散户自行办理(工行不代扣,企业只付货款,税由散户自己去办)
taxPaymentMethod=0 时配套传:个税项目 1=财产转让所得 / 2=经营所得
taxPaymentMethod=0 时配套传:补缴税费标志,工行文档说明目前固定传 Y
★付款账户的户名,也就是钱从哪家公司的账户出。asynFlag=1(默认那种)时工行要求必填,最多 120 字
★付款账户的账号。asynFlag=1(默认那种)时工行要求必填,最多 34 位。务必用字符串传,写成数字会丢位数