3.2.01上传销售单获取二维码链接 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

可选

示例值:

1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

对接不同系统来源编码，用于区分不同系统的回调接口

interfaceCode

enum<string>

接口业务编码

必需

枚举值:

BILL.PUSH

data

array [object {39}]

必需

需要把data的值加密成字符串，默认为base64

billNo

string

必需

单据编号【长度：32】

orgCode

string

可选

组织编码（默认可以不传，会通过销方税号自动匹配，一个税号分配给多个组织使用的必须要传组织）【长度：20】

billDate

string

必需

单据日期，(格式：yyyy-MM-dd)

totalAmount

number

必需

单据金额，含税标志是不含税时为不含税金额，含税是含税金额

autoInvoice

string

必需

自动开票，0-否，1-是，默认0

invoiceType

enum<string>

必需

发票种类， 028-增值税电子专用发票， 004-增值税纸质专用发票， 026-增值税电子普通发票， 007-增值税纸质普通发票，025-卷票【长度：4】，08xdp-全电专票，10xdp-全电普票

枚举值:

02802600400702508xdp10xdp

priority

string

必需

优先级，0,普通，1-加急

billSource

string

5-扫码开票

必需

contractNo

string

可选

合同号【长度：50】

sellerTaxpayerId

string

销方税号

必需

sellerName

string

销方名称

必需

sellerBankAndAccount

string

销方银行和账号

必需

sellerAddressAndTel

string

销方地址和电话

必需

includeTaxFlag

string

必需

含税标识，0-不含税，1-含税【长度：1】

deviceNo

string

可选

设备编号（可以不传，不传自动匹配税号默认设备）

terminalNo

string

可选

终端号码（可以不传，只有百旺服务器才需要传）

deduction

number

可选

差额征税差额【长度：(14,2)】

taxationStyle

string

必需

征税方式 0-普通，1-减按计征，2-差额征税

drawer

string

可选

开票人【长度：10】，未配置开票人策略时必填

payee

string

可选

收款人【长度：10】

reviewer

string

可选

复核人【长度：10】

remark

string

可选

备注，GBK编码230字节【长度：230】

autoMerge

string

必需

自动合并 0-否，1-是，自动开票为1时生效

pushMatchRules

string

必需

匹配规则 0-按物料匹配（默认） 1-物料分类匹配 2-按商品匹配 3-按开票项匹配

fillValueRule

string

必需

取值规则默认-取开票项名称 goodsName-取上游商品名称goodsCode-取上游商品编码 materialType-取上游物料分类

blueinvoiceCode

string

可选

待冲蓝票代码，开具红字普票时选填

blueinvoiceNo

string

可选

待冲蓝票号码，开具红字普票时选填

originalIssueTime

string

可选

待冲蓝票开票日期：格式为YYYY-MM-DD，开具红字普票时选填

blueInvoiceType

string

可选

待冲蓝票类型，开具红字普票时选填，（028-增值税电子专用发票， 004-增值税纸质专用发票， 026-增值税电子普通发票， 007-增值税纸质普通发票，025-卷票【长度：4】）

redReason

string

可选

冲红原因，开具红字普票时选填，1销货退回；2开票有误；3开票中止；4销售折让（填了待冲蓝票代码、号码时，如不填，默认为2开票有误）

specialType

string

可选

特殊票种，非特殊票种：00，收购类：02，成品油类：08，卷烟类：11。特殊票种时必填

invoiceProperty

string

可选

发票性质，0：蓝票；1：红票。不填默认蓝票

textField1

string

可选

主表扩展字段1【长度：GBK150字节】

textField2

string

可选

主表扩展字段2【长度：GBK150字节】

textField3

string

可选

主表扩展字段3【长度：GBK150字节】

textField4

string

可选

主表扩展字段4【长度：GBK150字节】

textField5

string

可选

主表扩展字段5【长度：GBK150字节】

travelerList

array [object {8}]

可选

旅客运输明细，发票云版本6.0.11支持

billDetail

array [object {21}]

必需

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": " BILL.PUSH",
  "data": [
    {
      "billNo": "string",
      "orgCode": "string",
      "billDate": "string",
      "totalAmount": 0,
      "autoInvoice": "string",
      "invoiceType": "028",
      "priority": "string",
      "billSource": "string",
      "contractNo": "string",
      "sellerTaxpayerId": "string",
      "sellerName": "string",
      "sellerBankAndAccount": "string",
      "sellerAddressAndTel": "string",
      "includeTaxFlag": "string",
      "deviceNo": "string",
      "terminalNo": "string",
      "deduction": 0,
      "taxationStyle": "string",
      "drawer": "string",
      "payee": "string",
      "reviewer": "string",
      "remark": "string",
      "autoMerge": "string",
      "pushMatchRules": "string",
      "fillValueRule": "string",
      "blueinvoiceCode": "string",
      "blueinvoiceNo": "string",
      "originalIssueTime": "string",
      "blueInvoiceType": "string",
      "redReason": "string",
      "specialType": "string",
      "invoiceProperty": "string",
      "textField1": "string",
      "textField2": "string",
      "textField3": "string",
      "textField4": "string",
      "textField5": "string",
      "travelerList": [
        {
          "traveler": "string",
          "cardType": "100",
          "cardNo": "string",
          "travelDate": "2024-04-02",
          "startPlace": "广东省深圳市宝安区",
          "endPlace": "广东省东莞市南城区",
          "transportType": "1",
          "seatClass": "一等座"
        }
      ],
      "billDetail": [
        {
          "amount": 0,
          "detailId": "string",
          "goodsCode": "string",
          "goodsName": "string",
          "lineProperty": 0,
          "price": 0,
          "privilegeContent": "string",
          "privilegeFlag": 0,
          "quantity": 0,
          "revenueCode": "string",
          "specification": "string",
          "taxRate": "string",
          "taxAmount": 0,
          "discountAmount": 0,
          "discountRate": "string",
          "units": "string",
          "extraField": "string",
          "extraField2": "string",
          "extraField3": "string",
          "extraField4": "string",
          "extraField5": "string"
        }
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi?access_token=1107974180231447552_L3nqi9yB42ysU25QKA2Z6qgxT3blIVYsp9Nr1eLbP9B63o4Pjb3177JC7544rQ0dgNCgwLEfI92NHbAaM5Cdxz1rsQwF9u1ANbDI' \
--header 'Content-Type: application/json' \
--data-raw '{
    "requestId": "string",
    "businessSystemCode": "string",
    "interfaceCode": " BILL.PUSH",
    "data": [
        {
            "billNo": "string",
            "orgCode": "string",
            "billDate": "string",
            "totalAmount": 0,
            "autoInvoice": "string",
            "invoiceType": "028",
            "priority": "string",
            "billSource": "string",
            "contractNo": "string",
            "sellerTaxpayerId": "string",
            "sellerName": "string",
            "sellerBankAndAccount": "string",
            "sellerAddressAndTel": "string",
            "includeTaxFlag": "string",
            "deviceNo": "string",
            "terminalNo": "string",
            "deduction": 0,
            "taxationStyle": "string",
            "drawer": "string",
            "payee": "string",
            "reviewer": "string",
            "remark": "string",
            "autoMerge": "string",
            "pushMatchRules": "string",
            "fillValueRule": "string",
            "blueinvoiceCode": "string",
            "blueinvoiceNo": "string",
            "originalIssueTime": "string",
            "blueInvoiceType": "string",
            "redReason": "string",
            "specialType": "string",
            "invoiceProperty": "string",
            "textField1": "string",
            "textField2": "string",
            "textField3": "string",
            "textField4": "string",
            "textField5": "string",
            "travelerList": [
                {
                    "traveler": "string",
                    "cardType": "100",
                    "cardNo": "string",
                    "travelDate": "2024-04-02",
                    "startPlace": "广东省深圳市宝安区",
                    "endPlace": "广东省东莞市南城区",
                    "transportType": "1",
                    "seatClass": "一等座"
                }
            ],
            "billDetail": [
                {
                    "amount": 0,
                    "detailId": "string",
                    "goodsCode": "string",
                    "goodsName": "string",
                    "lineProperty": 0,
                    "price": 0,
                    "privilegeContent": "string",
                    "privilegeFlag": 0,
                    "quantity": 0,
                    "revenueCode": "string",
                    "specification": "string",
                    "taxRate": "string",
                    "taxAmount": 0,
                    "discountAmount": 0,
                    "discountRate": "string",
                    "units": "string",
                    "extraField": "string",
                    "extraField2": "string",
                    "extraField3": "string",
                    "extraField4": "string",
                    "extraField5": "string"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

data

object

返回内容，需要解密

必需

scanUrl

string

扫码开票URL

必需

errorCode

string

0为成功

必需

success

boolean

成功响应

必需

示例

{
  "data": {
    "scanUrl": "http://ireturn.top/qrcode/test/?systemCode=SCAN_ERP&qrKey=816215273307d471c95&billNo=111111111111002264&tenantId=tenant_devscm_test&amount=19.12&timestamp=1611123027796"
  },
  "errorCode": "0",
  "success": true
}

🟢200失败