Maintainers
Pricing
Enterprise
More
More
Documentation
Try Live
Rankings
Install
Blog
Docs7
Ask
New
Add Docs
Kingdee Invoice Cloud Ultimate (旗舰版)
https://open-ultimate.piaozone.com/
Admin
金蝶发票云旗舰版（星瀚发票云）API 文档，提供开票、收票、勾选认证、影像及档案等发票云服务接口的对接指南与数据模型说明。
Tokens:
329,514
Snippets:
1,496
Trust Score:
6.1
Update:
11 hours ago
Context
Chat
Benchmark
Latest
Show doc for...
Code
Info
Show Results
Tokens:
Raw
Copy
Link
Tokens:
Raw
Copy
Link
### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-146003718 该接口用于开具税控/数电机动车发票，支持机动车和二手车发票类型。请求体包含发票基本信息、购买方和销售方信息、车辆信息等。 ```APIDOC ## POST /kapi/app/sim/openApi ### Description 该接口用于开具税控/数电机动车发票，支持机动车和二手车发票类型。请求体包含发票基本信息、购买方和销售方信息、车辆信息等。 ### Method POST ### Endpoint /kapi/app/sim/openApi ### Parameters #### Query 参数 无 #### Header 参数 无 #### Request Body - **requestId** (string) - 请求ID - **businessSystemCode** (string) - 业务系统编码 - **interfaceCode** (string) - 接口编码，固定为 "INVOICE.OPEN.VEHICLE" - **data** (object) - 发票数据对象 - **serialNo** (string) - 流水号 - **salerName** (string) - 销售方名称 - **salerTaxNo** (string) - 销售方税号 - **salerAddress** (string) - 销售方地址 - **salerPhone** (string) - 销售方电话 - **salerAccount** (string) - 销售方账号 - **salerBankName** (string) - 销售方开户行 - **buyerNation** (string) - 购买方国籍 - **buyerName** (string) - 购买方名称 - **buyerTaxNo** (string) - 购买方税号 - **buyerPhone** (string) - 购买方电话 - **buyerProperty** (string) - 购买方性质 - **buyerCardType** (string) - 购买方证件类型 - **invoiceType** (string) - 发票类型 - **drawer** (string) - 开票人 - **account** (string) - 账号 - **machineNo** (string) - 机器编号 - **totalAmount** (number) - 总金额 - **totalTaxAmount** (string) - 总税额 - **goodsCode** (string) - 商品编码 - **taxRate** (number) - 税率 - **zeroTaxRateFlag** (string) - 零税率标识 - **preferentialPolicy** (string) - 优惠政策 - **vatException** (string) - 增值税异常 - **buyerEmail** (string) - 购买方邮箱 - **recipientPhone** (string) - 收件人电话 - **vehicleIdentificationCode** (string) - 车辆识别代码 - **brandModel** (string) - 品牌型号 - **vehicleType** (string) - 车辆类型 - **vehicleName** (string) - 车辆名称 - **limitePeople** (string) - 限乘人数 - **overTaxCode** (string) - 超税码 - **producingArea** (string) - 产地 - **importCertificate** (string) - 进口证明书 - **commodityInspectionNum** (string) - 商检编号 - **engineNum** (string) - 发动机号 - **totalTon** (string) - 总吨位 - **taxAuthorityCode** (string) - 税务机关代码 - **taxAuthorityName** (string) - 税务机关名称 - **certificateNum** (string) - 合格证编号 - **producingName** (string) - 生产企业名称 - **version** (string) - 版本 - **invoiceCopyType** (string) - 发票联次 - **vehicleUuid** (string) - 车辆UUID - **mfgImportDate** (string) - 制造/进口日期 - **usedCarInfo** (object) - 二手车信息 - **issueWay** (string) - 开具方式 - **licensePlateNumber** (string) - 车牌号 - **registerNumber** (string) - 登记证号 - **vehicleAdminName** (string) - 车辆管理所名称 - **sellerProperty** (string) - 卖方性质 - **sellerName** (string) - 卖方名称 - **sellerTaxNo** (string) - 卖方税号 - **sellerrAddress** (string) - 卖方地址 - **sellerPhone** (string) - 卖方电话 - **sellerCardtype** (string) - 卖方证件类型 - **sellerNation** (string) - 卖方国籍 - **buyerProperty** (string) - 买方性质 - **buyerAddress** (string) - 买方地址 - **buyerPhone** (string) - 买方电话 - **buyerCardType** (string) - 买方证件类型 - **buyerNation** (string) - 买方国籍 - **onlySave** (string) - 仅保存 ### Request Example ```json { "requestId": "string", "businessSystemCode": "string", "interfaceCode": "INVOICE.OPEN.VEHICLE", "data": { "serialNo": "string", "salerName": "string", "salerTaxNo": "string", "salerAddress": "string", "salerPhone": "string", "salerAccount": "string", "salerBankName": "string", "buyerNation": "string", "buyerName": "string", "buyerTaxNo": "string", "buyerPhone": "string", "buyerProperty": "0", "buyerCardType": "103", "invoiceType": "006", "drawer": "string", "account": "string", "machineNo": "string", "totalAmount": 0, "totalTaxAmount": "string", "goodsCode": "string", "taxRate": 0, "zeroTaxRateFlag": "string", "preferentialPolicy": "0", "vatException": "string", "buyerEmail": "string", "recipientPhone": "string", "vehicleIdentificationCode": "string", "brandModel": "string", "vehicleType": "string", "vehicleName": "string", "limitePeople": "string", "overTaxCode": "string", "producingArea": "string", "importCertificate": "string", "commodityInspectionNum": "string", "engineNum": "string", "totalTon": "string", "taxAuthorityCode": "string", "taxAuthorityName": "string", "certificateNum": "string", "producingName": "string", "version": "string", "invoiceCopyType": "6", "vehicleUuid": "string", "mfgImportDate": "string", "usedCarInfo": { "issueWay": "0", "licensePlateNumber": "string", "registerNumber": "string", "vehicleAdminName": "string", "sellerProperty": "0", "sellerName": "string", "sellerTaxNo": "string", "sellerrAddress": "string", "sellerPhone": "string", "sellerCardtype": "103", "sellerNation": "004", "buyerProperty": "0", "buyerAddress": "string", "buyerPhone": "string", "buyerCardType": "103", "buyerNation": "004" }, "onlySave": "string" } } ``` ### Response #### Success Response (200) 未在文档中提供响应示例。 #### Response Example 未在文档中提供响应示例。 ``` -------------------------------- ### cURL request for PC image viewing Source: https://open-ultimate.piaozone.com/api-145421032 Example cURL command to call the image viewing endpoint. It uses the GET method with query parameter formId=bds_view_image and an empty eventCode. The request includes an access_token header and an empty JSON body. ```shell curl --location --request GET 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs//index.html?formId=bds_view_image&eventCode=' \ --header 'access_token: {{access_token}}' \ --header 'Content-Type: application/json' \ --data '{}' ``` -------------------------------- ### 3.1.01 业务系统组装二维码链接格式 Source: https://open-ultimate.piaozone.com/api-145421043 This API describes the format for assembling QR code links in the business system. ```APIDOC ## 3.1.01 业务系统组装二维码链接格式 ### Description This API describes the format for assembling QR code links in the business system. ### Endpoint Refer to the detailed documentation at https://open-ultimate.piaozone.com/api-146003735 ``` -------------------------------- ### Success Response Example Source: https://open-ultimate.piaozone.com/api-145421050 Example of a successful 200 response. Contains success, errorCode, and message fields, all strings. ```json { "success": "string", "errorCode": "string", "message": "string" } ``` -------------------------------- ### 5.1.03回调接口-按单回调（单据对应的所有发票开票完毕后一起回调（包含开票成功和开票失败），不支持合并又拆分的场景） Source: https://open-ultimate.piaozone.com/api-145421031 该接口用于按单回调，单据对应的所有发票开票完毕后一起回调，包含开票成功和开票失败，不支持合并又拆分的场景。 ```APIDOC ## 5.1.03回调接口-按单回调（单据对应的所有发票开票完毕后一起回调（包含开票成功和开票失败），不支持合并又拆分的场景） ### Description 该接口用于按单回调，单据对应的所有发票开票完毕后一起回调，包含开票成功和开票失败，不支持合并又拆分的场景。 ### Endpoint https://open-ultimate.piaozone.com/api-146003722 ``` -------------------------------- ### cURL request example Source: https://open-ultimate.piaozone.com/api-145421034 Example cURL command to call the endpoint with an access token header and empty JSON body. ```shell curl --location --request GET 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs//index.html?formId=' \ --header 'access_token: {{access_token}}' \ --header 'Content-Type: application/json' \ --data '{}' ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-149332334 开具数电蓝字发票。调用本接口将直接开票，不进行数据匹配、补全等处理。使用场景为调用方仅需要开票且可提供完整的开票数据时。 ```APIDOC ## POST /kapi/app/sim/openApi ### Description 开具数电蓝字发票。调用本接口将直接开票，不进行数据匹配、补全等处理。使用场景为调用方仅需要开票且可提供完整的开票数据时。 ### Method POST ### Endpoint https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 #### Header Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 - **Content-Type** (string) - Required - 请求体格式，值为 application/json。 #### Request Body - **requestId** (string) - Required - 请求唯一标识。 - **businessSystemCode** (string) - Required - 业务系统编码。 - **interfaceCode** (string) - Required - 接口编码，固定为 ALLE.INVOICE.OPEN。 - **data** (object) - Required - 开票数据。 - **serialNo** (string) - Required - 发票流水号。 - **invoiceType** (string) - Required - 发票类型，如 "02" 表示数电专票。 - **sellerName** (string) - Required - 销售方名称。 - **sellerTaxpayerId** (string) - Required - 销售方纳税人识别号。 - **sellerBank** (string) - Optional - 销售方开户银行。 - **sellerBankAccount** (string) - Optional - 销售方银行账号。 - **sellerAddress** (string) - Optional - 销售方地址。 - **buyerName** (string) - Required - 购买方名称。 - **buyerTaxpayerId** (string) - Required - 购买方纳税人识别号。 - **drawer** (string) - Required - 开票人。 - **invoiceDetail** (array) - Required - 发票明细列表。 - **lineProperty** (string) - Required - 行性质，如 "0" 表示正常行。 - **goodsName** (string) - Required - 货物或应税劳务名称。 - **amount** (number) - Required - 金额。 - **taxRate** (string) - Required - 税率。 - **revenueCode** (string) - Required - 税收分类编码。 ### Request Example { "requestId": "1624601109096", "businessSystemCode": "BUSINESS_FPY", "interfaceCode": "ALLE.INVOICE.OPEN", "data": { "serialNo": "202403011709193622521", "invoiceType": "02", "sellerName": "金蝶票据云科技(深圳)有限公司", "sellerTaxpayerId": "91440300MA5G9GK78Y", "sellerBank": "中国银行深圳皇岗支行1111111111", "sellerBankAccount": "4000027219200486412", "sellerAddress": "高新技术产业园南区科技南十二路11111111111111", "buyerName": "深圳金蝶账无忧网络科技有限公司", "buyerTaxpayerId": "91440300358768292H1", "drawer": "张三", "invoiceDetail": [ { "lineProperty": "0", "goodsName": "纸电一体开收票", "amount": 2000, "taxRate": "0.01", "revenueCode": "3040201010000000000" } ] } } ### Response #### Success Response (200) - **data** (string) - 开票结果数据，如发票号码。 - **errorCode** (string) - 错误码，"0" 表示成功。 - **success** (boolean) - 是否成功。 #### Response Example {"data":"BAIDU_TEST202203281503331951","errorCode":"0","success":true} ``` -------------------------------- ### Request Body Example for getEventCode Source: https://open-ultimate.piaozone.com/api-145421030 Example JSON body for the getEventCode endpoint. Contains scanBillNo and resource fields, both as strings. ```json { "scanBillNo": "string", "resource": "string" } ``` -------------------------------- ### 2.1.01 数电票蓝字开票接口 Source: https://open-ultimate.piaozone.com/doc-3655357 该接口用于上传开票数据，直接开具数电发票。请求地址为baseUrl + /kapi/app/sim/openApi?access_token={access_token}。 ```APIDOC ## [POST] /kapi/app/sim/openApi?access_token={access_token} ### Description 上传开票数据，直接开具数电发票。 ### Method POST ### Endpoint /kapi/app/sim/openApi?access_token={access_token} ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 ### Request Example （请求参数未在源文档中明确列出，此处省略） ### Response #### Success Response （返回示例未在源文档中明确列出，此处省略） #### Response Example （返回示例未在源文档中明确列出，此处省略） ``` -------------------------------- ### GET 2.04影像匹配结果页面 Source: https://open-ultimate.piaozone.com/api-145421035 This endpoint provides access to the image matching result page. It is a GET request, but no further details are available from the source. ```APIDOC ## GET 2.04影像匹配结果页面 ### Description This endpoint provides access to the image matching result page. ### Method GET ### Endpoint (Endpoint not specified in source) ``` -------------------------------- ### Success response example for BILL.QUICK.RED Source: https://open-ultimate.piaozone.com/api-146003730 Example of a successful response (HTTP 200) with message '批量单据红冲提交成功', errorCode '0', and success true. ```json { "message": "批量单据红冲提交成功", "errorCode": "0", "success": true } ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-341774752 获取跨区域涉税事项数据查询结果。调用跨区域涉税事项数据查询接口后，通过本接口获取查询结果。 ```APIDOC ## POST /kapi/app/sim/openApi ### Description 获取跨区域涉税事项数据查询结果。调用跨区域涉税事项数据查询接口后，通过本接口获取查询结果。 ### Method POST ### Endpoint https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 #### Header Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 - **Content-Type** (string) - Required - 请求体格式，值为 application/json。 #### Request Body - **requestId** (string) - Required - 请求唯一标识。 - **interfaceCode** (string) - Required - 接口代码。 - **businessSystemCode** (string) - Required - 业务系统代码。 - **data** (object) - Required - 请求数据对象。 - **batchNo** (string) - Required - 批次号，用于标识查询批次。 ### Request Example ```json { "requestId": "string", "interfaceCode": "string", "businessSystemCode": "string", "data": { "batchNo": "string" } } ``` ### Response #### Success Response (200) - **success** (boolean) - 请求是否成功。 - **errorCode** (string) - 错误码。 - **message** (string) - 消息。 - **data** (array) - 查询结果数组。 - **crossRegionTaxVerifyNo** (string) - 跨区域涉税事项验证号。 - **crossRegionArea** (string) - 跨区域地区。 - **crossRegionStreet** (string) - 跨区域街道。 - **crossRegionAddress** (string) - 跨区域地址。 - **taxValidityStartDate** (string) - 税务有效期开始日期。 - **taxValidityEndDate** (string) - 税务有效期结束日期。 - **projectName** (string) - 项目名称。 #### Response Example ```json { "success": true, "errorCode": "string", "message": "string", "data": [ { "crossRegionTaxVerifyNo": "string", "crossRegionArea": "string", "crossRegionStreet": "string", "crossRegionAddress": "string", "taxValidityStartDate": "string", "taxValidityEndDate": "string", "projectName": "string" } ] } ``` ``` -------------------------------- ### Response Example for queryCover Source: https://open-ultimate.piaozone.com/api-145421058 Example JSON response with message, errorCode, data containing cover and attachment arrays, and an invoice array. ```json { "message": "string", "errorCode": "string", "data": { "cover": [ { "localUrl": "string", "coverNo": "string", "snapshotUrl": "string", "fileType": "string" } ], "attachment": [ { "attachmentName": "string", "localUrl": "string", "snapshotUrl": "string", "serialNo": "string", "remark": "string", "attachmentType": "1" } ] }, "invoice": [ {} ] } ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-341240355 异构系统调用该接口，可查询跨区域涉税事项数据，支持查询单张或者批量查询，支持通过乐企和电子税局查询。查询成功后，使用提取跨区域涉税事项数据查询结果接口，获取查询结果。 ```APIDOC ## POST /kapi/app/sim/openApi ### Description 异构系统调用该接口，可查询跨区域涉税事项数据，支持查询单张或者批量查询，支持通过乐企和电子税局查询。查询成功后，使用提取跨区域涉税事项数据查询结果接口，获取查询结果。 ### Method POST ### Endpoint https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 #### Header Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 - **Content-Type** (string) - Required - 请求体格式，值为application/json。 #### Request Body - **requestId** (string) - Required - 请求唯一标识。 - **interfaceCode** (string) - Required - 接口代码。 - **businessSystemCode** (string) - Required - 业务系统代码。 - **data** (object) - Required - 查询数据对象。 - **orgCode** (string) - Required - 组织机构代码。 - **taxNo** (string) - Required - 税号。 - **reportIssueStartDate** (string) - Optional - 报告开具开始日期。 - **reportIssueEndDate** (string) - Optional - 报告开具结束日期。 - **crossRegionTaxVerifyNo** (string) - Optional - 跨区域涉税事项验证号。 - **account** (string) - Optional - 账号。 ### Request Example { "requestId": "string", "interfaceCode": "string", "businessSystemCode": "string", "data": { "orgCode": "string", "taxNo": "string", "reportIssueStartDate": "string", "reportIssueEndDate": "string", "crossRegionTaxVerifyNo": "string", "account": "string" } } ### Response #### Success Response (200) - **success** (boolean) - 是否成功。 - **errorCode** (string) - 错误代码。 - **message** (string) - 消息。 - **data** (object) - 响应数据。 - **batchNo** (string) - 批次号。 #### Response Example { "success": true, "errorCode": "string", "message": "string", "data": { "batchNo": "string" } } ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-503300230 该接口用于接收机动车统一销售发票的回调通知。请求体包含发票开具结果及相关信息，如发票代码、号码、状态等。 ```APIDOC ## POST /kapi/app/sim/openApi ### Description 该接口用于接收机动车统一销售发票的回调通知，包含发票开具结果及相关信息。 ### Method POST ### Endpoint /kapi/app/sim/openApi ### Parameters #### Query Parameters 无 #### Header Parameters 无 #### Request Body - **interfaceCode** (string) - 接口代码 - **returnCode** (string) - 返回代码 - **returnMsg** (string) - 返回信息 - **data** (object) - 回调数据 - **serialNo** (string) - 流水号 - **salerName** (string) - 销售方名称 - **salerTaxNo** (string) - 销售方税号 - **salerAddress** (string) - 销售方地址 - **salerPhone** (string) - 销售方电话 - **salerAccount** (string) - 销售方账户 - **salerBankName** (string) - 销售方开户行 - **buyerNation** (string) - 购买方国籍 - **buyerName** (string) - 购买方名称 - **buyerTaxNo** (string) - 购买方税号 - **buyerPhone** (string) - 购买方电话 - **buyerProperty** (string) - 购买方性质 - **buyerCardType** (string) - 购买方证件类型 - **invoiceType** (string) - 发票类型 - **drawer** (string) - 开票人 - **account** (string) - 账号 - **machineNo** (string) - 机器编号 - **totalAmount** (number) - 总金额 - **totalTaxAmount** (string) - 总税额 - **goodsCode** (string) - 商品编码 - **taxRate** (number) - 税率 - **zeroTaxRateFlag** (string) - 零税率标志 - **preferentialPolicy** (string) - 优惠政策 - **vatException** (string) - 增值税异常 - **buyerEmail** (string) - 购买方邮箱 - **recipientPhone** (string) - 收件人电话 - **vehicleIdentificationCode** (string) - 车辆识别代码 - **brandModel** (string) - 品牌型号 - **vehicleType** (string) - 车辆类型 - **vehicleName** (string) - 车辆名称 - **limitePeople** (string) - 限乘人数 - **overTaxCode** (string) - 超税码 - **producingArea** (string) - 产地 - **importCertificate** (string) - 进口证明书 - **commodityInspectionNum** (string) - 商检单号 - **engineNum** (string) - 发动机号 - **totalTon** (string) - 总吨位 - **taxAuthorityCode** (string) - 税务机关代码 - **taxAuthorityName** (string) - 税务机关名称 - **certificateNum** (string) - 合格证编号 - **producingName** (string) - 生产企业名称 - **version** (string) - 版本 - **invoiceCopyType** (string) - 发票联次 - **vehicleUuid** (string) - 车辆UUID - **mfgImportDate** (string) - 制造/进口日期 - **infoCode** (string) - 信息代码 - **invoiceAmount** (string) - 发票金额 - **invoiceCode** (string) - 发票代码 - **invoiceNo** (string) - 发票号码 - **invoiceDate** (string) - 开票日期 - **invoiceFileUrl** (string) - 发票文件URL - **invoiceStatus** (string) - 发票状态 - **issueStatus** (string) - 开具状态 - **issueErrorMessage** (string) - 开具错误信息 - **ofdFileUrl** (string) - OFD文件URL - **xmlFileUrl** (string) - XML文件URL - **originalInvoiceCode** (string) - 原发票代码 - **originalInvoiceNo** (string) - 原发票号码 - **systemSource** (string) - 系统来源 - **type** (string) - 类型 - **buyerCardno** (string) - 购买方证件号码 - **usedCarInfo** (object) - 二手车信息 - **issueWay** (string) - 开具方式 - **licensePlateNumber** (string) - 车牌号 - **registerNumber** (string) - 登记证号 - **vehicleAdminName** (string) - 车管所名称 - **sellerProperty** (string) - 销售方性质 - **sellerName** (string) - 销售方名称 - **sellerTaxNo** (string) - 销售方税号 - **sellerrAddress** (string) - 销售方地址 - **sellerPhone** (string) - 销售方电话 - **sellerCardtype** (string) - 销售方证件类型 - **sellerNation** (string) - 销售方国籍 - **buyerProperty** (string) - 购买方性质 - **buyerAddress** (string) - 购买方地址 - **buyerPhone** (string) - 购买方电话 - **buyerCardType** (string) - 购买方证件类型 - **buyerNation** (string) - 购买方国籍 ### Request Example ```json { "interfaceCode": "string", "returnCode": "string", "returnMsg": "string", "data": { "serialNo": "string", "salerName": "string", "salerTaxNo": "string", "salerAddress": "string", "salerPhone": "string", "salerAccount": "string", "salerBankName": "string", "buyerNation": "string", "buyerName": "string", "buyerTaxNo": "string", "buyerPhone": "string", "buyerProperty": "0", "buyerCardType": "103", "invoiceType": "006", "drawer": "string", "account": "string", "machineNo": "string", "totalAmount": 0, "totalTaxAmount": "string", "goodsCode": "string", "taxRate": 0, "zeroTaxRateFlag": "string", "preferentialPolicy": "0", "vatException": "string", "buyerEmail": "string", "recipientPhone": "string", "vehicleIdentificationCode": "string", "brandModel": "string", "vehicleType": "string", "vehicleName": "string", "limitePeople": "string", "overTaxCode": "string", "producingArea": "string", "importCertificate": "string", "commodityInspectionNum": "string", "engineNum": "string", "totalTon": "string", "taxAuthorityCode": "string", "taxAuthorityName": "string", "certificateNum": "string", "producingName": "string", "version": "string", "invoiceCopyType": "6", "vehicleUuid": "string", "mfgImportDate": "string", "infoCode": "string", "invoiceAmount": "string", "invoiceCode": "string", "invoiceNo": "string", "invoiceDate": "string", "invoiceFileUrl": "string", "invoiceStatus": "string", "issueStatus": "string", "issueErrorMessage": "string", "ofdFileUrl": "string", "xmlFileUrl": "string", "originalInvoiceCode": "string", "originalInvoiceNo": "string", "systemSource": "string", "type": "string", "buyerCardno": "string", "usedCarInfo": { "issueWay": "0", "licensePlateNumber": "string", "registerNumber": "string", "vehicleAdminName": "string", "sellerProperty": "0", "sellerName": "string", "sellerTaxNo": "string", "sellerrAddress": "string", "sellerPhone": "string", "sellerCardtype": "103", "sellerNation": "004", "buyerProperty": "0", "buyerAddress": "string", "buyerPhone": "string", "buyerCardType": "103", "buyerNation": "004" } } } ``` ### Response #### Success Response (200) 无明确响应示例。 #### Response Example 无明确响应示例。 ``` -------------------------------- ### Request Body Example for /kapi/app/bds/fileCollect Source: https://open-ultimate.piaozone.com/api-145421042 Example JSON body for the file collection request. At least one of base64 or fileDownUrl is required. ```json { "base64": "string", "fileDownUrl": "string", "fileSuffix": "string", "fileType": "string", "scanBillNo": "string", "billType": "string", "resource": "string", "needRecognition": "string" } ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-146003717 该接口用于重发发票的邮件或短信通知，支持数电票和税控发票。通过提供发票代码、发票号码、邮箱和手机号等信息，系统将重新发送相关通知。 ```APIDOC ## [POST] /kapi/app/sim/openApi ### Description 该接口用于重发发票的邮件或短信通知，支持数电票和税控发票。通过提供发票代码、发票号码、邮箱和手机号等信息，系统将重新发送相关通知。 ### Method POST ### Endpoint https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 #### Header Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 - **Content-Type** (string) - Required - 请求体格式，值为 application/json。 #### Request Body - **requestId** (string) - Required - 请求唯一标识。 - **businessSystemCode** (string) - Required - 业务系统编码。 - **interfaceCode** (string) - Required - 接口编码，固定为 "INVOICE.RESEND"。 - **data** (object) - Required - 请求数据对象。 - **resendtype** (string) - Required - 重发类型。 - **params** (array) - Required - 重发参数列表。 - **invoicecode** (string) - Required - 发票代码。 - **invoiceno** (string) - Required - 发票号码。 - **email** (string) - Optional - 接收邮箱地址。 - **phone** (string) - Optional - 接收手机号码。 ### Request Example ```json { "requestId": "string", "businessSystemCode": "string", "interfaceCode": "INVOICE.RESEND", "data": { "resendtype": "string", "params": [ { "invoicecode": "string", "invoiceno": "string", "email": "user@example.com", "phone": "string" } ] } } ``` ### Response #### Success Response (200) - **data** (object) - 返回数据，包含发票号码对应的重发结果信息。 - **message** (string) - 响应消息。 - **errorCode** (string) - 错误码，"0000" 表示成功。 - **success** (boolean) - 是否成功。 #### Response Example ```json {"data":{"152755310920_38569486":"该发票为非电子发票，不支持重发"},"message":"成功","errorCode":"0000","success":true} ``` ``` -------------------------------- ### Success Response Example for /kapi/app/bds/erpBillPush Source: https://open-ultimate.piaozone.com/api-145421031 Example of a successful 200 response. Contains success flag, errorCode, message, and data object. ```json { "success": true, "errorCode": "string", "message": "string", "data": {} } ``` -------------------------------- ### Response Example for generateurllink Source: https://open-ultimate.piaozone.com/api-201555744 Example JSON response for a successful (200) request. Contains errorCode, message, and data object with url_link field. ```json { "errorCode": "string", "message": "string", "data": { "url_link": "string" } } ``` -------------------------------- ### POST /kapi/app/sim/openApi Source: https://open-ultimate.piaozone.com/api-146003709 该接口用于快速红冲税控发票，仅支持全额红冲。通过提交发票代码、发票号码等信息，实现发票的红冲操作。 ```APIDOC ## [POST] /kapi/app/sim/openApi ### Description 该接口用于快速红冲税控发票，仅支持全额红冲。通过提交发票代码、发票号码等信息，实现发票的红冲操作。 ### Method POST ### Endpoint https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/sim/openApi ### Parameters #### Query Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 #### Header Parameters - **access_token** (string) - Required - 访问令牌，用于身份验证。 - **Content-Type** (string) - Required - 请求体格式，固定为application/json。 #### Request Body - **requestId** (string) - Required - 请求唯一标识。 - **businessSystemCode** (string) - Required - 业务系统编码。 - **interfaceCode** (string) - Required - 接口编码，固定为" QUICK.RED"。 - **data** (array) - Required - 红冲数据列表。 - **invoiceCode** (string) - Required - 发票代码。 - **invoiceNum** (string) - Required - 发票号码。 - **redInfoBillNo** (string) - Required - 红冲信息单据号。 - **redReason** (string) - Required - 红冲原因。 ### Request Example { "requestId": "string", "businessSystemCode": "string", "interfaceCode": " QUICK.RED", "data": [ { "invoiceCode": "string", "invoiceNum": "string", "redInfoBillNo": "string", "redReason": "string" } ] } ### Response #### Success Response (200) - **data** (string) - 操作结果信息，如"提交红冲成功"。 - **errorCode** (string) - 错误码，"0"表示成功。 - **success** (boolean) - 是否成功。 #### Response Example {"data":"提交红冲成功","errorCode":"0","success":true} ``` -------------------------------- ### Request Body JSON Example Source: https://open-ultimate.piaozone.com/api-201880993 Example JSON payload for the request body. The interfaceCode is 'ALLE.ACCOUNT.CHECK' and the data contains the tax number (taxno). ```json { "requestId": "string", "businessSystemCode": "string", "interfaceCode": "ALLE.ACCOUNT.CHECK", "data": { "taxno": "税号" } } ```
