发票台账标记接口
说明
该接口提供发票台账状态回写接口，支持回写发票状态码。
注意事项
- 每次最多只能传50条数据；
接口地址
/api/openapi/invoice/stateDefinition
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| invoiceStateDefinitionDtos | List<invoiceStateDefinitionDto> | 是 | 发票状态对象 |
InvoiceStateDefinitionDto 发票状态
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| entCode | String | 是 | 公司code |
| invoiceDataCode | String | 是 | 发票code |
| invoiceStateCode | String | 否 | 发票外部状态码（A-Z） |
| invoiceStateRemark | String | 否 | 发票状态码备注(不能超过1000字符) |
| cancellationMark | String | 否 | 发票作废状态:INVALID: 已作废 NOT_INVALID: 正常 FLUSHED: 已红冲（未知红冲比例) UNKNOWN : 未知 PARTIAL_RED_FLUSH : 部分红冲 FULL_AMOUNT_RED_FLUSH : 全额红冲 |
| cancellationMarkUpdateTime | Long | 否 | 发票状态码更新时间戳(时间戳) |
| supplierUnusual | String | 否 | 销售方异常状态:NORMAL:正常企业 BLACK:黑名单企业 ABNORMAL_BUSINESS:经营异常企业 SERIOUS_ILLEGAL:严重违法企业 TAX_ILLEGAL:税收违法企业 OTHER:其他异常, UNKNOWN:未知 |
| supplierUnusualUpdateTime | Long | 否 | 销售方异常状态更新时间戳(时间戳) |
参数样例
{
"invoiceStateDefinitionDtos": [
{
"invoiceDataCode": "eqweqwe",
"invoiceStateCode": "A",
"invoiceStateRemark":"测试备注2",
"entCode":"Eeeeee",
"cancellationMark": "INVALID",
"cancellationMarkUpdateTime": 1678156174374,
"supplierUnusual":"BLACK",
"supplierUnusualUpdateTime": 1678156174374
},
{
"invoiceDataCode": "INV1804031K5D2JUO",
"invoiceStateCode": "B",
"invoiceStateRemark":"测试备注3",
"entCode":"Eeeeee",
"cancellationMark": "FLUSHED",
"cancellationMarkUpdateTime": 1678156174374,
"supplierUnusual":"SERIOUS_ILLEGAL",
"supplierUnusualUpdateTime": 1678156174374
}
]
}
响应参数
响应参数说明
响应参数样例
{
"code": "ACK",
"message": "数据修改成功",
"data":null
}
修改记录
2023-02-08 新增发票外部状态接口文档