1.1.08 创建负数单匹配任务

开发中

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/sim/openApi

本接口为异步接口，需要结合1.1.09接口使用

请求参数

Query 参数

access_token

string

可选

示例值:

1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

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

interfaceCode

enum<string>

接口业务编码

必需

枚举值:

BILL.MATCH

data

array [object {17}]

必需

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

billNo

string <regex>

必需

单据编号；参数限制：数字、英文、下划线、-

<= 50 字符

默认值:

正则匹配:

^[a-zA-Z0-9_-]+$

redReason

enum<string>

必需

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

枚举值:

1234

默认值:

invoiceType

enum<string>

必需

发票种类，未配置票种管理策略时必填

枚举值:

02802600400702508xdp10xdp

orgCode

string

可选

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

<= 20 字符

sellerTaxpayerId

string

可选

销方税号。组织编号、销方名称/税号三选一必传（1）传组织编号，销方信息未传时，根据组织编号找销方信息。（2）销方税号/销方二选一，两者都填，以销方税号为准。

<= 20 字符

sellerName

string

可选

销方名称，销方税号或销方二选一必填，两者都填，以销方税号为准

<= 100 字符

buyerTaxpayerId

string

必需

购买方税号，（专票必填）当购买方性质为企业填写税号，当购方性质为个人填写身份证

<= 20 字符

buyerName

string

必需

购买方名称，根据购方名称匹配税号、地址电话、开户行账号（如有），不传且需自动开票时，提示：购方名称为空，请补充，不传且不自动开票时，保存为开票申请单

<= 100 字符

pushMatchRules

enum<string>

必需

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

枚举值:

0123

默认值:

fillValueRule

enum<string>

必需

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

枚举值:

nullgoodsNamegoodsCodematerialType

textField1

string

可选

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

<= 150 字符

textField2

string

可选

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

<= 150 字符

textField3

string

可选

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

<= 150 字符

textField4

string

可选

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

<= 150 字符

textField5

string

可选

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

<= 150 字符

totalAmount

number

可选

不含税金额。在匹配规则中，匹配基准为按金额匹配时必填，匹配基准为按数量匹配时不填

billDetail

array [object {17}]

单据明细

必需

示例

{
  "requestId": "1624601109096",
  "businessSystemCode": "BUSINESS_FPY",
  "interfaceCode": "BILL.PUSH",
  "data": [
    {
      "billNo": "ids-uat-3std1-29",
      "billDate": "2023-05-17",
      "totalAmount": 11300,
      "autoInvoice": "0",
      "invoiceType": "08xdp",
      "buyerName": "深圳市顺丰快运有限公司test01",
      "buyerProperty": "0",
      "sellerTaxpayerId": "91440300MA5G9GK78Y",
      "sellerName": "金蝶票据云科技(深圳)有限公司",
      "sellerBankAndAccount": "13710884704",
      "sellerAddressAndTel": "高新技术产业园南区科技南十二路58996989",
      "drawer": "开票人",
      "billDetail": [
        {
          "amount": 11300,
          "detailId": "1194121661989796666",
          "goodsName": "蜂胶口腔膜",
          "lineProperty": 2,
          "price": 11300,
          "quantity": 1,
          "revenueCode": "1070304990000000000",
          "taxRate": "0.13",
          "units": "个"
        }
      ]
    }
  ]
}

示例代码

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=1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "requestId": "1624601109096",
  "businessSystemCode": "BUSINESS_FPY",
  "interfaceCode": "BILL.PUSH",
  "data": [
    {
      "billNo": "ids-uat-3std1-29",
      "billDate": "2023-05-17",
      "totalAmount": 11300,
      "autoInvoice": "0",
      "invoiceType": "08xdp",
      "buyerName": "深圳市顺丰快运有限公司test01",
      "buyerProperty": "0",
      "sellerTaxpayerId": "91440300MA5G9GK78Y",
      "sellerName": "金蝶票据云科技(深圳)有限公司",
      "sellerBankAndAccount": "13710884704",
      "sellerAddressAndTel": "高新技术产业园南区科技南十二路58996989",
      "drawer": "开票人",
      "billDetail": [
        {
          "amount": 11300,
          "detailId": "1194121661989796666",
          "goodsName": "蜂胶口腔膜",
          "lineProperty": 2,
          "price": 11300,
          "quantity": 1,
          "revenueCode": "1070304990000000000",
          "taxRate": "0.13",
          "units": "个"
        }
      ]
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

data

object

返回内容，需要解密

可选

batchNo

string

任务号

必需

errorCode

string

0为成功

必需

message

string

错误信息

必需

success

boolean

成功响应

必需

示例

{
    "message": "成功",
    "errorCode": "0",
    "status": true,
    "success": true
}

🟢200失败

修改于 2025-03-14 02:15:27

1.1.07 开票申请单重开单生成（星瀚发票云版本5.0.015支持，不支持数电票）

1.1.09 查询负数单匹配任务结果