1.1.08 创建负数单匹配任务
开发中POST
/kapi/app/sim/openApi本接口为异步接口,需要结合1.1.09接口使用
请求参数
Query 参数
access_token
string
可选
示例值:
1617326422240529408_YGVCbl9K6s8XTrIE0J9rdaztYI5Nw9LqmCadaCx2kW9v5CLRGZwLetQjDShDRbi3LVxQQTH5e9v1v7h4ac4L2BUTF1n6ucvd1wM8
Body 参数application/json
requestId
string
时间戳
businessSystemCode
string
必需
对接不同系统来源编码,用于区分不同系统的回调接口
interfaceCode
string
接口业务编码
枚举值:
BILL.MATCH
data
array [object {17}]
必需
需要把data的值加密成字符串,默认为base64
billNo
string <regex>
必需
单据编号;参数限制:数字、英文、下划线、-
<= 50 字符
默认值:
0
正则匹配:
^[a-zA-Z0-9_-]+$
redReason
string
必需
冲红原因,开具红字普票时选填,1销货退回;2开票有误;3开票中止;4销售折让(填了待冲蓝票代码、号码时,如不填,默认为2开票有误)
枚举值:
1234
默认值:
2
invoiceType
#/definitions/82907377必需
发票种类,未配置票种管理策略时必填
orgCode
string
可选
组织编码(默认可以不传,会通过销方税号自动匹配,一个税号分配给多个组织使用的必须要传组织) 【长度:20】
sellerTaxpayerId
string
可选
销方税号。组织编号、销方名称/税号三选一必传 (1)传组织编号,销方信息未传时,根据组织编号找销方信息。 (2)销方税号/销方二选一,两者都填,以销方税号为准。
sellerName
string
可选
销方名称,销方税号或销方二选一必填,两者都填,以销方税号为准
buyerTaxpayerId
string
必需
购买方税号,(专票必填) 当购买方性质为企业填写税号,当购方性质为个人填写身份证
buyerName
string
必需
购买方名称,根据购方名称匹配税号、地址电话、开户行账号(如有),不传且需自动开票时,提示:购方名称为空,请补充,不传且不自动开票时,保存为开票申请单
pushMatchRules
string
必需
商品明细匹配规则 0-按物料匹配(默认) 1-物料分类匹配 2-按商品匹配 3-按开票项匹配
枚举值:
0123
默认值:
0
fillValueRule
string
必需
商品名称取值规则 默认-取开票项名称 goodsName-取上游商品名称goodsCode-取上游商品编码 materialType-取上游物料分类
枚举值:
nullgoodsNamegoodsCodematerialType
textField1
string
可选
主表扩展字段1【长度:GBK150字节】
textField2
string
可选
主表扩展字段2【长度:GBK150字节】
textField3
string
可选
主表扩展字段3【长度:GBK150字节】
textField4
string
可选
主表扩展字段4【长度:GBK150字节】
textField5
string
可选
主表扩展字段5【长度:GBK150字节】
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": "个"
}
]
}
]
}
示例代码
返回响应
成功(200)
失败(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object
返回内容,需要解密
batchNo
string
任务号
errorCode
string
0为成功
message
string
错误信息
success
boolean
成功响应
示例
{
"message": "成功",
"errorCode": "0",
"status": true,
"success": true
}
修改于 1 个月前