Compare commits
2 Commits
main
...
nuoshui-do
| Author | SHA1 | Date | |
|---|---|---|---|
| d47ed377d2 | |||
| 9ded558c52 |
@ -116,6 +116,8 @@
|
||||
|
||||
> 说明：本表中的历史记录按当时原始表述保留；当前正式数据库口径统一以“达梦数据库 8.0+”为准。
|
||||
|
||||
| 2026-03-24 | PostgreSQL 16 容灾资源申请专题新增 | 1）新增 `docs/design/03_Technical_Design/07_PostgreSQL16_DR_Resource_Application.md`，形成面向甲方的独立资源申请说明；2）明确单中心主备、同城双可用区、同城双中心+异地灾备、主备+PITR 四类容灾形态；3）补充备库作为同步热备、同步温备、异步热备、异步温备、异地灾备时的 CPU、内存、存储资源配比建议；4）补充资源申请清单、网络与存储要求、部署实施说明、切换与恢复要求；5）补充 `Patroni + HAProxy + PgBouncer` 代理接入架构、配置样例与主备切换接入逻辑说明；6）补充计划切换、故障切换、回切、切换前检查表与切换后验证表。 | 用户希望形成独立文档，用于向甲方申请 PostgreSQL 16 容灾资源，并明确多种部署形态、备库资源比例、代理搭建方式、切换方式和部署方式。 | 正面影响，仓库内新增了一份可独立提交、可直接用于资源审批沟通的数据库容灾专题文档；后续可在不改动数据库主文档主口径的前提下，为 PostgreSQL 16 方案提供单独的申请依据、代理建设建议、切换实施细则与实施说明。 |
|
||||
|
||||
| 2026-03-18 | REV-005 统计模板补齐 | 1）在 `specs/002-rev005-invoice-flow/verification.md` 为 `T055`、`T060`、`T061`、`T062`、`T063` 新增可直接填写的样本记录模板；2）将 SC-001 ~ SC-004 的建议统计口径细化为表格字段与待补说明，避免后续只剩抽象待办；3）保持“模板已补齐但实际统计结果仍待联调/测试环境补录”的真实状态，不虚构样本结果。 | 用户继续推进 REV-005，希望把剩余统计类待办进一步收敛成可执行模板，便于后续直接补录真实样本而不是重新设计统计格式。 | 正面影响，REV-005 当前已具备统一的统计与日志抽样记录模板；后续补 `T055`、`T060 ~ T063` 时可直接按模板填充真实环境数据，减少再次整理验证文档结构的成本。 |
|
||||
| 2026-03-18 | REV-005 verify 执行入口补齐 | 1）在 `specs/002-rev005-invoice-flow/verification.md` 补齐 `/business/invoice/apply`、`/query`、`/query/compensate`、`/write-back`、`/customer/query`、`/customer/download`、`/customer/push`、`/invalidate`、`/red-ink` 的最小请求模板；2）继续补齐 `T055`、`T060 ~ T063` 的执行命令草稿与样本采集顺序，明确仅作为测试/联调环境占位模板，真实地址、鉴权信息、业务主键与统计结果均待后续替换和回填；3）同步 `03_Task_Checklist.md`，将 verify 阶段推进到“替换真实环境参数即可执行”的状态。 | 用户继续推进 REV-005，希望不要停留在抽象验证建议，而是把剩余 verify 工作推进到可直接执行、可直接补样本的程度。 | 正面影响，REV-005 当前已具备统一的验证入口、请求模板、命令草稿与采样顺序；后续在测试或联调环境中可直接替换参数发起请求并回填 `T055`、`T060 ~ T063` 的真实结果，减少重复梳理接口和命令的成本。 |
|
||||
| 2026-03-18 | REV-005 联调补录清单补齐 | 1）在 `specs/002-rev005-invoice-flow/verification.md` 新增 `T055`、`T060 ~ T063` 的联调补录清单，按“申请 → 查询 → 回写 → 补偿查询 → 客户查询/下载/推送 → 作废/红冲 → 日志抽样”顺序拆解步骤；2）为每一步明确主要输入、预期产出与回填位置，确保联调执行时不再重复梳理样本归档方式；3）同步 `03_Task_Checklist.md`，将 verify 阶段推进到“可按顺序执行并即时补录”的状态。 | 用户继续推进 REV-005，希望把剩余运行态补证工作从“有命令草稿”进一步推进到“有顺序、有产出、有回填位置”的联调操作清单。 | 正面影响，REV-005 当前已具备联调补录步骤清单，后续在测试或联调环境中可按固定顺序执行并即时回填样本、统计与日志证据，降低遗漏申请单号、受理号与日志检索条件的风险。 |
|
||||
@ -341,3 +343,14 @@
|
||||
|
||||
- 完成 `REV-006` 当前轮次治理文档二次对齐：在 `15_SYS002_Requirement_Breakdown.md` 明确 `SYS002-REQ-011` 继续维持“未见实现”判断，并补记 `specs/006-reminder-event-design/` 工件基线与后续研发切入建议。
|
||||
- 同步回写 `03_Task_Checklist.md` 与本进度文档，补充本轮 implement 阶段的治理动作、验证动作与台账一致性说明，避免将文档收口误写为 backend 已实现。
|
||||
|
||||
### 2026-03-24 更新
|
||||
|
||||
- 完成 `010-bank-transfer-config` implement 阶段收口，统一 `12_REV_Detailed.md`、`03_Interface_Design.md`、`04_Security_Design.md`、`05_Deployment_Design.md` 与 `specs/010-bank-transfer-config/` 工件口径。
|
||||
- `sw-business-bank` 已新增 `FILE_TRANSFER_CONFIG` 配置类型、统一文件传输解析器、`SFTP/FTP` 双协议解析能力，以及 `send/back/reconcile` 审计字段承接；已落库批次回盘目录继续沿用批次固化结果。
|
||||
- 已完成 backend 最小验证：`mvn -f ../water-backend/sw-business-bank/pom.xml -pl sw-business-bank-server -am -DskipTests compile` 通过；`mvn ... -Dtest=BankTransferPathResolverTest,BankWithholdingTransferConfigTest -Dsurefire.failIfNoSpecifiedTests=false test` 通过，共 9 个定向测试全部通过。
|
||||
- 当前剩余 deferred 继续限定为真实银行 `SFTP/FTP` 联调、生产凭据与白名单开通、`BankCollection` 托收链路对等改造，以及运行态样本补证，不将其误写为已闭环能力。
|
||||
- 新增 `docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md`，形成诺税通 saas 首期对接实施清单，统一接口优先级、请求/响应字段映射、业务流程图、错误码处理策略与沙箱测试清单口径，作为外部发票平台首批实施与联调验收的正式参考。
|
||||
- 新增 `docs/guides/NUOSHUITONG_DATABASE_DESIGN.md`，形成诺税通对接数据库设计草案，明确发票、红字单据、设备、库存、企业配置与平台日志等落表建议，作为后续正式 DDL 与专项数据库设计对齐的输入。
|
||||
- 新增 `docs/guides/NUOSHUITONG_DDL_DRAFT.md`，形成诺税通对接 DDL 草案，覆盖核心表 `CREATE TABLE`、唯一约束与索引建议，作为后续数据库实现与 PostgreSQL/openGauss 方言适配的基础版本。
|
||||
- 新增 `docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md`，形成 PostgreSQL 16 / openGauss 适配建议，明确类型替换、主键策略、索引兼容性和迁移实施注意事项，作为双数据库口径下的实现参考。
|
||||
|
||||
Binary file not shown.
543
docs/guides/NUOSHUITONG_DATABASE_DESIGN.md
Normal file
543
docs/guides/NUOSHUITONG_DATABASE_DESIGN.md
Normal file
@ -0,0 +1,543 @@
|
||||
# 诺税通对接数据库设计草案
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 项目名称 | 福建水务营收系统 |
|
||||
| 文档类型 | 外部平台对接数据库设计草案 |
|
||||
| 对接平台 | 诺税通 saas |
|
||||
| 适用范围 | 销项开票、发票查询、文件获取、交付、作废、红字单据、设备与库存、企业开票配置 |
|
||||
| 版本 | v1.0 |
|
||||
| 日期 | 2026-03-24 |
|
||||
| 状态 | 草案 |
|
||||
|
||||
## 适用说明
|
||||
|
||||
本文档用于支撑福建水务营收系统对接诺税通 saas 时的数据库落库设计。内容聚焦对接层数据承接，不直接替代正式业务数据库设计主文档，而是作为外部平台集成方案、领域建模和后续 DDL 细化的基础输入。
|
||||
|
||||
当前口径基于以下资料统一整理：
|
||||
- `docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md`
|
||||
- `docs/guides/NUOSHUITONG_INTERFACE_SPEC/`
|
||||
|
||||
## 设计目标
|
||||
|
||||
本设计用于支撑以下闭环：
|
||||
- 开票申请与状态同步
|
||||
- 发票票面文件获取
|
||||
- 发票交付与补发
|
||||
- 发票作废、重开、冲红
|
||||
- 红字信息表与红字确认单管理
|
||||
- 开票设备与票源库存管理
|
||||
- 企业开票配置与规则缓存
|
||||
- 平台回调与请求日志追踪
|
||||
|
||||
## 表清单总览
|
||||
|
||||
| 表名 | 说明 |
|
||||
| --- | --- |
|
||||
| `ns_invoice` | 发票主表 |
|
||||
| `ns_invoice_item` | 发票明细表 |
|
||||
| `ns_invoice_delivery` | 发票交付记录表 |
|
||||
| `ns_invoice_reversal` | 发票逆向处理表 |
|
||||
| `ns_red_document` | 红字单据主表 |
|
||||
| `ns_red_document_item` | 红字单据明细表 |
|
||||
| `ns_billing_device` | 开票设备表 |
|
||||
| `ns_invoice_stock_snapshot` | 发票库存快照表 |
|
||||
| `ns_enterprise_billing_config` | 企业开票配置表 |
|
||||
| `ns_platform_event_log` | 平台回调事件表 |
|
||||
| `ns_platform_request_log` | 平台请求响应日志表 |
|
||||
| `ns_config_dictionary_cache` | 配置字典缓存表（可选） |
|
||||
|
||||
## 命名与通用约定
|
||||
|
||||
### 表命名
|
||||
- 对接域表统一采用 `ns_` 前缀，表示 Nuoshuitong 集成域。
|
||||
- 字段命名统一使用下划线命名法。
|
||||
|
||||
### 通用审计字段
|
||||
除快照类或纯日志类表外，建议统一具备：
|
||||
- `created_at`
|
||||
- `updated_at`
|
||||
- `created_by`
|
||||
- `updated_by`
|
||||
|
||||
### 状态字段约定
|
||||
建议状态类字段统一采用“编码 + 文本”双承接：
|
||||
- `*_status`
|
||||
- `*_status_text`
|
||||
|
||||
### JSON 字段约定
|
||||
当平台返回结构复杂、且短期内不适合完全拆表时，可保留 JSON/TEXT 字段承接，例如：
|
||||
- `specific_factor_json`
|
||||
- `request_body`
|
||||
- `response_body`
|
||||
- `payload_json`
|
||||
|
||||
## 详细表结构草案
|
||||
|
||||
## `ns_invoice` 发票主表
|
||||
|
||||
### 用途
|
||||
承接发票从申请、查询、回调、文件获取到交付的主生命周期。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `sys_request_no` | varchar(64) | 是 | 系统侧请求号，建议唯一 |
|
||||
| `order_no` | varchar(64) | 否 | 业务订单号 |
|
||||
| `source_business_type` | varchar(32) | 否 | 来源业务类型 |
|
||||
| `source_business_id` | varchar(64) | 否 | 来源业务主键 |
|
||||
| `platform_invoice_serial_num` | varchar(64) | 否 | 平台发票流水号 |
|
||||
| `invoice_id` | varchar(64) | 否 | 平台发票 ID |
|
||||
| `invoice_code` | varchar(32) | 否 | 发票代码 |
|
||||
| `invoice_no` | varchar(32) | 否 | 发票号码 |
|
||||
| `all_electronic_invoice_no` | varchar(64) | 否 | 数电票号码 |
|
||||
| `seller_tax_no` | varchar(32) | 是 | 销方税号 |
|
||||
| `buyer_name` | varchar(200) | 否 | 购方名称 |
|
||||
| `buyer_tax_no` | varchar(64) | 否 | 购方税号 |
|
||||
| `buyer_address` | varchar(255) | 否 | 购方地址 |
|
||||
| `buyer_tel` | varchar(64) | 否 | 购方电话 |
|
||||
| `buyer_account` | varchar(255) | 否 | 购方开户行及账号 |
|
||||
| `invoice_type` | varchar(16) | 否 | 蓝票/红票 |
|
||||
| `invoice_line` | varchar(16) | 否 | 发票票种 |
|
||||
| `list_flag` | smallint | 否 | 清单标志 |
|
||||
| `with_tax_flag` | smallint | 否 | 含税标志 |
|
||||
| `notify_phone` | varchar(64) | 否 | 交付手机号 |
|
||||
| `notify_email` | varchar(128) | 否 | 交付邮箱 |
|
||||
| `cc_phone` | varchar(256) | 否 | 抄送手机号 |
|
||||
| `cc_email` | varchar(256) | 否 | 抄送邮箱 |
|
||||
| `total_amount` | decimal(18,2) | 否 | 含税总金额 |
|
||||
| `amount_without_tax` | decimal(18,2) | 否 | 不含税总金额 |
|
||||
| `tax_amount` | decimal(18,2) | 否 | 税额 |
|
||||
| `request_status` | varchar(32) | 是 | 请求状态 |
|
||||
| `invoice_status` | varchar(32) | 否 | 开票状态 |
|
||||
| `invoice_status_text` | varchar(255) | 否 | 状态说明 |
|
||||
| `invalid_state` | varchar(32) | 否 | 作废状态 |
|
||||
| `delivery_status` | varchar(32) | 否 | 交付状态 |
|
||||
| `sync_status` | varchar(32) | 否 | 平台同步状态 |
|
||||
| `pdf_url` | varchar(1024) | 否 | PDF 地址 |
|
||||
| `ofd_url` | varchar(1024) | 否 | OFD 地址 |
|
||||
| `image_url` | varchar(1024) | 否 | 图片地址 |
|
||||
| `paper_pdf_url` | varchar(1024) | 否 | 纸票 PDF 地址 |
|
||||
| `invoice_time` | datetime | 否 | 开票时间 |
|
||||
| `request_time` | datetime | 否 | 请求时间 |
|
||||
| `invalid_time` | datetime | 否 | 作废时间 |
|
||||
| `last_sync_time` | datetime | 否 | 最近同步时间 |
|
||||
| `ori_invoice_code` | varchar(32) | 否 | 原发票代码 |
|
||||
| `ori_invoice_no` | varchar(32) | 否 | 原发票号码 |
|
||||
| `old_electronic_invoice_no` | varchar(64) | 否 | 原数电票号码 |
|
||||
| `remark` | varchar(1000) | 否 | 备注 |
|
||||
| `specific_factor_json` | text | 否 | 特殊因子 JSON |
|
||||
| `latest_result` | varchar(1000) | 否 | 最近一次平台结果摘要 |
|
||||
| `latest_error` | varchar(1000) | 否 | 最近一次错误摘要 |
|
||||
| `try_count` | int | 否 | 同步/补偿次数 |
|
||||
| `last_try_time` | datetime | 否 | 最近重试时间 |
|
||||
| `next_try_time` | datetime | 否 | 下次重试时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
| `created_by` | varchar(64) | 否 | 创建人 |
|
||||
| `updated_by` | varchar(64) | 否 | 更新人 |
|
||||
|
||||
### 主键与唯一约束建议
|
||||
- 主键：`id`
|
||||
- 唯一约束：`sys_request_no`
|
||||
- 可选唯一约束：`platform_invoice_serial_num`
|
||||
- 可选业务唯一约束：`seller_tax_no + invoice_code + invoice_no`
|
||||
|
||||
### 索引建议
|
||||
- `idx_ns_invoice_order_no`
|
||||
- `idx_ns_invoice_status`
|
||||
- `idx_ns_invoice_seller_tax_no`
|
||||
- `idx_ns_invoice_invoice_time`
|
||||
- `idx_ns_invoice_next_try_time`
|
||||
|
||||
### 状态字段建议
|
||||
#### `request_status`
|
||||
- `DRAFT`
|
||||
- `PRECHECK_FAILED`
|
||||
- `REQUESTED`
|
||||
- `PROCESSING`
|
||||
- `SUCCESS`
|
||||
- `FAILED`
|
||||
|
||||
#### `invoice_status`
|
||||
- `ISSUING`
|
||||
- `ISSUED`
|
||||
- `ISSUE_FAILED`
|
||||
- `CANCELLED`
|
||||
- `CANCEL_FAILED`
|
||||
- `RED_PROCESSED`
|
||||
|
||||
#### `delivery_status`
|
||||
- `NOT_DELIVERED`
|
||||
- `DELIVERING`
|
||||
- `DELIVERED`
|
||||
- `DELIVERY_FAILED`
|
||||
|
||||
## `ns_invoice_item` 发票明细表
|
||||
|
||||
### 用途
|
||||
保存开票请求与平台返回的发票明细。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `invoice_id` | bigint | 是 | 发票主表 ID |
|
||||
| `line_no` | int | 是 | 行号 |
|
||||
| `goods_name` | varchar(255) | 是 | 商品名称 |
|
||||
| `goods_code` | varchar(64) | 否 | 税收分类编码 |
|
||||
| `spec` | varchar(128) | 否 | 规格型号 |
|
||||
| `unit` | varchar(64) | 否 | 单位 |
|
||||
| `quantity` | decimal(18,6) | 否 | 数量 |
|
||||
| `unit_price` | decimal(18,6) | 否 | 单价 |
|
||||
| `amount_with_tax` | decimal(18,2) | 否 | 含税金额 |
|
||||
| `amount_without_tax` | decimal(18,2) | 否 | 不含税金额 |
|
||||
| `tax_rate` | decimal(8,4) | 否 | 税率 |
|
||||
| `tax_amount` | decimal(18,2) | 否 | 税额 |
|
||||
| `detail_type` | smallint | 否 | 行类型 |
|
||||
| `favoured_policy_flag` | smallint | 否 | 优惠政策标志 |
|
||||
| `zero_rate_flag` | smallint | 否 | 零税率标志 |
|
||||
| `favoured_policy_name` | varchar(128) | 否 | 优惠政策名称 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
### 约束建议
|
||||
- 外键：`invoice_id -> ns_invoice.id`
|
||||
- 唯一约束：`invoice_id + line_no`
|
||||
|
||||
## `ns_invoice_delivery` 发票交付记录表
|
||||
|
||||
### 用途
|
||||
记录首次交付、补发和交付失败结果。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `invoice_id` | bigint | 是 | 发票 ID |
|
||||
| `delivery_type` | varchar(16) | 是 | `SMS` / `EMAIL` |
|
||||
| `delivery_target` | varchar(256) | 是 | 发送目标 |
|
||||
| `cc_target` | varchar(512) | 否 | 抄送目标 |
|
||||
| `delivery_status` | varchar(32) | 是 | 交付状态 |
|
||||
| `delivery_message` | varchar(1000) | 否 | 平台返回信息 |
|
||||
| `delivery_attempt_no` | int | 是 | 第几次交付 |
|
||||
| `is_retry` | smallint | 是 | 是否补发 |
|
||||
| `response_code` | varchar(32) | 否 | 平台响应码 |
|
||||
| `response_body` | text | 否 | 平台响应体 |
|
||||
| `delivery_time` | datetime | 否 | 交付时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
|
||||
### 索引建议
|
||||
- `idx_ns_invoice_delivery_invoice_id`
|
||||
- `idx_ns_invoice_delivery_status`
|
||||
|
||||
## `ns_invoice_reversal` 发票逆向处理表
|
||||
|
||||
### 用途
|
||||
记录作废、冲红、重开、空白票作废等逆向业务动作。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `invoice_id` | bigint | 是 | 原发票 ID |
|
||||
| `reversal_type` | varchar(32) | 是 | `CANCEL` / `FAST_RED` / `REOPEN` / `BLANK_CANCEL` |
|
||||
| `source_invoice_code` | varchar(32) | 否 | 原票代码 |
|
||||
| `source_invoice_no` | varchar(32) | 否 | 原票号码 |
|
||||
| `invalid_reason` | varchar(32) | 否 | 作废原因编码 |
|
||||
| `specific_reason` | varchar(500) | 否 | 具体原因 |
|
||||
| `request_status` | varchar(32) | 是 | 请求状态 |
|
||||
| `reversal_status` | varchar(32) | 否 | 逆向状态 |
|
||||
| `platform_result_code` | varchar(32) | 否 | 平台响应码 |
|
||||
| `platform_result_msg` | varchar(1000) | 否 | 平台响应信息 |
|
||||
| `target_invoice_id` | bigint | 否 | 新票 ID |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
### 状态建议
|
||||
- `INIT`
|
||||
- `CHECKING`
|
||||
- `REQUESTED`
|
||||
- `SUCCESS`
|
||||
- `FAILED`
|
||||
- `REJECTED`
|
||||
|
||||
## `ns_red_document` 红字单据主表
|
||||
|
||||
### 用途
|
||||
统一承接红字信息表与红字确认单。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `invoice_id` | bigint | 否 | 关联蓝票 ID |
|
||||
| `document_type` | varchar(16) | 是 | `RED_INFO` / `RED_CONFIRM` |
|
||||
| `bill_no` | varchar(64) | 否 | 单据编号 |
|
||||
| `bill_id` | varchar(64) | 否 | 平台单据 ID |
|
||||
| `bill_info_no` | varchar(64) | 否 | 信息表编号 |
|
||||
| `bill_confirm_no` | varchar(64) | 否 | 确认单编号 |
|
||||
| `bill_uuid` | varchar(64) | 否 | 平台 UUID |
|
||||
| `blue_invoice_code` | varchar(32) | 否 | 蓝票代码 |
|
||||
| `blue_invoice_no` | varchar(32) | 否 | 蓝票号码 |
|
||||
| `blue_invoice_number` | varchar(64) | 否 | 蓝票数电号 |
|
||||
| `blue_invoice_line` | varchar(16) | 否 | 蓝票票种 |
|
||||
| `bill_type` | varchar(32) | 否 | 红字业务类型 |
|
||||
| `bill_status` | varchar(32) | 否 | 单据状态 |
|
||||
| `bill_status_text` | varchar(255) | 否 | 状态说明 |
|
||||
| `open_status` | varchar(32) | 否 | 开具状态 |
|
||||
| `back_type` | varchar(16) | 否 | 回传类型 |
|
||||
| `apply_source` | varchar(32) | 否 | 申请来源 |
|
||||
| `red_reason` | varchar(255) | 否 | 红字原因 |
|
||||
| `apply_remark` | varchar(1000) | 否 | 申请备注 |
|
||||
| `pdf_url` | varchar(1024) | 否 | PDF 地址 |
|
||||
| `callback_status` | varchar(32) | 否 | 回调处理状态 |
|
||||
| `last_sync_time` | datetime | 否 | 最近同步时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
### 唯一约束建议
|
||||
- `bill_no`
|
||||
- 可选：`bill_id`
|
||||
|
||||
## `ns_red_document_item` 红字单据明细表
|
||||
|
||||
### 用途
|
||||
承接红字申请与确认单明细。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `red_document_id` | bigint | 是 | 红字单据主表 ID |
|
||||
| `line_no` | int | 是 | 行号 |
|
||||
| `goods_name` | varchar(255) | 否 | 商品名称 |
|
||||
| `model` | varchar(128) | 否 | 型号 |
|
||||
| `unit` | varchar(64) | 否 | 单位 |
|
||||
| `quantity` | decimal(18,6) | 否 | 数量 |
|
||||
| `unit_price` | decimal(18,6) | 否 | 单价 |
|
||||
| `amount` | decimal(18,2) | 否 | 金额 |
|
||||
| `tax_rate` | decimal(8,4) | 否 | 税率 |
|
||||
| `tax_amount` | decimal(18,2) | 否 | 税额 |
|
||||
| `with_tax_flag` | smallint | 否 | 含税标志 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
## `ns_billing_device` 开票设备表
|
||||
|
||||
### 用途
|
||||
承接设备主数据、运行态状态和设备能力。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `tax_num` | varchar(32) | 是 | 企业税号 |
|
||||
| `company_id` | varchar(64) | 否 | 平台企业 ID |
|
||||
| `extension_num` | varchar(32) | 否 | 分机号 |
|
||||
| `machine_num` | varchar(64) | 否 | 机器编号 |
|
||||
| `terminal_num` | varchar(64) | 否 | 终端号 |
|
||||
| `server_type` | varchar(32) | 否 | 设备类型 |
|
||||
| `invoice_type_list` | varchar(512) | 否 | 支持票种列表 |
|
||||
| `login_account` | varchar(128) | 否 | 登录账号 |
|
||||
| `equipment_cabinet_id` | varchar(64) | 否 | 机柜 ID |
|
||||
| `device_status` | varchar(32) | 是 | 在线状态 |
|
||||
| `report_tax_status` | varchar(32) | 否 | 抄报状态 |
|
||||
| `clear_card_status` | varchar(32) | 否 | 清卡状态 |
|
||||
| `lock_date` | varchar(32) | 否 | 锁死日期 |
|
||||
| `single_billing_limit` | decimal(18,2) | 否 | 单笔限额 |
|
||||
| `offline_amount` | decimal(18,2) | 否 | 离线金额 |
|
||||
| `offline_time` | varchar(64) | 否 | 离线时间 |
|
||||
| `last_status_sync_time` | datetime | 否 | 最近状态同步时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
### 唯一约束建议
|
||||
- 保守建议：`tax_num + extension_num + machine_num`
|
||||
|
||||
## `ns_invoice_stock_snapshot` 发票库存快照表
|
||||
|
||||
### 用途
|
||||
记录库存查询、刷新、下载、申领后的快照结果。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `device_id` | bigint | 否 | 设备 ID |
|
||||
| `seller_tax_no` | varchar(32) | 是 | 销方税号 |
|
||||
| `extension_num` | varchar(32) | 否 | 分机号 |
|
||||
| `machine_num` | varchar(64) | 否 | 机器编号 |
|
||||
| `terminal_num` | varchar(64) | 否 | 终端号 |
|
||||
| `invoice_line` | varchar(16) | 否 | 票种 |
|
||||
| `invoice_code` | varchar(32) | 否 | 发票代码 |
|
||||
| `invoice_num_start` | varchar(32) | 否 | 起始号 |
|
||||
| `invoice_num_end` | varchar(32) | 否 | 结束号 |
|
||||
| `remain_num` | int | 否 | 剩余数量 |
|
||||
| `is_default` | smallint | 否 | 是否默认 |
|
||||
| `source_type` | varchar(16) | 是 | `QUERY` / `REFRESH` / `DOWNLOAD` / `APPLY` |
|
||||
| `snapshot_time` | datetime | 是 | 快照时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
|
||||
## `ns_enterprise_billing_config` 企业开票配置表
|
||||
|
||||
### 用途
|
||||
承接企业开票默认信息与认证状态。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `tax_num` | varchar(32) | 是 | 企业税号 |
|
||||
| `company_id` | varchar(64) | 否 | 平台企业 ID |
|
||||
| `use_scope` | varchar(32) | 否 | 使用范围 |
|
||||
| `clerker` | varchar(128) | 否 | 开票员 |
|
||||
| `seller_address` | varchar(255) | 否 | 销方地址 |
|
||||
| `seller_tel` | varchar(64) | 否 | 销方电话 |
|
||||
| `seller_bank` | varchar(255) | 否 | 销方开户行 |
|
||||
| `seller_account` | varchar(255) | 否 | 销方账号 |
|
||||
| `payee` | varchar(64) | 否 | 收款人 |
|
||||
| `checker` | varchar(64) | 否 | 复核人 |
|
||||
| `project_code` | varchar(64) | 否 | 项目编码 |
|
||||
| `department_name` | varchar(128) | 否 | 部门名称 |
|
||||
| `auth_status` | varchar(32) | 否 | 认证状态 |
|
||||
| `last_auth_time` | datetime | 否 | 最近认证时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
### 唯一约束建议
|
||||
- `tax_num`
|
||||
|
||||
## `ns_platform_event_log` 平台回调事件表
|
||||
|
||||
### 用途
|
||||
保留平台回调原文和处理结果，实现幂等与可追踪。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `event_type` | varchar(32) | 是 | `INVOICE_CALLBACK` / `RED_CALLBACK` |
|
||||
| `event_key` | varchar(128) | 是 | 幂等键 |
|
||||
| `seller_tax_no` | varchar(32) | 否 | 销方税号 |
|
||||
| `business_key` | varchar(128) | 否 | 业务主键 |
|
||||
| `payload_json` | longtext | 是 | 回调原文 |
|
||||
| `process_status` | varchar(32) | 是 | `INIT` / `SUCCESS` / `FAILED` / `IGNORED` |
|
||||
| `process_message` | varchar(1000) | 否 | 处理说明 |
|
||||
| `processed_at` | datetime | 否 | 处理时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
|
||||
### 唯一约束建议
|
||||
- `event_key`
|
||||
|
||||
## `ns_platform_request_log` 平台请求响应日志表
|
||||
|
||||
### 用途
|
||||
记录所有对诺税通平台的请求与响应，便于联调排障。
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `request_id` | varchar(64) | 是 | 请求 ID |
|
||||
| `business_type` | varchar(32) | 否 | 业务类型 |
|
||||
| `business_id` | varchar(64) | 否 | 业务 ID |
|
||||
| `method_name` | varchar(128) | 否 | 平台方法名 |
|
||||
| `request_headers_masked` | text | 否 | 脱敏请求头 |
|
||||
| `request_body` | longtext | 否 | 请求体 |
|
||||
| `response_body` | longtext | 否 | 响应体 |
|
||||
| `response_code` | varchar(32) | 否 | 响应码 |
|
||||
| `success_flag` | smallint | 否 | 成功标识 |
|
||||
| `error_message` | varchar(1000) | 否 | 错误信息 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
|
||||
## `ns_config_dictionary_cache` 配置字典缓存表（可选）
|
||||
|
||||
### 用途
|
||||
缓存平台字典项，如：
|
||||
- `requestSrc`
|
||||
- `invoiceLine`
|
||||
- `organize`
|
||||
- `dept`
|
||||
- `clerk`
|
||||
- `invalidSrc`
|
||||
|
||||
### 字段建议
|
||||
|
||||
| 字段名 | 类型建议 | 非空 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| `id` | bigint | 是 | 主键 |
|
||||
| `dict_type` | varchar(64) | 是 | 字典类型 |
|
||||
| `dict_key` | varchar(128) | 是 | 字典键 |
|
||||
| `dict_name` | varchar(255) | 否 | 字典名称 |
|
||||
| `company_id` | varchar(64) | 否 | 企业 ID |
|
||||
| `company_name` | varchar(255) | 否 | 企业名称 |
|
||||
| `extra_json` | text | 否 | 扩展 JSON |
|
||||
| `last_sync_time` | datetime | 否 | 最近同步时间 |
|
||||
| `created_at` | datetime | 是 | 创建时间 |
|
||||
| `updated_at` | datetime | 是 | 更新时间 |
|
||||
|
||||
## 表关系建议
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
ns_invoice ||--o{ ns_invoice_item : contains
|
||||
ns_invoice ||--o{ ns_invoice_delivery : delivers
|
||||
ns_invoice ||--o{ ns_invoice_reversal : reverses
|
||||
ns_invoice ||--o{ ns_red_document : relates
|
||||
ns_red_document ||--o{ ns_red_document_item : contains
|
||||
ns_billing_device ||--o{ ns_invoice_stock_snapshot : has
|
||||
ns_enterprise_billing_config ||--o{ ns_billing_device : configures
|
||||
```
|
||||
|
||||
## 幂等与审计建议
|
||||
|
||||
### 回调幂等
|
||||
必须依赖：
|
||||
- `ns_platform_event_log.event_key`
|
||||
|
||||
建议 `event_key` 构成为：
|
||||
- 发票回调：`sellerTaxNo + invoiceId + invoiceStatus`
|
||||
- 红字回调：`backType + billNo + billStatus`
|
||||
|
||||
### 请求幂等
|
||||
建议：
|
||||
- `sys_request_no` 全局唯一
|
||||
- 开票请求入库前先校验是否已存在同请求号记录
|
||||
|
||||
## 首期最小落表建议
|
||||
|
||||
若先追求最小可用，建议优先落以下 7 张表：
|
||||
- `ns_invoice`
|
||||
- `ns_invoice_item`
|
||||
- `ns_invoice_delivery`
|
||||
- `ns_invoice_reversal`
|
||||
- `ns_billing_device`
|
||||
- `ns_invoice_stock_snapshot`
|
||||
- `ns_platform_request_log`
|
||||
|
||||
第二批补充：
|
||||
- `ns_red_document`
|
||||
- `ns_red_document_item`
|
||||
- `ns_platform_event_log`
|
||||
- `ns_enterprise_billing_config`
|
||||
|
||||
## 后续建议
|
||||
|
||||
本文档完成后，建议继续补充两项内容：
|
||||
- 按表输出正式 DDL 草案
|
||||
- 与 `docs/design/03_Technical_Design/01_Database_Design.md` 对齐，纳入正式专项设计口径
|
||||
529
docs/guides/NUOSHUITONG_DDL_DRAFT.md
Normal file
529
docs/guides/NUOSHUITONG_DDL_DRAFT.md
Normal file
@ -0,0 +1,529 @@
|
||||
# 诺税通对接 DDL 草案
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 项目名称 | 福建水务营收系统 |
|
||||
| 文档类型 | 外部平台对接 DDL 草案 |
|
||||
| 对接平台 | 诺税通 saas |
|
||||
| 适用范围 | 发票、红字单据、设备、库存、企业配置、平台日志 |
|
||||
| 版本 | v1.0 |
|
||||
| 日期 | 2026-03-24 |
|
||||
| 状态 | 草案 |
|
||||
|
||||
## 适用说明
|
||||
|
||||
本文档在 `docs/guides/NUOSHUITONG_DATABASE_DESIGN.md` 的基础上，进一步给出面向实现的 DDL 草案。当前以 PostgreSQL/MySQL 均可平滑迁移的通用 SQL 风格表达为主，重点用于：
|
||||
- 明确核心表字段结构
|
||||
- 明确主键、唯一约束与索引建议
|
||||
- 为后续纳入正式数据库设计主文档提供输入
|
||||
|
||||
## 使用约定
|
||||
|
||||
- 主键统一使用 `bigint`
|
||||
- 金额统一使用 `decimal(18,2)`
|
||||
- 数量/单价类字段视场景使用 `decimal(18,6)`
|
||||
- 状态类字段统一使用 `varchar(32)`
|
||||
- URL 字段统一预留 `varchar(1024)`
|
||||
- 长报文、原始回调、请求响应体统一使用 `text` / `longtext`
|
||||
|
||||
## DDL 草案
|
||||
|
||||
## `ns_invoice` 发票主表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice (
|
||||
id BIGINT PRIMARY KEY,
|
||||
sys_request_no VARCHAR(64) NOT NULL,
|
||||
order_no VARCHAR(64),
|
||||
source_business_type VARCHAR(32),
|
||||
source_business_id VARCHAR(64),
|
||||
platform_invoice_serial_num VARCHAR(64),
|
||||
invoice_id VARCHAR(64),
|
||||
invoice_code VARCHAR(32),
|
||||
invoice_no VARCHAR(32),
|
||||
all_electronic_invoice_no VARCHAR(64),
|
||||
seller_tax_no VARCHAR(32) NOT NULL,
|
||||
buyer_name VARCHAR(200),
|
||||
buyer_tax_no VARCHAR(64),
|
||||
buyer_address VARCHAR(255),
|
||||
buyer_tel VARCHAR(64),
|
||||
buyer_account VARCHAR(255),
|
||||
invoice_type VARCHAR(16),
|
||||
invoice_line VARCHAR(16),
|
||||
list_flag SMALLINT,
|
||||
with_tax_flag SMALLINT,
|
||||
notify_phone VARCHAR(64),
|
||||
notify_email VARCHAR(128),
|
||||
cc_phone VARCHAR(256),
|
||||
cc_email VARCHAR(256),
|
||||
total_amount DECIMAL(18,2),
|
||||
amount_without_tax DECIMAL(18,2),
|
||||
tax_amount DECIMAL(18,2),
|
||||
request_status VARCHAR(32) NOT NULL,
|
||||
invoice_status VARCHAR(32),
|
||||
invoice_status_text VARCHAR(255),
|
||||
invalid_state VARCHAR(32),
|
||||
delivery_status VARCHAR(32),
|
||||
sync_status VARCHAR(32),
|
||||
pdf_url VARCHAR(1024),
|
||||
ofd_url VARCHAR(1024),
|
||||
image_url VARCHAR(1024),
|
||||
paper_pdf_url VARCHAR(1024),
|
||||
invoice_time DATETIME,
|
||||
request_time DATETIME,
|
||||
invalid_time DATETIME,
|
||||
last_sync_time DATETIME,
|
||||
ori_invoice_code VARCHAR(32),
|
||||
ori_invoice_no VARCHAR(32),
|
||||
old_electronic_invoice_no VARCHAR(64),
|
||||
remark VARCHAR(1000),
|
||||
specific_factor_json TEXT,
|
||||
latest_result VARCHAR(1000),
|
||||
latest_error VARCHAR(1000),
|
||||
try_count INT,
|
||||
last_try_time DATETIME,
|
||||
next_try_time DATETIME,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL,
|
||||
created_by VARCHAR(64),
|
||||
updated_by VARCHAR(64)
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_invoice
|
||||
ADD CONSTRAINT uk_ns_invoice_sys_request_no UNIQUE (sys_request_no);
|
||||
|
||||
CREATE UNIQUE INDEX uk_ns_invoice_platform_serial_num
|
||||
ON ns_invoice (platform_invoice_serial_num);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_order_no
|
||||
ON ns_invoice (order_no);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_status
|
||||
ON ns_invoice (request_status, invoice_status, delivery_status);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_seller_tax_no
|
||||
ON ns_invoice (seller_tax_no);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_invoice_time
|
||||
ON ns_invoice (invoice_time);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_next_try_time
|
||||
ON ns_invoice (next_try_time);
|
||||
```
|
||||
|
||||
## `ns_invoice_item` 发票明细表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice_item (
|
||||
id BIGINT PRIMARY KEY,
|
||||
invoice_id BIGINT NOT NULL,
|
||||
line_no INT NOT NULL,
|
||||
goods_name VARCHAR(255) NOT NULL,
|
||||
goods_code VARCHAR(64),
|
||||
spec VARCHAR(128),
|
||||
unit VARCHAR(64),
|
||||
quantity DECIMAL(18,6),
|
||||
unit_price DECIMAL(18,6),
|
||||
amount_with_tax DECIMAL(18,2),
|
||||
amount_without_tax DECIMAL(18,2),
|
||||
tax_rate DECIMAL(8,4),
|
||||
tax_amount DECIMAL(18,2),
|
||||
detail_type SMALLINT,
|
||||
favoured_policy_flag SMALLINT,
|
||||
zero_rate_flag SMALLINT,
|
||||
favoured_policy_name VARCHAR(128),
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_invoice_item
|
||||
ADD CONSTRAINT fk_ns_invoice_item_invoice
|
||||
FOREIGN KEY (invoice_id) REFERENCES ns_invoice(id);
|
||||
|
||||
CREATE UNIQUE INDEX uk_ns_invoice_item_invoice_line
|
||||
ON ns_invoice_item (invoice_id, line_no);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_item_invoice_id
|
||||
ON ns_invoice_item (invoice_id);
|
||||
```
|
||||
|
||||
## `ns_invoice_delivery` 发票交付记录表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice_delivery (
|
||||
id BIGINT PRIMARY KEY,
|
||||
invoice_id BIGINT NOT NULL,
|
||||
delivery_type VARCHAR(16) NOT NULL,
|
||||
delivery_target VARCHAR(256) NOT NULL,
|
||||
cc_target VARCHAR(512),
|
||||
delivery_status VARCHAR(32) NOT NULL,
|
||||
delivery_message VARCHAR(1000),
|
||||
delivery_attempt_no INT NOT NULL,
|
||||
is_retry SMALLINT NOT NULL,
|
||||
response_code VARCHAR(32),
|
||||
response_body TEXT,
|
||||
delivery_time DATETIME,
|
||||
created_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_invoice_delivery
|
||||
ADD CONSTRAINT fk_ns_invoice_delivery_invoice
|
||||
FOREIGN KEY (invoice_id) REFERENCES ns_invoice(id);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_delivery_invoice_id
|
||||
ON ns_invoice_delivery (invoice_id);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_delivery_status
|
||||
ON ns_invoice_delivery (delivery_status, delivery_time);
|
||||
```
|
||||
|
||||
## `ns_invoice_reversal` 发票逆向处理表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice_reversal (
|
||||
id BIGINT PRIMARY KEY,
|
||||
invoice_id BIGINT NOT NULL,
|
||||
reversal_type VARCHAR(32) NOT NULL,
|
||||
source_invoice_code VARCHAR(32),
|
||||
source_invoice_no VARCHAR(32),
|
||||
invalid_reason VARCHAR(32),
|
||||
specific_reason VARCHAR(500),
|
||||
request_status VARCHAR(32) NOT NULL,
|
||||
reversal_status VARCHAR(32),
|
||||
platform_result_code VARCHAR(32),
|
||||
platform_result_msg VARCHAR(1000),
|
||||
target_invoice_id BIGINT,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_invoice_reversal
|
||||
ADD CONSTRAINT fk_ns_invoice_reversal_invoice
|
||||
FOREIGN KEY (invoice_id) REFERENCES ns_invoice(id);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_reversal_invoice_id
|
||||
ON ns_invoice_reversal (invoice_id);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_reversal_status
|
||||
ON ns_invoice_reversal (request_status, reversal_status);
|
||||
```
|
||||
|
||||
## `ns_red_document` 红字单据主表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_red_document (
|
||||
id BIGINT PRIMARY KEY,
|
||||
invoice_id BIGINT,
|
||||
document_type VARCHAR(16) NOT NULL,
|
||||
bill_no VARCHAR(64),
|
||||
bill_id VARCHAR(64),
|
||||
bill_info_no VARCHAR(64),
|
||||
bill_confirm_no VARCHAR(64),
|
||||
bill_uuid VARCHAR(64),
|
||||
blue_invoice_code VARCHAR(32),
|
||||
blue_invoice_no VARCHAR(32),
|
||||
blue_invoice_number VARCHAR(64),
|
||||
blue_invoice_line VARCHAR(16),
|
||||
bill_type VARCHAR(32),
|
||||
bill_status VARCHAR(32),
|
||||
bill_status_text VARCHAR(255),
|
||||
open_status VARCHAR(32),
|
||||
back_type VARCHAR(16),
|
||||
apply_source VARCHAR(32),
|
||||
red_reason VARCHAR(255),
|
||||
apply_remark VARCHAR(1000),
|
||||
pdf_url VARCHAR(1024),
|
||||
callback_status VARCHAR(32),
|
||||
last_sync_time DATETIME,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_red_document
|
||||
ADD CONSTRAINT fk_ns_red_document_invoice
|
||||
FOREIGN KEY (invoice_id) REFERENCES ns_invoice(id);
|
||||
|
||||
CREATE UNIQUE INDEX uk_ns_red_document_bill_no
|
||||
ON ns_red_document (bill_no);
|
||||
|
||||
CREATE UNIQUE INDEX uk_ns_red_document_bill_id
|
||||
ON ns_red_document (bill_id);
|
||||
|
||||
CREATE INDEX idx_ns_red_document_invoice_id
|
||||
ON ns_red_document (invoice_id);
|
||||
|
||||
CREATE INDEX idx_ns_red_document_status
|
||||
ON ns_red_document (document_type, bill_status, open_status);
|
||||
```
|
||||
|
||||
## `ns_red_document_item` 红字单据明细表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_red_document_item (
|
||||
id BIGINT PRIMARY KEY,
|
||||
red_document_id BIGINT NOT NULL,
|
||||
line_no INT NOT NULL,
|
||||
goods_name VARCHAR(255),
|
||||
model VARCHAR(128),
|
||||
unit VARCHAR(64),
|
||||
quantity DECIMAL(18,6),
|
||||
unit_price DECIMAL(18,6),
|
||||
amount DECIMAL(18,2),
|
||||
tax_rate DECIMAL(8,4),
|
||||
tax_amount DECIMAL(18,2),
|
||||
with_tax_flag SMALLINT,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_red_document_item
|
||||
ADD CONSTRAINT fk_ns_red_document_item_main
|
||||
FOREIGN KEY (red_document_id) REFERENCES ns_red_document(id);
|
||||
|
||||
CREATE UNIQUE INDEX uk_ns_red_document_item_line
|
||||
ON ns_red_document_item (red_document_id, line_no);
|
||||
```
|
||||
|
||||
## `ns_billing_device` 开票设备表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_billing_device (
|
||||
id BIGINT PRIMARY KEY,
|
||||
tax_num VARCHAR(32) NOT NULL,
|
||||
company_id VARCHAR(64),
|
||||
extension_num VARCHAR(32),
|
||||
machine_num VARCHAR(64),
|
||||
terminal_num VARCHAR(64),
|
||||
server_type VARCHAR(32),
|
||||
invoice_type_list VARCHAR(512),
|
||||
login_account VARCHAR(128),
|
||||
equipment_cabinet_id VARCHAR(64),
|
||||
device_status VARCHAR(32) NOT NULL,
|
||||
report_tax_status VARCHAR(32),
|
||||
clear_card_status VARCHAR(32),
|
||||
lock_date VARCHAR(32),
|
||||
single_billing_limit DECIMAL(18,2),
|
||||
offline_amount DECIMAL(18,2),
|
||||
offline_time VARCHAR(64),
|
||||
last_status_sync_time DATETIME,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_billing_device_tax_ext_machine
|
||||
ON ns_billing_device (tax_num, extension_num, machine_num);
|
||||
|
||||
CREATE INDEX idx_ns_billing_device_tax_num
|
||||
ON ns_billing_device (tax_num);
|
||||
|
||||
CREATE INDEX idx_ns_billing_device_status
|
||||
ON ns_billing_device (device_status, report_tax_status, clear_card_status);
|
||||
```
|
||||
|
||||
## `ns_invoice_stock_snapshot` 发票库存快照表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice_stock_snapshot (
|
||||
id BIGINT PRIMARY KEY,
|
||||
device_id BIGINT,
|
||||
seller_tax_no VARCHAR(32) NOT NULL,
|
||||
extension_num VARCHAR(32),
|
||||
machine_num VARCHAR(64),
|
||||
terminal_num VARCHAR(64),
|
||||
invoice_line VARCHAR(16),
|
||||
invoice_code VARCHAR(32),
|
||||
invoice_num_start VARCHAR(32),
|
||||
invoice_num_end VARCHAR(32),
|
||||
remain_num INT,
|
||||
is_default SMALLINT,
|
||||
source_type VARCHAR(16) NOT NULL,
|
||||
snapshot_time DATETIME NOT NULL,
|
||||
created_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
ALTER TABLE ns_invoice_stock_snapshot
|
||||
ADD CONSTRAINT fk_ns_invoice_stock_device
|
||||
FOREIGN KEY (device_id) REFERENCES ns_billing_device(id);
|
||||
|
||||
CREATE INDEX idx_ns_stock_device_time
|
||||
ON ns_invoice_stock_snapshot (device_id, snapshot_time);
|
||||
|
||||
CREATE INDEX idx_ns_stock_tax_line_time
|
||||
ON ns_invoice_stock_snapshot (seller_tax_no, invoice_line, snapshot_time);
|
||||
```
|
||||
|
||||
## `ns_enterprise_billing_config` 企业开票配置表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_enterprise_billing_config (
|
||||
id BIGINT PRIMARY KEY,
|
||||
tax_num VARCHAR(32) NOT NULL,
|
||||
company_id VARCHAR(64),
|
||||
use_scope VARCHAR(32),
|
||||
clerker VARCHAR(128),
|
||||
seller_address VARCHAR(255),
|
||||
seller_tel VARCHAR(64),
|
||||
seller_bank VARCHAR(255),
|
||||
seller_account VARCHAR(255),
|
||||
payee VARCHAR(64),
|
||||
checker VARCHAR(64),
|
||||
project_code VARCHAR(64),
|
||||
department_name VARCHAR(128),
|
||||
auth_status VARCHAR(32),
|
||||
last_auth_time DATETIME,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_enterprise_billing_config_tax_num
|
||||
ON ns_enterprise_billing_config (tax_num);
|
||||
```
|
||||
|
||||
## `ns_platform_event_log` 平台回调事件表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_platform_event_log (
|
||||
id BIGINT PRIMARY KEY,
|
||||
event_type VARCHAR(32) NOT NULL,
|
||||
event_key VARCHAR(128) NOT NULL,
|
||||
seller_tax_no VARCHAR(32),
|
||||
business_key VARCHAR(128),
|
||||
payload_json TEXT NOT NULL,
|
||||
process_status VARCHAR(32) NOT NULL,
|
||||
process_message VARCHAR(1000),
|
||||
processed_at DATETIME,
|
||||
created_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_platform_event_log_event_key
|
||||
ON ns_platform_event_log (event_key);
|
||||
|
||||
CREATE INDEX idx_ns_platform_event_log_type_status
|
||||
ON ns_platform_event_log (event_type, process_status);
|
||||
```
|
||||
|
||||
## `ns_platform_request_log` 平台请求响应日志表
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_platform_request_log (
|
||||
id BIGINT PRIMARY KEY,
|
||||
request_id VARCHAR(64) NOT NULL,
|
||||
business_type VARCHAR(32),
|
||||
business_id VARCHAR(64),
|
||||
method_name VARCHAR(128),
|
||||
request_headers_masked TEXT,
|
||||
request_body TEXT,
|
||||
response_body TEXT,
|
||||
response_code VARCHAR(32),
|
||||
success_flag SMALLINT,
|
||||
error_message VARCHAR(1000),
|
||||
created_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_platform_request_log_request_id
|
||||
ON ns_platform_request_log (request_id);
|
||||
|
||||
CREATE INDEX idx_ns_platform_request_log_business
|
||||
ON ns_platform_request_log (business_type, business_id);
|
||||
|
||||
CREATE INDEX idx_ns_platform_request_log_method_name
|
||||
ON ns_platform_request_log (method_name);
|
||||
```
|
||||
|
||||
## `ns_config_dictionary_cache` 配置字典缓存表（可选）
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_config_dictionary_cache (
|
||||
id BIGINT PRIMARY KEY,
|
||||
dict_type VARCHAR(64) NOT NULL,
|
||||
dict_key VARCHAR(128) NOT NULL,
|
||||
dict_name VARCHAR(255),
|
||||
company_id VARCHAR(64),
|
||||
company_name VARCHAR(255),
|
||||
extra_json TEXT,
|
||||
last_sync_time DATETIME,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### 约束与索引建议
|
||||
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_config_dictionary_cache_type_key
|
||||
ON ns_config_dictionary_cache (dict_type, dict_key);
|
||||
|
||||
CREATE INDEX idx_ns_config_dictionary_cache_type
|
||||
ON ns_config_dictionary_cache (dict_type);
|
||||
```
|
||||
|
||||
## 首期最小实施 DDL 建议
|
||||
|
||||
若以“最小可用”为目标，建议优先建以下 7 张表：
|
||||
- `ns_invoice`
|
||||
- `ns_invoice_item`
|
||||
- `ns_invoice_delivery`
|
||||
- `ns_invoice_reversal`
|
||||
- `ns_billing_device`
|
||||
- `ns_invoice_stock_snapshot`
|
||||
- `ns_platform_request_log`
|
||||
|
||||
第二批补充：
|
||||
- `ns_red_document`
|
||||
- `ns_red_document_item`
|
||||
- `ns_platform_event_log`
|
||||
- `ns_enterprise_billing_config`
|
||||
|
||||
## 后续建议
|
||||
|
||||
建议在此基础上继续完成：
|
||||
- 字段注释 SQL 草案
|
||||
- 状态码 / 枚举字典与字段注释联动
|
||||
- PostgreSQL 16 / openGauss 方言适配版本
|
||||
- 与 `docs/design/03_Technical_Design/01_Database_Design.md` 的正式章节对齐
|
||||
53
docs/guides/NUOSHUITONG_INTERFACE_SPEC/01_概述与接入约定.md
Normal file
53
docs/guides/NUOSHUITONG_INTERFACE_SPEC/01_概述与接入约定.md
Normal file
@ -0,0 +1,53 @@
|
||||
---
|
||||
title: 概述与接入约定
|
||||
aliases:
|
||||
- 概述与接入约定
|
||||
- 诺税通概述与接入约定
|
||||
- 概述与接入约定索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 概述与接入约定
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [源文档封面与概述](01_概述与接入约定.md#源文档封面与概述)
|
||||
- [交互说明](01_概述与接入约定.md#交互说明)
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 本分组保留为概览页，适合作为首次阅读入口。
|
||||
- 详细接口请从其他分组或总索引进入。
|
||||
|
||||
---
|
||||
|
||||
## 源文档封面与概述
|
||||
|
||||
# 概述
|
||||
|
||||
本文档定义了诺税通-销项服务面向第三方系统的数据协议接口，主要包括：开票请求接口、开票结果查询接口、开票结果回传等接口。
|
||||
|
||||
# 技术规范
|
||||
|
||||
## 交互说明
|
||||
|
||||
|
||||
本文档提供的接口均为post请求方式的HTTP接口，参数均以在消息主体body中以application/json方式提交，即请求头中Content-Type需配置为“application/json;charset=utf-8”。
|
||||
|
||||
说明：限定的最大长度为字符个数（一个汉字或全角符号算两个字符），最大长度中的带小数点（.）的，表示该字段只支持数值以不带千位分隔符的十进制浮点数表示，限定总长度和最大小数位，如16.2表示为-9999999999999.99到9999999999999.99的数。
|
||||
|
||||
# 接口列表
|
||||
|
||||
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/02_开票主链路.md
Normal file
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/02_开票主链路.md
Normal file
@ -0,0 +1,37 @@
|
||||
---
|
||||
title: 开票主链路
|
||||
aliases:
|
||||
- 开票主链路
|
||||
- 诺税通开票主链路
|
||||
- 开票主链路索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 开票主链路
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/开票请求接口|开票请求接口]]
|
||||
- [[interfaces/开票结果查询接口|开票结果查询接口]]
|
||||
- [[interfaces/开票结果回传|开票结果回传]]
|
||||
- [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]
|
||||
- [[interfaces/发票列表查询接口|发票列表查询接口]]
|
||||
- [[interfaces/发票交付|发票交付]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/03_作废重开与冲红.md
Normal file
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/03_作废重开与冲红.md
Normal file
@ -0,0 +1,37 @@
|
||||
---
|
||||
title: 作废重开与冲红
|
||||
aliases:
|
||||
- 作废重开与冲红
|
||||
- 诺税通作废重开与冲红
|
||||
- 作废重开与冲红索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 作废重开与冲红
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/发票作废申请接口|发票作废申请接口]]
|
||||
- [[interfaces/发票重开接口|发票重开接口]]
|
||||
- [[interfaces/快捷冲红接口|快捷冲红接口]]
|
||||
- [[interfaces/空白发票作废申请|空白发票作废申请]]
|
||||
- [[interfaces/蓝字发票剩余可冲红的金额_税额查询接口|蓝字发票剩余可冲红的金额、税额查询接口]]
|
||||
- [[interfaces/获取关联发票接口|获取关联发票接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/04_红字信息表.md
Normal file
37
docs/guides/NUOSHUITONG_INTERFACE_SPEC/04_红字信息表.md
Normal file
@ -0,0 +1,37 @@
|
||||
---
|
||||
title: 红字信息表
|
||||
aliases:
|
||||
- 红字信息表
|
||||
- 诺税通红字信息表
|
||||
- 红字信息表索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/红字信息表申请接口_不支持拆分_不推荐使用|红字信息表申请接口（不支持拆分，不推荐使用）]]
|
||||
- [[interfaces/红字信息表申请接口_支持拆分|红字信息表申请接口（支持拆分）]]
|
||||
- [[interfaces/红字信息表下载接口|红字信息表下载接口]]
|
||||
- [[interfaces/红字信息表查询接口|红字信息表查询接口]]
|
||||
- [[interfaces/红字信息表撤销接口|红字信息表撤销接口]]
|
||||
- [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
36
docs/guides/NUOSHUITONG_INTERFACE_SPEC/05_红字确认单.md
Normal file
36
docs/guides/NUOSHUITONG_INTERFACE_SPEC/05_红字确认单.md
Normal file
@ -0,0 +1,36 @@
|
||||
---
|
||||
title: 红字确认单
|
||||
aliases:
|
||||
- 红字确认单
|
||||
- 诺税通红字确认单
|
||||
- 红字确认单索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/红字确认单申请接口|红字确认单申请接口]]
|
||||
- [[interfaces/红字确认单下载接口|红字确认单下载接口]]
|
||||
- [[interfaces/红字确认单查询接口|红字确认单查询接口]]
|
||||
- [[interfaces/红字确认单确认接口|红字确认单确认接口]]
|
||||
- [[interfaces/红字确认单撤销接口|红字确认单撤销接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
42
docs/guides/NUOSHUITONG_INTERFACE_SPEC/06_库存票源与打印.md
Normal file
42
docs/guides/NUOSHUITONG_INTERFACE_SPEC/06_库存票源与打印.md
Normal file
@ -0,0 +1,42 @@
|
||||
---
|
||||
title: 库存票源与打印
|
||||
aliases:
|
||||
- 库存票源与打印
|
||||
- 诺税通库存票源与打印
|
||||
- 库存票源与打印索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 库存票源与打印
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/获取纸票打印编号接口|获取纸票打印编号接口]]
|
||||
- [[interfaces/获取指定票种当前代码号码|获取指定票种当前代码号码]]
|
||||
- [[interfaces/获取下一张发票号码代码接口_A9机柜|获取下一张发票号码代码接口（A9+机柜）]]
|
||||
- [[interfaces/发票库存余量查询接口|发票库存余量查询接口]]
|
||||
- [[interfaces/刷新获取开票设备实时发票库存接口|刷新获取开票设备实时发票库存接口]]
|
||||
- [[interfaces/票源下载接口|票源下载接口]]
|
||||
- [[interfaces/查询可下载发票库存列表接口|查询可下载发票库存列表接口]]
|
||||
- [[interfaces/自定义票源下载接口|自定义票源下载接口]]
|
||||
- [[interfaces/刷新可下载发票库存接口|刷新可下载发票库存接口]]
|
||||
- [[interfaces/乐企查询数电库存接口|乐企查询数电库存接口]]
|
||||
- [[interfaces/乐企数电发票库存申领接口|乐企数电发票库存申领接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
41
docs/guides/NUOSHUITONG_INTERFACE_SPEC/07_设备企业与配置.md
Normal file
41
docs/guides/NUOSHUITONG_INTERFACE_SPEC/07_设备企业与配置.md
Normal file
@ -0,0 +1,41 @@
|
||||
---
|
||||
title: 设备企业与配置
|
||||
aliases:
|
||||
- 设备企业与配置
|
||||
- 诺税通设备企业与配置
|
||||
- 设备企业与配置索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 设备企业与配置
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[08_车辆辅助与回传]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/企业设备状态查询接口|企业设备状态查询接口]]
|
||||
- [[interfaces/企业设备查询接口|企业设备查询接口]]
|
||||
- [[interfaces/创建开票设备接口|创建开票设备接口]]
|
||||
- [[interfaces/新增_修改企业开票信息|新增/修改企业开票信息]]
|
||||
- [[interfaces/录入自定义字段|录入自定义字段]]
|
||||
- [[interfaces/批量获取信息转换配置接口|批量获取信息转换配置接口]]
|
||||
- [[interfaces/批量获取备注配置信息接口|批量获取备注配置信息接口]]
|
||||
- [[interfaces/根据业务标识查询对应值列表接口|根据业务标识查询对应值列表接口]]
|
||||
- [[interfaces/获取查询数电登录认证_开票实名认证二维码|获取查询数电登录认证、开票实名认证二维码]]
|
||||
- [[interfaces/登录扫码认证确认接口|登录扫码认证确认接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
40
docs/guides/NUOSHUITONG_INTERFACE_SPEC/08_车辆辅助与回传.md
Normal file
40
docs/guides/NUOSHUITONG_INTERFACE_SPEC/08_车辆辅助与回传.md
Normal file
@ -0,0 +1,40 @@
|
||||
---
|
||||
title: 车辆辅助与回传
|
||||
aliases:
|
||||
- 车辆辅助与回传
|
||||
- 诺税通车辆辅助与回传
|
||||
- 车辆辅助与回传索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 车辆辅助与回传
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[09_专项能力]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/收票入库接口_本地提取发票|收票入库接口（本地提取发票）]]
|
||||
- [[interfaces/创建_查询企业车架号_合格证状态接口|创建/查询企业车架号、合格证状态接口]]
|
||||
- [[interfaces/企业车架号等信息查询结果回传接口|企业车架号等信息查询结果回传接口]]
|
||||
- [[interfaces/查询获取车架号是否可开票结果接口|查询获取车架号是否可开票结果接口]]
|
||||
- [[interfaces/获取DAT加密包文件流接口|获取DAT加密包文件流接口]]
|
||||
- [[interfaces/更新发票票据关联状态接口|更新发票票据关联状态接口]]
|
||||
- [[interfaces/删除发票信息接口|删除发票信息接口]]
|
||||
- [[interfaces/审核开票删除回传接口|审核开票删除回传接口]]
|
||||
- [[interfaces/批量查询发票xmlUrl接口|批量查询发票xmlUrl接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
40
docs/guides/NUOSHUITONG_INTERFACE_SPEC/09_专项能力.md
Normal file
40
docs/guides/NUOSHUITONG_INTERFACE_SPEC/09_专项能力.md
Normal file
@ -0,0 +1,40 @@
|
||||
---
|
||||
title: 专项能力
|
||||
aliases:
|
||||
- 专项能力
|
||||
- 诺税通专项能力
|
||||
- 专项能力索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 专项能力
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[10_附录_通用状态码]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [[interfaces/查询成品油库存列表接口|查询成品油库存列表接口]]
|
||||
- [[interfaces/成品油库存下载接口|成品油库存下载接口]]
|
||||
- [[interfaces/刷新获取税盘实时成品油库存接口|刷新获取税盘实时成品油库存接口]]
|
||||
- [[interfaces/抄报清卡|抄报清卡]]
|
||||
- [[interfaces/授信额度刷新接口|授信额度刷新接口]]
|
||||
- [[interfaces/查询授信额度数据|查询授信额度数据]]
|
||||
- [[interfaces/乐企授信额度下载_退回接口|乐企授信额度下载/退回接口]]
|
||||
- [[interfaces/乐企授信额度更新有效期接口|乐企授信额度更新有效期接口]]
|
||||
- [[interfaces/获取发票勾选入账状态接口|获取发票勾选入账状态接口]]
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 点击上方单接口页进入正文。
|
||||
- 适合在 Obsidian 中作为专题 MOC 使用。
|
||||
41
docs/guides/NUOSHUITONG_INTERFACE_SPEC/10_附录_通用状态码.md
Normal file
41
docs/guides/NUOSHUITONG_INTERFACE_SPEC/10_附录_通用状态码.md
Normal file
@ -0,0 +1,41 @@
|
||||
---
|
||||
title: 附录：通用状态码
|
||||
aliases:
|
||||
- 附录：通用状态码
|
||||
- 诺税通附录：通用状态码
|
||||
- 附录：通用状态码索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 附录：通用状态码
|
||||
|
||||
> [!info] 导航
|
||||
> 总索引：[[README]]
|
||||
> 同级分组：[[01_概述与接入约定]] · [[02_开票主链路]] · [[03_作废重开与冲红]] · [[04_红字信息表]] · [[05_红字确认单]] · [[06_库存票源与打印]] · [[07_设备企业与配置]] · [[08_车辆辅助与回传]] · [[09_专项能力]]
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本页作为 Obsidian MOC，仅保留分组导航与接口入口；接口正文已下沉为单接口一页。
|
||||
|
||||
## 接口入口
|
||||
|
||||
- [通用状态码说明](10_附录_通用状态码.md#通用状态码说明)
|
||||
|
||||
## 使用说明
|
||||
|
||||
- 本分组保留附录全文，便于各接口页统一回查状态码。
|
||||
|
||||
## 通用状态码说明
|
||||
|
||||
| | |
|
||||
|:----------:|:--------------------:|
|
||||
| **状态码** | **描述** |
|
||||
| 200 | 成功 |
|
||||
| 501 | 请求异常或服务器异常 |
|
||||
|
||||
更多错误码描述可见message字段。
|
||||
147
docs/guides/NUOSHUITONG_INTERFACE_SPEC/11_枚举清单.md
Normal file
147
docs/guides/NUOSHUITONG_INTERFACE_SPEC/11_枚举清单.md
Normal file
@ -0,0 +1,147 @@
|
||||
---
|
||||
title: 诺税通接口枚举清单
|
||||
aliases:
|
||||
- 诺税通枚举清单
|
||||
- 诺税通参数枚举索引
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- enum-index
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: extracted-summary
|
||||
---
|
||||
|
||||
# 诺税通接口枚举清单
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本文从诺税通销项服务接口规范中提取各接口内出现的参数枚举、状态枚举与布尔/标志位语义，便于实施时统一核对。
|
||||
> 原始接口正文请进入 `interfaces/` 下的单接口页查看。
|
||||
|
||||
## 开票主链路
|
||||
|
||||
### [[interfaces/开票请求接口|开票请求接口]]
|
||||
|
||||
- `invoiceType`：1:蓝票；2:红票 | 2
|
||||
- `invoiceLine`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | 2
|
||||
- `remark`：j：机动车发票时，备注需注明：“一车一票”否则接口会自动添加该文案 | 备注，（注意：不同开票服务器类型支持的备注长度不同，请在提交前做好确认） | 数电电票：200(中文计算一位) 其他发票：230(中文计算两位)
|
||||
- `notifyType`：-1:不推送；0:邮箱；1:手机(默认)；2:邮箱、手机 | 2
|
||||
- `listFlag`：0:非清单；1:清单，纸票超过8行自动转成清单，电票无清单概念，默认都传0 | 2
|
||||
- `substituteFlag`：0:非代开；1:代开
|
||||
- `withTaxFlag`：0:不含税,1:含税 | 2
|
||||
- `favouredPolicyFlag`：0:不使用；1:使用 数电发票时为空，仅传入优惠政策编码即可 | 2
|
||||
- `zeroRateFlag`：1:免税；2:不征税；3:普通零税率；favouredPolicyFlag:0 zeroRateFlag:3 favouredPolicyName: 免税时，对应传值： favouredPolicyFlag:1 zeroRateFlag:1 favouredPolicyName:“免税” 不征税，对应传值： favouredPolicyFlag:1 zeroRateFlag:2 favouredPolicyName:“不征税” | 2
|
||||
|
||||
### [[interfaces/开票结果查询接口|开票结果查询接口]]
|
||||
|
||||
- `status`：0:开票中1:开票完成2:开票失败3:发票生成 | 2
|
||||
- `invoiceLine`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | 2
|
||||
- `productOilFlag`：0:非成品油；1:成品油 | 2
|
||||
- `vehicleFlag`：0：非机动车；1：机动车 | 2
|
||||
- `listFlag`：0:非清单，1:清单 | 2
|
||||
- `invalidReason`：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回） | 1
|
||||
- `withTaxFlag`：0:不含税；1:含税 | 2
|
||||
- `detailType`：0:正常行；1:折扣行；2:被折扣行 | 2
|
||||
- `favouredPolicyFlag`：0:不使用；1:使用 | 2
|
||||
- `zeroRateFlag`：1:免税；2:不征税；3:普通零税率 | 2
|
||||
|
||||
### [[interfaces/开票结果回传|开票结果回传]]
|
||||
|
||||
- `successFlag`：True:开票成功；false：开票失败 | 1
|
||||
- `vehicleFlag`：0：非机动车；1：机动车 | 2
|
||||
- `invoiceStatus`：1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功
|
||||
- `invoiceLine`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j:机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) 仅开票成功会返回 | 2
|
||||
- `relatedState`：0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败) |
|
||||
- `invalidReason`：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回） | 1
|
||||
|
||||
### [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]
|
||||
|
||||
- `invoiceLine`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | 1
|
||||
- `productOilFlag`：0:非成品油；1:成品油
|
||||
- `vehicleFlag`：0：非机动车；1：机动车 | 2
|
||||
- `listFlag`：0：非清单；1：清单
|
||||
- `invoiceStatus`：1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功
|
||||
- `relatedState`：0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败) |
|
||||
- `invalidReason`：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回） | 1
|
||||
- `withTaxFlag`：1:含税；0:不含税
|
||||
- `detailType`：0:正常行；1:折扣行；2:被扣行
|
||||
- `zeroRateFlag`：1:免税；2:不征税；3:普通零税率
|
||||
- `favouredPolicyFlag`：0:不使用；1:使用
|
||||
|
||||
### [[interfaces/发票列表查询接口|发票列表查询接口]]
|
||||
|
||||
- `status`：0:开票中1:开票完成2:开票失败3:发票生成 | 2
|
||||
- `invoiceLine`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | 2
|
||||
- `productOilFlag`：0:非成品油；1:成品油 | 2
|
||||
- `vehicleFlag`：0：非机动车；1：机动车 | 2
|
||||
- `listFlag`：0:非清单，1:清单 | 2
|
||||
- `invalidReason`：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回） | 1
|
||||
- `withTaxFlag`：0:不含税；1:含税 | 2
|
||||
- `detailType`：0:正常行；1:折扣行；2:被折扣行 | 2
|
||||
- `favouredPolicyFlag`：0:不使用；1:使用 | 2
|
||||
- `zeroRateFlag`：1:免税；2:不征税；3:普通零税率 | 2
|
||||
|
||||
## 作废重开与冲红
|
||||
|
||||
### [[interfaces/快捷冲红接口|快捷冲红接口]]
|
||||
|
||||
- `fastRedType`：1:数电发票快捷冲红(数电发票必传1) | 1
|
||||
- `fastRedType`：1:数电快捷冲红(数电发票必传1) | 1
|
||||
|
||||
## 红字信息表
|
||||
|
||||
### [[interfaces/红字信息表申请接口_不支持拆分_不推荐使用|红字信息表申请接口（不支持拆分，不推荐使用）]]
|
||||
|
||||
- `billType`：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） 默认为：0正常 注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单） 若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填
|
||||
|
||||
### [[interfaces/红字信息表申请接口_支持拆分|红字信息表申请接口（支持拆分）]]
|
||||
|
||||
- `billType`：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） 默认为：0正常 注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单） 若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填
|
||||
|
||||
### [[interfaces/红字信息表查询接口|红字信息表查询接口]]
|
||||
|
||||
- `billType`：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回 4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） | 1
|
||||
- `taxRate`：0:一票一税率 1:一票多税率) | 1
|
||||
- `billStatus`：-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销) | 2
|
||||
|
||||
### [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]
|
||||
|
||||
- `backType`：1: 红字信息表 2：红字确认单 | 2
|
||||
- `billType`：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回 4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） | 1
|
||||
- `billStatus`：-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销 -2:删除成功) | 2
|
||||
- `backType`：1: 红字信息表 2：红字确认单 | 2
|
||||
- `openStatus`：0：未开具 1：已开具 | 2
|
||||
- `blueInvoiceLine`：bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票 | 5
|
||||
|
||||
## 红字确认单
|
||||
|
||||
### [[interfaces/红字确认单申请接口|红字确认单申请接口]]
|
||||
|
||||
- `blueInvoiceLine`：bs:数电专票(电子), pc:数电普票(电子)， es:数电专票(纸质)；ec:数电普票(纸质)， p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票 | 5
|
||||
- `withTaxFlag`：0:不含税,1:含税 | 1
|
||||
- `zeroRateFlag`：1:免税；2:不征税；3:普通零税率 | 2
|
||||
|
||||
### [[interfaces/红字确认单下载接口|红字确认单下载接口]]
|
||||
|
||||
- `billStatus`：1：我是购买方时，必填 确认单状态，0.待确认 1.已确认 2.已过期 3.销方否认 4.已撤销 | 4
|
||||
|
||||
### [[interfaces/红字确认单查询接口|红字确认单查询接口]]
|
||||
|
||||
- `openStatus`：0：未开具 1：已开具 | 2
|
||||
- `blueInvoiceLine`：bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票 | 5
|
||||
|
||||
## 设备企业与配置
|
||||
|
||||
### [[interfaces/创建开票设备接口|创建开票设备接口]]
|
||||
|
||||
- `serverType`：1:C48, 11:诺诺开票, 14：A9, 15:四川税局代开, 17:诺诺机柜, 18:税控服务器, 20:单机版, 22:数电发票开票模式（通用版）, 24:数电发票开票模式（单机版）, 25:数电发票开票模式（机柜版） 数电单机版和机柜版暂只支持半本地环境 | 4
|
||||
- `invoiceTypelist`：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | -
|
||||
|
||||
## 车辆辅助与回传
|
||||
|
||||
### [[interfaces/收票入库接口_本地提取发票|收票入库接口（本地提取发票）]]
|
||||
|
||||
- `invoiceType`：1：蓝票；2：红票
|
||||
- `withTaxFlag`：0:不含税,1:含税
|
||||
|
||||
341
docs/guides/NUOSHUITONG_INTERFACE_SPEC/12_标准枚举字典.md
Normal file
341
docs/guides/NUOSHUITONG_INTERFACE_SPEC/12_标准枚举字典.md
Normal file
@ -0,0 +1,341 @@
|
||||
---
|
||||
title: 诺税通标准枚举字典
|
||||
aliases:
|
||||
- 诺税通枚举字典
|
||||
- 诺税通字段级枚举表
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- enum-dictionary
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: normalized-from-enum-index
|
||||
---
|
||||
|
||||
# 诺税通标准枚举字典
|
||||
|
||||
> [!abstract] 说明
|
||||
> 本文对 `11_枚举清单.md` 中跨接口重复出现的枚举字段进行字段级归并，便于实施时统一理解与复用。
|
||||
> 若同一字段在不同接口中存在补充说明或口径差异，均在“来源接口”中保留。
|
||||
|
||||
## 快速导航
|
||||
|
||||
- [[#`invoiceLine`|`invoiceLine`]]
|
||||
- [[#`invoiceType`|`invoiceType`]]
|
||||
- [[#`status`|`status`]]
|
||||
- [[#`invoiceStatus`|`invoiceStatus`]]
|
||||
- [[#`billStatus`|`billStatus`]]
|
||||
- [[#`billType`|`billType`]]
|
||||
- [[#`withTaxFlag`|`withTaxFlag`]]
|
||||
- [[#`listFlag`|`listFlag`]]
|
||||
- [[#`detailType`|`detailType`]]
|
||||
- [[#`invalidReason`|`invalidReason`]]
|
||||
- [[#`notifyType`|`notifyType`]]
|
||||
- [[#`vehicleFlag`|`vehicleFlag`]]
|
||||
- [[#`productOilFlag`|`productOilFlag`]]
|
||||
- [[#`zeroRateFlag`|`zeroRateFlag`]]
|
||||
- [[#`favouredPolicyFlag`|`favouredPolicyFlag`]]
|
||||
- [[#`backType`|`backType`]]
|
||||
- [[#`openStatus`|`openStatus`]]
|
||||
- [[#`serverType`|`serverType`]]
|
||||
- [[#`fastRedType`|`fastRedType`]]
|
||||
- [[#`taxRate`|`taxRate`]]
|
||||
- [[#`relatedState`|`relatedState`]]
|
||||
- [[#`successFlag`|`successFlag`]]
|
||||
- [[#`substituteFlag`|`substituteFlag`]]
|
||||
- [[#`blueInvoiceLine`|`blueInvoiceLine`]]
|
||||
- [[#`invoiceTypelist`|`invoiceTypelist`]]
|
||||
- [[#`remark`|`remark`]]
|
||||
|
||||
## `invoiceLine`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
> - p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
> - p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j:机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) 仅开票成功会返回
|
||||
> - p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j:机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) 仅开票成功会返回
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
|
||||
## `invoiceType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:蓝票；2:红票
|
||||
> - 1：蓝票；2：红票
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：1:蓝票；2:红票
|
||||
- **车辆辅助与回传 / [[interfaces/收票入库接口_本地提取发票|收票入库接口（本地提取发票）]]**：1：蓝票；2：红票
|
||||
|
||||
## `status`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:开票中1:开票完成2:开票失败3:发票生成
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:开票中1:开票完成2:开票失败3:发票生成
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:开票中1:开票完成2:开票失败3:发票生成
|
||||
|
||||
## `invoiceStatus`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功
|
||||
|
||||
## `billStatus`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - -1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销)
|
||||
> - -1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销 -2:删除成功)
|
||||
> - 1：我是购买方时，必填 确认单状态，0.待确认 1.已确认 2.已过期 3.销方否认 4.已撤销
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表查询接口|红字信息表查询接口]]**：-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销)
|
||||
- **红字信息表 / [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]**：-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销 -2:删除成功)
|
||||
- **红字确认单 / [[interfaces/红字确认单下载接口|红字确认单下载接口]]**：1：我是购买方时，必填 确认单状态，0.待确认 1.已确认 2.已过期 3.销方否认 4.已撤销
|
||||
|
||||
## `billType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） 默认为：0正常 注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单） 若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填
|
||||
> - 0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回 4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表申请接口_不支持拆分_不推荐使用|红字信息表申请接口（不支持拆分，不推荐使用）]]**：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） 默认为：0正常 注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单） 若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填
|
||||
- **红字信息表 / [[interfaces/红字信息表申请接口_支持拆分|红字信息表申请接口（支持拆分）]]**：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动） 默认为：0正常 注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单） 若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填
|
||||
- **红字信息表 / [[interfaces/红字信息表查询接口|红字信息表查询接口]]**：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回 4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）
|
||||
- **红字信息表 / [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]**：0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回 4、矿产品类专用信息表（涉及销售数量和金额变更） 5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）
|
||||
|
||||
## `withTaxFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:不含税,1:含税
|
||||
> - 0:不含税；1:含税
|
||||
> - 1:含税；0:不含税
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：0:不含税,1:含税
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:不含税；1:含税
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：1:含税；0:不含税
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:不含税；1:含税
|
||||
- **红字确认单 / [[interfaces/红字确认单申请接口|红字确认单申请接口]]**：0:不含税,1:含税
|
||||
- **车辆辅助与回传 / [[interfaces/收票入库接口_本地提取发票|收票入库接口（本地提取发票）]]**：0:不含税,1:含税
|
||||
|
||||
## `listFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:非清单；1:清单，纸票超过8行自动转成清单，电票无清单概念，默认都传0
|
||||
> - 0:非清单，1:清单
|
||||
> - 0：非清单；1：清单
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：0:非清单；1:清单，纸票超过8行自动转成清单，电票无清单概念，默认都传0
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:非清单，1:清单
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0：非清单；1：清单
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:非清单，1:清单
|
||||
|
||||
## `detailType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:正常行；1:折扣行；2:被折扣行
|
||||
> - 0:正常行；1:折扣行；2:被扣行
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:正常行；1:折扣行；2:被折扣行
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0:正常行；1:折扣行；2:被扣行
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:正常行；1:折扣行；2:被折扣行
|
||||
|
||||
## `invalidReason`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：1:销货退回；2:开票有误；3:服务中止；4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）
|
||||
|
||||
## `notifyType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - -1:不推送；0:邮箱；1:手机(默认)；2:邮箱、手机
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：-1:不推送；0:邮箱；1:手机(默认)；2:邮箱、手机
|
||||
|
||||
## `vehicleFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0：非机动车；1：机动车
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0：非机动车；1：机动车
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：0：非机动车；1：机动车
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0：非机动车；1：机动车
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0：非机动车；1：机动车
|
||||
|
||||
## `productOilFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:非成品油；1:成品油
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:非成品油；1:成品油
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0:非成品油；1:成品油
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:非成品油；1:成品油
|
||||
|
||||
## `zeroRateFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:免税；2:不征税；3:普通零税率；favouredPolicyFlag:0 zeroRateFlag:3 favouredPolicyName: 免税时，对应传值： favouredPolicyFlag:1 zeroRateFlag:1 favouredPolicyName:“免税” 不征税，对应传值： favouredPolicyFlag:1 zeroRateFlag:2 favouredPolicyName:“不征税”
|
||||
> - 1:免税；2:不征税；3:普通零税率
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：1:免税；2:不征税；3:普通零税率；favouredPolicyFlag:0 zeroRateFlag:3 favouredPolicyName: 免税时，对应传值： favouredPolicyFlag:1 zeroRateFlag:1 favouredPolicyName:“免税” 不征税，对应传值： favouredPolicyFlag:1 zeroRateFlag:2 favouredPolicyName:“不征税”
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：1:免税；2:不征税；3:普通零税率
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：1:免税；2:不征税；3:普通零税率
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：1:免税；2:不征税；3:普通零税率
|
||||
- **红字确认单 / [[interfaces/红字确认单申请接口|红字确认单申请接口]]**：1:免税；2:不征税；3:普通零税率
|
||||
|
||||
## `favouredPolicyFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:不使用；1:使用 数电发票时为空，仅传入优惠政策编码即可
|
||||
> - 0:不使用；1:使用
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：0:不使用；1:使用 数电发票时为空，仅传入优惠政策编码即可
|
||||
- **开票主链路 / [[interfaces/开票结果查询接口|开票结果查询接口]]**：0:不使用；1:使用
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0:不使用；1:使用
|
||||
- **开票主链路 / [[interfaces/发票列表查询接口|发票列表查询接口]]**：0:不使用；1:使用
|
||||
|
||||
## `backType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1: 红字信息表 2：红字确认单
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]**：1: 红字信息表 2：红字确认单
|
||||
|
||||
## `openStatus`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0：未开具 1：已开具
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]**：0：未开具 1：已开具
|
||||
- **红字确认单 / [[interfaces/红字确认单查询接口|红字确认单查询接口]]**：0：未开具 1：已开具
|
||||
|
||||
## `serverType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:C48, 11:诺诺开票, 14：A9, 15:四川税局代开, 17:诺诺机柜, 18:税控服务器, 20:单机版, 22:数电发票开票模式（通用版）, 24:数电发票开票模式（单机版）, 25:数电发票开票模式（机柜版） 数电单机版和机柜版暂只支持半本地环境
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **设备企业与配置 / [[interfaces/创建开票设备接口|创建开票设备接口]]**：1:C48, 11:诺诺开票, 14：A9, 15:四川税局代开, 17:诺诺机柜, 18:税控服务器, 20:单机版, 22:数电发票开票模式（通用版）, 24:数电发票开票模式（单机版）, 25:数电发票开票模式（机柜版） 数电单机版和机柜版暂只支持半本地环境
|
||||
|
||||
## `fastRedType`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 1:数电发票快捷冲红(数电发票必传1)
|
||||
> - 1:数电快捷冲红(数电发票必传1)
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **作废重开与冲红 / [[interfaces/快捷冲红接口|快捷冲红接口]]**：1:数电快捷冲红(数电发票必传1)
|
||||
|
||||
## `taxRate`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:一票一税率 1:一票多税率)
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表查询接口|红字信息表查询接口]]**：0:一票一税率 1:一票多税率)
|
||||
|
||||
## `relatedState`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败) |
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败) |
|
||||
- **开票主链路 / [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]**：0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败) |
|
||||
|
||||
## `successFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - True:开票成功；false：开票失败
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票结果回传|开票结果回传]]**：True:开票成功；false：开票失败
|
||||
|
||||
## `substituteFlag`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - 0:非代开；1:代开
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：0:非代开；1:代开
|
||||
|
||||
## `blueInvoiceLine`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票
|
||||
> - bs:数电专票(电子), pc:数电普票(电子)， es:数电专票(纸质)；ec:数电普票(纸质)， p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **红字信息表 / [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]**：bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票
|
||||
- **红字确认单 / [[interfaces/红字确认单申请接口|红字确认单申请接口]]**：bs:数电专票(电子), pc:数电普票(电子)， es:数电专票(纸质)；ec:数电普票(纸质)， p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票
|
||||
- **红字确认单 / [[interfaces/红字确认单查询接口|红字确认单查询接口]]**：bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) p:电子增值税普通发票， c:增值税普通发票(纸票)， s:增值税专用发票， b:增值税电子专用发票
|
||||
|
||||
## `invoiceTypelist`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **设备企业与配置 / [[interfaces/创建开票设备接口|创建开票设备接口]]**：p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)
|
||||
|
||||
## `remark`
|
||||
|
||||
> [!summary] 标准口径
|
||||
> - j：机动车发票时，备注需注明：“一车一票”否则接口会自动添加该文案 | 备注，（注意：不同开票服务器类型支持的备注长度不同，请在提交前做好确认） | 数电电票：200(中文计算一位) 其他发票：230(中文计算两位)
|
||||
|
||||
### 来源接口
|
||||
|
||||
- **开票主链路 / [[interfaces/开票请求接口|开票请求接口]]**：j：机动车发票时，备注需注明：“一车一票”否则接口会自动添加该文案 | 备注，（注意：不同开票服务器类型支持的备注长度不同，请在提交前做好确认） | 数电电票：200(中文计算一位) 其他发票：230(中文计算两位)
|
||||
|
||||
130
docs/guides/NUOSHUITONG_INTERFACE_SPEC/README.md
Normal file
130
docs/guides/NUOSHUITONG_INTERFACE_SPEC/README.md
Normal file
@ -0,0 +1,130 @@
|
||||
---
|
||||
title: 诺税通销项服务接口规范索引
|
||||
aliases:
|
||||
- 诺税通销项接口规范
|
||||
- 诺税通销项服务接口目录
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- moc
|
||||
source_docx: ../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 诺税通销项服务接口规范索引
|
||||
|
||||
> [!abstract] 文档说明
|
||||
> 本目录为 `诺诺网-诺税通销项服务对外接口规范v1.3.18.docx` 的 Markdown 转换结果，已进一步拆分为“单接口一页”。
|
||||
> 适用于 Obsidian 检索、双链浏览与专题整理。
|
||||
> 原始来源：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 配套实施清单：[NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md](../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
## 分组导航
|
||||
|
||||
- [[01_概述与接入约定]]
|
||||
- [[02_开票主链路]]
|
||||
- [[03_作废重开与冲红]]
|
||||
- [[04_红字信息表]]
|
||||
- [[05_红字确认单]]
|
||||
- [[06_库存票源与打印]]
|
||||
- [[07_设备企业与配置]]
|
||||
- [[08_车辆辅助与回传]]
|
||||
- [[09_专项能力]]
|
||||
- [[10_附录_通用状态码]]
|
||||
- [[11_枚举清单]]
|
||||
- [[12_标准枚举字典]]
|
||||
|
||||
## 单接口索引
|
||||
|
||||
### 开票主链路
|
||||
|
||||
- [[interfaces/开票请求接口|开票请求接口]]
|
||||
- [[interfaces/开票结果查询接口|开票结果查询接口]]
|
||||
- [[interfaces/开票结果回传|开票结果回传]]
|
||||
- [[interfaces/开票结果回传_含明细|开票结果回传（含明细）]]
|
||||
- [[interfaces/发票列表查询接口|发票列表查询接口]]
|
||||
- [[interfaces/发票交付|发票交付]]
|
||||
|
||||
### 作废重开与冲红
|
||||
|
||||
- [[interfaces/发票作废申请接口|发票作废申请接口]]
|
||||
- [[interfaces/发票重开接口|发票重开接口]]
|
||||
- [[interfaces/获取关联发票接口|获取关联发票接口]]
|
||||
- [[interfaces/快捷冲红接口|快捷冲红接口]]
|
||||
- [[interfaces/空白发票作废申请|空白发票作废申请]]
|
||||
- [[interfaces/蓝字发票剩余可冲红的金额_税额查询接口|蓝字发票剩余可冲红的金额、税额查询接口]]
|
||||
|
||||
### 红字信息表
|
||||
|
||||
- [[interfaces/红字信息表申请接口_不支持拆分_不推荐使用|红字信息表申请接口（不支持拆分，不推荐使用）]]
|
||||
- [[interfaces/红字信息表申请接口_支持拆分|红字信息表申请接口（支持拆分）]]
|
||||
- [[interfaces/红字信息表下载接口|红字信息表下载接口]]
|
||||
- [[interfaces/红字信息表查询接口|红字信息表查询接口]]
|
||||
- [[interfaces/红字信息表撤销接口|红字信息表撤销接口]]
|
||||
- [[interfaces/红字信息表_红字确认单回传|红字信息表/红字确认单回传]]
|
||||
|
||||
### 红字确认单
|
||||
|
||||
- [[interfaces/红字确认单申请接口|红字确认单申请接口]]
|
||||
- [[interfaces/红字确认单下载接口|红字确认单下载接口]]
|
||||
- [[interfaces/红字确认单查询接口|红字确认单查询接口]]
|
||||
- [[interfaces/红字确认单确认接口|红字确认单确认接口]]
|
||||
- [[interfaces/红字确认单撤销接口|红字确认单撤销接口]]
|
||||
|
||||
### 库存票源与打印
|
||||
|
||||
- [[interfaces/获取纸票打印编号接口|获取纸票打印编号接口]]
|
||||
- [[interfaces/获取指定票种当前代码号码|获取指定票种当前代码号码]]
|
||||
- [[interfaces/发票库存余量查询接口|发票库存余量查询接口]]
|
||||
- [[interfaces/刷新获取开票设备实时发票库存接口|刷新获取开票设备实时发票库存接口]]
|
||||
- [[interfaces/获取下一张发票号码代码接口_A9机柜|获取下一张发票号码代码接口（A9+机柜）]]
|
||||
- [[interfaces/票源下载接口|票源下载接口]]
|
||||
- [[interfaces/查询可下载发票库存列表接口|查询可下载发票库存列表接口]]
|
||||
- [[interfaces/自定义票源下载接口|自定义票源下载接口]]
|
||||
- [[interfaces/刷新可下载发票库存接口|刷新可下载发票库存接口]]
|
||||
- [[interfaces/乐企查询数电库存接口|乐企查询数电库存接口]]
|
||||
- [[interfaces/乐企数电发票库存申领接口|乐企数电发票库存申领接口]]
|
||||
|
||||
### 设备企业与配置
|
||||
|
||||
- [[interfaces/企业设备状态查询接口|企业设备状态查询接口]]
|
||||
- [[interfaces/新增_修改企业开票信息|新增/修改企业开票信息]]
|
||||
- [[interfaces/批量获取信息转换配置接口|批量获取信息转换配置接口]]
|
||||
- [[interfaces/批量获取备注配置信息接口|批量获取备注配置信息接口]]
|
||||
- [[interfaces/根据业务标识查询对应值列表接口|根据业务标识查询对应值列表接口]]
|
||||
- [[interfaces/企业设备查询接口|企业设备查询接口]]
|
||||
- [[interfaces/创建开票设备接口|创建开票设备接口]]
|
||||
- [[interfaces/录入自定义字段|录入自定义字段]]
|
||||
- [[interfaces/获取查询数电登录认证_开票实名认证二维码|获取查询数电登录认证、开票实名认证二维码]]
|
||||
- [[interfaces/登录扫码认证确认接口|登录扫码认证确认接口]]
|
||||
|
||||
### 车辆辅助与回传
|
||||
|
||||
- [[interfaces/收票入库接口_本地提取发票|收票入库接口（本地提取发票）]]
|
||||
- [[interfaces/创建_查询企业车架号_合格证状态接口|创建/查询企业车架号、合格证状态接口]]
|
||||
- [[interfaces/企业车架号等信息查询结果回传接口|企业车架号等信息查询结果回传接口]]
|
||||
- [[interfaces/获取DAT加密包文件流接口|获取DAT加密包文件流接口]]
|
||||
- [[interfaces/更新发票票据关联状态接口|更新发票票据关联状态接口]]
|
||||
- [[interfaces/查询获取车架号是否可开票结果接口|查询获取车架号是否可开票结果接口]]
|
||||
- [[interfaces/删除发票信息接口|删除发票信息接口]]
|
||||
- [[interfaces/审核开票删除回传接口|审核开票删除回传接口]]
|
||||
- [[interfaces/批量查询发票xmlUrl接口|批量查询发票xmlUrl接口]]
|
||||
|
||||
### 专项能力
|
||||
|
||||
- [[interfaces/查询成品油库存列表接口|查询成品油库存列表接口]]
|
||||
- [[interfaces/成品油库存下载接口|成品油库存下载接口]]
|
||||
- [[interfaces/刷新获取税盘实时成品油库存接口|刷新获取税盘实时成品油库存接口]]
|
||||
- [[interfaces/抄报清卡|抄报清卡]]
|
||||
- [[interfaces/授信额度刷新接口|授信额度刷新接口]]
|
||||
- [[interfaces/查询授信额度数据|查询授信额度数据]]
|
||||
- [[interfaces/乐企授信额度下载_退回接口|乐企授信额度下载/退回接口]]
|
||||
- [[interfaces/乐企授信额度更新有效期接口|乐企授信额度更新有效期接口]]
|
||||
- [[interfaces/获取发票勾选入账状态接口|获取发票勾选入账状态接口]]
|
||||
|
||||
## 使用建议
|
||||
|
||||
- 先阅读 [[01_概述与接入约定]] 了解整体交互方式。
|
||||
- 再按业务主题进入分组 MOC，最终跳转到 `interfaces/` 下的单接口笔记。
|
||||
- 若需实施口径，请同步参照 `NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md`。
|
||||
@ -0,0 +1,106 @@
|
||||
---
|
||||
title: 乐企授信额度下载/退回接口
|
||||
aliases:
|
||||
- 乐企授信额度下载/退回接口
|
||||
- 诺税通乐企授信额度下载/退回接口
|
||||
- 专项能力-乐企授信额度下载/退回接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 乐企授信额度下载/退回接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/creditQuota/downloadOrReturn.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 乐企授信额度下载/退回接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
乐企模式授信额度下载\退回接口，调用该接口时，需保证对应企业税号查询过授信额度。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/creditQuota/downloadOrReturn.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 |
|
||||
| amount | BigDecimal | 是 | 需要下载\退回的金额，只能为正数数字 | 处理额度 | (12,2) |
|
||||
| type | Integer | 是 | 0:下载 1:退回 | 请求类型 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"amount": 100,</p>
|
||||
<p>"type": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| vestPeriodBegin | Date | 是 | 2023-03-01 00:00:00 | 授信额度使用区间起 | \- |
|
||||
| vestPeriodEnd | Date | 是 | 2023-03-31 00:00:00 | 授信额度使用区间止 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"vestPeriodBegin": "2023-03-01 00:00:00",</p>
|
||||
<p>"vestPeriodEnd": "2023-03-31 00:00:00"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,104 @@
|
||||
---
|
||||
title: 乐企授信额度更新有效期接口
|
||||
aliases:
|
||||
- 乐企授信额度更新有效期接口
|
||||
- 诺税通乐企授信额度更新有效期接口
|
||||
- 专项能力-乐企授信额度更新有效期接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 乐企授信额度更新有效期接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/creditQuota/updateVestPeriod.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 乐企授信额度更新有效期接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
乐企模式授信额度更新有效期接口，调用该接口时，需保证对应企业税号查询过授信额度。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/creditQuota/updateVestPeriod.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:------------------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| vestPeriodBegin | Date | 是 | 2023-03-01 00:00:00 | 授信额度使用区间起 | \- |
|
||||
| vestPeriodEnd | Date | 是 | 2023-03-31 00:00:00 | 授信额度使用区间止 | \- |
|
||||
| vestPeriod | String | 是 | 202303 | 授信额度属期 格式：yyyyMM | 6 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"vestPeriodBegin": "2023-03-01 00:00:00",</p>
|
||||
<p>"vestPeriodEnd": "2023-03-31 00:00:00",</p>
|
||||
<p>"vestPeriod": "202303"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,170 @@
|
||||
---
|
||||
title: 乐企数电发票库存申领接口
|
||||
aliases:
|
||||
- 乐企数电发票库存申领接口
|
||||
- 诺税通乐企数电发票库存申领接口
|
||||
- 库存票源与打印-乐企数电发票库存申领接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 乐企数电发票库存申领接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/fullStock/applyStock.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 乐企数电发票库存申领接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
向纳税人提供批量预赋码功能，用于企业给数字化电子发票自动赋发票号码。每次最多申请5000份数字化电子发票。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:------------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/fullStock/applyStock.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 企业税号 | 申领发票的纳税人识别号或统一社会信用代码 | 20 |
|
||||
| applyNum | Integer | 是 | 申领数量 | 申领数量最大值：5000 | 10 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"applyNum": 2,</p>
|
||||
<p>"taxNum": "339901999999199"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 14%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 7%" />
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 35%" />
|
||||
<col style="width: 15%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">code</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">200</td>
|
||||
<td style="text-align: center;">状态,200-成功，非200-失败</td>
|
||||
<td style="text-align: center;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">成功</td>
|
||||
<td style="text-align: center;">详细信息</td>
|
||||
<td style="text-align: center;">1024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">data</td>
|
||||
<td style="text-align: center;">Object</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">查询对象</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="6" style="text-align: center;"><strong>数据信息</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applyNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
<td style="text-align: center;">领用数量</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceNumStart</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">23446000000000000042</td>
|
||||
<td style="text-align: center;"><blockquote>
|
||||
<p>发票起始号码</p>
|
||||
</blockquote></td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceNumEnd</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">23446000000000000043</td>
|
||||
<td style="text-align: center;">发票终止号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"applyNum": 2,</p>
|
||||
<p>"invoiceNumStart": "23446000000000000042",</p>
|
||||
<p>"invoiceNumEnd": "23446000000000000043"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
105
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企查询数电库存接口.md
Normal file
105
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企查询数电库存接口.md
Normal file
@ -0,0 +1,105 @@
|
||||
---
|
||||
title: 乐企查询数电库存接口
|
||||
aliases:
|
||||
- 乐企查询数电库存接口
|
||||
- 诺税通乐企查询数电库存接口
|
||||
- 库存票源与打印-乐企查询数电库存接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 乐企查询数电库存接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/fullStock/queryFullStock.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 乐企查询数电库存接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
用于查询数电发票库存
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/fullStock/queryFullStock.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:------------------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| **数据信息** | | | | | |
|
||||
| availableNum | Integer | 是 | 1 | 可用库存数量 | \- |
|
||||
| lockNum | Integer | 是 | 1 | 锁定库存数量 | \- |
|
||||
| applyTime | String | 是 | 2023-03-01 10:00:00 | 最后领用时间 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"availableNum": 1,</p>
|
||||
<p>"lockNum": 1,</p>
|
||||
<p>"applyTime": "2023-03-01 10:00:00"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
137
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备查询接口.md
Normal file
137
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备查询接口.md
Normal file
@ -0,0 +1,137 @@
|
||||
---
|
||||
title: 企业设备查询接口
|
||||
aliases:
|
||||
- 企业设备查询接口
|
||||
- 诺税通企业设备查询接口
|
||||
- 设备企业与配置-企业设备查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 企业设备查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`|`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 企业设备查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
与3.19相比返回增加了包括开票员id在内的全量设备信息，以票种+设备唯一返回
|
||||
|
||||
### 接口地址
|
||||
|
||||
| | |
|
||||
|:---|----|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/extensioninfo/queryExtensionList.do | |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **描述** | **最大长度** |
|
||||
| companyId | Long | 否 | 10162 | 公司id | |
|
||||
| taxnum | String | 是 | 150301199811285326 | 税号 | 20 |
|
||||
| extensionNum | String | 否 | 0 | 分机号 | 12 |
|
||||
| machineNum | String | 否 | 661565671900 | 机器号 | 12 |
|
||||
| invoiceLine | String | 否 | c | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | |
|
||||
| clerkId | String | 否 | 1 | 开票员id | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "companyId" :"10162",</p>
|
||||
<p> "taxnum" : "150301199811285326",</p>
|
||||
<p> "clerkId" : "1",</p>
|
||||
<p> "invoiceLine" : "c",</p>
|
||||
<p> "machineNum" : "661565671900",</p>
|
||||
<p> "extensionNum" : "0"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | | 成功 | | 详细信息 | 1024 |
|
||||
| data | Object | | | | 数据对象 | |
|
||||
| 数据信息 | | | | | | |
|
||||
| extensionId | Long | | 1373 | | extension设备表的主键 | |
|
||||
| InvoiceType | String | | c | | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) | |
|
||||
| extensionNum | Integer | | 0 | | 分机号 | 12 |
|
||||
| machineNum | String | | 661565671900 | | 机器编码 | 12 |
|
||||
| terminalNum | Integer | | 1 | | 终端号 | 10 |
|
||||
| serverType | Integer | | 14 | | 开票服务器类型 | |
|
||||
| reportTaxStatus | Integer | | 1 | | 报税状态 -1:未知 0:未抄报 1:已抄报 | |
|
||||
| clearCardStatus | Integer | | 1 | | 清卡状态 -1:未知 0:未清卡 1:已清卡 | |
|
||||
| lockDate | String | | 2022-06-15 | | 锁死日期 | |
|
||||
| singleBillingLimit | BigDecimal | | 999999.99 | | 单张开票限额 | |
|
||||
| offlineAmount | BigDecimal | | 9999999991.00 | | 离线剩余金额 | |
|
||||
| offlineTime | BigDecimal | | 720.00 | | 离线时限(h) | |
|
||||
| updateTime | String | | 2022-05-25 07:37:02 | | 更新时间 | |
|
||||
| clerkIds | String | | 1 | | 开票员id,多个用逗号隔开 | |
|
||||
| loginAccount | String | | | | 数电账号 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "code": 200,</p>
|
||||
<p> "message": "成功",</p>
|
||||
<p> "data": [</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceType": "c",</p>
|
||||
<p> "extensionNum": 0,</p>
|
||||
<p> "machineNum": "661565671900",</p>
|
||||
<p> "terminalNum": 1,</p>
|
||||
<p> "serverType": 14,</p>
|
||||
<p> "reportTaxStatus": 1,</p>
|
||||
<p> "clearCardStatus": 1,</p>
|
||||
<p> "lockDate": "2022-06-15",</p>
|
||||
<p> "singleBillingLimit": "999999.99",</p>
|
||||
<p> "offlineAmount": "9999999991.00",</p>
|
||||
<p> "offlineTime": "720.00",</p>
|
||||
<p> "updateTime": "2022-05-25 07:37:02",</p>
|
||||
<p> "clerkIds": "1"</p>
|
||||
<p> }</p>
|
||||
<p> ]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
178
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备状态查询接口.md
Normal file
178
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备状态查询接口.md
Normal file
@ -0,0 +1,178 @@
|
||||
---
|
||||
title: 企业设备状态查询接口
|
||||
aliases:
|
||||
- 企业设备状态查询接口
|
||||
- 诺税通企业设备状态查询接口
|
||||
- 设备企业与配置-企业设备状态查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 企业设备状态查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/extensioninfo/queryEquipmentStatusList.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：是
|
||||
> - 推荐优先级：P1（开票前保障）
|
||||
|
||||
|
||||
|
||||
## 企业设备状态查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
企业设备状态查询接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/extensioninfo/queryEquipmentStatusList.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| extensionNum | String | 选填 | 分机号 | 5 |
|
||||
| machineNumber | String | 选填 | 机器编号 | 12 |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": "0",</p>
|
||||
<p>"machineNumber": "123",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功则返回企业设备状态信息 | |
|
||||
| 企业设备状态 | | | | |
|
||||
| invoiceLine | String | 是 | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票 | |
|
||||
| reportTaxStatus | Integer | | 报税状态 -1:未知 0:未抄报 1:已抄报 | |
|
||||
| clearCardStatus | Integer | | 清卡状态 -1:未知 0:未清卡 1:已清卡 | |
|
||||
| lockDate | Date | | 锁死日期 | |
|
||||
| singleBillingLimit | BigDecimal | | 单张开票限额 | |
|
||||
| offlineAmount | BigDecimal | | 离线剩余金额 | |
|
||||
| offlineTime | BigDecimal | | 离线时限(h) | |
|
||||
| updateTime | Date | | 更新时间 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code":200,</p>
|
||||
<p> "message":"成功",</p>
|
||||
<p> "data":[</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceLine":"s",</p>
|
||||
<p> "lockDate":"2020-07-01",</p>
|
||||
<p> "reportTaxStatus":1,</p>
|
||||
<p> "clearCardStatus":-1,</p>
|
||||
<p> "offlineAmount":"111111111080.99",</p>
|
||||
<p> "offlineTime":"999.00",</p>
|
||||
<p> "singleBillingLimit":"100000000.00",</p>
|
||||
<p> "updateTime":"2020-11-25 01:00:01"</p>
|
||||
<p> },</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceLine":"c",</p>
|
||||
<p> "lockDate":"2020-07-01",</p>
|
||||
<p> "reportTaxStatus":1,</p>
|
||||
<p> "clearCardStatus":-1,</p>
|
||||
<p> "offlineAmount":"111111111019.60",</p>
|
||||
<p> "offlineTime":"999.00",</p>
|
||||
<p> "singleBillingLimit":"100000000.00",</p>
|
||||
<p> "updateTime":"2020-11-25 01:00:01"</p>
|
||||
<p> },</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceLine":"p",</p>
|
||||
<p> "lockDate":"2020-06-15",</p>
|
||||
<p> "reportTaxStatus":1,</p>
|
||||
<p> "clearCardStatus":-1,</p>
|
||||
<p> "offlineAmount":"320122.95",</p>
|
||||
<p> "offlineTime":"999.00",</p>
|
||||
<p> "singleBillingLimit":"9999.99",</p>
|
||||
<p> "updateTime":"2021-02-02 11:32:01"</p>
|
||||
<p> },</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceLine":"j",</p>
|
||||
<p> "lockDate":"2020-06-15",</p>
|
||||
<p> "reportTaxStatus":1,</p>
|
||||
<p> "clearCardStatus":-1,</p>
|
||||
<p> "offlineAmount":"999999999.00",</p>
|
||||
<p> "offlineTime":"999.00",</p>
|
||||
<p> "singleBillingLimit":"10000000.00",</p>
|
||||
<p> "updateTime":"2020-11-25 01:00:02"</p>
|
||||
<p> },</p>
|
||||
<p> {</p>
|
||||
<p> "invoiceLine":"r",</p>
|
||||
<p> "lockDate":"2020-06-15",</p>
|
||||
<p> "reportTaxStatus":1,</p>
|
||||
<p> "clearCardStatus":-1,</p>
|
||||
<p> "offlineAmount":"1111111.11",</p>
|
||||
<p> "offlineTime":"999.00",</p>
|
||||
<p> "singleBillingLimit":"10000000.00",</p>
|
||||
<p> "updateTime":"2020-11-25 01:00:02"</p>
|
||||
<p> }</p>
|
||||
<p> ]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code":900,</p>
|
||||
<p> "message":"不存在该设备抄报税信息",</p>
|
||||
<p> "data":null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,192 @@
|
||||
---
|
||||
title: 企业车架号等信息查询结果回传接口
|
||||
aliases:
|
||||
- 企业车架号等信息查询结果回传接口
|
||||
- 诺税通企业车架号等信息查询结果回传接口
|
||||
- 车辆辅助与回传-企业车架号等信息查询结果回传接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 企业车架号等信息查询结果回传接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`用户通过查询企业车架号、合格证状态接口中的callbackUrl字段提供回调地址。`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：是
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 企业车架号等信息查询结果回传接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
企业车架号等信息查询结果回传接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
用户通过查询企业车架号、合格证状态接口中的callbackUrl字段提供回调地址。
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** |
|
||||
| vehicleCode | String | 是 | 5656565 | 支持数字、字母、星号 | 车架号 |
|
||||
| sellerTaxnum | String | 是 | 338801999999001 | 必填 | 车架号所属企业税号，进项归集则需传购方企业税号 |
|
||||
| status | String | 是 | 1 | 必填 | 查询状态 1:查询成功，2：查询失败 |
|
||||
| certificate | String | 否 | 125999915630 | 非必填 | 合格证号 |
|
||||
| extensionNumber | integer | 否 | 123 | 非必填 | 分机号 |
|
||||
| machineCode | String | 否 | 123456789012 | 非必填 | 机器编号 |
|
||||
| terminalNum | String | 否 | 0 | 非必填 | 终端号 |
|
||||
| importCertifyNum | String | 否 | 343455555 | 非必填 | 进口证明书号（进口车才有） |
|
||||
| describe | String | 否 | | 非必填 | 描述信息 |
|
||||
| brandModel | String | 否 | | 非必填 | 厂牌型号 |
|
||||
| engineNum | String | 否 | | 非必填 | 发动机号码 |
|
||||
| vehicleType | String | 否 | | 非必填 | 车辆类型 |
|
||||
| inspectionOddNum | String | 否 | \- | 非必填 | 商检单号 |
|
||||
| productOrigin | String | 否 | 上海 | 非必填 | 产地 |
|
||||
| requestSrc | String | 是 | 3 | 必填 | 请求来源(0:未知;1-页面添加;2-页面导入;3-api进项调用;4-api用户调用;) |
|
||||
| vehicleStatus | String | 是 | 1 | 必填 | 车架号状态：1-可开票;3-未知;4-不可开票 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
查询成功回调（表示该车架号可开票）：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"vehicleCode": "5656565",</p>
|
||||
<p>"sellerTaxnum": "338801999999001",</p>
|
||||
<p>"certificate": "125999915630",</p>
|
||||
<p>"status": "1",</p>
|
||||
<p>"extensionNumber": "123",</p>
|
||||
<p>"machineCode": "123456789012",</p>
|
||||
<p>"importCertifyNum": "343455555",</p>
|
||||
<p>"describe": "机动车合格证号可用",</p>
|
||||
<p>"brandModel": "",</p>
|
||||
<p>"engineNum": "",</p>
|
||||
<p>"vehicleType": "",</p>
|
||||
<p>"inspectionOddNum": "",</p>
|
||||
<p>"productOrigin": "",</p>
|
||||
<p>"requestSrc": "4",</p>
|
||||
<p>"vehicleStatus": "1"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
查询失败回调（表示该车架号不可开票）：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"vehicleCode": "5656565",</p>
|
||||
<p>"sellerTaxnum": "338801999999001",</p>
|
||||
<p>"certificate": "125999915630",</p>
|
||||
<p>"status": "2",</p>
|
||||
<p>"describe": "合格证存在，不属于本企业",</p>
|
||||
<p>"requestSrc": "4",</p>
|
||||
<p>"vehicleStatus": "4"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
【describe】字段文案包含：
|
||||
|
||||
1、合格证已被使用
|
||||
|
||||
2、查询到合格证信息已使用，不允许开具发票
|
||||
|
||||
3、未查询到合格证信息，不允许开具发票
|
||||
|
||||
|
||||
4、合格证存在，不属于本企业！
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 12%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 14%" />
|
||||
<col style="width: 24%" />
|
||||
<col style="width: 9%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必须</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>更多限制</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>最大长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">code</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">0000</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"><p>状态,0000-成功，</p>
|
||||
<p>非0000-失败</p></td>
|
||||
<td style="text-align: left;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">message</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">成功</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">详细信息</td>
|
||||
<td style="text-align: left;">1024</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回示例
|
||||
|
||||
示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 0000,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,132 @@
|
||||
---
|
||||
title: 创建/查询企业车架号、合格证状态接口
|
||||
aliases:
|
||||
- 创建/查询企业车架号、合格证状态接口
|
||||
- 诺税通创建/查询企业车架号、合格证状态接口
|
||||
- 车辆辅助与回传-创建/查询企业车架号、合格证状态接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 创建/查询企业车架号、合格证状态接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/query/vehicleCodeIsInvoice.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 创建/查询企业车架号、合格证状态接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
仅用于请求车架号在税局的是否可开票状态，改接口返回成功仅说明提交查询请求成功，因需和税局交互，故需异步通过查询或回调获取查询结果。请求成功的数据可至诺税通-库存管理-车辆库存中查看。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/query/vehicleCodeIsInvoice.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| vehicleCode | String | 是 | 5656565 | 支持数字、字母、星号 | 车架号 | 23 |
|
||||
| sellerTaxnum | String | 是 | 338801999999001 | 必填 | 车架号所属企业税号，进项归集则需传购方企业税号 | 20 |
|
||||
| certificate | String | 否 | 125999915630 | 非必填 | 合格证号 | 50 |
|
||||
| vehicle Type | String | 否 | 辉腾 | 非必填 | 车辆类型 | 40 |
|
||||
| brandModel | String | 否 | 大众 | 非必填 | 厂牌型号 | 60 |
|
||||
| warehouse | String | 否 | 上海 | 非必填 | 所在仓库 | 50 |
|
||||
| extensionNum | String | 否 | 0 | 非必填 | 分机号 | 5 |
|
||||
| machineNumber | String | 否 | 1234565654 | 非必填 | 机器编号 | 12 |
|
||||
| terminalNum | String | 否 | 0 | 非必填 | 终端号 | 12 |
|
||||
| engineNum | String | 否 | 21166621 | 非必填 | 发动机号码 | 50 |
|
||||
| importCertifyNum | String | 否 | 343455555 | 非必填 | 进口证明书号 | 36 |
|
||||
| inspectionOddNum | String | 否 | \- | 非必填 | 商检单号 | 32 |
|
||||
| productOrigin | String | 否 | \- | 非必填 | 产地 | 32 |
|
||||
| displacement | String | 否 | | 非必填 | 排量 | 50 |
|
||||
| callbackUrl | String | 否 | http://127.0.0.1:8080/ | 当请求来源不是3时，必填 | 回调地址 | 255 |
|
||||
| requestSrc | String | 否 | 4 | 非必填 | 请求来源(0:未知;1-页面添加;2-页面导入;3-api进项调用;4-api用户调用;)默认为4 | 1 |
|
||||
| refreshFlag | String | 否 | 1 | 非必填 | 刷新标记。(0:不需要调用电票进行刷新;1-需要调用)默认为1 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"vehicleCode": "5656565",</p>
|
||||
<p>"sellerTaxnum": "338801999999001",</p>
|
||||
<p>"certificate": "125999915630",</p>
|
||||
<p>"callbackUrl": "http://127.0.0.1:8080/"，</p>
|
||||
<p>"brandModel": "品牌型号"，</p>
|
||||
<p>"warehouse": "上海"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 提交成功 | | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "提交成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 3001,</p>
|
||||
<p>"message": "结果查询中，请稍候重试"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
230
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建开票设备接口.md
Normal file
230
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建开票设备接口.md
Normal file
@ -0,0 +1,230 @@
|
||||
---
|
||||
title: 创建开票设备接口
|
||||
aliases:
|
||||
- 创建开票设备接口
|
||||
- 诺税通创建开票设备接口
|
||||
- 设备企业与配置-创建开票设备接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 创建开票设备接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/extensioninfo/insertExtension.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 创建开票设备接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
新增开票设备接口,开票设备唯一性规则：当开票员存在时 同一个开票员+开票设备+票种唯一，当不存在开票员时，针对数电设备分机号或登录账号不可重复，针对其他设备，机器编号不可重复。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/extensioninfo/insertExtension.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 10%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">企业税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">分机号 0--65535数字</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">terminalNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">终端号</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">machineNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">机器编号 非数电设备必填</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">serverType</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>开票服务器类型 传对应的数字枚举</p>
|
||||
<p>1:C48,</p>
|
||||
<p>11:诺诺开票,</p>
|
||||
<p>14：A9,</p>
|
||||
<p>15:四川税局代开,</p>
|
||||
<p>17:诺诺机柜,</p>
|
||||
<p>18:税控服务器,</p>
|
||||
<p>20:单机版,</p>
|
||||
<p>22:数电发票开票模式（通用版）,</p>
|
||||
<p>24:数电发票开票模式（单机版）,</p>
|
||||
<p>25:数电发票开票模式（机柜版）</p>
|
||||
<p>数电单机版和机柜版暂只支持半本地环境</p></td>
|
||||
<td style="text-align: center;">4</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">loginAccount</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">数电开票账号 开票服务器类型为数电时必传</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">elePassword</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">数电开票密码，使用aes加密 开票服务器类型为数电时必传</td>
|
||||
<td style="text-align: center;">加密前1-20位</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">equipmentCabinetId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">机柜序列号 当服务器类型为诺诺机柜时必传</td>
|
||||
<td style="text-align: center;">30</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxMachinePwd</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">设备证书口令 当服务器类型为诺诺机柜时必传</td>
|
||||
<td style="text-align: center;">35</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxPlatPwd</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">设备口令 当服务器类型为诺诺机柜时必传</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">serverAddress</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">服务器地址 当开票服务为A9或C48时必传</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceTypelist</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>当前设备可开发票种类，使用,隔开</p>
|
||||
<p>p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)</p></td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">clerkList</td>
|
||||
<td style="text-align: center;">List<Long></td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票员userId集合 当设备需要绑定开票员时必传</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">projectList</td>
|
||||
<td style="text-align: center;">List<String></td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">项目编码集合 当设备需要绑定设备信息时必传</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxnum": "150301199811285326",</p>
|
||||
<p>"projectList": ["BJ01-002","20221008"],</p>
|
||||
<p>"serverType": 14,</p>
|
||||
<p>"extensionNum": "5",</p>
|
||||
<p>"machineNum": "123456987456",</p>
|
||||
<p>"terminalNum": "5",</p>
|
||||
<p>"serverAddress": "123456",</p>
|
||||
<p>"clerkList": [8,7],</p>
|
||||
<p>"companName": "移动测试盘326",</p>
|
||||
<p>"invoiceTypelist": "b,s,p,c"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | String | 是 | 123456789 | 当前新增设备的唯一标识 | 20 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": "123456789"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
117
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/删除发票信息接口.md
Normal file
117
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/删除发票信息接口.md
Normal file
@ -0,0 +1,117 @@
|
||||
---
|
||||
title: 删除发票信息接口
|
||||
aliases:
|
||||
- 删除发票信息接口
|
||||
- 诺税通删除发票信息接口
|
||||
- 车辆辅助与回传-删除发票信息接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 删除发票信息接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/invoiceList/delete.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 删除发票信息接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
支持开票失败状态发票删除以及开票中状态发票撤回,传入订单编号删除时支持删除审核开票记录。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|-----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/invoiceList/delete.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| valueType | Integer | 是 | 值类型：0：发票流水号，1：订单编号 | \- |
|
||||
| value | String | 是 | 若值类型为0，value为发票流水号的值；若值类型为1，value为订单编号的值 | \- |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"value": "21051310255001000228",</p>
|
||||
<p>"valueType": 0</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code":200,</p>
|
||||
<p> "message":"成功",</p>
|
||||
<p> "data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 900,</p>
|
||||
<p>"message": "非开票失败、开票中状态的发票信息不允许删除",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
118
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新可下载发票库存接口.md
Normal file
118
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新可下载发票库存接口.md
Normal file
@ -0,0 +1,118 @@
|
||||
---
|
||||
title: 刷新可下载发票库存接口
|
||||
aliases:
|
||||
- 刷新可下载发票库存接口
|
||||
- 诺税通刷新可下载发票库存接口
|
||||
- 库存票源与打印-刷新可下载发票库存接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 刷新可下载发票库存接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/stock/flushDownloadableStock.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 刷新可下载发票库存接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
从税局获取局端可下载发票的信息，仅支持开票服务器类型为诺诺机柜和诺诺开票。控制一分钟之内只能操作一次,请勿频繁操作。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/stock/flushDownloadableStock.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 是 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 是 | 机器编号，12位数字 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 900,</p>
|
||||
<p>"message": "一分钟之内只能操作一次,请勿频繁操作",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,118 @@
|
||||
---
|
||||
title: 刷新获取开票设备实时发票库存接口
|
||||
aliases:
|
||||
- 刷新获取开票设备实时发票库存接口
|
||||
- 诺税通刷新获取开票设备实时发票库存接口
|
||||
- 库存票源与打印-刷新获取开票设备实时发票库存接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 刷新获取开票设备实时发票库存接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/stock/refreshLocalStock.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 刷新获取开票设备实时发票库存接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
触发刷新获取税盘实时库存接口，仅下发查询指令，需配合库存余量查询接口获取刷新后的实时库存。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/stock/refreshLocalStock.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 否 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 否 | 机器编号，12位数字 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 900,</p>
|
||||
<p>"message": "未找到设备！",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,118 @@
|
||||
---
|
||||
title: 刷新获取税盘实时成品油库存接口
|
||||
aliases:
|
||||
- 刷新获取税盘实时成品油库存接口
|
||||
- 诺税通刷新获取税盘实时成品油库存接口
|
||||
- 专项能力-刷新获取税盘实时成品油库存接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 刷新获取税盘实时成品油库存接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/oilStock/refreshProductOil.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 刷新获取税盘实时成品油库存接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
刷新成品油库存接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/oilStock/refreshProductOil.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 是 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 否 | 机器编号，12位数字 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 913,</p>
|
||||
<p>"message": "不支持的开票服务器类型！",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
181
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票交付.md
Normal file
181
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票交付.md
Normal file
@ -0,0 +1,181 @@
|
||||
---
|
||||
title: 发票交付
|
||||
aliases:
|
||||
- 发票交付
|
||||
- 诺税通发票交付
|
||||
- 开票主链路-发票交付
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 发票交付
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[02_开票主链路]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../02_开票主链路.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[02_开票主链路]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/invoice/delivery.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：是
|
||||
> - 推荐优先级：P1
|
||||
|
||||
|
||||
|
||||
## 发票交付
|
||||
|
||||
### 接口说明
|
||||
|
||||
发票交付接口，用于提供给企业对诺税通中开具的发票进行交付，具体的短信、邮件发送通道根据不同企业配置决定。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:--------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/invoice/delivery.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 23%" />
|
||||
<col style="width: 13%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 24%" />
|
||||
<col style="width: 16%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必须</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>最大长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">sellerTaxnum</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">150301199811285326</td>
|
||||
<td style="text-align: left;">销方税号；销方税号和销方组织编码其一必填</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">sellerCompanyCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">10162</td>
|
||||
<td style="text-align: left;">销方组织编码；销方税号和销方组织编码其一必填</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">050001901011</td>
|
||||
<td style="text-align: left;">发票代码12或10位</td>
|
||||
<td style="text-align: left;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceNumber</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">93693692</td>
|
||||
<td style="text-align: left;"><p>发票号码</p>
|
||||
<p>8或20位</p></td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: center;">交付手机号码；交付电话号码和交付邮箱至少有一个不为空，仅支持一个</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: center;">交付邮箱地址；交付电话号码和交付邮箱至少有一个不为空，仅支持一个</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">250</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求实例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"sellerCompanyCode": "",</p>
|
||||
<p>"invoiceCode": "",</p>
|
||||
<p>"invoiceNumber": "93693692",</p>
|
||||
<p>"notifyPhone": "15669968255",</p>
|
||||
<p>"notifyEmail": "zhuyihui@nnuo.com"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
146
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票作废申请接口.md
Normal file
146
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票作废申请接口.md
Normal file
@ -0,0 +1,146 @@
|
||||
---
|
||||
title: 发票作废申请接口
|
||||
aliases:
|
||||
- 发票作废申请接口
|
||||
- 诺税通发票作废申请接口
|
||||
- 作废重开与冲红-发票作废申请接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 发票作废申请接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/invalid-oneInvoice.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：是
|
||||
> - 推荐优先级：P1
|
||||
|
||||
|
||||
|
||||
## 发票作废申请接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
申请发票作废。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/invalid-oneInvoice.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| invoiceId | String | 是 | 18081620564001000232 | 必填 | 发票请求流水号 | 20 |
|
||||
| sellerTaxnum | String | 否 | 339901999999610 | 企业税号和组织编码必填其一 | 发票对应的销方企业税号 | 20 |
|
||||
| companyCode | String | 否 | | 企业税号和组织编码必填其一 | 组织编码 | 20 |
|
||||
| invoiceCode | String | 是 | 125999915630 | 必填 | 对应发票代码 | 12 |
|
||||
| invoiceNumber | String | 是 | 00130865 | 必填 | 对应发票号码 | 8 |
|
||||
| invalidReason | Integer | 否 | | 数电纸票时需要传（1:销货退回;2:开票有误;3:服务中止;4:其他），默认 2 | 作废原因 | 1 |
|
||||
| specificReason | String | 否 | | 数电纸票且作废原因选择4-其他时需要传 | 其他作废原因详情 | 255 |
|
||||
| columnFirst | String | 否 | 退货单号123 | 否 | 自定义列1 | |
|
||||
| columnSecond | String | 否 | 退货单号123 | 否 | 自定义列2 | |
|
||||
| columnThree | String | 否 | 退货单号123 | 否 | 自定义列3 | |
|
||||
| <span id="_Toc14732" class="anchor"></span>invalidUserCode | String | 否 | 123 | 否 | 作废操作人用户编码，优先使用操作人id | 20 |
|
||||
| invalidUserId | Long | 否 | 1 | 否 | 作废操作人ID | 11 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"invoiceId": "18081620564001000232",</p>
|
||||
<p>"sellerTaxnum": "339901999999610",</p>
|
||||
<p>"invoiceCode": "125999915630",</p>
|
||||
<p>"invoiceNumber": "00130865"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 作废成功 | | 详细信息 | 1024 |
|
||||
| data | String | 是 | 18081620564001000232 | | 提交成功则返回发票请求流水号 | 32 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "作废成功",</p>
|
||||
<p>"data": "18081620564001000232"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 9151,</p>
|
||||
<p>"message": "非当月纸票不能作废"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 状态码说明
|
||||
|
||||
| | |
|
||||
|:----------:|:---------------------------------------------------------:|
|
||||
| **状态码** | **描述** |
|
||||
| 2733 | 发票不存在 |
|
||||
| 2739 | 开票未完成，不可进行作废 |
|
||||
| 2740 | 电票暂不支持作废 |
|
||||
| 2741 | 发票被冲红不支持作废 |
|
||||
| 2743 | 非当月发票不支持作废 |
|
||||
| 2744 | 不支持重复作废 |
|
||||
| 2749 | 发票已经作废 |
|
||||
| 2751 | 企业税号不能为空 |
|
||||
| 2755 | 入参invoiceId不能为空 |
|
||||
| 2756 | 入参invoiceCode不能为空 |
|
||||
| 2757 | 入参invoiceNumber不能为空 |
|
||||
| 2758 | 入参invoiceId查询的发票记录中发票代码和入参发票代码不匹配 |
|
||||
| 2759 | 入参invoiceId查询的发票记录中发票号码和入参发票号码不匹配 |
|
||||
2057
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票列表查询接口.md
Normal file
2057
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票列表查询接口.md
Normal file
File diff suppressed because it is too large
Load Diff
146
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票库存余量查询接口.md
Normal file
146
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票库存余量查询接口.md
Normal file
@ -0,0 +1,146 @@
|
||||
---
|
||||
title: 发票库存余量查询接口
|
||||
aliases:
|
||||
- 发票库存余量查询接口
|
||||
- 诺税通发票库存余量查询接口
|
||||
- 库存票源与打印-发票库存余量查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 发票库存余量查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/queryStockInfoList.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：是
|
||||
> - 推荐优先级：P1（开票前保障）
|
||||
|
||||
|
||||
|
||||
## 发票库存余量查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
查询开票设备的发票库存余量。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/queryStockInfoList.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **其他说明** | **描述** | **长度** |
|
||||
| extensionNum | String | 否 | | 分机号 | 5 |
|
||||
| machineNumber | String | 否 | | 机器编号 | 12 |
|
||||
| sellerTaxnum | String | 否 | 销方税号、销方公司编码、销方公司名字三个必填其一 | 销方税号 | 20 |
|
||||
| sellerCompanyCode | String | 否 | 销方税号、销方公司编码、销方公司名字三个必填其一 | 销方公司编码 | 20 |
|
||||
| sellerCompanyName | String | 否 | 销方税号、销方公司编码、销方公司名字三个必填其一 | 销方公司名字 | 100 |
|
||||
| searchRange | Integer | 否 | | 查询范围,0:全部,1:仅在诺税通开票设备中维护的设备余量信息;默认0 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "extensionNum": "0",</p>
|
||||
<p> "machineNumber": "661565671900",</p>
|
||||
<p> "sellerTaxnum": "150301199811285326",</p>
|
||||
<p> "sellerCompanyName":"移动测试盘326",</p>
|
||||
<p> "sellerCompanyCode" : "1100"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功则返回红字申请信息 | |
|
||||
| 库存信息 | | | | |
|
||||
| sellerTaxnum | String | | 销方税号 | |
|
||||
| extensionNum | Integer | | 分机号 | |
|
||||
| machineNumber | String | | 机器编号 | |
|
||||
| stocks | List | | 库存信息列表 | |
|
||||
| 库存明细 | | | | |
|
||||
| terminalNum | Integer | | 终端号 | |
|
||||
| invoiceLine | String | | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票 | |
|
||||
| invoiceCode | String | | 发票代码 | |
|
||||
| invoiceNumStart | String | | 起始号码 | |
|
||||
| inoviceNumEnd | String | | 终止号码 | |
|
||||
| remainNum | Integer | | 剩余分数 | |
|
||||
| isDefault | Integer | | 是否默认卷：1-是 0-否(默认) | |
|
||||
| createTime | Date | | 更新时间 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": null,</p>
|
||||
<p>"stocks": [</p>
|
||||
<p>{</p>
|
||||
<p>"terminalNum": 0,</p>
|
||||
<p>"invoiceLine": "s",</p>
|
||||
<p>"invoiceCode": "5000201530",</p>
|
||||
<p>"invoiceNumStart": "71895758",</p>
|
||||
<p>"invoiceNumEnd": "0",</p>
|
||||
<p>"remainNum": 0,</p>
|
||||
<p>"createTime": "2021-06-04 17:20:24"</p>
|
||||
<p>},</p>
|
||||
<p>{</p>
|
||||
<p>"terminalNum": 0,</p>
|
||||
<p>"invoiceLine": "s",</p>
|
||||
<p>"invoiceCode": "5000201530",</p>
|
||||
<p>"invoiceNumStart": "85199644",</p>
|
||||
<p>"invoiceNumEnd": "0",</p>
|
||||
<p>"remainNum": 0,</p>
|
||||
<p>"createTime": "2021-06-04 17:20:24"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
186
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票重开接口.md
Normal file
186
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票重开接口.md
Normal file
@ -0,0 +1,186 @@
|
||||
---
|
||||
title: 发票重开接口
|
||||
aliases:
|
||||
- 发票重开接口
|
||||
- 诺税通发票重开接口
|
||||
- 作废重开与冲红-发票重开接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 发票重开接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/reInvoice.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 发票重开接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
当请求诺税通开具的发票返回开票失败时，可通过调用该接口触发开票失败的发票数据重新发起开票。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|--------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/reInvoice.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 22%" />
|
||||
<col style="width: 13%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 38%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>销方税号</p>
|
||||
<p>企业税号和组织编码必填其一</p></td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">companyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>组织编码</p>
|
||||
<p>企业税号和组织编码必填其一</p></td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">发票流水号(invoiceId和orderNo任一必填)</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">orderNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">订单号(invoiceId和orderNo任一必填)</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">nextInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>下一张发票代码</p>
|
||||
<p>支持票种：c普通发票（纸质）f收购发票（纸质）</p>
|
||||
<p>指定发票卷重开时必传</p></td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">nextInvoiceNum</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"><p>下一张发票号码</p>
|
||||
<p>支持票种：c普通发票（纸质）f收购发票（纸质）</p>
|
||||
<p>当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一必填</p></td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceNumEnd</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"><p>发票终止号码</p>
|
||||
<p>支持票种：c普通发票（纸质）f收购发票（纸质）</p>
|
||||
<p>当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一必填</p></td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"invoiceId": "21031114572601000143",</p>
|
||||
<p>"orderNo": "21031114572601000143",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"nextInvoiceNum": "1234456",</p>
|
||||
<p>"nextInvoiceCode": "123456"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 2733,</p>
|
||||
<p>"message": "该发票不存在"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
140
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/审核开票删除回传接口.md
Normal file
140
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/审核开票删除回传接口.md
Normal file
@ -0,0 +1,140 @@
|
||||
---
|
||||
title: 审核开票删除回传接口
|
||||
aliases:
|
||||
- 审核开票删除回传接口
|
||||
- 诺税通审核开票删除回传接口
|
||||
- 车辆辅助与回传-审核开票删除回传接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 审核开票删除回传接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`用户通过开票请求中的bizCallbackUrl字段提供回调地址。`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：是
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 审核开票删除回传接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
返回审核开票删除信息的订单编号和税号等信息
|
||||
|
||||
注意：请按照文档要求提供接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
用户通过开票请求中的bizCallbackUrl字段提供回调地址。
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **描述** | **最大长度** |
|
||||
| orderNo | String | 是 | 20220426094552511469 | 订单编号 | 64 |
|
||||
| sellerTaxnum | String | 是 | 150301199811285326 | 销方税号 | 20 |
|
||||
| invoiceStatus | Integer | 是 | 6 | 发票处理结果: 6：审核开票删除 | 1 |
|
||||
| formId | String | 否 | CB00696BD1094735849897E66029AB45 | 流程审批单id,回传给oa时必须 | 50 |
|
||||
| formType | int | 否 | 2 | 流程类型（1：用印申请,2:蓝票开具申请,3:红票开具申请,4:发票作废申请）,回传给oa时必须 | |
|
||||
| deleteDate | String | 是 | 2022-04-26 14:45:30 | 删除时间yyyy-MM-dd HH:mm:ss格式 | |
|
||||
| deleteUserId | long | 是 | 1 | 删除操作人id | |
|
||||
| deleteUserName | String | 是 | 张三 | 删除操作人名称 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"deleteDate":"2022-04-29 15:51:39",</p>
|
||||
<p>"deleteUserId":1,</p>
|
||||
<p>"deleteUserName":"张三",</p>
|
||||
<p>"formId":"7BCB5E90EAF64B9C903D920BF82591E4",</p>
|
||||
<p>"formType":2,</p>
|
||||
<p>"orderNo":"20220425091325328406",</p>
|
||||
<p>"sellerTaxnum":"150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 12%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 16%" />
|
||||
<col style="width: 30%" />
|
||||
<col style="width: 17%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必须</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>最大长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">code</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">200</td>
|
||||
<td style="text-align: left;"><p>状态,0000或200-成功，</p>
|
||||
<p>非0000，非200-失败</p></td>
|
||||
<td style="text-align: left;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">message</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">成功</td>
|
||||
<td style="text-align: left;">详细信息</td>
|
||||
<td style="text-align: left;">1024</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回示例
|
||||
|
||||
示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
620
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传.md
Normal file
620
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传.md
Normal file
@ -0,0 +1,620 @@
|
||||
---
|
||||
title: 开票结果回传
|
||||
aliases:
|
||||
- 开票结果回传
|
||||
- 诺税通开票结果回传
|
||||
- 开票主链路-开票结果回传
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 开票结果回传
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[02_开票主链路]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../02_开票主链路.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[02_开票主链路]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`用户通过开票请求中的bizCallbackUrl字段提供回调地址。`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：是
|
||||
> - 是否主链路：是
|
||||
> - 推荐优先级：P0（如采用回调模式）
|
||||
|
||||
|
||||
|
||||
## 开票结果回传
|
||||
|
||||
### 接口说明
|
||||
|
||||
返回开票申请结果。
|
||||
|
||||
注意：请按照文档要求提供接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
用户通过开票请求中的bizCallbackUrl字段提供回调地址。
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 12%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 14%" />
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必须</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>更多限制</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>最大长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">orderNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">订单编号</td>
|
||||
<td style="text-align: left;">64</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">sellerTaxnum</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">339901999999610</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">销方税号</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceId</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">20011617430401068182</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票流水号</td>
|
||||
<td style="text-align: left;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">successFlag</td>
|
||||
<td style="text-align: left;">boolean</td>
|
||||
<td style="text-align: left;">是</td>
|
||||
<td style="text-align: left;">true</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">True:开票成功；false：开票失败</td>
|
||||
<td style="text-align: left;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">vehicleFlag</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">0</td>
|
||||
<td style="text-align: left;">可不填，默认0</td>
|
||||
<td style="text-align: left;">0：非机动车。1：机动车</td>
|
||||
<td style="text-align: left;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">productOilFlag</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">0</td>
|
||||
<td style="text-align: left;">可不填，默认0</td>
|
||||
<td style="text-align: left;">成品油标志：0非成品油，1成品油，默认为0</td>
|
||||
<td style="text-align: left;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceStatus</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"><p>发票处理结果: 1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功。</p>
|
||||
<p>结果处于开票成功、 开票失败、作废成功、作废失败，开票失败删除成功触发回传</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">errorMessage</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">[9999]HX1000 4003-发票数据写盘失败[TCD_769_25,离线发票累计金额超限！],发票代码或号码为空</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">开票异常信息</td>
|
||||
<td style="text-align: left;">128</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">pdfUrl</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">https://inv.jss.com.cn/group1/M00/A6/4C/wKgHPll_IU-AVELfAACNq5bmzFM769.pdf</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票pdf地址，仅开票成功且版式文件为pdf时返回</td>
|
||||
<td style="text-align: left;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">paperPdfUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">纸票pdf地址（含底图）</td>
|
||||
<td style="text-align: center;">256</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">imageUrl</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票jpg地址，清单票发票主信息与清单信息以”,”隔开，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ofdUrl</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票ofd地址，仅开票成功且版式文件为ofd时返回</td>
|
||||
<td style="text-align: left;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">orderDate</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">2022-05-12</td>
|
||||
<td style="text-align: left;">年-月-日</td>
|
||||
<td style="text-align: left;">订单日期</td>
|
||||
<td style="text-align: left;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">deliverDate</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">2022-05-12</td>
|
||||
<td style="text-align: left;">年-月-日</td>
|
||||
<td style="text-align: left;">发货日期</td>
|
||||
<td style="text-align: left;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceTime</td>
|
||||
<td style="text-align: left;">Date</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">1604576878000</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">开票日期，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">13</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invalidTime</td>
|
||||
<td style="text-align: center;">Date</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">1615985882000</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">作废日期，仅作废成功后返回</td>
|
||||
<td style="text-align: center;">13</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">125999915630</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票代码，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceNumber</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">00130865</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票号码，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">allElectronicInvoiceNumber</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">数电发票号码，仅数电发票（电票+纸票）开票成功会返回</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">红票对应的蓝票发票代码</td>
|
||||
<td style="text-align: left;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">红票对应的蓝票发票号码</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oldEleInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">红票对应的蓝票数电发票号码</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">billNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">红字申请流水号，仅红字专票返回</td>
|
||||
<td style="text-align: left;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">billInfoNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">红字申请表编号，仅红字专票返回</td>
|
||||
<td style="text-align: left;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">taxFreeAmountTotal</td>
|
||||
<td style="text-align: left;">BigDecimal</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">不含税金额，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">taxTotal</td>
|
||||
<td style="text-align: left;">BigDecimal</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">税额，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">taxAmountTotal</td>
|
||||
<td style="text-align: left;">BigDecimal</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">含税金额，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">buyerName</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">浙江爱信诺</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">购方名称，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">buyerTaxnum</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">339901999999103</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">购方税号，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">sellerName</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">浙江爱信诺</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">销方名称，仅开票成功会返回</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invoiceLine</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">1</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j:机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) 仅开票成功会返回</td>
|
||||
<td style="text-align: left;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">columnFirst</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">有值就回传</td>
|
||||
<td style="text-align: center;">企业开票时传入自定义字段1</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">columnSecond</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">有值就回传</td>
|
||||
<td style="text-align: center;">企业开票时传入自定义字段2</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">columnThree</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">有值就回传</td>
|
||||
<td style="text-align: center;">企业开票时传入自定义字段3</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">requestSrc</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">开票方式,0:api接口 1:手工开票 2:批量导入 5:本地提取</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">mailNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">快递单号</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">businessType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">枚举值来源为基础字典配置</td>
|
||||
<td style="text-align: center;">业务类型</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">relatedState</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">有值就回传</td>
|
||||
<td style="text-align: center;">关联状态(0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败)</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">buyerManagerName</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">购买方经办人姓名，数电特有字段</td>
|
||||
<td style="text-align: left;">16</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">managerCardType</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: center;">101-组织机构代码证,102-营业执照,103-税务登记证, 199-其他单位证件, 201-居民身份证, 202-军官证, 203-武警警官证, 204-士兵证, 205-军队离退休干部证, 206-残疾人证, 207-残疾军人证（1-8级）, 208-外国护照, 210-港澳居民来往内地通行证, 212-中华人民共和国往来港澳通行证, 213-台湾居民来往大陆通行证, 214-大陆居民往来台湾通行证, 215-外国人居留证, 216-外交官证 299-其他个人证件</td>
|
||||
<td style="text-align: left;">经办人证件类型数电特有字段</td>
|
||||
<td style="text-align: left;">40</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">managerCardNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">经办人证件号码数电特有字段，证件类型有值时必填</td>
|
||||
<td style="text-align: left;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">billId</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">仅数电红票回传</td>
|
||||
<td style="text-align: left;">红字确认单流水号</td>
|
||||
<td style="text-align: left;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">billConfirmNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">仅数电红票回传</td>
|
||||
<td style="text-align: left;">红字确认单编号</td>
|
||||
<td style="text-align: left;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">billUuid</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">仅数电红票回传</td>
|
||||
<td style="text-align: left;">红字确认单UUID</td>
|
||||
<td style="text-align: left;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">specificFactor</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"><p>特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具</p>
|
||||
<p>35 矿产品发票</p></td>
|
||||
<td style="text-align: left;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">invalidReason</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">数电纸票作废原因 1:销货退回;2:开票有误;3:服务中止;4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）</td>
|
||||
<td style="text-align: left;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">specificReason</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;">其他作废原因详情（作废原因为4 且回传其他信息时返回）</td>
|
||||
<td style="text-align: left;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">subjectAccountCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">T123</td>
|
||||
<td style="text-align: left;">核算主体编码</td>
|
||||
<td style="text-align: left;">维护在诺税通的“核算主体编码”</td>
|
||||
<td style="text-align: left;">200</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">subjectAccount</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">核算主体名称</td>
|
||||
<td style="text-align: left;">核算主体名称</td>
|
||||
<td style="text-align: left;">核算主体名称</td>
|
||||
<td style="text-align: left;">200</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">redReason</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">1</td>
|
||||
<td style="text-align: left;">1：销售退回2：开票有误3：服务终止4：销售折让</td>
|
||||
<td style="text-align: left;">冲红原因</td>
|
||||
<td style="text-align: left;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">naturalPersonFlag</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">0</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: center;">购买方自然人标志：0-否（默认）、1-是</td>
|
||||
<td style="text-align: left;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;"><span id="_Toc30139" class="anchor"></span>customerCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: left;"></td>
|
||||
<td style="text-align: center;">客户编码</td>
|
||||
<td style="text-align: left;">64</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"buyerName":"个人",</p>
|
||||
<p>"buyerTaxnum":"339901999999142",</p>
|
||||
<p>"imageUrl":"",</p>
|
||||
<p>"invoiceCode":"131880930610",</p>
|
||||
<p>"invoiceId":"20111014474101989690",</p>
|
||||
<p>"invoiceLine":"p",</p>
|
||||
<p>"invoiceNumber":"61001098",</p>
|
||||
<p>"invoiceTime":1604994991000,</p>
|
||||
<p>"orderNo":"20170104120207971529",</p>
|
||||
<p>"pdfUrl":"https://invtest.nntest.cn/fp/tKhNlLpWjoP84chMYndBjLxrATHP7jJAEK71fHqOJVpzR7q39iU4mBTNBtjfHAANtFoj04OLAjWzfbYJIJhzhA.pdf",</p>
|
||||
<p>"sellerName":"演示公司",</p>
|
||||
<p>"successFlag":true,</p>
|
||||
<p>"taxAmountTotal":1.09,</p>
|
||||
<p>"taxFreeAmountTotal":0.09,</p>
|
||||
<p>"sellerTaxnum":"339901999999610",</p>
|
||||
<p>"taxTotal":0.01,</p>
|
||||
<p>"taxOfficeCode":"税务机关代码",</p>
|
||||
<p>"intactCertificateNum":"税务机关名称",</p>
|
||||
<p>"organizationCode":"完整凭证号码",</p>
|
||||
<p>"mailNo":"SF67263555514",</p>
|
||||
<p>"relatedState":2,</p>
|
||||
<p>"customerCode":"263555514"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | String | 是 | 0000 | | 状态码，字符串”0000”表示成功，非”0000”的字符串表示失败 | 6 |
|
||||
| message | String | 是 | 同步成功 | | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": "0000",</p>
|
||||
<p>"message": "业务方接收同步成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": "9999",</p>
|
||||
<p>"message": "同步失败的异常信息"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
1825
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传_含明细.md
Normal file
1825
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传_含明细.md
Normal file
File diff suppressed because it is too large
Load Diff
1995
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果查询接口.md
Normal file
1995
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果查询接口.md
Normal file
File diff suppressed because it is too large
Load Diff
2056
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票请求接口.md
Normal file
2056
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票请求接口.md
Normal file
File diff suppressed because it is too large
Load Diff
106
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/录入自定义字段.md
Normal file
106
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/录入自定义字段.md
Normal file
@ -0,0 +1,106 @@
|
||||
---
|
||||
title: 录入自定义字段
|
||||
aliases:
|
||||
- 录入自定义字段
|
||||
- 诺税通录入自定义字段
|
||||
- 设备企业与配置-录入自定义字段
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 录入自定义字段
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/operation/definedColumn/batchSave.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 录入自定义字段
|
||||
|
||||
### 接口说明
|
||||
|
||||
根据订单号或流水号录入自定义字段信息。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/operation/definedColumn/batchSave.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| orderNos | List | 否 | 订单号 订单号和发票流水号二选一必填，都传入则优先使用流水号 | 500 |
|
||||
| invoiceIds | List | 否 | 发票流水号 订单号和发票流水号二选一必填，都传入则优先使用流水号 | 500 |
|
||||
| columnFirst | String | 否 | 自定义字段一，三个自定义字段不可全为空 | \- |
|
||||
| columnSecond | String | 否 | 自定义字段二，三个自定义字段不可全为空 | \- |
|
||||
| columnThree | String | 否 | 自定义字段三，三个自定义字段不可全为空 | \- |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"orderNos": [</p>
|
||||
<p>"123456789"</p>
|
||||
<p>],</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"，</p>
|
||||
<p>"columnFirst": "自定义字段1"，</p>
|
||||
<p>"columnSecond": "自定义字段2"，</p>
|
||||
<p>"columnThree": "自定义字段3"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
402
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/快捷冲红接口.md
Normal file
402
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/快捷冲红接口.md
Normal file
@ -0,0 +1,402 @@
|
||||
---
|
||||
title: 快捷冲红接口
|
||||
aliases:
|
||||
- 快捷冲红接口
|
||||
- 诺税通快捷冲红接口
|
||||
- 作废重开与冲红-快捷冲红接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 快捷冲红接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/ fastRepeatedRedSingle.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 快捷冲红接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
支持直接请求蓝字发票直接触发开具对应的红字发票或红字信息表。
|
||||
|
||||
注：数电发票使用此接口开取红票
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/ fastRepeatedRedSingle.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 14%" />
|
||||
<col style="width: 5%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>销方税号，15-20位</p>
|
||||
<p>销方税号和组织编码必填其一</p></td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">companyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>组织编码</p>
|
||||
<p>企业税号和组织编码必填其一</p></td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票流水号 非数电发票时必填</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceCode</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票发票代码 非数电发票时必填</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceNumber</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票发票号码 非数电发票时必填</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>红字确认单申请单号</p>
|
||||
<p>与billNo、billUuid三选一必填</p></td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>红字确认单编号 数电发票时填写</p>
|
||||
<p>与billId、billUuid三选一必填</p></td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>红字确认单uuid 数电发票时填写</p>
|
||||
<p>与billId、billNo三选一必填</p></td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">fastRedType</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">快捷冲红类型 不填或者0为普通快捷冲红 1:数电发票快捷冲红(数电发票必传1)</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceLine</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>数电发票跨票种冲红时传入，发票票种：（非数电发票时不需要传）</p>
|
||||
<p>bs:数电专票(电子),</p>
|
||||
<p>pc:数电普票(电子)，</p>
|
||||
<p>es:数电专票(纸质)，</p>
|
||||
<p>ec:数电普票(纸质)</p>
|
||||
<p>1、默认为对应蓝票数电票种；</p>
|
||||
<p>2、蓝票为es 时可选择 bs、es进行冲红</p>
|
||||
<p>3、蓝票为ec时可选择pc、ec进行冲红</p>
|
||||
<p>4、蓝票为数电电票时只能拿原票种冲红</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">orderNo</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">红字发票对应订单编号</td>
|
||||
<td style="text-align: left;">64</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">columnFirst</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">自定义列1</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">columnSecond</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">自定义列2</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">columnThree</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">自定义列3</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"invoiceId": "14111111111",</p>
|
||||
<p>"invoiceCode": "11111111",</p>
|
||||
<p>"invoiceNumber": "22222222",</p>
|
||||
<p>"billId": "22222222",</p>
|
||||
<p>"billNo": "22222222",</p>
|
||||
<p>"billUuid": "123456",</p>
|
||||
<p>"fastRedType": 1,</p>
|
||||
<p>"invoiceLine": "es",</p>
|
||||
<p>"orderNo": "123456908888",</p>
|
||||
<p>"columnFirst": "c1",</p>
|
||||
<p>"columnSecond": "c2",</p>
|
||||
<p>"columnThree": "c3"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 46%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">code</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>状态,200-成功，非200-失败</p>
|
||||
<p>不代表冲红成功/失败</p></td>
|
||||
<td style="text-align: center;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">详细信息</td>
|
||||
<td style="text-align: center;">1024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">data</td>
|
||||
<td style="text-align: center;">Object</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="5" style="text-align: center;">data内字段说明</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票流水号 非数电发票时必填</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票代码 非数电发票时必填</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝票号码 非数电发票时必填</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redInvoiceId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">(蓝票非专票时的字段)红票流水号，非专票时必有值</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redOrderNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">(蓝票非专票时的字段)红票orderNo，非专票时必有值</td>
|
||||
<td style="text-align: center;">64</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redBillNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">(蓝票专票时的字段)红字信息表流水号(billNo),不是billInfoNo。专票时必有值</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">reason</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">失败原因，冲红失败时才会有值</td>
|
||||
<td style="text-align: center;">2000</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单编号 数电发票时必填</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单uuid 数电发票时必填</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">fastRedType</td>
|
||||
<td style="text-align: left;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">快捷冲红类型 不填或者0为普通快捷冲红 1:数电快捷冲红(数电发票必传1)</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"blueInvoiceId": "21122410310201000295",</p>
|
||||
<p>"blueInvoiceCode": "111100020026",</p>
|
||||
<p>"blueInvoiceNumber": "92482083",</p>
|
||||
<p>"redInvoiceId": "12312312312",</p>
|
||||
<p>"redOrderNo": "12123123123123",</p>
|
||||
<p>"redBillNo": null,</p>
|
||||
<p>"billId": "22222222",</p>
|
||||
<p>"billNo": "22222222",</p>
|
||||
<p>"billUuid": "123456",</p>
|
||||
<p>"fastRedType": 1,</p>
|
||||
<p>"reason": ""</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"blueInvoiceId": "21122410310201000295",</p>
|
||||
<p>"blueInvoiceCode": "111100020026",</p>
|
||||
<p>"blueInvoiceNumber": "92482083",</p>
|
||||
<p>"redInvoiceId": null,</p>
|
||||
<p>"redOrderNo": null,</p>
|
||||
<p>"redBillNo": null,</p>
|
||||
<p>"redBillNo": null,</p>
|
||||
<p>"billId": "22222222",</p>
|
||||
<p>"billNo": "22222222",</p>
|
||||
<p>"billUuid": "123456",</p>
|
||||
<p>"fastRedType": 1,</p>
|
||||
<p>"reason": "未知异常"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
122
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/成品油库存下载接口.md
Normal file
122
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/成品油库存下载接口.md
Normal file
@ -0,0 +1,122 @@
|
||||
---
|
||||
title: 成品油库存下载接口
|
||||
aliases:
|
||||
- 成品油库存下载接口
|
||||
- 诺税通成品油库存下载接口
|
||||
- 专项能力-成品油库存下载接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 成品油库存下载接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/oilStock/downloadProductOil.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 成品油库存下载接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
触发从税局局端下载成品油库存到税盘的接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/oilStock/downloadProductOil.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 是 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 否 | 机器编号，12位数字 | 12 |
|
||||
| taxCode | String | 是 | 税收分类编码 | 19 |
|
||||
| num | Double | 是 | 下载数量（升） | \- |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p>"num": 1,</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"taxCode": "1070101060100000000"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 913,</p>
|
||||
<p>"message": "[AA99]库存不够！",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
File diff suppressed because one or more lines are too long
@ -0,0 +1,100 @@
|
||||
---
|
||||
title: 批量获取信息转换配置接口
|
||||
aliases:
|
||||
- 批量获取信息转换配置接口
|
||||
- 诺税通批量获取信息转换配置接口
|
||||
- 设备企业与配置-批量获取信息转换配置接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 批量获取信息转换配置接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/infoConvert/batch.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 批量获取信息转换配置接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
批量获取信息转换配置，供应链使用，最多支持500个税号的查询。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/infoConvert/batch.do |
|
||||
|
||||
请求方式：POST
|
||||
|
||||
Content-Type：application/x-www-form-urlencoded
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:----------:|:----------:|:--------:|:-------------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| taxNumList | String\[\] | 是 | 销方税号列表，最多支持500组税号 | \- |
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
| data内字段说明 | | | | |
|
||||
| taxnum | String | 是 | 销方税号 | |
|
||||
| customerOpenFlag | int | 是 | 客户信息转换开关:0-关，1-开，默认值0 | |
|
||||
| customerProcessNode | String | 是 | 客户信息处理节点：提交开票时SUBMIT_INVOICE,创建订单时ORDER_SAVE,开票时INVOICE | |
|
||||
| goodsOpenFlag | int | 是 | 商品信息转换开关:0-关，1-开，默认值0 | |
|
||||
| goodsProcessNode | String | 是 | 商品信息处理节点：提交开票时SUBMIT_INVOICE,创建订单时ORDER_SAVE,开票时INVOICE | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"taxnum": "150301199811285326",</p>
|
||||
<p>"goodsOpenFlag": 1,</p>
|
||||
<p>"goodsProcessNode": "INVOICE",</p>
|
||||
<p>"customerOpenFlag": 1,</p>
|
||||
<p>"customerProcessNode": "INVOICE"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,148 @@
|
||||
---
|
||||
title: 批量获取备注配置信息接口
|
||||
aliases:
|
||||
- 批量获取备注配置信息接口
|
||||
- 诺税通批量获取备注配置信息接口
|
||||
- 设备企业与配置-批量获取备注配置信息接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 批量获取备注配置信息接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/config/remarkConf/batch.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 批量获取备注配置信息接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
批量获取备注配置信息，供应链使用，最多支持500组数据的查询。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/config/remarkConf/batch.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:------------:|:--------:|:--------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| taxnum | String | 否 | 企业税号 | 20 |
|
||||
| businessType | String | 否 | 业务标识 | 2 |
|
||||
| processNode | String | 否 | 处理节点 | 100 |
|
||||
| buyerTaxnum | String | 否 | 购方税号 | 20 |
|
||||
| buyerName | String | 否 | 购方名称 | 100 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>[</p>
|
||||
<p>{</p>
|
||||
<p>"businessType": "1",</p>
|
||||
<p>"buyerName": "",</p>
|
||||
<p>"buyerTaxnum": "",</p>
|
||||
<p>"processNode": "INVOICE",</p>
|
||||
<p>"taxnum": "3333333333333333"</p>
|
||||
<p>}</p>
|
||||
<p>]</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | | String | 是 | 详细信息 | 1024 |
|
||||
| data | | Object | | | |
|
||||
| data内字段说明 | | | | | |
|
||||
| taxnum | | String | | 企业税号 | 20 |
|
||||
| businessType | | String | | 业务标识 | 2 |
|
||||
| processNode | | String | | 处理节点 | 100 |
|
||||
| buyerTaxnum | | String | | 请求中的购方税号 | 20 |
|
||||
| buyerName | | String | | 请求中的购方名称 | 100 |
|
||||
| configs | | Object | | 备注配置信息 | \- |
|
||||
| buyerInfoList | | Object | | 模板的全部购方信息 | \- |
|
||||
| configs内字段说明 | | | | | |
|
||||
| idx | | int | | 序号 | |
|
||||
| paramCode | | String | | 对应参数代码 | |
|
||||
| remarkTitle | | String | | 备注名称 | |
|
||||
| rowNo | | int | | 行号 | |
|
||||
| valSource | | int | | 取值来源 | |
|
||||
| buyerInfoList内字段说明 | | | | | |
|
||||
| buyerTaxnum | String | | | 购方税号 | |
|
||||
| buyerName | String | | | 购方名称 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"taxnum": "3333333333333333",</p>
|
||||
<p>"businessType": "1",</p>
|
||||
<p>"processNode": "INVOICE",</p>
|
||||
<p>"buyerName": "",</p>
|
||||
<p>"buyerTaxnum": "",</p>
|
||||
<p>"configs": [</p>
|
||||
<p>{</p>
|
||||
<p>"idx": 0,</p>
|
||||
<p>"rowNo": 1,</p>
|
||||
<p>"remarkTitle": "出口",</p>
|
||||
<p>"paramCode": "",</p>
|
||||
<p>"valSource": 1</p>
|
||||
<p>},</p>
|
||||
<p>{</p>
|
||||
<p>"idx": 1,</p>
|
||||
<p>"rowNo": 2,</p>
|
||||
<p>"remarkTitle": "外币金额:",</p>
|
||||
<p>"paramCode": "FOREIGN_CURRENCY_AMOUNT",</p>
|
||||
<p>"valSource": 1</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
121
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/抄报清卡.md
Normal file
121
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/抄报清卡.md
Normal file
@ -0,0 +1,121 @@
|
||||
---
|
||||
title: 抄报清卡
|
||||
aliases:
|
||||
- 抄报清卡
|
||||
- 诺税通抄报清卡
|
||||
- 专项能力-抄报清卡
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 抄报清卡
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/extensioninfo/reportAndClear.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 抄报清卡
|
||||
|
||||
### 接口说明
|
||||
|
||||
触发抄报清卡
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/extensioninfo/reportAndClear.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:------------:|:--------:|:--------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| taxnum | String | 是 | 销方税号 | 20 |
|
||||
| extensionNum | String | 否 | 分机号 | |
|
||||
| machineNum | String | 否 | 机器号 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"taxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum": "1",</p>
|
||||
<p>"machineNum": "123456789123"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:------------:|:--------:|:--------:|:--------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | String | 否 | 触发失败的原因以及设备信息 | |
|
||||
| extensionNum | String | 否 | 分机号 | |
|
||||
| machineNum | String | 否 | 机器号 | |
|
||||
| reason | String | 否 | 触发失败的原因 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败返回示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 400,</p>
|
||||
<p>"message": "税号不能为空",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
124
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/授信额度刷新接口.md
Normal file
124
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/授信额度刷新接口.md
Normal file
@ -0,0 +1,124 @@
|
||||
---
|
||||
title: 授信额度刷新接口
|
||||
aliases:
|
||||
- 授信额度刷新接口
|
||||
- 诺税通授信额度刷新接口
|
||||
- 专项能力-授信额度刷新接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 授信额度刷新接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/creditQuota/query.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 授信额度刷新接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取数电发票税局最新授信额度,该接口根据不同设备类型，返回不同结果。如果乐企模式，则同步返回授信额度数据。如果非乐企模式，为异步查询，需搭配接口3.57使用，来获取查询结果。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/creditQuota/query.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 |
|
||||
| type | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 请求类型 0:乐企 1:数电普通 | \- |
|
||||
| extensionNum | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 分机号 | 0-99999 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"type": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| 乐企模式返回字段 | | | | | |
|
||||
| creditFlag | String | 是 | Y | 暂停授信标志 Y：暂停 N：未暂停 | 1 |
|
||||
| creditQuotaAmount | BigDecimal | 是 | 10000.00 | 本月授信额度 | 12,2 |
|
||||
| downloadAmount | BigDecimal | 是 | 10000.00 | 可用剩余额度 | 12,2 |
|
||||
| downloadRemainAmount | BigDecimal | 是 | 10000.00 | 已下载额度 | 12,2 |
|
||||
| remainAmount | BigDecimal | 是 | 10000.00 | 已下载未使用额度 | 12,2 |
|
||||
| taxnum | String | 是 | 150301199811285326 | 企业税号 | 20 |
|
||||
| vestPeriod | String | 否 | 202303 | 属期 格式：yyyyMM | |
|
||||
| creditUpdateTime | Date | 是 | 2023-03-06 00:00:00 | 授信额度更新时间 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": "200",</p>
|
||||
<p>"message": "查询成功" ,</p>
|
||||
<p>"data": {</p>
|
||||
<p>"creditFlag": "Y",</p>
|
||||
<p>"creditQuotaAmount": "10000.00" ,</p>
|
||||
<p>"downloadAmount": "10000.00",</p>
|
||||
<p>"downloadRemainAmount": "10000.00",</p>
|
||||
<p>"remainAmount": "10000.00",</p>
|
||||
<p>"taxnum": "150301199811285326",</p>
|
||||
<p>"vestPeriod": "202303",</p>
|
||||
<p>"creditUpdateTime": "2023-03-06 00:00:00"</p>
|
||||
<p>}</p>
|
||||
<p>}</p>
|
||||
<p>非乐企:</p>
|
||||
<p>{</p>
|
||||
<p>"code": "200",</p>
|
||||
<p>"message": "查询成功" ,</p>
|
||||
<p>"data": ""</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
1148
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/收票入库接口_本地提取发票.md
Normal file
1148
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/收票入库接口_本地提取发票.md
Normal file
File diff suppressed because it is too large
Load Diff
123
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/新增_修改企业开票信息.md
Normal file
123
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/新增_修改企业开票信息.md
Normal file
@ -0,0 +1,123 @@
|
||||
---
|
||||
title: 新增/修改企业开票信息
|
||||
aliases:
|
||||
- 新增/修改企业开票信息
|
||||
- 诺税通新增/修改企业开票信息
|
||||
- 设备企业与配置-新增/修改企业开票信息
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 新增/修改企业开票信息
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/seller/save.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 新增/修改企业开票信息
|
||||
|
||||
### 接口说明
|
||||
|
||||
创建/修改企业开票信息接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/seller/save.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 企业税号 | 15～20 |
|
||||
| useScope | Integer | 必填 | 使用范围，0企业,1:个人,2部门,3项目 | 1 |
|
||||
| clerker | String | 必填 | 使用范围是个人时必填，填入用户管理手机号，使用范围为公司、部门、项目时非必填，直接填入值 | 100 |
|
||||
| sellerAddress | String | 必填 | 公司地址 | 100 |
|
||||
| sellerTel | String | 必填 | 公司电话 | 20 |
|
||||
| sellerBank | String | 必填 | 开户银行 | 100 |
|
||||
| sellerAccount | String | 必填 | 银行账号 | 50 |
|
||||
| payee | String | 选填 | 收款人 | 20 |
|
||||
| checker | String | 选填 | 复核人 | 20 |
|
||||
| projectCode | String | 选填 | 当前企业下的项目编码 使用范围为项目时必填 | 64 |
|
||||
| departmentName | String | 选填 | 当前企业下的部门名称 使用范围为部门时必填 | 100 |
|
||||
|
||||
注意：
|
||||
|
||||
1. 公司地址+公司电话总共不得超过100个字符
|
||||
|
||||
2. 开户银行+银行账号总共不得超过100个字符
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "taxNum": "33333333333333333",</p>
|
||||
<p> "useScope": 1,</p>
|
||||
<p> "clerker": "13655554433",</p>
|
||||
<p> "sellerAddress": "地址",</p>
|
||||
<p> "sellerTel": "tel",</p>
|
||||
<p> "sellerAccount": "account",</p>
|
||||
<p> "sellerBank": "bank",</p>
|
||||
<p> "payee": "",</p>
|
||||
<p> "checker": "",</p>
|
||||
<p>"projectCode": "test123",</p>
|
||||
<p> "departmentName": "测试部门"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,107 @@
|
||||
---
|
||||
title: 更新发票票据关联状态接口
|
||||
aliases:
|
||||
- 更新发票票据关联状态接口
|
||||
- 诺税通更新发票票据关联状态接口
|
||||
- 车辆辅助与回传-更新发票票据关联状态接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 更新发票票据关联状态接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/updateInvoiceAssociationStatus.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 更新发票票据关联状态接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
更新发票票据关联状态接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/updateInvoiceAssociationStatus.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | | |
|
||||
|:---------------------:|:--------:|:--------:|:--------------:|:---:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | | 20 |
|
||||
| uploadStatus | String | 是 | 工信部上传状态 | | 12 |
|
||||
| **发票代码+发票号码** | | | | | |
|
||||
| invoiceCode | String | 是 | 发票代码 | 12 | |
|
||||
| invoiceNumber | String | 是 | 发票号码 | 8 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"invoiceAssociations": [</p>
|
||||
<p>{</p>
|
||||
<p>"invoiceCode": "1500020560",</p>
|
||||
<p>"invoiceNumber": "87609473"</p>
|
||||
<p>}</p>
|
||||
<p>],</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"uploadStatus": "上传成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code":200,</p>
|
||||
<p> "message":"成功",</p>
|
||||
<p> "data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,125 @@
|
||||
---
|
||||
title: 查询可下载发票库存列表接口
|
||||
aliases:
|
||||
- 查询可下载发票库存列表接口
|
||||
- 诺税通查询可下载发票库存列表接口
|
||||
- 库存票源与打印-查询可下载发票库存列表接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 查询可下载发票库存列表接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/stock/getDownloadableStock.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 查询可下载发票库存列表接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
查询诺税通库中可下载发票库存列表
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/stock/getDownloadableStock.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 否 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 否 | 机器编号，12位数字 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 28,</p>
|
||||
<p>"machineNumber": "661103844159",</p>
|
||||
<p>"sellerTaxnum": "110101999999999618"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:------------------:|:----------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | 是 | | |
|
||||
| data内字段说明 | | | | |
|
||||
| sellerTaxnum | String | | 销方税号 | |
|
||||
| extensionNum | String | | 分机号 | |
|
||||
| machineNumber | String | | 机器编号 | |
|
||||
| invoiceCode | String | | 发票代码 | |
|
||||
| invoiceLine | String | | 发票种类 | |
|
||||
| invoiceNumStart | String | | 发票号码起始值 | |
|
||||
| invoiceNumEnd | String | | 发票代码终止值 | |
|
||||
| num | Integer | | 发票可下载数量 | |
|
||||
| singleBillingLimit | BigDecimal | | 单张开票限额 | |
|
||||
| updatedTime | String | | 更新时间 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"sellerTaxnum": "110101999999999618",</p>
|
||||
<p>"extensionNum": 28,</p>
|
||||
<p>"machineNumber": "661103844159",</p>
|
||||
<p>"invoiceLine": "p",</p>
|
||||
<p>"invoiceCode": "050002000208",</p>
|
||||
<p>"num": 39899,</p>
|
||||
<p>"singleBillingLimit": null,</p>
|
||||
<p>"invoiceNumStart": "93666868",</p>
|
||||
<p>"invoiceNumEnd": null,</p>
|
||||
<p>"updatedTime": "2022-05-25 13:24:54"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
121
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询成品油库存列表接口.md
Normal file
121
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询成品油库存列表接口.md
Normal file
@ -0,0 +1,121 @@
|
||||
---
|
||||
title: 查询成品油库存列表接口
|
||||
aliases:
|
||||
- 查询成品油库存列表接口
|
||||
- 诺税通查询成品油库存列表接口
|
||||
- 专项能力-查询成品油库存列表接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 查询成品油库存列表接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/oilStock/getOilStockInfoList.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 查询成品油库存列表接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
查询诺税通库中成品油库存列表接口，包括税盘可使用的和局端可下载的。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/oilStock/getOilStockInfoList.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 是 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 否 | 机器编号，12位数字 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
| data内字段说明 | | | | |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | |
|
||||
| extensionNum | String | 是 | 分机号 | |
|
||||
| machineNumber | String | 是 | 机器编号 | |
|
||||
| oilType | String | 是 | 成品油类型 | |
|
||||
| taxCode | String | 是 | 税收分类编码 | |
|
||||
| downloadedStockAmount | String | 是 | 开票设备中已下载可使用库存（升） | |
|
||||
| downloadableStockAmount | String | 是 | 局端可下载库存（升） | |
|
||||
| updateTime | String | 是 | 更新时间 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "code":200,</p>
|
||||
<p> "message":"成功",</p>
|
||||
<p> "data":[</p>
|
||||
<p> {</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900",</p>
|
||||
<p> "oilType":"汽油",</p>
|
||||
<p> "taxCode":"1070101010100000000",</p>
|
||||
<p> "downloadedStockAmount":"8366796.99",</p>
|
||||
<p> "downloadableStockAmount":"0.00",</p>
|
||||
<p> "updateTime":"2021-12-24 14:06:37"</p>
|
||||
<p> }</p>
|
||||
<p> ]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
136
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询授信额度数据.md
Normal file
136
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询授信额度数据.md
Normal file
@ -0,0 +1,136 @@
|
||||
---
|
||||
title: 查询授信额度数据
|
||||
aliases:
|
||||
- 查询授信额度数据
|
||||
- 诺税通查询授信额度数据
|
||||
- 专项能力-查询授信额度数据
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 查询授信额度数据
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/creditQuota/queryLocalData.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 查询授信额度数据
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取数电发票授信额度,该接口根据不同设备类型，返回不同结果。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/creditQuota/queryLocalData.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 |
|
||||
| type | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 请求类型 0:乐企 1:数电普通 | \- |
|
||||
| extensionNum | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 分机号 | 0-99999 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"type": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| 乐企模式返回字段 | | | | | |
|
||||
| creditFlag | String | 是 | Y | 暂停授信标志 Y：暂停 N：未暂停 | 1 |
|
||||
| creditQuotaAmount | BigDecimal | 是 | 10000.00 | 本月授信额度 | 12,2 |
|
||||
| downloadAmount | BigDecimal | 是 | 10000.00 | 可用剩余额度 | 12,2 |
|
||||
| downloadRemainAmount | BigDecimal | 是 | 10000.00 | 已下载额度 | 12,2 |
|
||||
| remainAmount | BigDecimal | 是 | 10000.00 | 已下载未使用额度 | 12,2 |
|
||||
| taxnum | String | 是 | 150301199811285326 | 企业税号 | 20 |
|
||||
| vestPeriod | String | 否 | 202303 | 属期 格式：yyyyMM | |
|
||||
| creditUpdateTime | Date | 是 | 2023-03-06 00:00:00 | 授信额度更新时间 | |
|
||||
| 非乐企模式返回字段 | | | | | |
|
||||
| creditQuotaAmount | BigDecimal | 是 | 10000.00 | 本月授信额度 | 12,2 |
|
||||
| remainAmount | BigDecimal | 是 | 10000.00 | 可用剩余额度 | 12,2 |
|
||||
| queryStatus | Integer | 是 | 1 | 查询状态 0:查询中 1:查询成功 2:查询失败 | 1 |
|
||||
| creditUpdateTime | Date | 是 | 2023-03-06 00:00:00 | 授信额度更新时间 | |
|
||||
| message | String | 否 | 分机信息不存在 | 查询失败原因 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": "200",</p>
|
||||
<p>"message": "查询成功",</p>
|
||||
<p>"data":{</p>
|
||||
<p>"creditFlag": "Y",</p>
|
||||
<p>"creditQuotaAmount": "10000.00" ,</p>
|
||||
<p>"downloadAmount": "10000.00",</p>
|
||||
<p>"downloadRemainAmount": "10000.00",</p>
|
||||
<p>"remainAmount": "10000.00",</p>
|
||||
<p>"taxnum": "150301199811285326",</p>
|
||||
<p>"vestPeriod": "202303",</p>
|
||||
<p>"creditUpdateTime": "2023-03-06 00:00:00"</p>
|
||||
<p>}</p>
|
||||
<p>}</p>
|
||||
<p>非乐企:</p>
|
||||
<p>{</p>
|
||||
<p>"code": "200",</p>
|
||||
<p>"message": "查询成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"creditQuotaAmount": "10000.00",</p>
|
||||
<p>"downloadAmount": "10000.00",</p>
|
||||
<p>"queryStatus":1,</p>
|
||||
<p>"creditUpdateTime": "2023-03-06 00:00:00",</p>
|
||||
<p>"message": "分机信息不存在"</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,134 @@
|
||||
---
|
||||
title: 查询获取车架号是否可开票结果接口
|
||||
aliases:
|
||||
- 查询获取车架号是否可开票结果接口
|
||||
- 诺税通查询获取车架号是否可开票结果接口
|
||||
- 车辆辅助与回传-查询获取车架号是否可开票结果接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 查询获取车架号是否可开票结果接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/query/queryVehicleCodeIsInvoice.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 查询获取车架号是否可开票结果接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取车架号是否可开票结果接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/query/queryVehicleCodeIsInvoice.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | |
|
||||
|:---------------:|:----------:|:--------:|:----------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| vehicleCodeList | String\[\] | 是 | 车架号，支持最多2000个 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"vehicleCodeList": [</p>
|
||||
<p>"111"</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功则返回车架号记录信息 | |
|
||||
| **车架号记录信息** | | | | |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| companyCode | String | 是 | 企业编码 | 20 |
|
||||
| vehicleCode | String | 是 | 车架号 | 23 |
|
||||
| status | String | 是 | 车架号状态：1-可开票;2-查询中;3-未知;4-不可开票;5-已开票 | 2 |
|
||||
| certificate | String | \- | 合格证号，查询到车架号所属该税号且未开票时后端返回有值 | 50 |
|
||||
| machineNum | String | \- | 设备编号，查询到车架号所属该税号且未开票时后端返回有值 | 12 |
|
||||
| importCertifyNum | String | \- | 进口证明书编号，查询到车架号所属该税号且未开票时后端返回有值 | 32 |
|
||||
| message | String | 否 | 描述信息，举例：合格证已被使用； | 1024 |
|
||||
| requestSrc | String | 是 | 请求来源(0:未知;1-页面添加;2-页面导入;3-api进项调用;4-api用户调用;5-开票) | 2 |
|
||||
| brandModel | String | 否 | 厂牌型号 | 60 |
|
||||
| engineNum | String | 否 | 发动机号码 | 50 |
|
||||
| vehicleType | String | 否 | 车辆类型 | 40 |
|
||||
| inspectionOddNum | String | 否 | 商检单号 | 32 |
|
||||
| productOrigin | String | 否 | 产地 | 32 |
|
||||
| displacement | String | 否 | 排量 | 50 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"companyCode": "1100",</p>
|
||||
<p>"vehicleCode": "111",</p>
|
||||
<p>"status": 2,</p>
|
||||
<p>"certificate": "1",</p>
|
||||
<p>"machineNum": "134874514782",</p>
|
||||
<p>"importCertifyNum": "13242234",</p>
|
||||
<p>"message": "未查询到合格证信息，不允许开具发票",</p>
|
||||
<p>"requestSrc": "3",</p>
|
||||
<p>"brandModel": "",</p>
|
||||
<p>"engineNum": "",</p>
|
||||
<p>"vehicleType": "",</p>
|
||||
<p>"inspectionOddNum": "",</p>
|
||||
<p>"productOrigin": ""</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,127 @@
|
||||
---
|
||||
title: 根据业务标识查询对应值列表接口
|
||||
aliases:
|
||||
- 根据业务标识查询对应值列表接口
|
||||
- 诺税通根据业务标识查询对应值列表接口
|
||||
- 设备企业与配置-根据业务标识查询对应值列表接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 根据业务标识查询对应值列表接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/oa/getOaOptionList.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 根据业务标识查询对应值列表接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
根据业务标识查询对应的值列表，给OA审批流使用
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/oa/getOaOptionList.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | |
|
||||
|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** |
|
||||
| type | String | 是 | 业务类型：开票方式:requestSrc,发票种类:invoiceLine,组织名称:organize,部门名称:dept,开票员:clerk,作废来源：invalidSrc |
|
||||
| name | String | 否 | 名称，根据名称模糊查询 |
|
||||
| pageNum | int | 否 | 当前页，默认为1 |
|
||||
| pageSize | int | 否 | 分页条数，默认为15 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"pageNum": 1,</p>
|
||||
<p>"pageSize": 15,</p>
|
||||
<p>"type": "dept",</p>
|
||||
<p>"name": "测试部门2"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | | 成功 | | 详细信息 | 1024 |
|
||||
| data | Object | | | | 数据对象 | |
|
||||
| **数据信息** | | | | | | |
|
||||
| pageNum | int | 是 | 1 | | 当前页数 | |
|
||||
| pageSize | int | 是 | 15 | | 每页条数 | |
|
||||
| pages | int | 是 | 1 | | 总页数 | |
|
||||
| total | int | 是 | 2 | | 数据总数 | |
|
||||
| list | List | | | | 查询成功则返回具体信息 | |
|
||||
| **具体信息** | | | | | | |
|
||||
| key | String | | 201127 | | 唯一标识 | |
|
||||
| name | String | | 测试部门2 | | 名称 | |
|
||||
| companyId | long | | 10162 | | 企业id，业务类型为dept、clerk时返回 | |
|
||||
| companyName | String | | 移动测试盘326 | | 企业名称，业务类型为dept、clerk时返回 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"total": "9",</p>
|
||||
<p>"list": [</p>
|
||||
<p>{</p>
|
||||
<p>"key": "201127",</p>
|
||||
<p>"name": "测试部门2-2",</p>
|
||||
<p>"companyName": "移动测试盘326",</p>
|
||||
<p>"companyId": "10162"</p>
|
||||
<p>}</p>
|
||||
<p>],</p>
|
||||
<p>"pageNum": 1,</p>
|
||||
<p>"pageSize": 2,</p>
|
||||
<p>"pages": 5</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
255
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/登录扫码认证确认接口.md
Normal file
255
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/登录扫码认证确认接口.md
Normal file
@ -0,0 +1,255 @@
|
||||
---
|
||||
title: 登录扫码认证确认接口
|
||||
aliases:
|
||||
- 登录扫码认证确认接口
|
||||
- 诺税通登录扫码认证确认接口
|
||||
- 设备企业与配置-登录扫码认证确认接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 登录扫码认证确认接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/auth/authAffirm.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 登录扫码认证确认接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
用于3.53获取登录扫码认证二维码（对应qrCodeType=1、2、3、4）后的二次确认登录操作
|
||||
|
||||
注意：电子税务局认证操作的数电账号（分机号） 和 登录二次确认操作的数电账号（分机号）必须为同一个
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/auth/authAffirm.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 10%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号，分机号和数电账号任一必填</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">account</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">数电账号，分机号和数电账号任一必填</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">opType</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>操作类型：</p>
|
||||
<p>0-扫码登录验证完成操作（默认）</p>
|
||||
<p>1-查询扫码登录结果</p>
|
||||
<p>2-短信登录提交登录（此时填写verifyCode）</p>
|
||||
<p>3-查询短信登录结果</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">verifyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>短信验证码（当数电发票开具进行短信验</p>
|
||||
<p>证码登录时才需要传）</p></td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326"，</p>
|
||||
<p>"extensionNum": 1，</p>
|
||||
<p>"account": "123456"，</p>
|
||||
<p>"opType": 2，</p>
|
||||
<p>"verifyCode": "1236"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 14%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 7%" />
|
||||
<col style="width: 15%" />
|
||||
<col style="width: 35%" />
|
||||
<col style="width: 15%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>示例值</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">code</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">200</td>
|
||||
<td style="text-align: center;">状态,200-成功，非200-失败</td>
|
||||
<td style="text-align: center;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: left;">成功</td>
|
||||
<td style="text-align: center;">详细信息</td>
|
||||
<td style="text-align: center;">1024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">data</td>
|
||||
<td style="text-align: center;">Object</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">结果</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">status</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
<td style="text-align: center;">0-登录执行中；1-成功；2-失败</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">登录成功</td>
|
||||
<td style="text-align: center;">结果信息（登录成功/失败原因）</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">loginType</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"><p>登录方式：</p>
|
||||
<ol type="1">
|
||||
<li><p>扫码登录</p></li>
|
||||
<li><p>短信验证码登录</p></li>
|
||||
</ol></td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">339901999999199</td>
|
||||
<td style="text-align: center;">税号</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">100</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">account</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">138****1234</td>
|
||||
<td style="text-align: center;">用户名/手机号（脱敏处理）</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{<br />
|
||||
"code":200,<br />
|
||||
"message": "成功"，</p>
|
||||
<p>"data":</p>
|
||||
<p>{</p>
|
||||
<p>"account": "123456",</p>
|
||||
<p>"taxNum": "1234567890",</p>
|
||||
<p>"status": "1",</p>
|
||||
<p>"message": "登录成功",</p>
|
||||
<p>"loginType": 2,</p>
|
||||
<p>"extensionNum": 123</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
117
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/票源下载接口.md
Normal file
117
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/票源下载接口.md
Normal file
@ -0,0 +1,117 @@
|
||||
---
|
||||
title: 票源下载接口
|
||||
aliases:
|
||||
- 票源下载接口
|
||||
- 诺税通票源下载接口
|
||||
- 库存票源与打印-票源下载接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 票源下载接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/stock/downInvoiceSource.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 票源下载接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
票源下载接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|----|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/stock/downInvoiceSource.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:------------:|:--------:|:--------:|:--------------------------:|:--------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **更多限制** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | | 销方税号 | 20 |
|
||||
| extensionNum | String | 否 | 至少分机号或机器号任一必填 | 分机号 | 5 |
|
||||
| machineNum | String | 否 | 至少分机号或机器号任一必填 | 机器号 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum":"0",</p>
|
||||
<p>"machineNum":"661565671900",</p>
|
||||
<p>"sellerTaxnum":"150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code": 200,</p>
|
||||
<p> "message": "成功",</p>
|
||||
<p> "data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p> "code": 27761,</p>
|
||||
<p> "message": "请传入分机号或机器编号",</p>
|
||||
<p> "data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
111
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/空白发票作废申请.md
Normal file
111
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/空白发票作废申请.md
Normal file
@ -0,0 +1,111 @@
|
||||
---
|
||||
title: 空白发票作废申请
|
||||
aliases:
|
||||
- 空白发票作废申请
|
||||
- 诺税通空白发票作废申请
|
||||
- 作废重开与冲红-空白发票作废申请
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 空白发票作废申请
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/blankInvoiceInvalid.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 空白发票作废申请
|
||||
|
||||
### 接口说明
|
||||
|
||||
空白发票作废申请接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/blankInvoiceInvalid.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| extensionNum | String | 是 | 分机号 | 5 |
|
||||
| machineNum | String | 是 | 税控设备号（机器编码） | 12 |
|
||||
| terminalNum | String | 否 | 终端号 | 10 |
|
||||
| invoiceLine | String | 必填，发票种类对应枚举值，例:p:普通发票(电子) | 发票种类，c:增值税普通发票(纸票)，s:增值税专用发票，f:收购发票(纸质)，j：机动车发票，u：二手车发票 | 1 |
|
||||
| invoiceCode | String | 是 | 发票代码 | 12 |
|
||||
| invoiceNum | String | 是 | 发票号码 | 8 |
|
||||
| invalidNum | String | 否 | 作废份数，目前仅支持作废1张，默认为1 | 1 |
|
||||
| userId | Long | 否 | 诺税通用户ID | |
|
||||
| departmentId | Long | 否 | 诺税通部门ID | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum":" 1",</p>
|
||||
<p>"machineNum":" 661929539468",</p>
|
||||
<p>"invoiceLine": "c"</p>
|
||||
<p>"invoiceCode":" 033001800105",</p>
|
||||
<p>"invoiceNum":" 33111355",</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | String | | 查询成功则返回申请流水号 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": "123456789"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,644 @@
|
||||
---
|
||||
title: 红字信息表/红字确认单回传
|
||||
aliases:
|
||||
- 红字信息表/红字确认单回传
|
||||
- 诺税通红字信息表/红字确认单回传
|
||||
- 红字信息表-红字信息表/红字确认单回传
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表/红字确认单回传
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`用户通过红字信息表/确认单申请请求中的bizCallbackUrl字段进行回调，若接口不传回传地址，则使用开票配置中配置的红字信息表/红字确认单回传地址。`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：是
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表/红字确认单回传
|
||||
|
||||
### 接口说明
|
||||
|
||||
返回红字信息表/红字确认单信息。
|
||||
|
||||
注意：请按照文档要求提供接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
用户通过红字信息表/确认单申请请求中的bizCallbackUrl字段进行回调，若接口不传回传地址，则使用开票配置中配置的红字信息表/红字确认单回传地址。
|
||||
|
||||
数电票种回传红字确认单信息，非数电票种回传红字信息表。通过backType类型区分回传红字信息表或红字确认单。
|
||||
|
||||
信息表触发回传的状态：申请失败、审核通过、审核未通过、已撤销、撤销失败
|
||||
|
||||
确认单触发回传的状态：无需确认、购销双方已确认、作废（销方录入购方否认）、作废（购方录入销方否认）、作废（超72小时未确认）、作废（发起方撤销）、作废（确认方撤销）
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
backType=1时，回传红字信息表结果。
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 46%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">backType</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">回传类型, 1: 红字信息表 2：红字确认单</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">申请单号</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回</p>
|
||||
<p>4、矿产品类专用信息表（涉及销售数量和金额变更）</p>
|
||||
<p>5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票代码</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票号码</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>对应蓝票开票日期</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税种类别(0:营业税 1:增值税)</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxRate</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税率：单税率就保存税率，如0.13；多税率M</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAddress</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方地址</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerPhone</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方电话</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerBank</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方银行</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAccount</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方账号</td>
|
||||
<td style="text-align: center;">30</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreeAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">不含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">合计税额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>填开时间</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applyRemark</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">申请说明（购方已抵扣：1100000000,购方未抵扣：1010000000,销售方申请：0000000100）</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">businessTaxCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">营业税标志</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billInfoNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">信息表编号</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>信息表状态(-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销</p>
|
||||
<p>-2:删除成功)</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billMessage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">[信息表状态代码]信息表状态描述</td>
|
||||
<td style="text-align: center;">300</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">pdfUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">申请表pdf url</td>
|
||||
<td style="text-align: center;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">detailList</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">明细列表</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">specificFactor</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具</p>
|
||||
<p>35 矿产品发票</p></td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **商品明细** detailList | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | String | 是 | 单据明细序号 | 5 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | decimal | 是 | 税率 | 1 |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识，0:不使用;1:使用 | 2 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
backType=2，则回传红字确认单。
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 46%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">backType</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">回传类型, 1: 红字信息表 2：红字确认单</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单编号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: left;"><p>确认单状态</p>
|
||||
<p>-1 提交失败</p>
|
||||
<p>00 提交中</p>
|
||||
<p>01 无需确认</p>
|
||||
<p>02 销方录入待购方确认</p>
|
||||
<p>03 购方录入待销方确认</p>
|
||||
<p>04 购销双方已确认</p>
|
||||
<p>05 作废（销方录入购方否认）</p>
|
||||
<p>06 作废（购方录入销方否认）</p>
|
||||
<p>07 作废（超72小时未确认）</p>
|
||||
<p>08 作废（发起方撤销）</p>
|
||||
<p>09 作废（确认方撤销）</p>
|
||||
<p>15 提交税局中</p>
|
||||
<p>16 提交税局失败</p></td>
|
||||
<td style="text-align: center;">4</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billMessage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">[确认单状态代码]确认单状态描述</td>
|
||||
<td style="text-align: center;">300</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">openStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>开具状态</p>
|
||||
<p>0：未开具</p>
|
||||
<p>1：已开具</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applySource</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请来源</p>
|
||||
<p>0 销方</p>
|
||||
<p>1 购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>填开时间</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreeAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">不含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">合计税额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>蓝票票种</p>
|
||||
<p>bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)</p>
|
||||
<p>p:电子增值税普通发票，</p>
|
||||
<p>c:增值税普通发票(纸票)，</p>
|
||||
<p>s:增值税专用发票，</p>
|
||||
<p>b:增值税电子专用发票</p></td>
|
||||
<td style="text-align: center;">5</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">vatUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票增值税用途</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">saleTaxUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票消费税用途</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">accountStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">发票入账状态</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redReason</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>冲红原因</p>
|
||||
<p>1开票有误</p>
|
||||
<p>2销货退回</p>
|
||||
<p>3服务中止</p>
|
||||
<p>4销售折让</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">detail</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单明细</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **确认单明细** detail | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | Integer | 是 | 单据明细序号 | 5 |
|
||||
| blueDetailIndex | Integer | 是 | 对应数电蓝票明细行 | 5 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | String | 是 | 税率 | 10 |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识 | 10 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
### 请求示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"billNo": "12345678901234567890097q",</p>
|
||||
<p>"billType": "0",</p>
|
||||
<p>"oriInvoiceCode": "005000181530",</p>
|
||||
<p>"oriInvoiceNumber": "45625450",</p>
|
||||
<p>"oriInvoiceTime": null,</p>
|
||||
<p>"taxType": "1",</p>
|
||||
<p>"taxRate": "0",</p>
|
||||
<p>"buyerName": "officia in irure",</p>
|
||||
<p>"buyerTaxnum": "CILLUM",</p>
|
||||
<p>"sellerName": "Excepteur dolor ",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"taxFreeAmountTotal": "-1.00",</p>
|
||||
<p>"taxTotal": "-1.00",</p>
|
||||
<p>"billTime": "2020-05-26 03:14:15",</p>
|
||||
<p>"applyRemark": "0000000100",</p>
|
||||
<p>"businessTaxCode": "0000000000",</p>
|
||||
<p>"billInfoNo": "",</p>
|
||||
<p>"billStatus": 2,</p>
|
||||
<p>"billMessage": "[B900006]申请单号不能为空或者格式不正确",</p>
|
||||
<p>"pdfUrl": "",</p>
|
||||
<p>"detailList": [</p>
|
||||
<p>{</p>
|
||||
<p>"detailIndex": 1,</p>
|
||||
<p>"goodsName": "Ut min",</p>
|
||||
<p>"withTaxFlag": null,</p>
|
||||
<p>"goodsPrice": "0.0000000000000000",</p>
|
||||
<p>"taxFreePrice": "0.0900000000000000",</p>
|
||||
<p>"goodsNum": "-1.0000000000000000",</p>
|
||||
<p>"taxrate": "0.09",</p>
|
||||
<p>"specType": "nost",</p>
|
||||
<p>"goodsUnit": "aliqu",</p>
|
||||
<p>"goodsCode": "esseonsequ",</p>
|
||||
<p>"goodsCodeAbb": "irure in",</p>
|
||||
<p>"favouredPolicyFlag": 0,</p>
|
||||
<p>"zeroRateFlag": "",</p>
|
||||
<p>"favouredPolicyName": "",</p>
|
||||
<p>"selfCode": "sed Lorem",</p>
|
||||
<p>"deduction": "0.00",</p>
|
||||
<p>"taxAmount": "-0.01",</p>
|
||||
<p>"taxFreeAmount": "-0.09",</p>
|
||||
<p>"tax": "-0.01"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | String | 是 | 0000 | | 状态码，字符串”0000”表示成功，非”0000”的字符串表示失败 | 6 |
|
||||
| message | String | 是 | 同步成功 | | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": "0000",</p>
|
||||
<p>"message": "业务方接收同步成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": "9999",</p>
|
||||
<p>"message": "同步失败的异常信息"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
187
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表下载接口.md
Normal file
187
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表下载接口.md
Normal file
@ -0,0 +1,187 @@
|
||||
---
|
||||
title: 红字信息表下载接口
|
||||
aliases:
|
||||
- 红字信息表下载接口
|
||||
- 诺税通红字信息表下载接口
|
||||
- 红字信息表-红字信息表下载接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表下载接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/red-apply-down`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表下载接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
销方可调用专用发票红字信息表下载接口下载购买方申请的红字信息表。仅触发下载指令，需配合红字信息表查询接口获取详细的信息表信息。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/red-apply-down |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">发票种类</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billInfoNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">信息表编号</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redApplyStartTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字申请时间-查询起期（yyyyMMdd），时间跨度不能超过30天</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redApplyEndTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>红字申请时间-查询止期（yyyyMMdd）</p>
|
||||
<p>时间跨度不能超过30天</p></td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">machineNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">机器编号</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注意：
|
||||
|
||||
1.查询开始时间、结束时间允许同时为空，或者同时不为空
|
||||
|
||||
2.如果时间同时为空，则信息表编号必填
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"billInfoNo": "",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"buyerTaxnum": "339901999999513",</p>
|
||||
<p>"invoiceLine": "s",</p>
|
||||
<p>"redApplyStartTime": "20201201",</p>
|
||||
<p>"redApplyEndTime": "20201229",</p>
|
||||
<p>"userId": 1,</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
101
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表撤销接口.md
Normal file
101
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表撤销接口.md
Normal file
@ -0,0 +1,101 @@
|
||||
---
|
||||
title: 红字信息表撤销接口
|
||||
aliases:
|
||||
- 红字信息表撤销接口
|
||||
- 诺税通红字信息表撤销接口
|
||||
- 红字信息表-红字信息表撤销接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表撤销接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/red-apply-cancel`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表撤销接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
专用发票红字信息表撤销申请接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-----------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/red-apply-cancel |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:-------------:|:--------:|:--------:|:----------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| billInfoNo | String | 是 | 信息表编号 | 24 |
|
||||
| userId | Long | 否 | 开票人id | \- |
|
||||
| extensionNum | Integer | 否 | 分机号 | \- |
|
||||
| machineNumber | String | 否 | 机器编号 | 12 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"billInfoNo": "1403011905003535",</p>
|
||||
<p>"userId": 1,</p>
|
||||
<p>"extensionNum": 0,</p>
|
||||
<p>"machineNumber": "661565671900"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
407
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表查询接口.md
Normal file
407
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表查询接口.md
Normal file
@ -0,0 +1,407 @@
|
||||
---
|
||||
title: 红字信息表查询接口
|
||||
aliases:
|
||||
- 红字信息表查询接口
|
||||
- 诺税通红字信息表查询接口
|
||||
- 红字信息表-红字信息表查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/red-apply-query`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
专用发票红字信息表查询接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/red-apply-query |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| billNo | String | 否 | 信息表流水号(12位税盘编号+12位蓝票开票时间YYMMDDHHMMSS) | 24 |
|
||||
| billInfoNo | String | 否 | 信息表编号 | 24 |
|
||||
| buyerTaxnum | String | 否 | 购方税号 | 20 |
|
||||
| redApplyStartTime | String | 否 | 红字申请时间-查询起期（yyyy-MM-dd HH:mm:ss） | 19 |
|
||||
| redApplyEndTime | String | 否 | 红字申请时间-查询止期（yyyy-MM-dd HH:mm:ss） | 19 |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
|
||||
注意：
|
||||
|
||||
1.billInfoNo或billNo为空时，redApplyStartTime必填。
|
||||
|
||||
2.billInfoNo或billNo为空时，redApplyEndTime不填时默认当前日期，并且时间范围不能超过60天。
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"billInfoNo": "",</p>
|
||||
<p>"billNo": "",</p>
|
||||
<p>"buyerTaxnum": "339901999999513",</p>
|
||||
<p>"redApplyEndTime": "2020-12-29 23:00:00",</p>
|
||||
<p>"redApplyStartTime": "2020-11-01 00:00:00",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 46%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">code</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">状态,200-成功，非200-失败</td>
|
||||
<td style="text-align: center;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">详细信息</td>
|
||||
<td style="text-align: center;">1024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">data</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">查询成功则返回红字申请信息</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">发票信息</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">信息表流水号(12位税盘编号+12位蓝票开票时间YYMMDDHHMMSS)</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回</p>
|
||||
<p>4、矿产品类专用信息表（涉及销售数量和金额变更）</p>
|
||||
<p>5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票代码</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票号码</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>对应蓝票开票日期</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税种类别(0:营业税 1:增值税)</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxRate</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">多税率标志(0:一票一税率 1:一票多税率)</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAddress</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方地址</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerPhone</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方电话</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerBank</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方银行</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAccount</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方账号</td>
|
||||
<td style="text-align: center;">30</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreeAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">不含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">合计税额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>填开时间</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applyRemark</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">申请说明（购方已抵扣：1100000000,购方未抵扣：1010000000,销售方申请：0000000100）</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">businessTaxCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">营业税标志</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billInfoNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">信息表编号</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">信息表状态(-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销)</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billMessage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">[信息表状态代码]信息表状态描述</td>
|
||||
<td style="text-align: center;">300</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">pdfUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">申请表pdf url</td>
|
||||
<td style="text-align: center;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">specificFactor</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>特定要素特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票</p>
|
||||
<p>注：开具矿产品发票时必传，此时billType只能为4或5</p></td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **商品明细** detailList | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | String | 是 | 单据明细序号 | 5 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | decimal | 是 | 税率 | 1 |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识，0:不使用;1:使用 | 2 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"billNo": "12345678901234567890097q",</p>
|
||||
<p>"billType": "0",</p>
|
||||
<p>"oriInvoiceCode": "005000181530",</p>
|
||||
<p>"oriInvoiceNumber": "45625450",</p>
|
||||
<p>"oriInvoiceTime": null,</p>
|
||||
<p>"taxType": "1",</p>
|
||||
<p>"taxRate": "0",</p>
|
||||
<p>"buyerName": "officia in irure",</p>
|
||||
<p>"buyerTaxnum": "CILLUM",</p>
|
||||
<p>"sellerName": "Excepteur dolor ",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"taxFreeAmountTotal": "-1.00",</p>
|
||||
<p>"taxTotal": "-1.00",</p>
|
||||
<p>"billTime": "2020-05-26 03:14:15",</p>
|
||||
<p>"applyRemark": "0000000100",</p>
|
||||
<p>"businessTaxCode": "0000000000",</p>
|
||||
<p>"billInfoNo": "",</p>
|
||||
<p>"billStatus": 2,</p>
|
||||
<p>"billMessage": "[B900006]申请单号不能为空或者格式不正确",</p>
|
||||
<p>"pdfUrl": "",</p>
|
||||
<p>"detailList": [</p>
|
||||
<p>{</p>
|
||||
<p>"id": "178",</p>
|
||||
<p>"billNo": "12345678901234567890097q",</p>
|
||||
<p>"detailIndex": 1,</p>
|
||||
<p>"goodsName": "Ut min",</p>
|
||||
<p>"withTaxFlag": null,</p>
|
||||
<p>"goodsPrice": "0.0000000000000000",</p>
|
||||
<p>"taxFreePrice": "0.0900000000000000",</p>
|
||||
<p>"goodsNum": "-1.0000000000000000",</p>
|
||||
<p>"taxrate": "0.09",</p>
|
||||
<p>"specType": "nost",</p>
|
||||
<p>"goodsUnit": "aliqu",</p>
|
||||
<p>"goodsCode": "esseonsequ",</p>
|
||||
<p>"goodsCodeAbb": "irure in",</p>
|
||||
<p>"favouredPolicyFlag": 0,</p>
|
||||
<p>"zeroRateFlag": "",</p>
|
||||
<p>"favouredPolicyName": "",</p>
|
||||
<p>"selfCode": "sed Lorem",</p>
|
||||
<p>"deduction": "0.00",</p>
|
||||
<p>"taxAmount": "-0.01",</p>
|
||||
<p>"taxFreeAmount": "-0.09",</p>
|
||||
<p>"tax": "-0.01",</p>
|
||||
<p>"createTime": "2020-06-04 11:13:00",</p>
|
||||
<p>"updateTime": "2020-06-04 11:13:00"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,418 @@
|
||||
---
|
||||
title: 红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
aliases:
|
||||
- 红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
- 诺税通红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
- 红字信息表-红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/red-apply-submit`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表申请接口（不支持拆分，不推荐使用）
|
||||
|
||||
### 接口说明
|
||||
|
||||
针对专用发票进行红字信息表申请接口，不支持机动车专票按退货方式（信息表类型为2时）申请红字信息表时，自动拆分成8行一个信息表。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-----------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/red-apply-submit |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">发票种类</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">24位申请单号（12位开票设备编号+12位流水）</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更）</p>
|
||||
<p>5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）</p>
|
||||
<p>默认为：0正常</p>
|
||||
<p>注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单）</p>
|
||||
<p>若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填。</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票代码</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票号码</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;"><del>oriInvoiceTime</del></td>
|
||||
<td style="text-align: center;"><del>String</del></td>
|
||||
<td style="text-align: center;"><del>否</del></td>
|
||||
<td style="text-align: center;"><p><del>蓝票填开时间（yyyy-MM-dd HH:mm:ss）</del></p>
|
||||
<p><del>除了购方已抵扣，若没有对应的蓝票信息，oriInvoiceTime需必填</del></p></td>
|
||||
<td style="text-align: center;"><del>19</del></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>蓝票填开时间（YYYYMM）</p>
|
||||
<p>除了购方已抵扣，若没有对应的蓝票信息，blueInvoiceTime需必填，新局端要求上传对应蓝字发票开具时间（年月）</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAddress</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方地址</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerPhone</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方电话</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerBank</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方银行</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAccount</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方账号</td>
|
||||
<td style="text-align: center;">30</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">operator</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">经办人</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applyRemark</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请说明</p>
|
||||
<p>(购方已抵扣：1100000000 购方未KJ抵扣：1010000000 销售方申请：0000000100)</p></td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">productOilFlag</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>成品油标识 0,非成品油;1,成品油</p>
|
||||
<p>若没有对应的蓝票信息，productOilFlag必填</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">11</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">terminalNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">终端号</td>
|
||||
<td style="text-align: center;">11</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">machineNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">机器号</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">deptId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（本地系统中的id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（本地系统中的id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">bizCallbackUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">业务系统回调地址</td>
|
||||
<td style="text-align: center;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">detailList</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">商品明细</td>
|
||||
<td style="text-align: center;">无</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">specificFactor</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票</p>
|
||||
<p>注：开具矿产品发票时必传，此时billType只能为4或5，成品油发票特定要素和成品油标识选一即可，均传以特定要素为准。</p></td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付手机号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付邮箱地址</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">250</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **商品明细** detailList | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | String | 是 | 单据明细序号 | 5 |
|
||||
| commodityCode | String | 否 | 商品编码 | 64 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | decimal | 是 | 税率 | (15,2) |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识，0:不使用;1:使用 | 2 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"invoiceLine": "s",</p>
|
||||
<p>"billNo": "",</p>
|
||||
<p>"billType": "0",</p>
|
||||
<p>"oriInvoiceCode": "5000201530",</p>
|
||||
<p>"oriInvoiceNumber": "67523624",</p>
|
||||
<p>"oriInvoiceTime": "2020-11-12 00:00:00",</p>
|
||||
<p>"sellerName": "移动测试盘326",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"buyerName": "326专26",</p>
|
||||
<p>"buyerTaxnum": "339901999999513",</p>
|
||||
<p>"operator": "超级管理员",</p>
|
||||
<p>"applyRemark": "0000000100",</p>
|
||||
<p>"productOilFlag": 0,</p>
|
||||
<p>"extensionNumber": "",</p>
|
||||
<p>"terminalNumber": "",</p>
|
||||
<p>"departmentId": "",</p>
|
||||
<p>"userId": "",</p>
|
||||
<p>"detailList": [</p>
|
||||
<p>{</p>
|
||||
<p>"deduction": 0.0,</p>
|
||||
<p>"detailIndex": 1,</p>
|
||||
<p>"favouredPolicyFlag": 1,</p>
|
||||
<p>"favouredPolicyName": "即征即退",</p>
|
||||
<p>"goodsCode": "商品编码",</p>
|
||||
<p>"goodsCodeAbb": "商品编码简称",</p>
|
||||
<p>"goodsName": "商品名称",</p>
|
||||
<p>"goodsNum": -1,</p>
|
||||
<p>"goodsPrice": 1,</p>
|
||||
<p>"goodsUnit": "元",</p>
|
||||
<p>"selfCode": "企业自行编码",</p>
|
||||
<p>"specType": "规格型号",</p>
|
||||
<p>"tax": -0.03,</p>
|
||||
<p>"taxAmount": -1.03,</p>
|
||||
<p>"taxFreeAmount": -1,</p>
|
||||
<p>"taxFreePrice": 1,</p>
|
||||
<p>"taxrate": "0.03",</p>
|
||||
<p>"withTaxFlag": 0,</p>
|
||||
<p>"zeroRateFlag": "1"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 查询成功 | 详细信息 | 1024 |
|
||||
| data | String | 否 | "661545615505210618135603" | 提交成功则返回billNo申请编号 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message":"成功",</p>
|
||||
<p>"data": "661545615505210618135603"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":"400",</p>
|
||||
<p>"message":"参数校验失败"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 状态码说明
|
||||
|
||||
| | |
|
||||
|:-----------|:-------------|
|
||||
| **状态码** | **描述** |
|
||||
| 200 | 查询成功 |
|
||||
| 400 | 参数校验失败 |
|
||||
@ -0,0 +1,410 @@
|
||||
---
|
||||
title: 红字信息表申请接口（支持拆分）
|
||||
aliases:
|
||||
- 红字信息表申请接口（支持拆分）
|
||||
- 诺税通红字信息表申请接口（支持拆分）
|
||||
- 红字信息表-红字信息表申请接口（支持拆分）
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字信息表申请接口（支持拆分）
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[04_红字信息表]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../04_红字信息表.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[04_红字信息表]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/red-apply-submit-split`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字信息表申请接口（支持拆分）
|
||||
|
||||
### 接口说明
|
||||
|
||||
专用发票红字信息表申请接口，支持机动车专票按退货方式（信息表类型为2时）申请红字信息表时自动拆分成8行一个信息表。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/red-apply-submit-split |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">invoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">发票种类</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">24位申请单号（12位开票设备编号+12位蓝票开票时间YYMMDDHHMMSS）</td>
|
||||
<td style="text-align: center;">24</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更）</p>
|
||||
<p>5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）</p>
|
||||
<p>默认为：0正常</p>
|
||||
<p>注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单）</p>
|
||||
<p>若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填。</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票代码</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">oriInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票号码</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>蓝票填开时间（YYYYMM）</p>
|
||||
<p>除了购方已抵扣，若没有对应的蓝票信息，blueInvoiceTime需必填，新局端要求上传对应蓝字发票开具时间（年月）</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAddress</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方地址</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerPhone</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方电话</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerBank</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方银行</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerAccount</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方账号</td>
|
||||
<td style="text-align: center;">30</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">operator</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">经办人</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applyRemark</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请说明</p>
|
||||
<p>(购方已抵扣：1100000000 ，购方未抵扣：1010000000， 销售方申请：0000000100)</p></td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">productOilFlag</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>成品油标识 0,非成品油;1,成品油</p>
|
||||
<p>若没有对应的蓝票信息，productOilFlag必填</p></td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">11</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">terminalNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">终端号</td>
|
||||
<td style="text-align: center;">11</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">machineNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">机器编号</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">deptId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（本地系统中的id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（本地系统中的id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">bizCallbackUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">业务系统回调地址</td>
|
||||
<td style="text-align: center;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">detailList</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">商品明细</td>
|
||||
<td style="text-align: center;">无</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">specificFactor</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票</p>
|
||||
<p>注：开具矿产品发票时必传，此时billType只能为4或5，成品油发票特定要素和成品油标识选一即可，均传以特定要素为准。</p></td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付手机号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付邮箱地址</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">250</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **商品明细** detailList | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | String | 是 | 单据明细序号 | 5 |
|
||||
| commodityCode | String | 否 | 商品编码 | 64 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | decimal | 是 | 税率 | (15,2) |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识，0:不使用;1:使用 | 2 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"invoiceLine": "s",</p>
|
||||
<p>"billNo": "",</p>
|
||||
<p>"billType": "0",</p>
|
||||
<p>"oriInvoiceCode": "5000201530",</p>
|
||||
<p>"oriInvoiceNumber": "67523624",</p>
|
||||
<p>"oriInvoiceTime": "2020-11-12 00:00:00",</p>
|
||||
<p>"sellerName": "移动测试盘326",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"buyerName": "326专26",</p>
|
||||
<p>"buyerTaxnum": "339901999999513",</p>
|
||||
<p>"operator": "超级管理员",</p>
|
||||
<p>"applyRemark": "0000000100",</p>
|
||||
<p>"productOilFlag": 0,</p>
|
||||
<p>"extensionNumber": "",</p>
|
||||
<p>"terminalNumber": "",</p>
|
||||
<p>"departmentId": "",</p>
|
||||
<p>"userId": "",</p>
|
||||
<p>"detailList": [</p>
|
||||
<p>{</p>
|
||||
<p>"deduction": 0.0,</p>
|
||||
<p>"detailIndex": 1,</p>
|
||||
<p>"favouredPolicyFlag": 1,</p>
|
||||
<p>"favouredPolicyName": "即征即退",</p>
|
||||
<p>"goodsCode": "商品编码",</p>
|
||||
<p>"goodsCodeAbb": "商品编码简称",</p>
|
||||
<p>"goodsName": "商品名称",</p>
|
||||
<p>"goodsNum": -1,</p>
|
||||
<p>"goodsPrice": 1.03,</p>
|
||||
<p>"goodsUnit": "元",</p>
|
||||
<p>"selfCode": "企业自行编码",</p>
|
||||
<p>"specType": "规格型号",</p>
|
||||
<p>"tax": -0.03,</p>
|
||||
<p>"taxAmount": -1.03,</p>
|
||||
<p>"taxFreeAmount": -1,</p>
|
||||
<p>"taxFreePrice": 1,</p>
|
||||
<p>"taxrate": "0.03",</p>
|
||||
<p>"withTaxFlag": 0,</p>
|
||||
<p>"zeroRateFlag": "1"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 查询成功 | 详细信息 | 1024 |
|
||||
| data | String | 否 | "661545615505210618135603,661545615505210618135604" | 提交成功则返回billNo申请编号，多个以英文逗号分隔 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message":"成功",</p>
|
||||
<p>"data": "661545615505210618135603,661545615505210618135604"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":"400",</p>
|
||||
<p>"message":"参数校验失败"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 状态码说明
|
||||
|
||||
| | |
|
||||
|:-----------|:-------------|
|
||||
| **状态码** | **描述** |
|
||||
| 200 | 查询成功 |
|
||||
| 400 | 参数校验失败 |
|
||||
186
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单下载接口.md
Normal file
186
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单下载接口.md
Normal file
@ -0,0 +1,186 @@
|
||||
---
|
||||
title: 红字确认单下载接口
|
||||
aliases:
|
||||
- 红字确认单下载接口
|
||||
- 诺税通红字确认单下载接口
|
||||
- 红字确认单-红字确认单下载接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单下载接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[05_红字确认单]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../05_红字确认单.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[05_红字确认单]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/download.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字确认单下载接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
数电发票红字确认单下载接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:-----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/download.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">identity</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>购销身份：</p>
|
||||
<p>0：我是销售方</p>
|
||||
<p>1：我是购买方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>购销身份为1：我是购买方时，必填</p>
|
||||
<p>确认单状态，0.待确认 1.已确认 2.已过期 3.销方否认 4.已撤销</p></td>
|
||||
<td style="text-align: center;">4</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">startTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">填开起始时间（确认单billuuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd）</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">endTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">填开结束时间(确认单编号有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd)</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">departmentId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（诺税通中的部门id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（诺税通中的用户id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注意：
|
||||
|
||||
1、有红字确认单uuid时，走精确查询；（查询的税号需要符合红字确认单中的销方或购方）
|
||||
|
||||
2、无红字确认单uuid时，必须传购销身份及确认单填开的起始结束时间
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"identity": 0,</p>
|
||||
<p>"billUuid": "1fdsafda350301132998",</p>
|
||||
<p>"startTime": "2020-11-12",</p>
|
||||
<p>"endTime": "2020-11-14",</p>
|
||||
<p>"extensionNum": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
185
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单撤销接口.md
Normal file
185
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单撤销接口.md
Normal file
@ -0,0 +1,185 @@
|
||||
---
|
||||
title: 红字确认单撤销接口
|
||||
aliases:
|
||||
- 红字确认单撤销接口
|
||||
- 诺税通红字确认单撤销接口
|
||||
- 红字确认单-红字确认单撤销接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单撤销接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[05_红字确认单]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../05_红字确认单.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[05_红字确认单]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/cancel.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字确认单撤销接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
数电发票红字确认单撤销接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/cancel.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税号（和组织编码任一必填）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">companyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">组织编码</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">identity</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>撤销方身份：</p>
|
||||
<p>0：销方</p>
|
||||
<p>1：购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单编号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">departmentId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（诺税通中的部门id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（诺税通中的用户id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注：
|
||||
|
||||
3. 有红字确认单申请号、红字确认单编号、红字确认单uuid任一必传
|
||||
|
||||
4. 税号和企业编码任一必填，可通过企业编码转换为税号
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"companyCode": "1234324231",</p>
|
||||
<p>"identity": 0,</p>
|
||||
<p>"billUuid": "1fdsafda350301132998",</p>
|
||||
<p>"extensionNum": 1，</p>
|
||||
<p>"userId": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
501
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单查询接口.md
Normal file
501
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单查询接口.md
Normal file
@ -0,0 +1,501 @@
|
||||
---
|
||||
title: 红字确认单查询接口
|
||||
aliases:
|
||||
- 红字确认单查询接口
|
||||
- 诺税通红字确认单查询接口
|
||||
- 红字确认单-红字确认单查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[05_红字确认单]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../05_红字确认单.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[05_红字确认单]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/query.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字确认单查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
数电发票红字确认单查询接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:--------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/query.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applySource</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请方身份：</p>
|
||||
<p>0 销方</p>
|
||||
<p>1 购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: left;"><p>红字确认单状态：</p>
|
||||
<p>01 无需确认</p>
|
||||
<p>02 销方录入待购方确认</p>
|
||||
<p>03 购方录入待销方确认</p>
|
||||
<p>04 购销双方已确认</p>
|
||||
<p>05 作废（销方录入购方否认）</p>
|
||||
<p>06 作废（购方录入销方否认）</p>
|
||||
<p>07 作废（超72小时未确认）</p>
|
||||
<p>08 作废（发起方撤销）</p>
|
||||
<p>09 作废（确认方撤销）</p></td>
|
||||
<td style="text-align: center;">4</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单编号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">startTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">填开起始时间（确认单申请号/编号/uuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd）</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">endTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">填开结束时间(确认单申请号/编号/uuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd)</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注：
|
||||
|
||||
1、有红字确认单申请号、红字确认单编号、红字确认单uuid时（一个或多个时），走精确查询；（查询的税号需要符合红字确认单中的销方或购方）
|
||||
|
||||
2、无红字确认单申请号、红字确认单编号、红字确认单uuid时，必须传申请方身份及确认单填开的起始结束时间
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"applySource": 1,</p>
|
||||
<p>"billStatus": "01",</p>
|
||||
<p>"billId": "342234232432432423",</p>
|
||||
<p>"billNo": "32432f342df324sewerwe",</p>
|
||||
<p>"billUuid": "3423423dgv324234dfg43r34g43",</p>
|
||||
<p>"startTime": "2022-06-22",</p>
|
||||
<p>"endTime": "2022-06-23"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 8%" />
|
||||
<col style="width: 46%" />
|
||||
<col style="width: 13%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">code</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">状态,200-成功，非200-失败</td>
|
||||
<td style="text-align: center;">6</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">message</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">详细信息</td>
|
||||
<td style="text-align: center;">1024</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">data</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;">查询成功则返回红字确认单信息</td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">发票信息</td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
<td style="text-align: center;"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单编号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: left;"><p>确认单状态</p>
|
||||
<p>-1 提交失败</p>
|
||||
<p>00 提交中</p>
|
||||
<p>01 无需确认</p>
|
||||
<p>02 销方录入待购方确认</p>
|
||||
<p>03 购方录入待销方确认</p>
|
||||
<p>04 购销双方已确认</p>
|
||||
<p>05 作废（销方录入购方否认）</p>
|
||||
<p>06 作废（购方录入销方否认）</p>
|
||||
<p>07 作废（超72小时未确认）</p>
|
||||
<p>08 作废（发起方撤销）</p>
|
||||
<p>09 作废（确认方撤销）</p>
|
||||
<p>15 提交税局中</p>
|
||||
<p>16 提交税局失败</p></td>
|
||||
<td style="text-align: center;">4</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billMessage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">[确认单状态代码]确认单状态描述</td>
|
||||
<td style="text-align: center;">300</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">openStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>开具状态</p>
|
||||
<p>0：未开具</p>
|
||||
<p>1：已开具</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applySource</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请来源</p>
|
||||
<p>0 销方</p>
|
||||
<p>1 购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>填开时间</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreeAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">不含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">合计税额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxAmountTotal</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">含税金额</td>
|
||||
<td style="text-align: center;">15.2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票数电号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>蓝票票种</p>
|
||||
<p>bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)</p>
|
||||
<p>p:电子增值税普通发票，</p>
|
||||
<p>c:增值税普通发票(纸票)，</p>
|
||||
<p>s:增值税专用发票，</p>
|
||||
<p>b:增值税电子专用发票</p></td>
|
||||
<td style="text-align: center;">5</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">vatUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票增值税用途</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">saleTaxUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票消费税用途</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">accountStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">发票入账状态</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redReason</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>冲红原因</p>
|
||||
<p>1开票有误</p>
|
||||
<p>2销货退回</p>
|
||||
<p>3服务中止</p>
|
||||
<p>4销售折让</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">detail</td>
|
||||
<td style="text-align: center;">List</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">确认单明细</td>
|
||||
<td style="text-align: left;"></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **确认单明细** detail | | | | |
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| detailIndex | Integer | 是 | 单据明细序号 | 5 |
|
||||
| blueDetailIndex | Integer | 是 | 对应数电蓝票明细行 | 6 |
|
||||
| goodsName | String | 是 | 商品名称 | 90 |
|
||||
| goodsUnit | String | 否 | 单位 | 22 |
|
||||
| specType | String | 否 | 规格型号 | 40 |
|
||||
| withTaxFlag | int | 是 | 单价含税标志，0:不含税,1:含税 | 1 |
|
||||
| goodsPrice | decimal | 否 | 含税单价 | decimal(32,16) |
|
||||
| taxFreePrice | decimal | 否 | 不含税单价 | decimal(32,16) |
|
||||
| goodsNum | decimal | 否 | 数量 | decimal(32,16) |
|
||||
| taxFreeAmount | decimal | 否 | 不含税金额 | (15,2) |
|
||||
| tax | decimal | 否 | 税额 | (15,2) |
|
||||
| taxAmount | decimal | 否 | 含税金额 | (15,2) |
|
||||
| taxrate | String | 是 | 税率 | 10 |
|
||||
| goodsCode | String | 否 | 税收分类编码 | 19 |
|
||||
| goodsCodeAbb | String | 否 是 | 税收分类编码简称 | 200 |
|
||||
| selfCode | String | 否 | 自行编码 | 20 |
|
||||
| favouredPolicyFlag | String | 是 | 优惠政策标识 | 10 |
|
||||
| favouredPolicyName | String | 否 | 优惠政策内容，如：即征即退、免税、不征税、简易征收等 | 50 |
|
||||
| zeroRateFlag | String | 否 | 零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率 | 2 |
|
||||
| deduction | decimal | 否 | 扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00 | (15,2) |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [</p>
|
||||
<p>{</p>
|
||||
<p>"billId": "12345678901234567890097q",</p>
|
||||
<p>"billNo": "12345678901234567890097q",</p>
|
||||
<p>"billUuid": "sdfcvs3g3554y5y4y54y55445t54",</p>
|
||||
<p>"billStatus": "01",</p>
|
||||
<p>"billMessage": "[B900006]申请单号不能为空或者格式不正确",</p>
|
||||
<p>"openStatus": 1,</p>
|
||||
<p>"applySource": 1,</p>
|
||||
<p>"billTime": "2020-05-26 03:14:15",</p>
|
||||
<p>"taxFreeAmountTotal": "-1.00",</p>
|
||||
<p>"taxTotal": "-1.00",</p>
|
||||
<p>"taxAmountTotal": "-1.00",</p>
|
||||
<p>"blueInvoiceNumber": "45625450",</p>
|
||||
<p>"blueInvoiceTime": null,</p>
|
||||
<p>"blueInvoiceLine": "bs",</p>
|
||||
<p>"sellerName": "Excepteur dolor ",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"buyerName": "officia in irure",</p>
|
||||
<p>"buyerTaxnum": "150301199811285326",</p>
|
||||
<p>"vatUsage": "2",</p>
|
||||
<p>"saleTaxUsage": "1",</p>
|
||||
<p>"accountStatus": "1",</p>
|
||||
<p>"redReason": "1",</p>
|
||||
<p>"detailList": [</p>
|
||||
<p>{</p>
|
||||
<p>"billId": "12345678901234567890097q",</p>
|
||||
<p>"detailIndex": 1,</p>
|
||||
<p>"blueDetailIndex": 2,</p>
|
||||
<p>"goodsName": "Ut min",</p>
|
||||
<p>"withTaxFlag": 0,</p>
|
||||
<p>"goodsPrice": "0.0000000000000000",</p>
|
||||
<p>"taxFreePrice": "0.0900000000000000",</p>
|
||||
<p>"goodsNum": "-1.0000000000000000",</p>
|
||||
<p>"taxrate": "0.09",</p>
|
||||
<p>"specType": "nost",</p>
|
||||
<p>"goodsUnit": "aliqu",</p>
|
||||
<p>"goodsCode": "esseonsequ",</p>
|
||||
<p>"goodsCodeAbb": "irure in",</p>
|
||||
<p>"favouredPolicyFlag": 0,</p>
|
||||
<p>"zeroRateFlag": "",</p>
|
||||
<p>"favouredPolicyName": "",</p>
|
||||
<p>"selfCode": "sed Lorem",</p>
|
||||
<p>"deduction": "0.00",</p>
|
||||
<p>"taxAmount": "-0.01",</p>
|
||||
<p>"taxFreeAmount": "-0.09",</p>
|
||||
<p>"tax": "-0.01"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
526
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单申请接口.md
Normal file
526
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单申请接口.md
Normal file
@ -0,0 +1,526 @@
|
||||
---
|
||||
title: 红字确认单申请接口
|
||||
aliases:
|
||||
- 红字确认单申请接口
|
||||
- 诺税通红字确认单申请接口
|
||||
- 红字确认单-红字确认单申请接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单申请接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[05_红字确认单]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../05_红字确认单.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[05_红字确认单]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/apply.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字确认单申请接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
数电发票红字确认单申请接口。
|
||||
|
||||
注：对数电蓝票进行部分冲红确认单申请时，明细中蓝票序号对应冲红蓝票的明细序号，在开具蓝票时，需保证蓝票的序号为从1开始的连续数字。
|
||||
|
||||
开具蓝票为增值税发票(只支持专票、普票)的红字确认单，暂只支持乐企开票模式。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:--------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/apply.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 23%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单申请单号（需要保持唯一，不传的话系统自动生成一个）</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">applySource</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>申请方身份：</p>
|
||||
<p>0 销方</p>
|
||||
<p>1 购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税号(税号、组织编码其一必填)</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">companyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">组织编码(税号、组织编码其一必填)</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billTime</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>填开时间</p>
|
||||
<p>默认当前时间</p>
|
||||
<p>yyyy-MM-dd HH:mm:ss</p></td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNumber</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">对应蓝票数电号码（数电普票、数电专票都需要，蓝票为数电票必填）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">8</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)</td>
|
||||
<td style="text-align: center;">12</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueInvoiceLine</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>蓝票未在系统时，需要必填</p>
|
||||
<p>蓝票数电发票种类:</p>
|
||||
<p>bs:数电专票(电子),</p>
|
||||
<p>pc:数电普票(电子)，</p>
|
||||
<p>es:数电专票(纸质)；</p>
|
||||
<p>ec:数电普票(纸质)，</p>
|
||||
<p>p:电子增值税普通发票，</p>
|
||||
<p>c:增值税普通发票(纸票)，</p>
|
||||
<p>s:增值税专用发票，</p>
|
||||
<p>b:增值税电子专用发票</p></td>
|
||||
<td style="text-align: center;">5</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">sellerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">销方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方名称</td>
|
||||
<td style="text-align: center;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">buyerTaxnum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">购方税号</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">vatUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票增值税用途（预留字段可为空）</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">saleTaxUsage</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">蓝字发票消费税用途（预留字段可为空）</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">accountStatus</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">发票入账状态（预留字段可为空）</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">redReason</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>冲红原因：</p>
|
||||
<p>1销货退回</p>
|
||||
<p>2开票有误</p>
|
||||
<p>3服务中止</p>
|
||||
<p>4销售折让</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">bizCallbackUrl</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">业务系统回调地址</td>
|
||||
<td style="text-align: center;">255</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">11</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">departmentId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（诺税通中的部门id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（诺税通中的用户id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付手机号码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">notifyEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">交付邮箱地址</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccPhone</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">100</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">ccEmail</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: left;">否</td>
|
||||
<td style="text-align: left;">抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个</td>
|
||||
<td style="text-align: left;">250</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<table style="width:100%;">
|
||||
<colgroup>
|
||||
<col style="width: 20%" />
|
||||
<col style="width: 11%" />
|
||||
<col style="width: 7%" />
|
||||
<col style="width: 44%" />
|
||||
<col style="width: 15%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td colspan="5" style="text-align: center;"><strong>确认单明细</strong> details</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">blueDetailIndex</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">对应数电蓝票的明细序号</td>
|
||||
<td style="text-align: center;">5</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">商品名称</td>
|
||||
<td style="text-align: center;">90</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsUnit</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">单位</td>
|
||||
<td style="text-align: center;">22</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">specType</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">规格型号</td>
|
||||
<td style="text-align: center;">40</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">withTaxFlag</td>
|
||||
<td style="text-align: center;">int</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">单价含税标志，0:不含税,1:含税</td>
|
||||
<td style="text-align: center;">1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsPrice</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">含税单价</td>
|
||||
<td style="text-align: center;">decimal(32,16)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreePrice</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">不含税单价</td>
|
||||
<td style="text-align: center;">decimal(32,16)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsNum</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">数量（传负数）</td>
|
||||
<td style="text-align: center;">decimal(32,16)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxFreeAmount</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">不含税金额（传负数）</td>
|
||||
<td style="text-align: center;">(15,2)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">tax</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">税额（传负数）</td>
|
||||
<td style="text-align: center;">(15,2)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxAmount</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">含税金额（传负数）</td>
|
||||
<td style="text-align: center;">(15,2)</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxrate</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">税率</td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税收分类编码</td>
|
||||
<td style="text-align: center;">19</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">goodsCodeAbb</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税收分类编码简称</td>
|
||||
<td style="text-align: center;">200</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">selfCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">自行编码</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">favouredPolicyFlag</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;"><p>优惠政策标识</p>
|
||||
<p>01：简易征收 02：稀土产品 03：免税 04：不征税 05：先征后退 06：100%先征后退 07：50%先征后退 08：按3%简易征收 09：按5%简易征收 10：按5%简易征收减按1.5%计征 11：即征即退30% 12：即征即退50% 13：即征即退70% 14：即征即退100% 15：超税负3%即征即退 16：超税负8%即征即退 17：超税负12%即征即退 18：超税负6%即征即退</p></td>
|
||||
<td style="text-align: center;">10</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">favouredPolicyName</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">优惠政策内容，如：即征即退、免税、不征税、简易征收等</td>
|
||||
<td style="text-align: center;">50</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">zeroRateFlag</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">deduction</td>
|
||||
<td style="text-align: center;">decimal</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00</td>
|
||||
<td style="text-align: center;">(15,2)</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注：
|
||||
|
||||
1\. 确认单明细不填时，进行全额冲红申请，填写明细信息，为部分冲红申请。
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"billId": "661545615505210618135603",</p>
|
||||
<p>"applySource": 1,</p>
|
||||
<p>"billTime": "2020-11-12 00:00:00",</p>
|
||||
<p>"blueInvoiceNumber": "5000201530",</p>
|
||||
<p>"blueInvoiceLine": "bs",</p>
|
||||
<p>"sellerName": "移动测试盘326",</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"buyerName": "326专26",</p>
|
||||
<p>"buyerTaxnum": "339901999999513",</p>
|
||||
<p>"vatUsage": "1",</p>
|
||||
<p>"saleTaxUsage": "2",</p>
|
||||
<p>"accountStatus": "1",</p>
|
||||
<p>"redReason": "1",</p>
|
||||
<p>"extensionNum": "0",</p>
|
||||
<p>"departmentId": 123,</p>
|
||||
<p>"userId": 1,</p>
|
||||
<p>"details": [</p>
|
||||
<p>{</p>
|
||||
<p>"blueDetailIndex": 2,</p>
|
||||
<p>"favouredPolicyName": "",</p>
|
||||
<p>"goodsCode": "1070304080000000000",</p>
|
||||
<p>"goodsCodeAbb": "中成药",</p>
|
||||
<p>"goodsName": "胶囊",</p>
|
||||
<p>"goodsNum": -1,</p>
|
||||
<p>"goodsPrice": 13.56,</p>
|
||||
<p>"goodsUnit": "盒",</p>
|
||||
<p>"specType": "中成药胶囊1",</p>
|
||||
<p>"tax": -1.56,</p>
|
||||
<p>"taxAmount": -13.56,</p>
|
||||
<p>"taxFreeAmount": -12.00,</p>
|
||||
<p>"taxFreePrice": 12,</p>
|
||||
<p>"taxrate": "0.13",</p>
|
||||
<p>"withTaxFlag": 1,</p>
|
||||
<p>"zeroRateFlag": ""</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 查询成功 | 详细信息 | 1024 |
|
||||
| data | String | 否 | "661545615505210618135603" | 提交成功则返回billId申请编号 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message":"成功",</p>
|
||||
<p>"data": "661545615505210618135603"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":"400",</p>
|
||||
<p>"message":"参数校验失败"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 状态码说明
|
||||
|
||||
| | |
|
||||
|:-----------|:-------------|
|
||||
| **状态码** | **描述** |
|
||||
| 200 | 查询成功 |
|
||||
| 400 | 参数校验失败 |
|
||||
201
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单确认接口.md
Normal file
201
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单确认接口.md
Normal file
@ -0,0 +1,201 @@
|
||||
---
|
||||
title: 红字确认单确认接口
|
||||
aliases:
|
||||
- 红字确认单确认接口
|
||||
- 诺税通红字确认单确认接口
|
||||
- 红字确认单-红字确认单确认接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 红字确认单确认接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[05_红字确认单]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../05_红字确认单.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[05_红字确认单]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/confirm.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 红字确认单确认接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
数电发票红字确认单确认接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/confirm.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 25%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 9%" />
|
||||
<col style="width: 43%" />
|
||||
<col style="width: 11%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: center;"><strong>名称</strong></td>
|
||||
<td style="text-align: center;"><strong>类型</strong></td>
|
||||
<td style="text-align: center;"><strong>必填</strong></td>
|
||||
<td style="text-align: center;"><strong>描述</strong></td>
|
||||
<td style="text-align: center;"><strong>长度</strong></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">taxNum</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">税号（和组织编码任一必填）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">companyCode</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">组织编码</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">identity</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;"><p>确认方身份：</p>
|
||||
<p>0：销方</p>
|
||||
<p>1：购方</p></td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billUuid</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单uuid</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billId</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单申请单号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">billNo</td>
|
||||
<td style="text-align: center;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">红字确认单编号</td>
|
||||
<td style="text-align: center;">32</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">confirmAgreement</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">是</td>
|
||||
<td style="text-align: center;">处理意见 0拒绝 1同意</td>
|
||||
<td style="text-align: center;">2</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">confirmReason</td>
|
||||
<td style="text-align: left;">String</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">处理理由</td>
|
||||
<td style="text-align: center;">200</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">extensionNum</td>
|
||||
<td style="text-align: center;">Integer</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">分机号</td>
|
||||
<td style="text-align: center;">-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">departmentId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">部门门店id（诺税通中的部门id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: center;">userId</td>
|
||||
<td style="text-align: center;">Long</td>
|
||||
<td style="text-align: center;">否</td>
|
||||
<td style="text-align: center;">开票人id（诺税通中的用户id）</td>
|
||||
<td style="text-align: center;">20</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
注：
|
||||
|
||||
1. 有红字确认单申请号、红字确认单编号、红字确认单uuid任一必传
|
||||
|
||||
2. 税号和企业编码任一必填，可通过企业编码转换为税号
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"taxNum": "150301199811285326",</p>
|
||||
<p>"companyCode": "1234324231",</p>
|
||||
<p>"identity": 0,</p>
|
||||
<p>"billUuid": "1fdsafda350301132998",</p>
|
||||
<p>"confirmAgreement": 0,</p>
|
||||
<p>"confirmReason": "通过",</p>
|
||||
<p>"extensionNum": 1，</p>
|
||||
<p>"userId": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
132
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/自定义票源下载接口.md
Normal file
132
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/自定义票源下载接口.md
Normal file
@ -0,0 +1,132 @@
|
||||
---
|
||||
title: 自定义票源下载接口
|
||||
aliases:
|
||||
- 自定义票源下载接口
|
||||
- 诺税通自定义票源下载接口
|
||||
- 库存票源与打印-自定义票源下载接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 自定义票源下载接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/stock/downloadStockCustomize.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 自定义票源下载接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
仅支持开票服务器类型为诺诺机柜、诺诺开票。下载成功之后客户端会重新上报可下载库存，之后可以调用查询接口刷新列表数据。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/stock/downloadStockCustomize.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| extensionNum | Integer | 是 | 分机号，纯数字 | \- |
|
||||
| machineNumber | String | 是 | 机器编号，12位数字 | 12 |
|
||||
| downloadableStockList | List | 是 | 可下载票源数量信息列表 | |
|
||||
| 可下载票源数量信息列表 | | | | |
|
||||
| invoiceCode | String | 是 | 要下载号段的发票代码 | |
|
||||
| invoiceLine | String | 是 | 发票种类 | |
|
||||
| invoiceNumStart | String | 是 | 要下载号段的起始发票号码 | |
|
||||
| downloadNum | Integer | 是 | 想要下载的份数，**需要小于等于可下载数量** | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"extensionNum":0,</p>
|
||||
<p>"machineNumber":"661565671900",</p>
|
||||
<p>"sellerTaxnum":"150301199811285326",</p>
|
||||
<p>"downloadableStockList":[</p>
|
||||
<p>{</p>
|
||||
<p>"invoiceCode":"5000201530",</p>
|
||||
<p>"invoiceLine":"p",</p>
|
||||
<p>"invoiceNumStart":"93669589",</p>
|
||||
<p>"downloadNum":10</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | Object | | | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 900,</p>
|
||||
<p>"message": "下载份数要小于等于发票份数",</p>
|
||||
<p>"data": null</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,106 @@
|
||||
---
|
||||
title: 获取DAT加密包文件流接口
|
||||
aliases:
|
||||
- 获取DAT加密包文件流接口
|
||||
- 诺税通获取DAT加密包文件流接口
|
||||
- 车辆辅助与回传-获取DAT加密包文件流接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取DAT加密包文件流接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[08_车辆辅助与回传]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../08_车辆辅助与回传.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[08_车辆辅助与回传]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/getEncryptedStream.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取DAT加密包文件流接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取加密包文件流接口，最多支持获取500张发票的加密包。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:----------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/getEncryptedStream.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | | |
|
||||
|:---------------------:|:--------:|:--------:|:--------:|:---:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | | 20 |
|
||||
| **发票代码+发票号码** | | | | | |
|
||||
| invoiceCode | String | 是 | 发票代码 | 12 | |
|
||||
| invoiceNumber | String | 是 | 发票号码 | 8 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"invoiceAssociations": [</p>
|
||||
<p>{</p>
|
||||
<p>"invoiceCode": "1500020560",</p>
|
||||
<p>"invoiceNumber": "87609473"</p>
|
||||
<p>}</p>
|
||||
<p>],</p>
|
||||
<p>"sellerTaxnum": "150301199811285326"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--------:|:--------:|:--------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | String | | 返回base64加密的文件内容 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": "dkSMheZ+2xkuW55b5HY5yzBIyrmKhRyhc9gnXHG5UOLUQnJoGCZkCg6h8hSgBAuneXD3z9uuT3rFd5VJBUripEa2IUWj5NYYvwkoku8ZSYL8xp4WGVx/Mkvprat8olT4WgDlIhJ1H8w1SVQ7oyoi8AcMBFTxDQ40eWBssK7tDaV5ND250xBe+qi1mso17pAkGvUzo2Kxz2VsWDd258sGYl3/7iEqyR5+eE4HwTc8h0+tuhPJtSw/WvyEEAcTHJFUZDW3mKqtXYHvWtRI9qqx2DU9bt+M2BveaWdLDqB6oXdluQJojWW7YjDT/MVVVnONVZnQXv5mtGKZNFG1snj/zTZdT4ucEKa7e0GSujP2HT6HNQcXLGfnB4QoLpTVpgNrDjrZJZSuTBTO/V7J2aEVVNzYODfKMIcDBp3mpVhD2HUUNl/bqnLemOkjkVJ6cCaa4lUOBz9nSD8TfNAagkrzph12M/ltmcRZrXTOdlaDwUF+GD15Vjv4MtKLHxnlYFK71CsDCT/F0lR8fo7NNiQJb7qnuadsRyAraK1lcneByLwJldkKpcYjOeO+4D/Sx0G/7WTw5mJTP08nXPUpwiP96PVI+jHmiQlK6IglFzZTrC6X5dMtWnxr1zdsF//I7rugfumlU1uS+IGLEpv/zTR9mxkZ1sOVzgjz+V8P3POrXU0Oi6O7n019qZd4a6hx2dGjau8STDevRNNm2Qz93HROjsdTWTC+5GYuCLbp+TVNJEx36BnIOgAR6+tj+jtCw4+cW7u7ILY1AkYA/anshTeTnUlCdglZuVsyFDTz+riy6wVwkcpqR0tN7t9rZPNLd3B/xeHxYsf50Th/kcVjo5qaSw=="</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,119 @@
|
||||
---
|
||||
title: 获取下一张发票号码代码接口（A9+机柜）
|
||||
aliases:
|
||||
- 获取下一张发票号码代码接口（A9+机柜）
|
||||
- 诺税通获取下一张发票号码代码接口（A9+机柜）
|
||||
- 库存票源与打印-获取下一张发票号码代码接口（A9+机柜）
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取下一张发票号码代码接口（A9+机柜）
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/getNextInvoice.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取下一张发票号码代码接口（A9+机柜）
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取下一张发票号码代码，全本地（A9+机柜），半本地（机柜）
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/getNextInvoice.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| extensionNum | String | 是 | 分机号 | 5 |
|
||||
| machineNum | String | 是 | 税控设备号（机器编码） | 12 |
|
||||
| terminalNum | String | 否 | 终端号 | 10 |
|
||||
| invoiceLine | String | 必填，发票种类对应枚举值，例:p:普通发票(电子) | 发票种类，c:增值税普通发票(纸票)，s:增值税专用发票，f:收购发票(纸质)，j：机动车发票，u：二手车发票 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum":" 1",</p>
|
||||
<p>"machineNum":" 661929539468",</p>
|
||||
<p>"invoiceLine": "c"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功 | |
|
||||
| 信息 | | | | |
|
||||
| invoiceLine | String | 必填，发票种类对应枚举值 | 发票种类，c:增值税普通发票(纸票)，s:增值税专用发票，f:收购发票(纸质)，j：机动车发票，u：二手车发票 | 1 |
|
||||
| nextInvoiceCode | String | 是 | 下一张发票代码 | 12 |
|
||||
| nextInvoiceNum | String | 是 | 下一张发票号码 | 8 |
|
||||
| remainNum | Integer | 否 | 剩余发票份数 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": [{</p>
|
||||
<p>"invoiceLine": "c",</p>
|
||||
<p>"nextInvoiceCode": "150010020011",</p>
|
||||
<p>"nextInvoiceNum": "23499027",</p>
|
||||
<p>"remainNum": 487</p>
|
||||
<p>},{</p>
|
||||
<p>"invoiceLine": "c",</p>
|
||||
<p>"nextInvoiceCode": "150010020011",</p>
|
||||
<p>"nextInvoiceNum": "23499028",</p>
|
||||
<p>"remainNum": 486</p>
|
||||
<p>}]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
147
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取关联发票接口.md
Normal file
147
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取关联发票接口.md
Normal file
@ -0,0 +1,147 @@
|
||||
---
|
||||
title: 获取关联发票接口
|
||||
aliases:
|
||||
- 获取关联发票接口
|
||||
- 诺税通获取关联发票接口
|
||||
- 作废重开与冲红-获取关联发票接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取关联发票接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/queryInvoiceAsscciationList.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取关联发票接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
获取关联发票接口。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/queryInvoiceAsscciationList.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| dateType | Integer | 是 | 时间类型（0：创建时间，1：开票时间） | 1 |
|
||||
| startDate | String | 是 | 开始时间，最大跨度不得超过180天，格式为yyyy-MM-dd HH:mm:ss | 20 |
|
||||
| endDate | String | 是 | 结束时间，最大跨度不得超过180天，格式为yyyy-MM-dd HH:mm:ss | 20 |
|
||||
| certificateOwnership | String | 选填 | 合格证归属，可多个，多个用英文逗号隔开 | 50 |
|
||||
| uploadStatus | String | 选填 | 工信部上传状态，可多个，多个用英文逗号隔开 | 50 |
|
||||
| buyerName | String | 选填 | 购方名称 | 100 |
|
||||
| invoiceLines | String\[\] | 选填 | 发票种类列表—p电子增值税普通发票，c增值税普通发票(纸票)，s增值税专用发票，e收购发票(电子)，f收购发票(纸质)，u：二手车发票 | \- |
|
||||
| productNatures | Integer\[\] | 选填 | 发票性质列表—0：普通发票；1：成品油发票；2：机动车类专用发票；默认：0：普通发票 | \- |
|
||||
| pageNum | Integer | 选填 | 页码，默认是1，每页条数为20条 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"dateType": 0,</p>
|
||||
<p>"startDate": "2021-09-20 10:00:00",</p>
|
||||
<p>"endDate": "2021-09-21 10:00:00",</p>
|
||||
<p>"certificateOwnership": "三厂",</p>
|
||||
<p>"uploadStatus": "上传成功",</p>
|
||||
<p>"buyerName": "浙江师范大学",</p>
|
||||
<p>"invoiceLines": [</p>
|
||||
<p>"p"</p>
|
||||
<p>],</p>
|
||||
<p>"productNatures": [</p>
|
||||
<p>0</p>
|
||||
<p>],</p>
|
||||
<p>pageNum:1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:----------------:|:----------:|:--------:|:--------------------------:|:--------:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功则返回发票关联信息 | |
|
||||
| **数据信息** | | | | |
|
||||
| pageNum | Integer | 是 | 当前页数 | |
|
||||
| pageSize | Integer | 是 | 每页条数，为固定值20 | |
|
||||
| pages | Integer | 是 | 总页数 | |
|
||||
| total | Integer | 是 | 数据总数 | |
|
||||
| list | List | | 查询成功则返回发票关联信息 | |
|
||||
| **发票关联信息** | | | | |
|
||||
| buyerName | String | 是 | 购方名称 | 100 |
|
||||
| buyerTaxnum | String | 是 | 购方税号 | 20 |
|
||||
| invoiceCode | String | 是 | 发票代码 | 12 |
|
||||
| invoiceNumber | String | 是 | 发票号码 | 8 |
|
||||
| specTypes | String\[\] | 是 | 规格型号列表 | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"data": {</p>
|
||||
<p>"pageNum": 1,</p>
|
||||
<p>"pageSize": 20,</p>
|
||||
<p>"pages": 1,</p>
|
||||
<p>"total": 1,</p>
|
||||
<p>"list": [</p>
|
||||
<p>{</p>
|
||||
<p>"buyerName": "浙江师范大学",</p>
|
||||
<p>"buyerTaxnum": "339901999999142",</p>
|
||||
<p>"invoiceCode": "1500020560",</p>
|
||||
<p>"invoiceNumber": "87609471",</p>
|
||||
<p>"specTypes": [</p>
|
||||
<p>"得力0231"</p>
|
||||
<p>]</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>},</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,164 @@
|
||||
---
|
||||
title: 获取发票勾选入账状态接口
|
||||
aliases:
|
||||
- 获取发票勾选入账状态接口
|
||||
- 诺税通获取发票勾选入账状态接口
|
||||
- 专项能力-获取发票勾选入账状态接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取发票勾选入账状态接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[09_专项能力]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../09_专项能力.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[09_专项能力]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/redConfirm/queryFpgxStatus.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取发票勾选入账状态接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
销方通过接口查询到蓝票的勾选入账状态,接口异步
|
||||
|
||||
核心逻辑： 先进行operateType=1进行数据从数据初始化查询，间隔一会儿之后再进行operateType=0进行查询数据的获取
|
||||
|
||||
限制条件：
|
||||
|
||||
1. operateType=1请求30s一次
|
||||
|
||||
2. 税号+数电账号，每天最多20次
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|----|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/redConfirm/queryFpgxStatus.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** |
|
||||
| saleTaxNum | String | 是 | 销方税号 | 销售发票的纳税人识别号或统一社会信用代码 | 15-20 |
|
||||
| elecInvoiceNumber | String | 否 | 蓝字数电票号码 | 数电号码、蓝票号码代码必须选择其一 | 20 |
|
||||
| invoiceCode | Stirng | 否 | 蓝票发票代码 | | |
|
||||
| invoiceNumber | String | 否 | 蓝票发票号码 | | |
|
||||
| operateType | Integer | 是 | 操作类型 | 操作类型，0-查询，1-税局获取 | 1 |
|
||||
| extensionNum | String | 否 | 分机号 | | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "saleTaxNum":"339901999999008",</p>
|
||||
<p> "elecInvoiceNumber":"23312000000000540819",</p>
|
||||
<p> "invoiceCode":"",</p>
|
||||
<p> "invoiceNumber":"",</p>
|
||||
<p> "extensionNum":"1",</p>
|
||||
<p> "operateType":0</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | 是 | | 查询对象 | |
|
||||
| **数据信息** | | | | | |
|
||||
| invoiceCode | String | 否 | 033001600111 | 发票代码 | |
|
||||
| invoiceNumber | String | 否 | 45738316 | 发票号码 | |
|
||||
| elecInvoiceNumber | String | 否 | 23312000000000540819 | 数电号码 | 20 |
|
||||
| sellerTaxnum | String | 是 | 339902999999789109 | 销方税号 | |
|
||||
| sellerName | String | 是 | 航信培训企业789109 | 销方名称 | |
|
||||
| buyerTaxnum | String | 是 | 915110247729829567 | 购方税号 | |
|
||||
| buyerName | String | 是 | 威远县和平洗煤设备 | 购方名称 | |
|
||||
| invoiceTime | String | 是 | 2023-06-08 13:00:22 | 开票时间 | |
|
||||
| taxFreeAmountTotal | String | 是 | 0.92 | 合计不含税金额 | |
|
||||
| taxAmountTotal | String | 是 | 1.00 | 价税合计 | |
|
||||
| taxTotal | String | 是 | 0.08 | 合计税额 | |
|
||||
| vatUsageCode | String | 是 | 01 | 增值税用途代码 ：00 已勾选未确认, 01已确认, 03未勾选 | 2 |
|
||||
| saleTaxUsageCode | String | 是 | 00 | 消费税用途代码 :00 未勾选,非00 已勾选 | 2 |
|
||||
| accountStatus | String | 是 | 00 | 发票入账状态代码 :00 未入账，01:已入账 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
失败示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "code": 900,</p>
|
||||
<p> "message": "该功能暂停使用或访问，请稍后再试！",</p>
|
||||
<p> "data": <strong>null</strong></p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
成功示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p> "code": 200,</p>
|
||||
<p> "message": "成功",</p>
|
||||
<p> "data": {</p>
|
||||
<p> "invoiceCode": "",</p>
|
||||
<p> "invoiceNumber": "20882305231323060035",</p>
|
||||
<p> "elecInvoiceNumber": "20882305231323060035",</p>
|
||||
<p> "sellerTaxnum": "339902999999789109",</p>
|
||||
<p> "sellerName": "航信培训企业789109",</p>
|
||||
<p> "buyerTaxnum": "915110247729829567",</p>
|
||||
<p> "buyerName": "威远县和平洗煤设备",</p>
|
||||
<p> "invoiceTime": "2023-06-08 13:00:22",</p>
|
||||
<p> "taxFreeAmountTotal": "0.92",</p>
|
||||
<p> "taxAmountTotal": "1.00",</p>
|
||||
<p> "taxTotal": "0.08",</p>
|
||||
<p> "vatUsageCode": "00",</p>
|
||||
<p> "saleTaxUsageCode": "00",</p>
|
||||
<p> "accountStatus": "01"</p>
|
||||
<p> }</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
# 附录
|
||||
@ -0,0 +1,124 @@
|
||||
---
|
||||
title: 获取指定票种当前代码号码
|
||||
aliases:
|
||||
- 获取指定票种当前代码号码
|
||||
- 诺税通获取指定票种当前代码号码
|
||||
- 库存票源与打印-获取指定票种当前代码号码
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取指定票种当前代码号码
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/getInvoiceCode.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取指定票种当前代码号码
|
||||
|
||||
### 接口说明
|
||||
|
||||
指定票种当前代码号码查询接口。
|
||||
|
||||
目前仅支持全自建-A9服务器。
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/getInvoiceCode.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号 | 20 |
|
||||
| extensionNum | String | 选填，至少分机号或机器编号任一必填 | 分机号 | 5 |
|
||||
| machineNum | String | 选填，至少分机号或机器编号任一必填 | 机器编号 | 12 |
|
||||
| terminalNum | String | 否 | 终端号 | 10 |
|
||||
| invoiceLine | String | 必填，发票种类对应枚举值，例:p:普通发票(电子) | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum":" 1",</p>
|
||||
<p>"terminalNum":" 1",</p>
|
||||
<p>"invoiceLine": "p"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 详细信息 | 1024 |
|
||||
| data | List | | 查询成功则返回 | |
|
||||
| 信息 | | | | |
|
||||
| sellerTaxnum | String | 否 | 销方税号 | 20 |
|
||||
| extensionNum | String | 否 | 分机号 | 5 |
|
||||
| machineNum | String | 否 | 机器编号 | 12 |
|
||||
| terminalNum | String | 否 | 终端号 | 10 |
|
||||
| invoiceLine | String | 必填，发票种类对应枚举值，例:p:普通发票(电子) | 发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票 | 1 |
|
||||
| invoiceCode | String | 是 | 当前发票代码 | 12 |
|
||||
| invoiceNum | String | 是 | 当前发票号码 | 8 |
|
||||
| remainNum | Integer | 否 | 剩余发票份数 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"message": "成功",</p>
|
||||
<p>"data": {</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"extensionNum": "1",</p>
|
||||
<p>"machineNum": null,</p>
|
||||
<p>"terminalNum": "1",</p>
|
||||
<p>"invoiceLine": "p",</p>
|
||||
<p>"invoiceCode": "150010020011",</p>
|
||||
<p>"invoiceNum": "23499027",</p>
|
||||
<p>"remainNum": 487</p>
|
||||
<p>}</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,118 @@
|
||||
---
|
||||
title: 获取查询数电登录认证、开票实名认证二维码
|
||||
aliases:
|
||||
- 获取查询数电登录认证、开票实名认证二维码
|
||||
- 诺税通获取查询数电登录认证、开票实名认证二维码
|
||||
- 设备企业与配置-获取查询数电登录认证、开票实名认证二维码
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取查询数电登录认证、开票实名认证二维码
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[07_设备企业与配置]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../07_设备企业与配置.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[07_设备企业与配置]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/auth/authQr.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取查询数电登录认证、开票实名认证二维码
|
||||
|
||||
### 接口说明
|
||||
|
||||
用于数电发票开具时登录扫码认证、短信验证 或 开票实名认证的时候，进行获取或查询认证二维码
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|:---------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/auth/authQr.do |
|
||||
|
||||
### 请求参数
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| taxNum | String | 是 | 税号 | 20 |
|
||||
| extensionNum | Integer | 否 | 分机号，分机号和数电账号任一必填 | \- |
|
||||
| account | String | 否 | 数电账号，分机号和数电账号任一必填 | 20 |
|
||||
| opType | Integer | 否 | 操作类型 0：刷新(认证二维码) 1：查询(认证二维码) 2：刷新(登录二维码) 3：查询(登录二维码) 4：发送短信验证码（短信验证码登录时）5：查询短信验证发送状态,默认1 | 1 |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"taxNum": "150301199811285326"，</p>
|
||||
<p>"extensionNum": 1，</p>
|
||||
<p>"account": "123456"，</p>
|
||||
<p>"opType": 1</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** |
|
||||
| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 是 | 成功 | 详细信息 | 1024 |
|
||||
| data | Object | | | 结果 | |
|
||||
| 二维码信息 | | | | | |
|
||||
| account | String | 否 | 138\*\*\*\*1234 | 用户名/手机号（脱敏处理） | 20 |
|
||||
| taxNum | String | 否 | 150301199811285326 | 税号 | 20 |
|
||||
| qrCodeType | String | 否 | 1 | 二维码类型 1:登录扫码认证多源二维码 2:登录扫码认证税APP二维码 3:登录扫码认证电子营业执照二维码 4:开票实名认证二维码 | 1 |
|
||||
| status | String | 否 | 0 | 获取状态0-获取二维码中/短信发送中；1-成功；2-失败 | 1 |
|
||||
| message | String | 否 | 获取中 | 信息 | 300 |
|
||||
| qrCode | String | 否 | | 登录扫码认证 或 开票实人认证二维码qrcode | \- |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{<br />
|
||||
"code":200,<br />
|
||||
"message": "成功"，</p>
|
||||
<p>"data":</p>
|
||||
<p>{</p>
|
||||
<p>"account": "123456",</p>
|
||||
<p>"taxNum": "1234567890",</p>
|
||||
<p>"qrCodeType": "1",</p>
|
||||
<p>"status": "0",</p>
|
||||
<p>"message": "获取中",</p>
|
||||
<p>"qrCode": "1fsd34s"</p>
|
||||
<p>}<br />
|
||||
}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
127
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取纸票打印编号接口.md
Normal file
127
docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取纸票打印编号接口.md
Normal file
@ -0,0 +1,127 @@
|
||||
---
|
||||
title: 获取纸票打印编号接口
|
||||
aliases:
|
||||
- 获取纸票打印编号接口
|
||||
- 诺税通获取纸票打印编号接口
|
||||
- 库存票源与打印-获取纸票打印编号接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 获取纸票打印编号接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[06_库存票源与打印]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../06_库存票源与打印.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[06_库存票源与打印]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`/salescore/lan/print/ batchPrintInvoiceDecrypt.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 获取纸票打印编号接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
通过该接口获取可以拉起打印助手的加密字符串。
|
||||
|
||||
注意：请按照文档要求提供接口，最多可打印500张发票。
|
||||
|
||||
### 接口地址
|
||||
|
||||
/salescore/lan/print/ batchPrintInvoiceDecrypt.do
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| sellerTaxnum | String | 是 | | | 销方税号 | |
|
||||
| invoiceCodeNumbers | List | 是 | | | 代码号码参数列表 | 100 |
|
||||
| 票据号码金额明细列表 | | | | | | |
|
||||
| invoiceCode | String | 是 | | | 票据代码 | |
|
||||
| invoiceNumber | String | 是 | | | 票据号码 | |
|
||||
| taxAmountTotal | String | 是 | | | 价税合计 | |
|
||||
|
||||
### 请求示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"invoiceCodeNumbers": [</p>
|
||||
<p>{</p>
|
||||
<p>"invoiceCode": "5000191650",</p>
|
||||
<p>"invoiceNumber": "54523588",</p>
|
||||
<p>"taxAmountTotal": "1.09"</p>
|
||||
<p>}</p>
|
||||
<p>]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** |
|
||||
| code | String | 是 | 200 | | 状态码，字符串”200”表示成功，非”200”的字符串表示失败 | 6 |
|
||||
| message | String | 是 | 同步成功 | | 详细信息 | 1024 |
|
||||
| data | String | | | | 用以拉起打印助手的参数，拼接规则如下“webprint: 2,150301199811285326%215d09ed6548424aed811e8cfd39583a03%2102”即可拉起打印助手 | |
|
||||
|
||||
\#####注意拼接规则 webprint:+data (不要带加号)
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code":200,</p>
|
||||
<p>"data":"2,150301199811285326%215d09ed6548424aed811e8cfd39583a03%2102",</p>
|
||||
<p>"message":"成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
失败示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;"><p>{</p>
|
||||
<p>"code": "9999",</p>
|
||||
<p>"message": ""</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -0,0 +1,197 @@
|
||||
---
|
||||
title: 蓝字发票剩余可冲红的金额、税额查询接口
|
||||
aliases:
|
||||
- 蓝字发票剩余可冲红的金额、税额查询接口
|
||||
- 诺税通蓝字发票剩余可冲红的金额、税额查询接口
|
||||
- 作废重开与冲红-蓝字发票剩余可冲红的金额、税额查询接口
|
||||
tags:
|
||||
- water-docs
|
||||
- nuoshuitong
|
||||
- invoice-api
|
||||
- obsidian
|
||||
- single-interface
|
||||
source_docx: ../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx
|
||||
source_type: converted-and-split
|
||||
---
|
||||
# 蓝字发票剩余可冲红的金额、税额查询接口
|
||||
|
||||
> [!info] 导航
|
||||
> 上级索引：[[README]] · [[03_作废重开与冲红]]
|
||||
> 文档链接：[总索引](../README.md) · [分组页](../03_作废重开与冲红.md) · [实施清单](../../NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md)
|
||||
|
||||
> [!note] 来源
|
||||
> 来源原件：[诺诺网-诺税通销项服务对外接口规范v1.3.18.docx](../../../design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx)
|
||||
> 接口分组：[[03_作废重开与冲红]]
|
||||
|
||||
## 字段摘要
|
||||
|
||||
> [!summary] 接口元信息
|
||||
> - 接口地址：`http[s]://\<host\>[:\<port\>]/salescore/lan/scm/query-invoice-red.do`
|
||||
> - 请求方式：`POST`
|
||||
> - 是否回调：否
|
||||
> - 是否主链路：否
|
||||
> - 推荐优先级：扩展/按需
|
||||
|
||||
|
||||
|
||||
## 蓝字发票剩余可冲红的金额、税额查询接口
|
||||
|
||||
### 接口说明
|
||||
|
||||
提供蓝字发票剩余可冲红的金额、税额查询接口
|
||||
|
||||
### 接口地址
|
||||
|
||||
| |
|
||||
|--------------------------------------------------------------------------|
|
||||
| http\[s\]://\<host\>\[:\<port\>\]/salescore/lan/scm/query-invoice-red.do |
|
||||
|
||||
### 请求参数(用json格式接收)
|
||||
|
||||
| | | | | |
|
||||
|:--:|:--:|:--:|:--:|:--:|
|
||||
| **名称** | **类型** | **必填** | **描述** | **长度** |
|
||||
| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 |
|
||||
| buyerName | String | 是 | 购方名称，精确匹配 | \- |
|
||||
| buyerTaxnum | String | 否 | 购方税号，精确匹配 | \- |
|
||||
| invoiceStartTime | String | 否 | 包含头尾，起始日期，精确到日 | \- |
|
||||
| invoiceEndTime | String | 否 | 包含头尾，截止日期，精确到日 | |
|
||||
| invoiceNumber | String | 否 | 发票号码，精确匹配 发票代码有值时，发票号码必填 | |
|
||||
| orderNo | String | 否 | 模糊匹配出全部拆分后规则的订单，举例：入参：A，可返回A_00001 、A_00002 | |
|
||||
| taxAmountTotal | String | 否 | 含税金额，查询大于等于入参金额的发票。 | |
|
||||
| taxFreeAmountTotal | String | 否 | 不含税金额，查询大于等于入参金额的发票。 | |
|
||||
| invoiceLine | List\<String\> | 是 | 发票种类 | |
|
||||
| goodsName | String | 否 | 商品名称，模糊匹配，只要商品明细中包含传入商品名称就返回对应发票信息 | |
|
||||
| invoiceType | Integer | 是 | 发票类型 1,蓝票 | |
|
||||
| invoiceIds | List\<String\> | 否 | 发票流水号 | |
|
||||
| invoiceCode | String | 否 | 发票代码 | |
|
||||
| allElectronicInvoiceNumber | String | 否 | 数电发票号码 | |
|
||||
| pageNum | Integer | 否 | 当前页，默认为1 | |
|
||||
| pageSize | Integer | 否 | 分页条数，默认为15 | |
|
||||
|
||||
### 请求参数示例
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"buyerName": "浙江师范大学",</p>
|
||||
<p>"goodsName": "谷物细粉",</p>
|
||||
<p>"invoiceLine": [</p>
|
||||
<p>"p",</p>
|
||||
<p>"j"</p>
|
||||
<p>],</p>
|
||||
<p>"invoiceType": 1,</p>
|
||||
<p>"pageNum": 1,</p>
|
||||
<p>"pageSize": 15,</p>
|
||||
<p>"sellerTaxnum": "150301199811285326",</p>
|
||||
<p>"invoiceIds": ["21102610281401000004"]</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
### 返回参数
|
||||
|
||||
| | | | |
|
||||
|:--------------------------:|:----------:|:-------------------------:|:--------:|
|
||||
| **名称** | **类型** | **描述** | **长度** |
|
||||
| code | Integer | 状态,200-成功，非200-失败 | 6 |
|
||||
| message | String | 详细信息 | 1024 |
|
||||
| data | list | 查询结果 | |
|
||||
| buyerName | String | 购方名称 | |
|
||||
| buyerTaxnum | String | 购方税号 | \- |
|
||||
| invoiceTime | Date | 开票时间 | \- |
|
||||
| invoiceCode | String | 发票代码 | |
|
||||
| invoiceNumber | String | 发票号码 | |
|
||||
| invoiceId | String | 发票流水号 | |
|
||||
| orderNo | String | 订单编号 | |
|
||||
| taxAmountTotal | BigDecimal | 含税金额 | |
|
||||
| taxFreeAmountTotal | BigDecimal | 不含税金额 | |
|
||||
| taxTotal | BigDecimal | 合计税额 | |
|
||||
| invoiceLine | String | 发票种类 | |
|
||||
| pdfUrl | String | 发票pdf地址 | |
|
||||
| imageUrl | String | 发票图片地址 | |
|
||||
| ofdUrl | String | 发票ofd地址 | |
|
||||
| redTaxAmount | BigDecimal | 可冲红含税金额 | |
|
||||
| redTaxFreeAmount | BigDecimal | 可冲红不含税金额 | |
|
||||
| redTaxTotal | BigDecimal | 可冲红税额 | |
|
||||
| allElectronicInvoiceNumber | String | 数电发票号码 | |
|
||||
| pageNum | Integer | 当前页 | |
|
||||
| pageSize | Integer | 每页显示条数 | |
|
||||
| pages | Integer | 总页数 | |
|
||||
| total | Integer | 总条数 | |
|
||||
|
||||
### 返回示例
|
||||
|
||||
成功示例：
|
||||
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><table>
|
||||
<colgroup>
|
||||
<col style="width: 100%" />
|
||||
</colgroup>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>{</p>
|
||||
<p>"code": 200,</p>
|
||||
<p>"data": {</p>
|
||||
<p>"list": [</p>
|
||||
<p>{</p>
|
||||
<p>"buyerName": "浙江师范大学",</p>
|
||||
<p>"buyerTaxnum": "339901999999142",</p>
|
||||
<p>"imageUrl": "https://invtest.nntest.cn/fp/4ZVOcdXd-2mNx4YoP3hNXrINJSHYL3HA4gm70TaLrdGz3G1YmhriRKQyCM8qH1k5xu0zgSkfY9RvPW2qY442Fw.jpg",</p>
|
||||
<p>"invoiceCode": "011001901011",</p>
|
||||
<p>"invoiceId": "21092615495801000039",</p>
|
||||
<p>"invoiceLine": "p",</p>
|
||||
<p>"invoiceNumber": "92446751",</p>
|
||||
<p>"invoiceTime": 1632642784000,</p>
|
||||
<p>"ofdUrl": "",</p>
|
||||
<p>"orderNo": "458fe678107c4f45867ce1d441a9626d",</p>
|
||||
<p>"pdfUrl": "https://invtest.nntest.cn/fp/4ZVOcdXd-2mNx4YoP3hNXsj5w-6soDHl59Y-RJmc3-_OBpMxMxMjDRKdB-P36JpWGj5uUtg51-_NjiIgM7LTiw.pdf",</p>
|
||||
<p>"redTaxAmount": 1.03,</p>
|
||||
<p>"redTaxFreeAmount": 1.00,</p>
|
||||
<p>"redTaxTotal": 0.03,</p>
|
||||
<p>"taxAmountTotal": 1.03,</p>
|
||||
<p>"taxFreeAmountTotal": 1.00,</p>
|
||||
<p>"taxTotal": 0.03</p>
|
||||
<p>},</p>
|
||||
<p>{</p>
|
||||
<p>"buyerName": "浙江师范大学",</p>
|
||||
<p>"buyerTaxnum": "339901999999142",</p>
|
||||
<p>"imageUrl": "",</p>
|
||||
<p>"invoiceCode": "",</p>
|
||||
<p>"invoiceId": "21102610460701000007",</p>
|
||||
<p>"invoiceLine": "p",</p>
|
||||
<p>"invoiceNumber": "",</p>
|
||||
<p>"orderNo": "c7ab4c44656146d799930c29ca9befb4",</p>
|
||||
<p>"pdfUrl": "",</p>
|
||||
<p>"redTaxAmount": 1.03,</p>
|
||||
<p>"redTaxFreeAmount": 1.00,</p>
|
||||
<p>"redTaxTotal": 0.03,</p>
|
||||
<p>"taxAmountTotal": 1.03,</p>
|
||||
<p>"taxFreeAmountTotal": 1.00,</p>
|
||||
<p>"taxTotal": 0.03</p>
|
||||
<p>}</p>
|
||||
<p>],</p>
|
||||
<p>"pageNum": 1,</p>
|
||||
<p>"pageSize": 15,</p>
|
||||
<p>"pages": 9,</p>
|
||||
<p>"total": 121</p>
|
||||
<p>},</p>
|
||||
<p>"message": "成功"</p>
|
||||
<p>}</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
342
docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md
Normal file
342
docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md
Normal file
@ -0,0 +1,342 @@
|
||||
# 诺税通 DDL（PostgreSQL 16 / openGauss 适配建议）
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 项目名称 | 福建水务营收系统 |
|
||||
| 文档类型 | 外部平台对接数据库方言适配建议 |
|
||||
| 对接平台 | 诺税通 saas |
|
||||
| 适用范围 | PostgreSQL 16、openGauss 场景下的诺税通对接表结构实现 |
|
||||
| 版本 | v1.0 |
|
||||
| 日期 | 2026-03-24 |
|
||||
| 状态 | 草案 |
|
||||
|
||||
## 适用说明
|
||||
|
||||
本文档基于以下文档继续细化：
|
||||
- `docs/guides/NUOSHUITONG_DATABASE_DESIGN.md`
|
||||
- `docs/guides/NUOSHUITONG_DDL_DRAFT.md`
|
||||
|
||||
本文不重复给出全部业务设计，而聚焦 PostgreSQL 16 / openGauss 下的结构落地差异、字段类型建议、主键策略、索引策略与兼容性注意事项，作为后续正式数据库实现与迁移脚本编制的输入。
|
||||
|
||||
## 总体结论
|
||||
|
||||
对于当前诺税通对接表，PostgreSQL 16 与 openGauss 可基本沿用同一套逻辑模型，差异主要集中在：
|
||||
- 自增主键策略
|
||||
- `text/json/jsonb` 选型
|
||||
- 时间类型与默认值写法
|
||||
- 索引能力与语法细节
|
||||
- 约束命名、在线变更和迁移脚本组织方式
|
||||
|
||||
建议策略如下：
|
||||
- **逻辑模型统一**：表结构、字段名、状态字段口径统一维护
|
||||
- **DDL 方言分层**：保留一份逻辑 DDL 草案，再针对 PG16/openGauss 输出方言版本
|
||||
- **优先使用兼容类型**：避免过度依赖仅单方言增强特性
|
||||
|
||||
## 类型适配建议
|
||||
|
||||
### 主键与数值
|
||||
| 逻辑类型 | PostgreSQL 16 建议 | openGauss 建议 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 主键 ID | `bigint` + sequence / identity | `bigint` + sequence / identity | 两侧均可用 |
|
||||
| 整数 | `integer` / `bigint` | `integer` / `bigint` | 保持一致 |
|
||||
| 金额 | `numeric(18,2)` | `numeric(18,2)` | 替代通用 DDL 中的 `decimal(18,2)` |
|
||||
| 数量/单价 | `numeric(18,6)` | `numeric(18,6)` | 保持一致 |
|
||||
| 布尔语义标志 | `smallint` | `smallint` | 建议继续用 `0/1`，避免历史口径不一致 |
|
||||
|
||||
### 字符与大文本
|
||||
| 逻辑类型 | PostgreSQL 16 建议 | openGauss 建议 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 短文本 | `varchar(n)` | `varchar(n)` | 保持一致 |
|
||||
| 长文本报文 | `text` | `text` | 不再使用 MySQL 风格 `longtext` |
|
||||
| URL | `varchar(1024)` | `varchar(1024)` | 保持一致 |
|
||||
|
||||
### 时间类型
|
||||
| 逻辑类型 | PostgreSQL 16 建议 | openGauss 建议 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 业务时间 | `timestamp without time zone` | `timestamp without time zone` | 若系统全局统一时区，可保持此口径 |
|
||||
| 创建/更新时间 | `timestamp without time zone` | `timestamp without time zone` | 与主文档风格统一 |
|
||||
| 默认当前时间 | `CURRENT_TIMESTAMP` | `CURRENT_TIMESTAMP` | 两侧兼容 |
|
||||
|
||||
### JSON / 扩展字段
|
||||
| 场景 | PostgreSQL 16 建议 | openGauss 建议 | 说明 |
|
||||
| --- | --- | --- | --- |
|
||||
| 对接原文强留痕 | `text` | `text` | 最稳妥 |
|
||||
| 需要结构化查询的 JSON 字段 | `jsonb` | `json` 或 `text`（视版本能力） | 若需强兼容，优先 `text` |
|
||||
| 当前诺税通场景 | `text` 优先 | `text` 优先 | 如 `specific_factor_json`、`payload_json` |
|
||||
|
||||
**建议**：诺税通对接首期以兼容优先，所有原始报文与扩展对象字段统一先落 `text`，避免在 openGauss 与 PostgreSQL 16 之间引入额外 JSON 运算差异。
|
||||
|
||||
## 主键策略建议
|
||||
|
||||
### 推荐策略
|
||||
建议统一采用：
|
||||
- `bigint` 主键
|
||||
- 显式 sequence 或 identity
|
||||
- 由应用层雪花 ID / 序列服务统一发号更佳
|
||||
|
||||
### PostgreSQL 16 建议写法
|
||||
```sql
|
||||
id bigint generated by default as identity primary key
|
||||
```
|
||||
|
||||
### openGauss 建议写法
|
||||
若版本兼容 identity，则保持一致；否则可退回：
|
||||
```sql
|
||||
id bigint not null default nextval('seq_ns_invoice')
|
||||
```
|
||||
|
||||
### 实施建议
|
||||
为了避免不同数据库版本行为差异，若你们当前已有统一 ID 生成器，建议：
|
||||
- 数据库字段仅定义 `bigint not null`
|
||||
- 主键值由应用生成
|
||||
|
||||
这样迁移和多库兼容会最稳。
|
||||
|
||||
## 约束与索引适配建议
|
||||
|
||||
### 唯一索引
|
||||
当前草案中的以下唯一约束可直接保留：
|
||||
- `uk_ns_invoice_sys_request_no`
|
||||
- `uk_ns_red_document_bill_no`
|
||||
- `uk_ns_enterprise_billing_config_tax_num`
|
||||
- `uk_ns_platform_event_log_event_key`
|
||||
- `uk_ns_platform_request_log_request_id`
|
||||
|
||||
### 可空唯一索引注意事项
|
||||
如：
|
||||
- `uk_ns_invoice_platform_serial_num`
|
||||
- `uk_ns_red_document_bill_id`
|
||||
|
||||
在 PostgreSQL 16 / openGauss 中，多数情况下允许多个 `NULL`，一般符合当前需求；但若你后续要求“非空且唯一”，建议改成：
|
||||
- 业务侧先判空
|
||||
- 数据库侧用部分索引（若目标方言支持并确认兼容）
|
||||
|
||||
### 索引字段建议
|
||||
对以下场景重点保留组合索引：
|
||||
- 发票状态补偿：`request_status, invoice_status, delivery_status`
|
||||
- 发票查询：`seller_tax_no, invoice_time`
|
||||
- 重试调度：`next_try_time`
|
||||
- 红字查询：`document_type, bill_status, open_status`
|
||||
- 设备健康：`device_status, report_tax_status, clear_card_status`
|
||||
- 库存快照：`seller_tax_no, invoice_line, snapshot_time`
|
||||
|
||||
## 时间字段适配建议
|
||||
|
||||
原 DDL 草案中使用了 `DATETIME`。建议在 PostgreSQL 16 / openGauss 中统一替换为：
|
||||
```sql
|
||||
timestamp without time zone
|
||||
```
|
||||
|
||||
### 推荐替换规则
|
||||
| 草案写法 | PG/openGauss 建议写法 |
|
||||
| --- | --- |
|
||||
| `DATETIME` | `timestamp without time zone` |
|
||||
| `created_at DATETIME NOT NULL` | `created_at timestamp without time zone not null` |
|
||||
| `updated_at DATETIME NOT NULL` | `updated_at timestamp without time zone not null` |
|
||||
|
||||
## 核心表方言适配示例
|
||||
|
||||
## `ns_invoice` PostgreSQL 16 / openGauss 建议写法
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice (
|
||||
id bigint NOT NULL,
|
||||
sys_request_no varchar(64) NOT NULL,
|
||||
order_no varchar(64),
|
||||
source_business_type varchar(32),
|
||||
source_business_id varchar(64),
|
||||
platform_invoice_serial_num varchar(64),
|
||||
invoice_id varchar(64),
|
||||
invoice_code varchar(32),
|
||||
invoice_no varchar(32),
|
||||
all_electronic_invoice_no varchar(64),
|
||||
seller_tax_no varchar(32) NOT NULL,
|
||||
buyer_name varchar(200),
|
||||
buyer_tax_no varchar(64),
|
||||
buyer_address varchar(255),
|
||||
buyer_tel varchar(64),
|
||||
buyer_account varchar(255),
|
||||
invoice_type varchar(16),
|
||||
invoice_line varchar(16),
|
||||
list_flag smallint,
|
||||
with_tax_flag smallint,
|
||||
notify_phone varchar(64),
|
||||
notify_email varchar(128),
|
||||
cc_phone varchar(256),
|
||||
cc_email varchar(256),
|
||||
total_amount numeric(18,2),
|
||||
amount_without_tax numeric(18,2),
|
||||
tax_amount numeric(18,2),
|
||||
request_status varchar(32) NOT NULL,
|
||||
invoice_status varchar(32),
|
||||
invoice_status_text varchar(255),
|
||||
invalid_state varchar(32),
|
||||
delivery_status varchar(32),
|
||||
sync_status varchar(32),
|
||||
pdf_url varchar(1024),
|
||||
ofd_url varchar(1024),
|
||||
image_url varchar(1024),
|
||||
paper_pdf_url varchar(1024),
|
||||
invoice_time timestamp without time zone,
|
||||
request_time timestamp without time zone,
|
||||
invalid_time timestamp without time zone,
|
||||
last_sync_time timestamp without time zone,
|
||||
ori_invoice_code varchar(32),
|
||||
ori_invoice_no varchar(32),
|
||||
old_electronic_invoice_no varchar(64),
|
||||
remark varchar(1000),
|
||||
specific_factor_json text,
|
||||
latest_result varchar(1000),
|
||||
latest_error varchar(1000),
|
||||
try_count integer,
|
||||
last_try_time timestamp without time zone,
|
||||
next_try_time timestamp without time zone,
|
||||
created_at timestamp without time zone NOT NULL,
|
||||
updated_at timestamp without time zone NOT NULL,
|
||||
created_by varchar(64),
|
||||
updated_by varchar(64),
|
||||
CONSTRAINT pk_ns_invoice PRIMARY KEY (id),
|
||||
CONSTRAINT uk_ns_invoice_sys_request_no UNIQUE (sys_request_no)
|
||||
);
|
||||
```
|
||||
|
||||
### 推荐索引
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uk_ns_invoice_platform_serial_num
|
||||
ON ns_invoice (platform_invoice_serial_num);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_order_no
|
||||
ON ns_invoice (order_no);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_status
|
||||
ON ns_invoice (request_status, invoice_status, delivery_status);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_seller_tax_no
|
||||
ON ns_invoice (seller_tax_no);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_invoice_time
|
||||
ON ns_invoice (invoice_time);
|
||||
|
||||
CREATE INDEX idx_ns_invoice_next_try_time
|
||||
ON ns_invoice (next_try_time);
|
||||
```
|
||||
|
||||
## `ns_platform_event_log` PostgreSQL 16 / openGauss 建议写法
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_platform_event_log (
|
||||
id bigint NOT NULL,
|
||||
event_type varchar(32) NOT NULL,
|
||||
event_key varchar(128) NOT NULL,
|
||||
seller_tax_no varchar(32),
|
||||
business_key varchar(128),
|
||||
payload_json text NOT NULL,
|
||||
process_status varchar(32) NOT NULL,
|
||||
process_message varchar(1000),
|
||||
processed_at timestamp without time zone,
|
||||
created_at timestamp without time zone NOT NULL,
|
||||
CONSTRAINT pk_ns_platform_event_log PRIMARY KEY (id),
|
||||
CONSTRAINT uk_ns_platform_event_log_event_key UNIQUE (event_key)
|
||||
);
|
||||
```
|
||||
|
||||
## `ns_invoice_stock_snapshot` PostgreSQL 16 / openGauss 建议写法
|
||||
|
||||
```sql
|
||||
CREATE TABLE ns_invoice_stock_snapshot (
|
||||
id bigint NOT NULL,
|
||||
device_id bigint,
|
||||
seller_tax_no varchar(32) NOT NULL,
|
||||
extension_num varchar(32),
|
||||
machine_num varchar(64),
|
||||
terminal_num varchar(64),
|
||||
invoice_line varchar(16),
|
||||
invoice_code varchar(32),
|
||||
invoice_num_start varchar(32),
|
||||
invoice_num_end varchar(32),
|
||||
remain_num integer,
|
||||
is_default smallint,
|
||||
source_type varchar(16) NOT NULL,
|
||||
snapshot_time timestamp without time zone NOT NULL,
|
||||
created_at timestamp without time zone NOT NULL,
|
||||
CONSTRAINT pk_ns_invoice_stock_snapshot PRIMARY KEY (id)
|
||||
);
|
||||
```
|
||||
|
||||
## openGauss 特别注意事项
|
||||
|
||||
### 1. 避免首期过度依赖 JSONB
|
||||
虽然部分 openGauss 版本具备 JSON 能力，但在迁移期为了降低差异，建议：
|
||||
- `specific_factor_json` 用 `text`
|
||||
- `payload_json` 用 `text`
|
||||
- `request_body/response_body` 用 `text`
|
||||
|
||||
### 2. 避免直接依赖部分索引、表达式索引的高级特性
|
||||
如果后续确实需要，请在 PG16 与 openGauss 两侧分别验证后再引入。
|
||||
|
||||
### 3. 约束命名统一
|
||||
建议所有主键、唯一约束、外键、索引均显式命名，避免迁移工具自动生成差异名称。
|
||||
|
||||
### 4. 时间默认值与更新策略
|
||||
不要依赖 MySQL 风格的 `on update current_timestamp`；建议：
|
||||
- `created_at` 默认应用层写入
|
||||
- `updated_at` 由应用更新
|
||||
- 或用触发器，但触发器策略需单独治理
|
||||
|
||||
## PostgreSQL 16 特别建议
|
||||
|
||||
### 1. 可考虑使用 identity
|
||||
若项目主键策略准备切换到数据库发号，可优先在 PostgreSQL 16 使用：
|
||||
```sql
|
||||
generated by default as identity
|
||||
```
|
||||
|
||||
### 2. 后续可逐步将部分 `text` 字段演进为 `jsonb`
|
||||
适用于：
|
||||
- 平台事件检索增强
|
||||
- `specific_factor_json` 局部结构化查询
|
||||
|
||||
但建议等 openGauss 迁移策略稳定后再做。
|
||||
|
||||
## 迁移实施建议
|
||||
|
||||
### 第一阶段：逻辑模型统一
|
||||
- 保持当前 `ns_` 表结构不变
|
||||
- 所有长文本字段先统一使用 `text`
|
||||
- 所有时间字段统一替换为 `timestamp without time zone`
|
||||
|
||||
### 第二阶段：DDL 方言拆分
|
||||
输出两份实际执行脚本：
|
||||
- `postgresql/nuoshuitong_ddl.sql`
|
||||
- `opengauss/nuoshuitong_ddl.sql`
|
||||
|
||||
### 第三阶段：兼容性验证
|
||||
重点验证：
|
||||
- 唯一约束在空值场景下的行为
|
||||
- 外键创建顺序
|
||||
- 索引创建语句
|
||||
- 迁移工具（如 Flyway/Liquibase）执行兼容性
|
||||
|
||||
## 推荐优先落地表
|
||||
建议在 PostgreSQL 16 / openGauss 两侧先优先验证以下 5 张表：
|
||||
- `ns_invoice`
|
||||
- `ns_invoice_item`
|
||||
- `ns_invoice_reversal`
|
||||
- `ns_billing_device`
|
||||
- `ns_platform_request_log`
|
||||
|
||||
原因：
|
||||
- 覆盖主链路核心对象
|
||||
- 覆盖状态流转
|
||||
- 覆盖设备与日志两类最容易暴露方言差异的场景
|
||||
|
||||
## 后续建议
|
||||
|
||||
建议在本文档基础上继续输出：
|
||||
- PostgreSQL 16 实际可执行版 DDL
|
||||
- openGauss 实际可执行版 DDL
|
||||
- 字段注释脚本
|
||||
- 初始化枚举字典脚本
|
||||
- Flyway / Liquibase 迁移脚本编排建议
|
||||
555
docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md
Normal file
555
docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md
Normal file
@ -0,0 +1,555 @@
|
||||
# 诺税通 saas 对接实施清单
|
||||
|
||||
## 文档信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 项目名称 | 福建水务营收系统 |
|
||||
| 文档类型 | 外部平台对接实施清单 |
|
||||
| 对接平台 | 诺税通 saas |
|
||||
| 适用范围 | 销项开票、发票查询、PDF 获取、重新交付、作废、库存与客户端状态检查 |
|
||||
| 版本 | v1.0 |
|
||||
| 日期 | 2026-03-24 |
|
||||
| 状态 | 已整理 |
|
||||
|
||||
## 适用说明
|
||||
|
||||
本文档用于指导福建水务营收系统对接诺税通 saas 的首期实施工作，聚焦销项发票主链路。内容覆盖接口优先级、字段映射建议、业务流程、错误码处理策略与沙箱测试清单，适合作为实施前评审、开发拆解与联调验收的统一依据。
|
||||
|
||||
当前口径以诺诺开放平台中“诺税通 saas”接口组为准，不再沿用通用 `ElectronInvoice` 接口组作为主实施入口。
|
||||
|
||||
## 接口优先级
|
||||
|
||||
### P0：首批必须接入
|
||||
|
||||
#### 请求开具发票
|
||||
- 方法：`nuonuo.OpeMplatform.requestBillingNew`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100607`
|
||||
- 作用：提交开票请求，获取平台发票流水号，是销项开票主入口。
|
||||
|
||||
#### 发票列表查询
|
||||
- 方法：`nuonuo.OpeMplatform.queryInvoiceList`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100687`
|
||||
- 作用：查询发票列表、状态与基础结果，是查询与状态核对主入口。
|
||||
|
||||
#### 获取电子发票 PDF
|
||||
- 方法：`nuonuo.OpeMplatform.getPDF`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100694`
|
||||
- 作用：获取已开票发票的 PDF 地址，用于下载、预览与交付。
|
||||
|
||||
### P1：首批强烈建议接入
|
||||
|
||||
#### 发票重新交付
|
||||
- 方法：`nuonuo.OpeMplatform.deliveryInvoice`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100696`
|
||||
- 作用：对未收到发票的用户重新通过短信或邮件进行交付。
|
||||
|
||||
#### 发票作废
|
||||
- 方法：`nuonuo.OpeMplatform.invoiceCancellation`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100591`
|
||||
- 作用：退款、撤销或错误开票后的作废处理。
|
||||
|
||||
### P1：开票前保障接口
|
||||
|
||||
#### 企业发票余量查询
|
||||
- 方法：`nuonuo.OpeMplatform.getInvoiceStock`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100599`
|
||||
- 作用：检查票源余量，避免无票或票段不足时继续开票。
|
||||
|
||||
#### 客户端在线状态检测
|
||||
- 方法：`nuonuo.OpeMplatform.GetClientStatus`
|
||||
- 文档入口：`https://jss.com.cn/open/#/api-doc/common-api?id=100598`
|
||||
- 作用：确认客户端或设备在线状态，是开票前健康检查的重要前置条件。
|
||||
|
||||
## 统一接入规范
|
||||
|
||||
### 网关地址
|
||||
- 正式环境：`https://sdk.nuonuo.com/open/v1/services`
|
||||
- 沙箱环境：`https://sandbox.nuonuocs.cn/open/v1/services`
|
||||
|
||||
### 通用消息头
|
||||
- `Content-type`
|
||||
- `X-Nuonuo-Sign`
|
||||
- `accessToken`
|
||||
- `userTax`
|
||||
- `method`
|
||||
|
||||
### 通用消息体
|
||||
- `senid`
|
||||
- `nonce`
|
||||
- `timestamp`
|
||||
- `appkey`
|
||||
|
||||
### 平台侧基础凭据
|
||||
实施前需准备以下内容：
|
||||
- `appKey`
|
||||
- `appSecret`
|
||||
- `accessToken`
|
||||
- 销方税号 / 授权税号
|
||||
- 如采用客户端设备模式，还需准备分机号、机器编号、部门 ID 等运行态配置
|
||||
|
||||
## 请求 / 响应字段映射建议
|
||||
|
||||
### 请求开具发票
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.requestBillingNew`
|
||||
|
||||
#### 请求结构
|
||||
平台私有请求参数顶层为：
|
||||
- `order: Object`
|
||||
|
||||
即业务字段全部封装在 `order` 对象中。
|
||||
|
||||
#### 建议内部模型
|
||||
|
||||
##### 发票主对象 `InvoiceOrder`
|
||||
- `orderNo`：业务订单号
|
||||
- `invoiceType`：开票类型，建议内部固定枚举蓝票/红票
|
||||
- `sellerTaxNo`：销方税号
|
||||
- `buyerName`：购方名称
|
||||
- `buyerTaxNo`：购方税号
|
||||
- `buyerAddress`：购方地址
|
||||
- `buyerTel`：购方电话
|
||||
- `buyerAccount`：购方开户行及账号
|
||||
- `email`：交付邮箱
|
||||
- `phone`：交付手机号
|
||||
- `invoiceLine`：发票类型线别
|
||||
- `listFlag`：清单标志
|
||||
- `pushMode`：交付方式
|
||||
- `departmentId`：部门 ID
|
||||
- `machineCode`：机器编号
|
||||
- `clerkId`：开票员 ID
|
||||
- `payee`：收款人
|
||||
- `remark`：备注
|
||||
|
||||
##### 发票明细对象 `InvoiceItem`
|
||||
- `goodsName`：商品名称
|
||||
- `goodsCode`：税收分类编码
|
||||
- `taxRate`：税率
|
||||
- `quantity`：数量
|
||||
- `unitPrice`：单价
|
||||
- `taxIncludedAmount`：含税金额
|
||||
- `taxExcludedAmount`：不含税金额
|
||||
- `tax`：税额
|
||||
- `invoiceLineProperty`：明细行属性
|
||||
|
||||
#### 响应字段
|
||||
- `invoiceSerialNum`：平台发票流水号
|
||||
|
||||
#### 建议落库字段
|
||||
- `platformInvoiceSerialNum`
|
||||
- `requestStatus`
|
||||
- `requestTime`
|
||||
- `sellerTaxNo`
|
||||
- `orderNo`
|
||||
|
||||
### 发票列表查询
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.queryInvoiceList`
|
||||
|
||||
#### 已确认关键请求字段
|
||||
- `taxnum`：企业税号
|
||||
- `requestType`：查询类型
|
||||
- `0`：按发票添加时间查询
|
||||
- `1`：按开票时间查询
|
||||
- `2`：按发票状态更新时间查询
|
||||
|
||||
#### 建议内部查询参数
|
||||
- `sellerTaxNo`
|
||||
- `queryMode`
|
||||
- `startTime`
|
||||
- `endTime`
|
||||
- `pageNo`
|
||||
- `pageSize`
|
||||
- `invoiceStatus`
|
||||
|
||||
#### 建议响应映射
|
||||
- `platformInvoiceSerialNum`
|
||||
- `invoiceCode`
|
||||
- `invoiceNo`
|
||||
- `invoiceType`
|
||||
- `invoiceStatus`
|
||||
- `invoiceStatusText`
|
||||
- `buyerName`
|
||||
- `buyerTaxNo`
|
||||
- `totalAmount`
|
||||
- `taxAmount`
|
||||
- `invoiceTime`
|
||||
- `pdfUrl`
|
||||
- `orderNo`
|
||||
|
||||
### 获取电子发票 PDF
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.getPDF`
|
||||
|
||||
#### 请求字段
|
||||
- `invoiceCode`：发票代码，数电票时可为空
|
||||
- `invoiceNo`：发票号码，数电票传 20 位号码
|
||||
|
||||
#### 响应字段
|
||||
- `pdfurl`：PDF 地址
|
||||
|
||||
#### 建议内部映射
|
||||
请求：
|
||||
- `invoiceCode`
|
||||
- `invoiceNo`
|
||||
|
||||
响应：
|
||||
- `pdfUrl`
|
||||
- `fetchedAt`
|
||||
|
||||
### 发票重新交付
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.deliveryInvoice`
|
||||
|
||||
#### 请求字段
|
||||
- `taxnum`：销方税号
|
||||
- `invoiceCode`：发票代码，全电发票可为空
|
||||
- `invoiceNum`：发票号码
|
||||
- `phone`：交付手机号
|
||||
- `mail`：交付邮箱
|
||||
|
||||
约束：手机号和邮箱至少一个非空。
|
||||
|
||||
#### 响应字段
|
||||
- `code`
|
||||
- `describe`
|
||||
- `result`
|
||||
|
||||
#### 建议内部映射
|
||||
请求：
|
||||
- `sellerTaxNo`
|
||||
- `invoiceCode`
|
||||
- `invoiceNo`
|
||||
- `deliveryPhone`
|
||||
- `deliveryEmail`
|
||||
|
||||
响应：
|
||||
- `deliveryStatus`
|
||||
- `deliveryMessage`
|
||||
- `deliveryTime`
|
||||
|
||||
### 发票作废
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.invoiceCancellation`
|
||||
|
||||
#### 请求字段
|
||||
- `invoiceId`
|
||||
- `invoiceCode`
|
||||
- `invoiceNo`
|
||||
- `invalidReason`
|
||||
- `specificReason`
|
||||
|
||||
其中：
|
||||
- `invalidReason` 在全电纸票作废时需要传，取值为 `1` 销货退回、`2` 开票有误、`3` 服务中止、`4` 其他
|
||||
- `specificReason` 在作废原因为“其他”时填写具体原因
|
||||
|
||||
#### 响应字段
|
||||
- `invoiceId`
|
||||
|
||||
#### 建议内部映射
|
||||
请求：
|
||||
- `platformInvoiceSerialNum`
|
||||
- `invoiceCode`
|
||||
- `invoiceNo`
|
||||
- `cancelReasonCode`
|
||||
- `cancelReasonText`
|
||||
|
||||
响应：
|
||||
- `platformInvoiceSerialNum`
|
||||
|
||||
### 企业发票余量查询
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.getInvoiceStock`
|
||||
|
||||
#### 请求字段
|
||||
- `departmentId`
|
||||
- `extensionNums`
|
||||
- `machineCode`
|
||||
- `extMachineCodePairs`
|
||||
|
||||
#### 响应字段
|
||||
- `extensionNumber`
|
||||
- `terminalNumber`
|
||||
- `invoiceLine`
|
||||
- `machineCode`
|
||||
- `remainNum`
|
||||
- `invoiceNumStart`
|
||||
- `invoiceNumEnd`
|
||||
- `updateTime`
|
||||
|
||||
#### 建议内部映射
|
||||
- `sellerTaxNo`
|
||||
- `machineCode`
|
||||
- `invoiceLine`
|
||||
- `remainNum`
|
||||
- `invoiceNumStart`
|
||||
- `invoiceNumEnd`
|
||||
- `lastSyncTime`
|
||||
|
||||
### 客户端在线状态检测
|
||||
|
||||
#### 接口
|
||||
`nuonuo.OpeMplatform.GetClientStatus`
|
||||
|
||||
#### 请求字段
|
||||
- `sellerTaxNo`
|
||||
- `extensionNumber`
|
||||
- `machineCode`
|
||||
|
||||
#### 响应字段
|
||||
- `sellerTaxNo`
|
||||
- `sellerName`
|
||||
- `extensionNumber`
|
||||
- `machineCode`
|
||||
- `clientVersion`
|
||||
- `onlineStatus`：`0` 不在线，`1` 在线
|
||||
- `date`
|
||||
|
||||
#### 建议内部映射
|
||||
- `sellerTaxNo`
|
||||
- `machineCode`
|
||||
- `extensionNumber`
|
||||
- `clientVersion`
|
||||
- `onlineStatus`
|
||||
- `checkedAt`
|
||||
|
||||
## 业务流程图
|
||||
|
||||
### 开票主流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[业务订单满足开票条件] --> B[检查客户端在线状态]
|
||||
B -->|不在线| B1[返回不可开票并告警]
|
||||
B -->|在线| C[检查发票余量]
|
||||
C -->|无余量或异常| C1[返回不可开票并告警]
|
||||
C -->|正常| D[组装开票请求 order]
|
||||
D --> E[调用 requestBillingNew]
|
||||
E -->|失败| E1[记录失败原因]
|
||||
E -->|成功| F[保存 invoiceSerialNum]
|
||||
F --> G[调用 queryInvoiceList 或状态查询]
|
||||
G -->|未开票完成| G1[轮询或等待回调]
|
||||
G -->|开票完成| H[调用 getPDF]
|
||||
H --> I[保存 pdfUrl]
|
||||
I --> J[交付给用户]
|
||||
J --> K[结束]
|
||||
```
|
||||
|
||||
### 补发流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[用户未收到发票] --> B[查到已开票记录]
|
||||
B --> C[收集手机号或邮箱]
|
||||
C --> D[调用 deliveryInvoice]
|
||||
D -->|成功| E[记录补发成功]
|
||||
D -->|失败| F[记录失败原因并转人工处理]
|
||||
```
|
||||
|
||||
### 作废流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[订单退款或撤销或开票错误] --> B[查询发票记录]
|
||||
B --> C[确认 invoiceId invoiceCode invoiceNo]
|
||||
C --> D[调用 invoiceCancellation]
|
||||
D -->|成功| E[更新作废申请状态]
|
||||
D -->|失败| F[记录失败原因]
|
||||
```
|
||||
|
||||
## 错误码处理策略
|
||||
|
||||
### A 类：参数错误，直接拦截
|
||||
典型错误码：
|
||||
- `E4000`
|
||||
- `E9101`
|
||||
- `E9102`
|
||||
- `E9104`
|
||||
- `E9106`
|
||||
|
||||
处理建议：
|
||||
- 不重试
|
||||
- 记录请求校验失败
|
||||
- 直接返回调用方明确提示
|
||||
|
||||
### B 类：资质或权限错误，升级处理
|
||||
典型错误码：
|
||||
- `E9301`
|
||||
- `E9302`
|
||||
- `E9338`
|
||||
- `E9513`
|
||||
- `E9548`
|
||||
- `E1001`
|
||||
|
||||
处理建议：
|
||||
- 不自动重试
|
||||
- 标记为配置或权限异常
|
||||
- 通知实施、运维或平台管理员处理
|
||||
|
||||
### C 类：业务状态异常，需要人工介入
|
||||
典型场景：
|
||||
- 发票不存在
|
||||
- 发票不可重复冲红
|
||||
- 发票不能重新交付
|
||||
- 平台返回 `E9999` 且语义为业务错误
|
||||
|
||||
处理建议：
|
||||
- 记录完整请求参数与上下文
|
||||
- 进入人工处理队列
|
||||
|
||||
### D 类：环境与设备状态异常
|
||||
典型场景：
|
||||
- 客户端不在线
|
||||
- 分机号错误
|
||||
- 票源余量不足
|
||||
|
||||
处理建议：
|
||||
- 在开票前即拦截
|
||||
- 不进入正式开票流程
|
||||
- 发出运行告警
|
||||
|
||||
### 建议错误处理表
|
||||
|
||||
| 错误类型 | 是否重试 | 是否告警 | 是否人工介入 |
|
||||
| --- | --- | --- | --- |
|
||||
| 参数错误 | 否 | 否 | 否 |
|
||||
| 企业资质/权限错误 | 否 | 是 | 是 |
|
||||
| 发票不存在 | 否 | 否 | 是 |
|
||||
| 客户端离线 | 否 | 是 | 是 |
|
||||
| 库存不足 | 否 | 是 | 是 |
|
||||
| 平台系统错误 | 有限重试 | 是 | 视情况 |
|
||||
|
||||
### 建议重试策略
|
||||
仅对明显的平台瞬时失败做有限重试：
|
||||
- 最多 2~3 次
|
||||
- 使用指数退避
|
||||
- 对参数错误、资质错误、业务状态错误不重试
|
||||
|
||||
## 沙箱测试清单
|
||||
|
||||
### 环境准备
|
||||
- [ ] 获取沙箱 `appKey`
|
||||
- [ ] 获取沙箱 `appSecret`
|
||||
- [ ] 获取沙箱 `accessToken`
|
||||
- [ ] 确认沙箱测试税号
|
||||
- [ ] 确认已开通 API 开票权限
|
||||
- [ ] 确认测试设备、分机号、机器编号
|
||||
|
||||
### 接口连通性
|
||||
- [ ] 成功调用统一网关
|
||||
- [ ] 签名计算正确
|
||||
- [ ] `accessToken` 可用
|
||||
- [ ] `userTax` 配置正确
|
||||
|
||||
### 开票前检查
|
||||
- [ ] `GetClientStatus` 返回在线
|
||||
- [ ] `getInvoiceStock` 返回库存信息
|
||||
- [ ] 分机号与机器编号识别正确
|
||||
|
||||
### 开票测试
|
||||
- [ ] 成功开具一张蓝票
|
||||
- [ ] 返回 `invoiceSerialNum`
|
||||
- [ ] 发票列表可查到该票
|
||||
- [ ] PDF 地址获取成功
|
||||
- [ ] 邮箱交付成功
|
||||
- [ ] 手机交付成功
|
||||
|
||||
### 异常测试
|
||||
- [ ] 缺少必填字段触发 `E4000`
|
||||
- [ ] 错误税号触发资质或权限异常
|
||||
- [ ] 错误发票号获取 PDF 失败
|
||||
- [ ] 错误发票号重新交付失败
|
||||
- [ ] 错误发票号作废失败
|
||||
|
||||
### 作废测试
|
||||
- [ ] 正常作废成功
|
||||
- [ ] 返回新的 `invoiceId`
|
||||
- [ ] 作废后列表状态与平台侧一致
|
||||
|
||||
### 结果核验
|
||||
- [ ] 业务订单号与平台流水号绑定成功
|
||||
- [ ] PDF 地址成功保存
|
||||
- [ ] 错误日志与请求日志完整
|
||||
- [ ] 所有请求报文可追踪
|
||||
- [ ] 沙箱字段模型与正式环境字段模型保持一致
|
||||
|
||||
## 建议的数据落库字段
|
||||
|
||||
### 发票主表
|
||||
- `order_no`
|
||||
- `seller_tax_no`
|
||||
- `buyer_name`
|
||||
- `buyer_tax_no`
|
||||
- `invoice_type`
|
||||
- `invoice_code`
|
||||
- `invoice_no`
|
||||
- `platform_invoice_serial_num`
|
||||
- `invoice_status`
|
||||
- `invoice_status_text`
|
||||
- `pdf_url`
|
||||
- `total_amount`
|
||||
- `tax_amount`
|
||||
- `invoice_time`
|
||||
- `created_at`
|
||||
- `updated_at`
|
||||
|
||||
### 平台交互日志表
|
||||
- `request_id`
|
||||
- `method`
|
||||
- `request_headers_masked`
|
||||
- `request_body`
|
||||
- `response_body`
|
||||
- `response_code`
|
||||
- `success_flag`
|
||||
- `error_message`
|
||||
- `created_at`
|
||||
|
||||
### 交付记录表
|
||||
- `invoice_id`
|
||||
- `delivery_type`
|
||||
- `delivery_target`
|
||||
- `delivery_status`
|
||||
- `delivery_message`
|
||||
- `delivery_time`
|
||||
|
||||
## 实施建议
|
||||
|
||||
### 第一阶段
|
||||
优先打通：
|
||||
- 在线状态检测
|
||||
- 余量查询
|
||||
- 请求开票
|
||||
- 列表查询
|
||||
- PDF 获取
|
||||
|
||||
### 第二阶段
|
||||
补齐：
|
||||
- 重新交付
|
||||
- 作废
|
||||
|
||||
### 第三阶段
|
||||
再扩展：
|
||||
- 回调与轮询优化
|
||||
- 自动重试
|
||||
- 监控与告警
|
||||
- 对账与审计
|
||||
|
||||
## 当前明确结论
|
||||
|
||||
福建水务营收系统对接诺税通 saas 时，应以以下方法名作为首期实施主入口：
|
||||
- `nuonuo.OpeMplatform.requestBillingNew`
|
||||
- `nuonuo.OpeMplatform.queryInvoiceList`
|
||||
- `nuonuo.OpeMplatform.getPDF`
|
||||
- `nuonuo.OpeMplatform.deliveryInvoice`
|
||||
- `nuonuo.OpeMplatform.invoiceCancellation`
|
||||
- `nuonuo.OpeMplatform.getInvoiceStock`
|
||||
- `nuonuo.OpeMplatform.GetClientStatus`
|
||||
|
||||
不再以通用 `ElectronInvoice` 接口组作为主实施口径。
|
||||
Loading…
x
Reference in New Issue
Block a user