简要描述:

  • 第三方系统,通过迅联云接入认证后,须有需要可以通过自定义的接口接收此报文,用来接收发票修改的状态通知,(实际调用地址为申请单和草稿单据中的callbackurl地址)

接口版本:

版本号 制定人 制定日期 修订日期
王佳田 2022-4-8 2022-4-8

请求方式:

  • POST

请求头:

参数名 是否必须 类型 说明
Content-Type String 请求类型: application/json

请求URL:

post 申请单和草稿单据中的callbackurl地址

请求参数:

主信息
字段 参数名称 是否必须 类型 长度 说明
operateType 本次操作类型 Integer 2 0:已开具 2:已删除 4:已作废 5:已红冲 6:申请单
requisitionApplyNo 开票申请单编号 String 96
requisitionStatus 申请单状态 String 2 02:部分开具;03:已开具发票;(红冲和作废发票均还原为部分开具)04:已删除
otherId 第三方平台发票唯一标识 String 100 本次操作类型为已红冲时,该字段是原蓝票的otherId;
docId 平台单据编号 String 20 本次操作类型为已红冲时,该字段是原蓝票的docId;
invoiceUuid 平台单据UUID String 36 本次操作类型为已红冲时,该字段是原蓝票的invoiceUuid;
companyDataResource 数据来源 String 36 只能是字母或数字
buyerAddress 购方地址、电话 String 100 中文占2字节
buyerBankAndId 购方开户行及账号 String 100 中文占2字节
buyerName 购方名称 String 100 中文占2字节
buyerTaxId 购方税号 String 20
sellerAddress 销方地址、电话 String 100 中文占2字节
sellerBankAndId 销方开户行及账号 String 100 中文占2字节
sellerName 销方名称 String 100 中文占2字节
sellerTaxId 销方税号 String 20
docStatus 发票状态 String 2 ISSUED-已开具;CANCELED-已作废;
invoiceTypeCode 发票类型代码 String 2 专票:01;普票:04;电子普票票:10; 电子专票08;
invoiceCode 发票代码 String 12 本次操作类型为已红冲时,该字段是红票的发票代码
invoiceNumber 发票号码 String 8 本次操作类型为已红冲时,该字段是红票的发票号码
issueDate 开票日期 String 20 时间戳 毫秒
blueInvoiceCode 原蓝票发票代码 String 12
blueInvoiceNo 原蓝票发票号码 String 8
totalAmountExcludeTax 发票金额 BigDecimal 12/13 小数点后2位
totalTaxAmount 发票税额 BigDecimal 12/13 小数点后2位
totalAmountIncludeTax 价税合计 BigDecimal 13/14 小数点后2位
checkCode 校验码 String 128
codeVersion 编码表版本号 String 20
computeWithTax 含税标识 Integer 2 是否含税 :0不含税 1含税
drawer 开票人 String 20 中文占2字节
payee 收款人 String 16 中文占2字节
reviewer 复核人 String 16 中文占2字节
note 备注 String 212 中文占2字节
specialInvoiceMark 特殊票种标识 String 2 00:非特殊票种 08:成品油销售
receiveRecipient 收件人 String 10
receiveAddress 收件人地址 String 200
receiveMsgEmail 接收电票下载信息邮箱号 String 64
receiveMsgPhone 接收电票下载信息手机号 String 12
ofdUrl Ofd发票下载地址 String
statementCode 对账单编号 String 100
noticeCodeNo 通知单编号 String 100
lines 行信息 object[]
lines明细信息
字段 参数名称 是否必须 类型 长度 说明
id 明细编号 String 20 平台生成的编号
requisitionLineNo 申请单行号 String 20 申请单创建时的明细行号
lineAttribute 发票行性质 String 2 发票行性质; 0:正常行(无折扣),1:折扣行 2:被折扣行(有折扣)
itemName 货物名称 String 92 中文占2字节
unit 单位 String 14 中文占2字节
itemModelName 供应商规格型号 String 40 中文占2字节
quantity 数量 BigDecimal 16 小数点后8位
priceExcludeTax 不含税单价 BigDecimal 16 小数点后8位
priceIncludeTax 含税单价 BigDecimal 16 小数点后8位
lineAmountExcludeTax 不含税金额 BigDecimal 12 小数点后2位
lineAmountIncludeTax 含税金额 BigDecimal 12 小数点后2位
taxAmount 税额 BigDecimal 12 小数点后2位
taxRate 税率 BigDecimal 12 小数点后2位
discount 含税折扣额 BigDecimal 12 小数点后2位,被折扣行有值且为正数
lineDiscountExcludeTax 不含税折扣额 BigDecimal 12 小数点后2位,被折扣行有值且为正数
taxDiscount 折扣税额 BigDecimal 12 小数点后2位,(正数)
taxClassificationCode 税收分类编码 String 20
materialCode 物料编码 String 20
zeroTaxRateFlag 零税率标识 String 2 空代表无1出口免税和其他免税优惠政策 2 不征增值税 3 普通零税率
favouredPolicyMark 优惠政策标识 String 2 0:未使用,1:使用
favouredPolicyName 优惠政策名称 String 500 中文占2字节
orderNo 订单编号 String 100
orderLineId 订单行号 String 20
statementCode 对账单编号 String 100
StatementLineId 对账单行号 String 20
noticeCodeNo 通知单编号 String 100
noticeLineId 通知单行号 String 20

请求示例:

 {
  "blueInvoiceCode": "string",
  "blueInvoiceNo": "string",
  "buyerAddress": "string",
  "buyerBankAndId": "string",
  "buyerName": "string",
  "buyerTaxId": "string",
  "callbackUrl": "string",
  "checkCode": "string",
  "codeVersion": "string",
  "computeWithTax": 0,
  "companyDataResource": "string",
  "docId": "string",
  "drawer": "string",
  "invoiceCode": "string",
  "invoiceNumber": "string",
  "invoiceTypeCode": "string",
  "invoiceUuid": "string",
  "issueDate": "",
  "lines": [
    {
      "discount": 0,
      "lineDiscountExcludeTax":0,
      "taxDiscount": 0,
      "favouredPolicyMark": "string",
      "favouredPolicyName": "string",
      "id": "string",
      "itemModelName": "string",
      "itemName": "string",
      "lineAmountExcludeTax": 0,
      "lineAmountIncludeTax": 0,
      "lineAttribute": "string",
      "priceExcludeTax": 0,
      "priceIncludeTax": 0,
      "quantity": 0,
      "taxAmount": 0,
      "taxClassificationCode": "string",
      "taxDiscount": 0,
      "taxRate": 0,
      "unit": "string",
      "zeroTaxRateFlag": "string",
      "orderNo": null,
      "orderLineId": null,
      "statementCode": null,
      "statementLineId": null,
      "noticeCodeNo": null,
      "noticeLineId": null,
      "lineNo": null
    }
  ],
  "note": "string",
  "ofdUrl": "string",
  "operateType": 0,
  "otherId": "string",
  "payee": "string",
  "receiveMsgEmail": "string",
  "receiveMsgPhone": "string",
  "requisitionApplyNo": "string",
  "requisitionStatus": "string",
  "reviewer": "string",
  "sellerAddress": "string",
  "sellerBankAndId": "string",
  "sellerName": "string",
  "sellerTaxId": "string",
  "specialInvoiceMark": "string",
  "totalAmountExcludeTax": 0,
  "totalAmountIncludeTax": 0,
  "totalTaxAmount": 0,
  "statementCode": null,
  "noticeCodeNo": null,
  "receiveRecipient": null,
  "receiveAddress": null
}
文档更新时间: 2022-09-26 14:35   作者:王佳田