简要描述:

  • 销项发票分页查询

接口版本:

版本号 制定人 制定日期 修订日期
王佳田 2022-04-08 2022-04-08

请求方式:

  • POST

请求头:

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

请求URL:

/sco-invoice-legged-biz/tax/output/openapi/sellerInvoiceQueryPage

请求参数:

字段 参数名称 是否必须 类型 长度 说明
buyerName 购买方公司名称 string 255
complianceStatus 查验合规状态 Array[integer] 1 未较验0、合规1、不合规2、查验中3、待校验4
cooperativeStatus 协同状态:0未发送、1已发送、2已接收、3已接受、4已拒绝 Array[string] 1
createTime 创建时间 string UTC格式
createTimeEnd 终止创建时间 string UTC格式
createTimeStart 起始创建时间 string UTC格式
deliveryStatus 交付状态( 0 未交付 1 交付中 2 已交付) string 2
docId 单据编号 string 100
docStatus 单据状态:DRAFT-草稿;ISSUED-开具;CANCELED-作废;SENT-已发送 Array[string] 32
draftType 草稿类型:0:普通草稿1:预制发票(不可编辑,只可开票、回退、赋码) integer 32
expressNumber 快递单号 string 30
inventoryMark 清单标志0-无清单 1-带清单 string 1
invoiceCode 发票代码 string 12
invoiceDateEnd 开票日期(止) date YYYY-mm-dd HH:mm:ss
invoiceDateStart 开票日期(起) date YYYY-mm-dd HH:mm:ss
invoiceDocUuidList 发票单据集合 Array[string] Uuid集合
invoiceNumber 发票号码 string 8
invoiceTypeCode 发票类型 Array[string] [“01”,”04”,”08”,”10”] “01”增值税专用发票 “04”增值税普通发票 “08” 值税专用发票(电票) “10”增值税普通发票(电票)
invoiceTypeSign 电票类型标志 Y 电票 N 纸票 string 1
mailingStatus 邮寄状态 (0 未邮寄、1 未发送、2 已邮寄、3 已发送、4 已签收) string
orderMap 排序属性,key为要排序的属性名,value为0或1;0:正序;1:倒序 Map
pageNum 第几页 integer 默认1
pageSize 每页大小 integer 2 默认15
printStatus 打印状态(“0”未打印 “1”已打印 integer 100
requisitionApplyNo 申请单编号 string 10
specialInvoiceMarkList 成品油标识(08) Array[string] 20,2 特殊票种标识(00:不是,01:农产品销售,02:农产品收购,08:成品油)
totalAmountExcludeTaxMax 总金额最大值 BigDecimal 20,2
totalAmountExcludeTaxMin 总金额最小值 BigDecimal 20,2
totalAmountIncludeTaxMax 价税合计最大值 BigDecimal 20,2
totalAmountIncludeTaxMin 价税合计最小值 BigDecimal 1
upload 是否上传 0否 1是 integer 2000
warningMsg 警告内容 Array[string] 11
warningStatus 警告状态 Array[integer] 警告状态,未较验0、正常1、失败2

请求示例:

{
  "buyerName": "",
  "complianceStatus": [

  ],
  "cooperativeStatus": [

  ],
  "createTime": "",
  "createTimeEnd": "",
  "createTimeStart": "",
  "deliveryStatus": "",
  "docId": "",
  "docStatus": [

  ],
  "draftType": 0,
  "expressNumber": "",
  "inventoryMark": "",
  "invoiceCode": "",
  "invoiceDateEnd": "",
  "invoiceDateStart": "",
  "invoiceDocUuidList": [

  ],
  "invoiceNumber": "",
  "invoiceTypeCode": [

  ],
  "invoiceTypeSign": "",
  "mailingStatus": "",
  "orderMap": {},
  "pageNum": 1,
  "pageSize": 15,
  "printStatus": 0,
  "requisitionApplyNo": "",
  "specialInvoiceMarkList": [

  ],
  "upload": 0,
  "warningMsg": [

  ],
  "warningStatus": [

  ]
}

返回示例:

正确时返回:

{
  "body": {
    "brotherAndSelfTotal": 0,
    "docFlag": "0",
    "documentInfo": {},
    "documentTotal": 0,
    "list": {
      "items": [
        {
          "adverseDid": null,
          "buyerName": "XX开票测试科技有限公司",
          "buyerTaxId": "XX5001006220997PX5",
          "companyDataResource": null,
          "companyId": "62b03222-54ec-4c65-af5f-55049445ff1f",
          "companyName": "91110101201912260A",
          "complianceFail": null,
          "complianceStatus": 1,
          "cooperativeStatus": null,
          "createTime": "2021-03-31T17:23:28",
          "deliveryStatus": "0",
          "deviceNum": null,
          "docComplianceFail": "",
          "docComplianceStatus": 1,
          "docId": "INV20210331000010",
          "docStatus": "ISSUED",
          "draftType": 0,
          "enteringType": 9,
          "expressCompanyCode": null,
          "expressNumber": null,
          "extractionCode": "",
          "id": 2208,
          "imageOfdPath": null,
          "imagePath": null,
          "imagePdfPath": null,
          "inventoryMark": "0",
          "invoiceCode": "5000181530",
          "invoiceDate": "2021-03-29T00:00:00",
          "invoiceNumber": "10902413",
          "invoiceParityCode": "",
          "invoiceTypeCode": "01",
          "invoiceUuid": "abc8605f-f5c8-4c3a-b5bd-f3e7203d0f94",
          "lineCounter": 6,
          "mailingStatus": "0",
          "nationalDownloadUrl": null,
          "noticeCodeNo": null,
          "onSplit": 0,
          "otherId": null,
          "printStatus": null,
          "receiveAddress": null,
          "receiveMsgEmail": null,
          "receiveMsgPhone": null,
          "receiveRecipient": null,
          "relationReconciliationList": null,
          "relationRedStatus": 0,
          "requisitionApplyNo": null,
          "specialInvoiceMark": "00",
          "statementCode": null,
          "taxStatus": "0",
          "tempInvoiceCode": null,
          "tempInvoiceNumber": null,
          "toPhoneNumber": null,
          "totalAmountExcludeTax": "17669.55",
          "totalAmountIncludeTax": "19206.99",
          "upload": 0,
          "warningFail": "",
          "warningStatus": 1
        }
      ],
      "pageMeta": {
        "pageNum": 1,
        "pageSize": 15,
        "pages": 1,
        "total": 1
      }
    },
    "refDocInfo": null
  },
  "ok": true,
  "requestNum": null,
  "status": {
    "description": null,
    "message": null,
    "path": null,
    "returnCode": "200",
    "serviceCode": null,
    "time": null
  }
}

错误时返回:

返回参数说明:

参数名称 类型 是否必填 描述 长度 说明
ok Boolean 操作状态 4
status 执行状态
description 详细描述 错误描述
message String 提示信息
returnCode 结果代码
time 时间戳
body 数组 结果详情 详情见下body
list
items
requisitionApplyNo String 开票申请单编号
invoiceUuid String 单据UUID
otherId String 第三方平台主键
id String 单据编号
companyDataResource String 数据来源
buyerName String 购方名称
buyerTaxId String 购方税号
invoiceTypeCode String 发票类型代码 专票:01; 普票:04 ;电子普票票:10; 电子专票08;
invoiceCode String 发票代码
invoiceNumber String 开票号码
docStatus String 发票状态 DRAFT-草稿 ISSUED-开具 CANCELED-作废 SENT-已发送;
specialInvoiceMark String 特殊票种标识 00:非特殊票种 08:成品油销售
totalAmountExcludeTax BigDecimal 发票金额 12/13 小数点后2位
totalAmountIncludeTax BigDecimal 价税合计 13/14 小数点后2位
receiveRecipient String 收件人 10
receiveAddress String 收件人地址 200
receiveMsgEmail String 接收电票下载信息邮箱号 11
receiveMsgPhone String 接收电票下载信息手机号
statementCode String 对账单编号 100
noticeCodeNo String 通知单编号 100
adverseDid String 对方的did 100
companyId String 销方公司ID 36
companyName String 销方公司名称 100
complianceFail String 警告原因 2000
complianceStatus int 警告状态,未较验0、正常1、失败2 11
cooperativeStatus String 协同状态:0未发送、1已发送、2已接收、3已接受、4已拒绝、5已退票’ 2
createTime LocalDateTime
deliveryStatus String 交付状态 2 ( “0” 未交付 “1” 交付中 “2” 已交付)’
deviceNum String 设备编号 128
docComplianceFail String 设备编号 2000
docComplianceStatus Int 单据合规状态,未较验0、正常1、失败2 11
docId String 单据编号 100
draftType Int 单据类型 2 0:普通草稿 1:预制发票
enteringType String 录入方式 1:手工 2:扫描枪 3:影像 4:扫描仪 5:Excel 9:税盘’ 11
expressCompanyCode String 快递公司代码 50
expressNumber String 快递单号 30
extractionCode String 提取码 100
imageOfdPath String ofd文件地址 255
imagePath String 文件地址 255
imagePdfPath String pdf文件地址 255
inventoryMark String 清单标志0-无清单 1-带清单 1
invoiceDate datetime 开票日期
invoiceParityCode String 校验码 128
lineCounter Int 行数 10
mailingStatus String 邮寄状态 (“0” 未邮寄、”1” 未发送、”2” 已邮寄、”3” 已发送、”4 “ 已签收) 2
nationalDownloadUrl String 国税下载地址 255
onSplit Int 是否在拆分中: 不是0,是1 2
printStatus tinyint 打印状态(“0”未打印 “1”已打印) 2
relationReconciliationList String 关联对账单号集合
relationRedStatus String 是否关联红票 0否 , 1是 2
taxStatus Int 国税状态、正常0、失控1、作废2、红冲3、异常4 10
tempInvoiceCode String 临时发票代码 12
tempInvoiceNumber String 临时发票号码 8
toPhoneNumber String 收件人手机号后4位 11
upload Int 是否开具的发票已上传 0 否 1是 5
warningFail String 警告原因 2000
warningStatus Int 警告状态,未较验0、正常1、失败2 11
pageMeta
pageNum
pageSize
pages
total
文档更新时间: 2022-09-26 14:48   作者:王佳田