diff --git a/docs/design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx b/docs/design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx new file mode 100644 index 0000000..f9a8a5a Binary files /dev/null and b/docs/design/04_Appendix/Archive/03_Design_Docs/诺诺网-诺税通销项服务对外接口规范v1.3.18.docx differ diff --git a/docs/guides/NUOSHUITONG_DATABASE_DESIGN.md b/docs/guides/NUOSHUITONG_DATABASE_DESIGN.md new file mode 100644 index 0000000..87c6707 --- /dev/null +++ b/docs/guides/NUOSHUITONG_DATABASE_DESIGN.md @@ -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` 对齐，纳入正式专项设计口径 diff --git a/docs/guides/NUOSHUITONG_DDL_DRAFT.md b/docs/guides/NUOSHUITONG_DDL_DRAFT.md new file mode 100644 index 0000000..0675caa --- /dev/null +++ b/docs/guides/NUOSHUITONG_DDL_DRAFT.md @@ -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` 的正式章节对齐 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/01_概述与接入约定.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/01_概述与接入约定.md new file mode 100644 index 0000000..dca12a8 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/01_概述与接入约定.md @@ -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的数。 + +# 接口列表 + diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/02_开票主链路.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/02_开票主链路.md new file mode 100644 index 0000000..df179d8 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/02_开票主链路.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/03_作废重开与冲红.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/03_作废重开与冲红.md new file mode 100644 index 0000000..1d4e487 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/03_作废重开与冲红.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/04_红字信息表.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/04_红字信息表.md new file mode 100644 index 0000000..d49daba --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/04_红字信息表.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/05_红字确认单.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/05_红字确认单.md new file mode 100644 index 0000000..a03e6ae --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/05_红字确认单.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/06_库存票源与打印.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/06_库存票源与打印.md new file mode 100644 index 0000000..eac0251 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/06_库存票源与打印.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/07_设备企业与配置.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/07_设备企业与配置.md new file mode 100644 index 0000000..f60f38e --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/07_设备企业与配置.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/08_车辆辅助与回传.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/08_车辆辅助与回传.md new file mode 100644 index 0000000..8d9e671 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/08_车辆辅助与回传.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/09_专项能力.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/09_专项能力.md new file mode 100644 index 0000000..4289c9b --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/09_专项能力.md @@ -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 使用。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/10_附录_通用状态码.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/10_附录_通用状态码.md new file mode 100644 index 0000000..4f10918 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/10_附录_通用状态码.md @@ -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字段。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/11_枚举清单.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/11_枚举清单.md new file mode 100644 index 0000000..fba9fa9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/11_枚举清单.md @@ -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:含税 + diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/12_标准枚举字典.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/12_标准枚举字典.md new file mode 100644 index 0000000..8e0faeb --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/12_标准枚举字典.md @@ -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(中文计算两位) + diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/README.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/README.md new file mode 100644 index 0000000..f069341 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/README.md @@ -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`。 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度下载_退回接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度下载_退回接口.md new file mode 100644 index 0000000..9e6701a --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度下载_退回接口.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]://\[:\]/salescore/lan/creditQuota/downloadOrReturn.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 乐企授信额度下载/退回接口 + +### 接口说明 + +乐企模式授信额度下载\退回接口，调用该接口时，需保证对应企业税号查询过授信额度。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/creditQuota/downloadOrReturn.do | + +### 请求参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 | +| amount | BigDecimal | 是 | 需要下载\退回的金额，只能为正数数字 | 处理额度 | (12,2) | +| type | Integer | 是 | 0:下载 1:退回 | 请求类型 | 1 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"amount": 100,

+

"type": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | 授信额度使用区间止 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"vestPeriodBegin": "2023-03-01 00:00:00",

+

"vestPeriodEnd": "2023-03-31 00:00:00"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度更新有效期接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度更新有效期接口.md new file mode 100644 index 0000000..d509d2d --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企授信额度更新有效期接口.md @@ -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]://\[:\]/salescore/lan/creditQuota/updateVestPeriod.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 乐企授信额度更新有效期接口 + +### 接口说明 + +乐企模式授信额度更新有效期接口，调用该接口时，需保证对应企业税号查询过授信额度。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/creditQuota/updateVestPeriod.do | + +### 请求参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:------------------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"vestPeriodBegin": "2023-03-01 00:00:00",

+

"vestPeriodEnd": "2023-03-31 00:00:00",

+

"vestPeriod": "202303"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企数电发票库存申领接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企数电发票库存申领接口.md new file mode 100644 index 0000000..d59d639 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企数电发票库存申领接口.md @@ -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]://\[:\]/salescore/lan/fullStock/applyStock.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 乐企数电发票库存申领接口 + +### 接口说明 + +向纳税人提供批量预赋码功能，用于企业给数字化电子发票自动赋发票号码。每次最多申请5000份数字化电子发票。 + +### 接口地址 + +| | +|:------------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/fullStock/applyStock.do | + +### 请求参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 企业税号 | 申领发票的纳税人识别号或统一社会信用代码 | 20 | +| applyNum | Integer | 是 | 申领数量 | 申领数量最大值：5000 | 10 | + +### 请求示例 + + +++ + + + + + +

{

+

"applyNum": 2,

+

"taxNum": "339901999999199"

+

}

+ +### 返回参数 + + ++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值描述长度
codeInteger是200状态,200-成功，非200-失败6
messageString是成功详细信息1024
dataObject是查询对象
数据信息
applyNumInteger是2领用数量10
invoiceNumStartString是23446000000000000042
+

发票起始号码

+
20
invoiceNumEndString是23446000000000000043发票终止号码20
+ +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"applyNum": 2,

+

"invoiceNumStart": "23446000000000000042",

+

"invoiceNumEnd": "23446000000000000043"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企查询数电库存接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企查询数电库存接口.md new file mode 100644 index 0000000..3fa817b --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/乐企查询数电库存接口.md @@ -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]://\[:\]/salescore/lan/fullStock/queryFullStock.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 乐企查询数电库存接口 + +### 接口说明 + +用于查询数电发票库存 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/fullStock/queryFullStock.do | + +### 请求参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:------------------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | 最后领用时间 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"availableNum": 1,

+

"lockNum": 1,

+

"applyTime": "2023-03-01 10:00:00"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备查询接口.md new file mode 100644 index 0000000..efe8a95 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备查询接口.md @@ -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\]://\\[:\\]/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 | | + +### 请求示例 + + +++ + + + + + +

{

+

    "companyId" :"10162",

+

    "taxnum" : "150301199811285326",

+

    "clerkId" : "1",

+

    "invoiceLine" : "c",

+

    "machineNum" : "661565671900",

+

    "extensionNum" : "0"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **更多限制** | **描述** | **最大长度** | +| 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 | | | | 数电账号 | | + +### 返回示例 + + +++ + + + + + +

{

+

    "code": 200,

+

    "message": "成功",

+

    "data": [

+

        {

+

            "invoiceType": "c",

+

            "extensionNum": 0,

+

            "machineNum": "661565671900",

+

            "terminalNum": 1,

+

            "serverType": 14,

+

            "reportTaxStatus": 1,

+

            "clearCardStatus": 1,

+

            "lockDate": "2022-06-15",

+

            "singleBillingLimit": "999999.99",

+

            "offlineAmount": "9999999991.00",

+

            "offlineTime": "720.00",

+

            "updateTime": "2022-05-25 07:37:02",

+

            "clerkIds": "1"

+

        }

+

    ]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备状态查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备状态查询接口.md new file mode 100644 index 0000000..a854dd2 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业设备状态查询接口.md @@ -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]://\[:\]/salescore/extensioninfo/queryEquipmentStatusList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P1（开票前保障） + + + +## 企业设备状态查询接口 + +### 接口说明 + +企业设备状态查询接口。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/extensioninfo/queryEquipmentStatusList.do | + +### 请求参数(用json格式接收) + +| | | | | | +|:-------------:|:--------:|:--------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| extensionNum | String | 选填 | 分机号 | 5 | +| machineNumber | String | 选填 | 机器编号 | 12 | +| sellerTaxnum | String | 是 | 销方税号 | 20 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": "0",

+

"machineNumber": "123",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | | 更新时间 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

    "code":200,

+

    "message":"成功",

+

    "data":[

+

        {

+

            "invoiceLine":"s",

+

            "lockDate":"2020-07-01",

+

            "reportTaxStatus":1,

+

            "clearCardStatus":-1,

+

            "offlineAmount":"111111111080.99",

+

            "offlineTime":"999.00",

+

            "singleBillingLimit":"100000000.00",

+

            "updateTime":"2020-11-25 01:00:01"

+

        },

+

        {

+

            "invoiceLine":"c",

+

            "lockDate":"2020-07-01",

+

            "reportTaxStatus":1,

+

            "clearCardStatus":-1,

+

            "offlineAmount":"111111111019.60",

+

            "offlineTime":"999.00",

+

            "singleBillingLimit":"100000000.00",

+

            "updateTime":"2020-11-25 01:00:01"

+

        },

+

        {

+

            "invoiceLine":"p",

+

            "lockDate":"2020-06-15",

+

            "reportTaxStatus":1,

+

            "clearCardStatus":-1,

+

            "offlineAmount":"320122.95",

+

            "offlineTime":"999.00",

+

            "singleBillingLimit":"9999.99",

+

            "updateTime":"2021-02-02 11:32:01"

+

        },

+

        {

+

            "invoiceLine":"j",

+

            "lockDate":"2020-06-15",

+

            "reportTaxStatus":1,

+

            "clearCardStatus":-1,

+

            "offlineAmount":"999999999.00",

+

            "offlineTime":"999.00",

+

            "singleBillingLimit":"10000000.00",

+

            "updateTime":"2020-11-25 01:00:02"

+

        },

+

        {

+

            "invoiceLine":"r",

+

            "lockDate":"2020-06-15",

+

            "reportTaxStatus":1,

+

            "clearCardStatus":-1,

+

            "offlineAmount":"1111111.11",

+

            "offlineTime":"999.00",

+

            "singleBillingLimit":"10000000.00",

+

            "updateTime":"2020-11-25 01:00:02"

+

        }

+

    ]

+

}

+ +失败示例： + + +++ + + + + + +

{

+

    "code":900,

+

    "message":"不存在该设备抄报税信息",

+

    "data":null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业车架号等信息查询结果回传接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业车架号等信息查询结果回传接口.md new file mode 100644 index 0000000..7332c40 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/企业车架号等信息查询结果回传接口.md @@ -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-不可开票 | + +### 请求示例 + +查询成功回调（表示该车架号可开票）： + + +++ + + + + + +

{

+

"vehicleCode": "5656565",

+

"sellerTaxnum": "338801999999001",

+

"certificate": "125999915630",

+

"status": "1",

+

"extensionNumber": "123",

+

"machineCode": "123456789012",

+

"importCertifyNum": "343455555",

+

"describe": "机动车合格证号可用",

+

"brandModel": "",

+

"engineNum": "",

+

"vehicleType": "",

+

"inspectionOddNum": "",

+

"productOrigin": "",

+

"requestSrc": "4",

+

"vehicleStatus": "1"

+

}

+ +查询失败回调（表示该车架号不可开票）： + + +++ + + + + + +

{

+

"vehicleCode": "5656565",

+

"sellerTaxnum": "338801999999001",

+

"certificate": "125999915630",

+

"status": "2",

+

"describe": "合格证存在，不属于本企业",

+

"requestSrc": "4",

+

"vehicleStatus": "4"

+

}

+ +【describe】字段文案包含： + +1、合格证已被使用 + +2、查询到合格证信息已使用，不允许开具发票 + +3、未查询到合格证信息，不允许开具发票 + + +4、合格证存在，不属于本企业！ + +### 返回参数 + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值更多限制描述最大长度
codeInteger是0000

状态,0000-成功，

+

非0000-失败

6
messageString是成功详细信息1024
+ +### 返回示例 + +示例： + + +++ + + + + + +

{

+

"code": 0000,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建_查询企业车架号_合格证状态接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建_查询企业车架号_合格证状态接口.md new file mode 100644 index 0000000..0866696 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建_查询企业车架号_合格证状态接口.md @@ -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]://\[:\]/salescore/lan/query/vehicleCodeIsInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 创建/查询企业车架号、合格证状态接口 + +### 接口说明 + +仅用于请求车架号在税局的是否可开票状态，改接口返回成功仅说明提交查询请求成功，因需和税局交互，故需异步通过查询或回调获取查询结果。请求成功的数据可至诺税通-库存管理-车辆库存中查看。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/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 | + +### 请求示例 + + +++ + + + + + +

{

+

"vehicleCode": "5656565",

+

"sellerTaxnum": "338801999999001",

+

"certificate": "125999915630",

+

"callbackUrl": "http://127.0.0.1:8080/"，

+

"brandModel": "品牌型号"，

+

"warehouse": "上海"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 提交成功 | | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "提交成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 3001,

+

"message": "结果查询中，请稍候重试"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建开票设备接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建开票设备接口.md new file mode 100644 index 0000000..447d6de --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/创建开票设备接口.md @@ -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]://\[:\]/salescore/extensioninfo/insertExtension.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 创建开票设备接口 + +### 接口说明 + +新增开票设备接口,开票设备唯一性规则：当开票员存在时 同一个开票员+开票设备+票种唯一，当不存在开票员时，针对数电设备分机号或登录账号不可重复，针对其他设备，机器编号不可重复。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/extensioninfo/insertExtension.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString是企业税号20
extensionNumInteger是分机号 0--65535数字-
terminalNumInteger否终端号2
machineNumString否机器编号 非数电设备必填32
serverTypeInteger是

开票服务器类型 传对应的数字枚举

+

1:C48,

+

11:诺诺开票,

+

14：A9,

+

15:四川税局代开,

+

17:诺诺机柜,

+

18:税控服务器,

+

20:单机版,

+

22:数电发票开票模式（通用版）,

+

24:数电发票开票模式（单机版）,

+

25:数电发票开票模式（机柜版）

+

数电单机版和机柜版暂只支持半本地环境

4
loginAccountString否数电开票账号 开票服务器类型为数电时必传20
elePasswordString否数电开票密码，使用aes加密 开票服务器类型为数电时必传加密前1-20位
equipmentCabinetIdString否机柜序列号 当服务器类型为诺诺机柜时必传30
taxMachinePwdString否设备证书口令 当服务器类型为诺诺机柜时必传35
taxPlatPwdString否设备口令 当服务器类型为诺诺机柜时必传100
serverAddressString否服务器地址 当开票服务为A9或C48时必传100
invoiceTypelistString是

当前设备可开发票种类，使用,隔开

+

p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)

-
clerkListList<Long>否开票员userId集合 当设备需要绑定开票员时必传-
projectListList<String>否项目编码集合 当设备需要绑定设备信息时必传-
+ +### 请求示例 + + +++ + + + + + +

{

+

"taxnum": "150301199811285326",

+

"projectList": ["BJ01-002","20221008"],

+

"serverType": 14,

+

"extensionNum": "5",

+

"machineNum": "123456987456",

+

"terminalNum": "5",

+

"serverAddress": "123456",

+

"clerkList": [8,7],

+

"companName": "移动测试盘326",

+

"invoiceTypelist": "b,s,p,c"

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | +| data | String | 是 | 123456789 | 当前新增设备的唯一标识 | 20 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功",

+

"data": "123456789"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/删除发票信息接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/删除发票信息接口.md new file mode 100644 index 0000000..f1b8948 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/删除发票信息接口.md @@ -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]://\[:\]/salescore/lan/invoiceList/delete.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 删除发票信息接口 + +### 接口说明 + +支持开票失败状态发票删除以及开票中状态发票撤回,传入订单编号删除时支持删除审核开票记录。 + +### 接口地址 + +| | +|-----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/invoiceList/delete.do | + +### 请求参数(用json格式接收) + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| valueType | Integer | 是 | 值类型：0：发票流水号，1：订单编号 | \- | +| value | String | 是 | 若值类型为0，value为发票流水号的值；若值类型为1，value为订单编号的值 | \- | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"value": "21051310255001000228",

+

"valueType": 0

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

    "code":200,

+

    "message":"成功",

+

    "data":  null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 900,

+

"message": "非开票失败、开票中状态的发票信息不允许删除",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新可下载发票库存接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新可下载发票库存接口.md new file mode 100644 index 0000000..335bfa9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新可下载发票库存接口.md @@ -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]://\[:\]/salescore/lan/stock/flushDownloadableStock.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 刷新可下载发票库存接口 + +### 接口说明 + +从税局获取局端可下载发票的信息，仅支持开票服务器类型为诺诺机柜和诺诺开票。控制一分钟之内只能操作一次,请勿频繁操作。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/stock/flushDownloadableStock.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 是 | 分机号，纯数字 | \- | +| machineNumber | String | 是 | 机器编号，12位数字 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 900,

+

"message": "一分钟之内只能操作一次,请勿频繁操作",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取开票设备实时发票库存接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取开票设备实时发票库存接口.md new file mode 100644 index 0000000..c704360 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取开票设备实时发票库存接口.md @@ -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]://\[:\]/salescore/lan/stock/refreshLocalStock.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 刷新获取开票设备实时发票库存接口 + +### 接口说明 + +触发刷新获取税盘实时库存接口，仅下发查询指令，需配合库存余量查询接口获取刷新后的实时库存。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/stock/refreshLocalStock.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 否 | 分机号，纯数字 | \- | +| machineNumber | String | 否 | 机器编号，12位数字 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 900,

+

"message": "未找到设备！",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取税盘实时成品油库存接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取税盘实时成品油库存接口.md new file mode 100644 index 0000000..71a1749 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/刷新获取税盘实时成品油库存接口.md @@ -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]://\[:\]/salescore/lan/oilStock/refreshProductOil.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 刷新获取税盘实时成品油库存接口 + +### 接口说明 + +刷新成品油库存接口 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/oilStock/refreshProductOil.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 是 | 分机号，纯数字 | \- | +| machineNumber | String | 否 | 机器编号，12位数字 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 913,

+

"message": "不支持的开票服务器类型！",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票交付.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票交付.md new file mode 100644 index 0000000..9321e1f --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票交付.md @@ -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]://\[:\]/salescore/lan/invoice/delivery.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P1 + + + +## 发票交付 + +### 接口说明 + +发票交付接口，用于提供给企业对诺税通中开具的发票进行交付，具体的短信、邮件发送通道根据不同企业配置决定。 + +### 接口地址 + +| | +|:--------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/invoice/delivery.do | + +### 请求参数 + + ++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值描述最大长度
sellerTaxnumString否150301199811285326销方税号；销方税号和销方组织编码其一必填
sellerCompanyCodeString否10162销方组织编码；销方税号和销方组织编码其一必填
invoiceCodeString否050001901011发票代码12或10位12
invoiceNumberString是93693692

发票号码

+

8或20位

20
notifyPhoneString否交付手机号码；交付电话号码和交付邮箱至少有一个不为空，仅支持一个
notifyEmailString否交付邮箱地址；交付电话号码和交付邮箱至少有一个不为空，仅支持一个
ccPhoneString否抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个100
ccEmailString否抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个250
+ +### 请求实例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"sellerCompanyCode": "",

+

"invoiceCode": "",

+

"invoiceNumber": "93693692",

+

"notifyPhone": "15669968255",

+

"notifyEmail": "zhuyihui@nnuo.com"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票作废申请接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票作废申请接口.md new file mode 100644 index 0000000..e634888 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票作废申请接口.md @@ -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]://\[:\]/salescore/lan/invalid-oneInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P1 + + + +## 发票作废申请接口 + +### 接口说明 + +申请发票作废。 + +### 接口地址 + +| | +|:----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | | +| invalidUserCode | String | 否 | 123 | 否 | 作废操作人用户编码，优先使用操作人id | 20 | +| invalidUserId | Long | 否 | 1 | 否 | 作废操作人ID | 11 | + +### 请求示例 + + +++ + + + + + +

{

+

"invoiceId": "18081620564001000232",

+

"sellerTaxnum": "339901999999610",

+

"invoiceCode": "125999915630",

+

"invoiceNumber": "00130865"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 作废成功 | | 详细信息 | 1024 | +| data | String | 是 | 18081620564001000232 | | 提交成功则返回发票请求流水号 | 32 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "作废成功",

+

"data": "18081620564001000232"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 9151,

+

"message": "非当月纸票不能作废"

+

}

+ +### 状态码说明 + +| | | +|:----------:|:---------------------------------------------------------:| +| **状态码** | **描述** | +| 2733 | 发票不存在 | +| 2739 | 开票未完成，不可进行作废 | +| 2740 | 电票暂不支持作废 | +| 2741 | 发票被冲红不支持作废 | +| 2743 | 非当月发票不支持作废 | +| 2744 | 不支持重复作废 | +| 2749 | 发票已经作废 | +| 2751 | 企业税号不能为空 | +| 2755 | 入参invoiceId不能为空 | +| 2756 | 入参invoiceCode不能为空 | +| 2757 | 入参invoiceNumber不能为空 | +| 2758 | 入参invoiceId查询的发票记录中发票代码和入参发票代码不匹配 | +| 2759 | 入参invoiceId查询的发票记录中发票号码和入参发票号码不匹配 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票列表查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票列表查询接口.md new file mode 100644 index 0000000..82bc6b2 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票列表查询接口.md @@ -0,0 +1,2057 @@ +--- +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]://\[:\]/salescore/lan/queryInvoiceList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P0 + + + +## 发票列表查询接口 + +### 接口说明 + +通过时间、自定义字段分页查询企业发票列表。 + +### 接口地址 + +| | +|:--------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/queryInvoiceList.do | + +### 请求参数 + + ++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值更多限制描述
sellerTaxnumString否150301199811285326销方税号和销方组织编码二选一必填销方税号
companyCodeString否销方税号和销方组织编码二选一必填销方组织编码
requestTypeInteger否0默认为0请求类型，默认是0；0为按照订单添加时间查询，1为按照开票时间查询
startDateString是2021-07-01格式：yyyy-MM-dd,开始时间和结束时间跨度不能超过365天开始时间
endDateString是2021-07-21格式：yyyy-MM-dd,开始时间和结束时间跨度不能超过365天结束时间
columnFirstString否1
columnSecondString否2
columnThreeString否3
isDetailInt否0默认为0

是否包含明细

+

0不包含 1包含

pageNumint否1默认为1当前页
pageSizeint否15默认为15，分页条数最大支持50条分页条数
+ +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"requestType":1,

+

"startDate":"2021-07-01",

+

"endDate":"2021-07-21",

+

"columnFirst":"1",

+

"columnSecond":"2",

+

"columnThree":"3",

+

"isDetail":1,

+

"pageNum":1,

+

"pageSize":15

+

}

+ +### 返回参数 + + ++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值更多限制描述最大长度
codeInteger是200状态,200-成功，非200-失败6
messageString查询成功详细信息1024
dataObject18081620564001000232查询成功则返回数据信息
数据信息
pageNumint是1当前页数
pageSizeint是15每页条数
pagesint是1总页数
totalint是2数据总数
listList查询成功则返回发票信息
发票信息
orderNoString否20170104120207971529订单号64
invoiceIdString否20092114394901000002流水号20
statusInteger否2开票状态(0:开票中1:开票完成2:开票失败3:发票生成2
invalidStateInteger否0发票作废状态: 0 未提交 , 1 作废成功 , 2 作废失败 , 3 已提交(作废中)。默认值02
invalidTimeString否1604576878000发票作废时间
requestSrcInteger否开票方式,0:api接口 1:手工开票 2:批量导入 5:本地提取1
errorMessageString否[9999]HX1000 4003-发票数据写盘失败[TCD_769_25,离线发票累计金额超限！],发票代码或号码为空开票异常信息128
pdfUrlString否https://inv.jss.com.cn/group1/M00/A6/4C/wKgHPll_IU-AVELfAACNq5bmzFM769.pdf发票pdf地址255
paperPdfUrlString否PDF含底图255
imageUrlString否发票jpg地址，清单票发票主信息与清单信息以”,”隔开255
ofdUrlString否发票ofd地址255
invoiceTimeString否1604576878000开票日期19
invoiceCodeString否125999915630发票代码12
invoiceNumberString否00130865发票号码8
allElectronicInvoiceNumberString否数电发票号码20
taxFreeAmountTotalBigDecimal否不含税金额15.2
taxTotalBigDecimal否税额15.2
taxAmountTotalBigDecimal否含税金额15.2
buyerNameString否浙江爱信诺购方名称100
buyerTaxnumString否339901999999103购方税号20
buyerAddressString否浙江省杭州市万塘路购方地址100
buyerPhoneString否15858585858购方电话50
buyerBankString否购方开户行购方开户行100
buyerAccountString否购方银行账号购方银行账号30
invoiceLineString否1发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)2
checkCodeString否校验码20
qrCodeString否二维码3000
machineNumberString否机器编号12
invoiceCipherString否发票密文300
clerkerString否张三开票人20
payeeString否李四收款人20
checkerString否王五复核人20
sellerNameString否浙江爱信诺销方名称100
sellerTaxnumString否330100555190356销方税号20
sellerAddressString否杭州市西湖区万塘路销方地址100
sellerPhoneString否0571-81029365销方电话20
sellerBankString否开户行销方开户行100
sellerAccountString否开户行账号销方开户行账号30
remarkString否备注信息备注

数电电票：200(中文计算一位)

+

其他发票：230(中文计算两位)

productOilFlagInteger否0

成品油标志，

+

0:非成品油;

+

1:成品油

2
vehicleFlagInteger否0默认00：非机动车。1：机动车2
extensionNumInteger否开票请求分机号,范围为0-655355
terminalNumInteger否开票请求终端号5
notifyPhoneString否推送手机20
notifyEmailString否test@xx.com推送邮箱50
deptIdString否9F7E9439CA8B4C60A2FFF3EA3290B088部门门店id（诺诺系统中的id）32
clerkIdString否3F7EA439CA8B4C60A2FFF3EA3290B084开票员id（诺诺系统中的id）32
oriInvoiceCodeString否125999915630原发票代码12
oriInvoiceNumberString否00130865原发票号码8
oldEleInvoiceNumberString否原数电发票号码20
listFlagInteger否0

清单标志，

+

0:非清单，1:清单

2
listGoodsNameString否详见销货清单注意：税局要求清单项目名称为（详见销货清单）90
orderDateString否2022-05-12年-月-日订单日期10
deliverDateString否2022-05-12年-月-日发货日期
columnFirstString否业务调用方自定义字段一业务调用方自定义字段一255
columnSecondString否业务调用方自定义字段二业务调用方自定义字段二255
columnThreeString否业务调用方自定义字段三业务调用方自定义字段三255
projectCodeString否项目编码64
projectNameString否项目名称300
mailNoString否快递单号
businessTypeString否枚举值来源为基础字典配置业务类型
ccPhoneString否抄送手机，多个以英文逗号分隔100
ccEmailString否抄送邮箱，多个以英文逗号分隔250
invalidReasonInteger否数电纸票作废原因 1:销货退回;2:开票有误;3:服务中止;4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）1
specificReasonString否其他作废原因详情（作废原因为4 且回传其他信息时返回）255
specificFactorString否特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具 35矿产品发票50
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
redReasonInteger否11：销售退回2：开票有误3：服务终止4：销售折让冲红原因1
naturalPersonFlagInteger否0购买方自然人标志：0-否（默认）、1-是2
invoiceGoodsTransportsList否货物运输发票时必填货物运输明细最大长度2000
realPropertyRentObject否开具不动产租赁发票时必填不动产租赁发票信息
invoiceBuildingInfoObject否建筑服务发票时必填建筑服务信息
货物运输明细
goodsNameString否煤炭运输货物名称80
originString否北京市市辖区东城区起运地80
destinationString否北京市市辖区丰台区到达地80
transportTool否1运输工具种类：1铁路运输、2公路运输、3.水路运输、4.航空运输、5.管道运输1
transportToolNumString否车牌号DD运输工具牌号80
detailList否发票明细信息
发票明细
detailIndexInteger否0明细行序号5
goodsNameString否商品名称90
taxrateString否0.16税率10
withTaxFlagInteger否

单价含税标志:

+

0:不含税;

+

1:含税

2
taxFreePriceBigDecimal否不含税单价32.16
goodsPriceBigDecimal否含税单价32.16
goodsNumBigDecimal否数量32.16
taxAmountBigDecimal否含税金额15.2
taxFreeAmountBigDecimal否不含税金额15.2
taxBigDecimal否税额15.2
goodsUnitString否单位22
specTypeString否规格型号40
commodityCodeString否商品编码64
goodsCodeString否税收分类编码19
goodsCodeAbbString否税收分类编码简称200
detailTypeInteger否

明细行性质:

+

0:正常行;

+

1:折扣行;

+

2:被折扣行

2
favouredPolicyFlagInteger否

优惠政策标识:

+

0:不使用;

+

1:使用

2
favouredPolicyNameString否优惠政策内容，如：即征即退、免税、简易征收 等50
zeroRateFlagInteger否

零税率标识:

+

空:非零税率;

+

1:免税;

+

2:不征税;

+

3:普通零税率

2
selfCodeString否自行编码20
deductionBigDecimal否扣除额15.2
columnFirstString否自定义字段1255
columnSecondString否自定义字段2255
columnThreeString否自定义字段3255
columnFourString否自定义字段4255
columnFiveString否自定义字段5255
favouredPolicyCodeString否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%即征即退

优惠政策编码

+

数电发票特有字段

机动车(j)/二手车(u)发票明细
vehicleTypeString否车辆类型40
brandModelString否厂牌型号60
productOriginString否产地32
certificateString否合格证号50
importCertifyNumString否进口证明书号50
inspectionOddNumString否商检单号50
engineNumString否发动机号码50
vehicleCodeString否车辆识别代号/车架号码50
taxOfficeCodeString否主营税务机关及代码100
intactCertificateNumString否完税凭证号码50
measureUnitsString否吨位20
maxCapacityString否限乘人数10
produceCompanyNameString否生产企业名称50
organizationCodeString否339901999999103其他证件号码30
organizeTypeString是发票种类为二手车发票返回开票方类型：1.经营单位2.拍卖单位3.二手车市场（二手车专用）2
licenseNumberString是发票种类为二手车发票返回车牌号码（二手车专用）20
registerCertNoString是发票种类为二手车发票返回登记证号（二手车专用）20
vehicleManagementNameString是发票种类为二手车发票返回转入地车辆管理所名称（二手车专用）80
salerNameString是发票种类为二手车发票返回卖方单位/个人名称（二手车专用）80
salerNumString是发票种类为二手车发票返回卖方单位代码/身份证号码（二手车专用）20
salerAddressString否卖方单位/个人地址（二手车专用）80
salerPhoneString否卖方电话（二手车专用）20
不动产租赁发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
rentStartDateString是2023-02-17yyyy-MM-dd格式租赁期起期10
rentEndDateString是2023-02-18yyyy-MM-dd格式租赁期止期10
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位1
建筑服务发票信息
buildingAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入建筑服务发生地-
detailedAddressString否XXXX街道XXX号建筑服务发生地+详细地址最大长度120详细地址120
landVatItemNoString否1234556土地增值税项目编号16
itemNameString是1234556项目名称80
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertySellObject否不动产销售发票时必填不动产销售发票信息
不动产销售发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位10
realPropertyContractNumberString否不动产单元代码/网签合同备案编号28
incrementTaxNumberString否土地增值税项目编号18
priceString否核定计税价格20
taxAmountString否核定计税价格有值时,实际成交含税金额必填实际成交含税金额20
invoiceTravellerTransportInfoListList否开旅客运输发票时传入出行人信息出行人信息
出行人信息
travellerString是出行人20
travelDateString是年-月-日格式出行日期 年-月-日10
travellerCardTypeString是

101-组织机构代码证

+

102-营业执照

+

103-税务登记证

+

199-其他单位证件

+

201-居民身份证

+

202-军官证

+

203-武警警官证

+

204-士兵证

+

205-军队离退休干部证

+

206-残疾人证

+

207-残疾军人证（1-8级）

+

208-外国护照

+

210-港澳居民来往内地通行证

+

212-中华人民共和国往来港澳通行证

+

213-台湾居民来往大陆通行证

+

214-大陆居民往来台湾通行证

+

215-外国人居留证

+

216-外交官证

+

217-使（领事）馆证

+

218-海员证

+

219-香港永久性居民身份证

+

220-台湾身份证

+

221-澳门特别行政区永久性居民身份证

+

222-外国人身份证件

+

224-就业失业登记证

+

225-退休证

+

226-离休证

+

227-中国护照

+

228-城镇退役士兵自谋职业证

+

229-随军家属身份证明

+

230-中国人民解放军军官转业证书

+

231-中国人民解放军义务兵退出现役证

+

232-中国人民解放军士官退出现役证

+

233-外国人永久居留身份证（外国人永久居留证）

+

234-就业创业证

+

235-香港特别行政区护照

+

236-澳门特别行政区护照

+

237-中华人民共和国港澳居民居住证

+

238-中华人民共和国台湾居民居住证

+

239-《中华人民共和国外国人工作许可证》（A类）

+

240-《中华人民共和国外国人工作许可证》（B类）

+

241-《中华人民共和国外国人工作许可证》（C类）

+

291-出生医学证明

+

299-其他个人证件

出行人证件类型5
travellerCardNoString是出行人证件号码20
travelPlaceString是出行地80
arrivePlaceString是到达地80
vehicleTypeInteger是
    +

  1. 飞机

    2. +

  2. 火车

    3. +

  3. 长途汽车

    4. +

  4. 公共交通

    5. +

  5. 出租车

    6. +

  6. 汽车

    7. +

  7. 船舶

    +

    9-其他

    8. +
交通工具类型2
vehicleLevelString否

当交通工具类型是火车、飞机、船舶时必填选择，其他交通工具时可选填

+

当交通工具类型是火车时，必填，下拉框选择，可选项是 一等座、二等座、软席（软座、软卧）、硬卧（硬座、硬卧）

+

当交通工具类型是飞机时，必填，下拉框选择，可选项是 公务舱、头等舱、经济舱

+

当交通工具类型是船舶事，必填，下拉框选择，可选项是 一等舱、二等舱、三等舱

+

当交通工具类型是其他时，选填

交通工具等级20
+ +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"data": {

+

"pageNum": 1,

+

"pageSize": 15,

+

"pages": 1,

+

"total": 2,

+

"list": [

+

{

+

"buyerAccount": "123456789012345678901234567890",

+

"buyerAddress": "浙江金华婺城区",

+

"buyerBank": "工商银行",

+

"buyerName": "浙江师范大学",

+

"buyerPhone": "0579-88888887",

+

"buyerTaxnum": "339901999999142",

+

"checkCode": "44247972354050973155",

+

"checker": "ying",

+

"clerkId": "",

+

"clerker": "自动开票",

+

"columnFirst": "1",

+

"columnSecond": "2",

+

"columnThree": "3",

+

"deptId": "",

+

"extensionNum": 0,

+

"imageUrl": "https://invtest.nntest.cn/fp/aUl7efywBqGm-WqwuBHyR-TuSTdyr1vDp6vV4xUQ-Ms51qY2OEO1t8aughx4NPG82l_jECyLMEzBoXrlwxJuig.jpg",

+

"invalidState": 0,

+

"invoiceCipher": "-&lt;3359597+2969&gt;-08&lt;7+8*03&lt;3/-4845-+4&gt;450658*517/659574+&gt;530&lt;/14444313-4/&gt;21+&lt;3++9232-&gt;9-*4*-80-/*2418/7014&lt;1",

+

"invoiceCode": "150010020011",

+

"invoiceId": "21062515355501000053",

+

"invoiceLine": "p",

+

"invoiceNumber": "13458270",

+

"invoiceTime": 1624606697000,

+

"invalidTime":"1604576878000",

+

"requestSrc":"1",

+

"listFlag": 0,

+

"listGoodsName": "",

+

"machineNumber": "661565671900",

+

"notifyEmail": "",

+

"notifyPhone": "",

+

"ofdUrl": "",

+

"orderNo": "d66d077f01484315b6d44dca86295d16",

+

"oriInvoiceCode": "150010020011",

+

"oriInvoiceNumber": "13458270",

+

"payee": "zhangsan",

+

"pdfUrl": "https://invtest.nntest.cn/fp/aUl7efywBqGm-WqwuBHyR7VgIQHxTpPvSxy-wAnGgAitSwrfyaeVMyJhHWPtA3NNDC3H8IVGaK4gfceqZubnfg.pdf",

+

"productOilFlag": 0,

+

"qrCode": "01,10,150010020011,13458270,1.00,20210625,44247972354050973155,F829,",

+

"remark": "222",

+

"sellerAccount": "66998877665544332211",

+

"sellerAddress": "金色西溪",

+

"sellerBank": "中国银行",

+

"sellerName": "移动测试盘",

+

"sellerPhone": "41312",

+

"sellerTaxnum": "150301199811285326",

+

"status": 1,

+

"taxAmountTotal": 1.03,

+

"taxFreeAmountTotal": 1,

+

"taxTotal": 0.03,

+

"terminalNum": 1,

+

"vehicleFlag": 0,

+

"projectCode": "项目名称",

+

"projectName": "项目编码",

+

"detail":[

+

{

+

"detailIndex":0,

+

"detailType":0,

+

"goodsName":"苹果",

+

"withTaxFlag":0,

+

"goodsPrice":"1.09",

+

"taxFreePrice":"1",

+

"goodsNum":"1",

+

"taxrate":"0.09",

+

"specType":"20个",

+

"goodsUnit":"箱",

+

"goodsCode":"1010115010100000000",

+

"goodsCodeAbb":"水果",

+

"favouredPolicyFlag":0,

+

"zeroRateFlag":"",

+

"favouredPolicyName":"",

+

"selfCode":null,

+

"deduction":null,

+

"taxAmount":"1.09",

+

"taxFreeAmount":"1.00",

+

"tax":"0.09",

+

"vehicleType":"三轮运输车",

+

"brandModel":"厂牌型号",

+

"productOrigin":"产地",

+

"certificate":"合格证号",

+

"importCertifyNum":"进出口证明书号",

+

"inspectionOddNum":"商检单号",

+

"engineNum":"发动机号",

+

"vehicleCode":"车辆识别代号",

+

"measureUnits":"吨",

+

"maxCapacity":"10",

+

"organizationCode":"组织机构代码",

+

"produceCompanyName":"生产企业名称",

+

"columnFirst":"自定义字段1",

+

"columnSecond":"自定义字段2",

+

"columnThree":"自定义字段3",

+

"columnFour":"自定义字段4",

+

"columnFive":"自定义字段5"

+

}

+

]

+

},

+

{

+

"buyerAccount": "123456789012345678901234567890",

+

"buyerAddress": "浙江金华婺城区",

+

"buyerBank": "工商银行",

+

"buyerName": "浙江师范大学",

+

"buyerPhone": "0579-88888887",

+

"buyerTaxnum": "339901999999142",

+

"checkCode": "51425603410203243765",

+

"checker": "ying",

+

"clerkId": "",

+

"clerker": "自动开票",

+

"columnFirst": "1",

+

"columnSecond": "2",

+

"columnThree": "3",

+

"deptId": "",

+

"extensionNum": 0,

+

"imageUrl": "https://invtest.nntest.cn/fp/yGRZLqKEdmrazWrzrjyAPXvOrBm2E5eX9CDq6WYWwEn21ct8SLwlfbXKcy6UdWC_E-Tl9W-xZzVPzVC3q7bviA.jpg",

+

"invalidState": 0,

+

"invoiceCipher": "2/32-21/5979-&lt;1/*380-&gt;-1864&lt;8&lt;4&lt;015&lt;5*--+17/+/8945/6+248--9//0+&gt;00126-9+14/184-/&lt;38+**+10&lt;917+1529857*8*&lt;001",

+

"invoiceCode": "150010020012",

+

"invoiceId": "21062811273101175660",

+

"invoiceLine": "p",

+

"invoiceNumber": "35424243",

+

"invoiceTime": 1624850993000,

+

"listFlag": 0,

+

"listGoodsName": "",

+

"machineNumber": "661565671900",

+

"notifyEmail": "",

+

"notifyPhone": "",

+

"ofdUrl": "",

+

"orderNo": "f74cfabe58204444b441e41b9ec2ec06",

+

"oriInvoiceCode": "150010020012",

+

"oriInvoiceNumber": "35424243",

+

"payee": "zhangsan",

+

"pdfUrl": "https://invtest.nntest.cn/fp/yGRZLqKEdmrazWrzrjyAPXMQKkuNfD09X5SFPQgz6v6H9YJPp9QXzJa9qgiWf2hfW5gEdDPUwwzLmuYXHLvBHQ.pdf",

+

"productOilFlag": 0,

+

"qrCode": "01,10,150010020012,35424243,1.00,20210628,51425603410203243765,4319,",

+

"remark": "222",

+

"sellerAccount": "66998877665544332211",

+

"sellerAddress": "金色西溪",

+

"sellerBank": "中国银行",

+

"sellerName": "移动测试盘",

+

"sellerPhone": "41312",

+

"sellerTaxnum": "150301199811285326",

+

"status": 1,

+

"taxAmountTotal": 1.03,

+

"taxFreeAmountTotal": 1,

+

"taxTotal": 0.03,

+

"terminalNum": 1,

+

"vehicleFlag": 0,

+

"projectCode": "项目名称",

+

"projectName": "项目编码",

+

"detail":[

+

{

+

"detailIndex":0,

+

"detailType":0,

+

"goodsName":"苹果",

+

"withTaxFlag":0,

+

"goodsPrice":"1.09",

+

"taxFreePrice":"1",

+

"goodsNum":"1",

+

"taxrate":"0.09",

+

"specType":"20个",

+

"goodsUnit":"箱",

+

"goodsCode":"1010115010100000000",

+

"goodsCodeAbb":"水果",

+

"favouredPolicyFlag":0,

+

"zeroRateFlag":"",

+

"favouredPolicyName":"",

+

"selfCode":null,

+

"deduction":null,

+

"taxAmount":"1.09",

+

"taxFreeAmount":"1.00",

+

"tax":"0.09",

+

"vehicleType":"三轮运输车",

+

"brandModel":"厂牌型号",

+

"productOrigin":"产地",

+

"certificate":"合格证号",

+

"importCertifyNum":"进出口证明书号",

+

"inspectionOddNum":"商检单号",

+

"engineNum":"发动机号",

+

"vehicleCode":"车辆识别代号",

+

"measureUnits":"吨",

+

"maxCapacity":"10",

+

"organizationCode":"组织机构代码",

+

"produceCompanyName":"生产企业名称",

+

"columnFirst":"自定义字段1",

+

"columnSecond":"自定义字段2",

+

"columnThree":"自定义字段3",

+

"columnFour":"自定义字段4",

+

"columnFive":"自定义字段5"

+

}

+

]

+

}

+

]

+

},

+

"message": "成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":2649,

+

"message":"销方税号不能为空"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票库存余量查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票库存余量查询接口.md new file mode 100644 index 0000000..de0ec67 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票库存余量查询接口.md @@ -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]://\[:\]/salescore/lan/queryStockInfoList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P1（开票前保障） + + + +## 发票库存余量查询接口 + +### 接口说明 + +查询开票设备的发票库存余量。 + +### 接口地址 + +| | +|:----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | + +### 请求示例 + + +++ + + + + + +

{

+

  "extensionNum": "0",

+

  "machineNumber": "661565671900",

+

  "sellerTaxnum": "150301199811285326",

+

  "sellerCompanyName":"移动测试盘326",

+

  "sellerCompanyCode" : "1100"

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | | 更新时间 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum": 0,

+

"machineNumber": null,

+

"stocks": [

+

{

+

"terminalNum": 0,

+

"invoiceLine": "s",

+

"invoiceCode": "5000201530",

+

"invoiceNumStart": "71895758",

+

"invoiceNumEnd": "0",

+

"remainNum": 0,

+

"createTime": "2021-06-04 17:20:24"

+

},

+

{

+

"terminalNum": 0,

+

"invoiceLine": "s",

+

"invoiceCode": "5000201530",

+

"invoiceNumStart": "85199644",

+

"invoiceNumEnd": "0",

+

"remainNum": 0,

+

"createTime": "2021-06-04 17:20:24"

+

}

+

]

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票重开接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票重开接口.md new file mode 100644 index 0000000..92543b9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/发票重开接口.md @@ -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]://\[:\]/salescore/lan/reInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 发票重开接口 + +### 接口说明 + +当请求诺税通开具的发票返回开票失败时，可通过调用该接口触发开票失败的发票数据重新发起开票。 + +### 接口地址 + +| | +|--------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/reInvoice.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
sellerTaxNumString否

销方税号

+

企业税号和组织编码必填其一

20
companyCodeString否

组织编码

+

企业税号和组织编码必填其一

20
invoiceIdString否发票流水号(invoiceId和orderNo任一必填)32
orderNoString否订单号(invoiceId和orderNo任一必填)32
nextInvoiceCodeString否

下一张发票代码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

+

指定发票卷重开时必传

12
nextInvoiceNumString否

下一张发票号码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

+

当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一必填

invoiceNumEndString否

发票终止号码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

+

当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一必填

+ +### 请求示例 + + +++ + + + + + +

{

+

"invoiceId": "21031114572601000143",

+

"orderNo": "21031114572601000143",

+

"sellerTaxnum": "150301199811285326",

+

"nextInvoiceNum": "1234456",

+

"nextInvoiceCode": "123456"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 2733,

+

"message": "该发票不存在"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/审核开票删除回传接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/审核开票删除回传接口.md new file mode 100644 index 0000000..6009344 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/审核开票删除回传接口.md @@ -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 | 是 | 张三 | 删除操作人名称 | | + +### 请求示例 + + +++ + + + + + +

{

+

"deleteDate":"2022-04-29 15:51:39",

+

"deleteUserId":1,

+

"deleteUserName":"张三",

+

"formId":"7BCB5E90EAF64B9C903D920BF82591E4",

+

"formType":2,

+

"orderNo":"20220425091325328406",

+

"sellerTaxnum":"150301199811285326"

+

}

+ +### 返回参数 + + ++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值描述最大长度
codeInteger是200

状态,0000或200-成功，

+

非0000，非200-失败

6
messageString是成功详细信息1024
+ +### 返回示例 + +示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传.md new file mode 100644 index 0000000..2cbb6df --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传.md @@ -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格式接收) + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值更多限制描述最大长度
orderNoString是订单编号64
sellerTaxnumString是339901999999610销方税号20
invoiceIdString是20011617430401068182发票流水号32
successFlagboolean是trueTrue:开票成功；false：开票失败1
vehicleFlagInteger否0可不填，默认00：非机动车。1：机动车2
productOilFlagInteger否0可不填，默认0成品油标志：0非成品油，1成品油，默认为02
invoiceStatusInteger是

发票处理结果: 1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功。

+

结果处于开票成功、 开票失败、作废成功、作废失败，开票失败删除成功触发回传

1
errorMessageString否[9999]HX1000 4003-发票数据写盘失败[TCD_769_25,离线发票累计金额超限！],发票代码或号码为空开票异常信息128
pdfUrlString否https://inv.jss.com.cn/group1/M00/A6/4C/wKgHPll_IU-AVELfAACNq5bmzFM769.pdf发票pdf地址，仅开票成功且版式文件为pdf时返回255
paperPdfUrlString否纸票pdf地址（含底图）256
imageUrlString否发票jpg地址，清单票发票主信息与清单信息以”,”隔开，仅开票成功会返回255
ofdUrlString否发票ofd地址，仅开票成功且版式文件为ofd时返回255
orderDateString否2022-05-12年-月-日订单日期10
deliverDateString否2022-05-12年-月-日发货日期10
invoiceTimeDate否1604576878000开票日期，仅开票成功会返回13
invalidTimeDate否1615985882000作废日期，仅作废成功后返回13
invoiceCodeString否125999915630发票代码，仅开票成功会返回12
invoiceNumberString否00130865发票号码，仅开票成功会返回20
allElectronicInvoiceNumberString否数电发票号码，仅数电发票（电票+纸票）开票成功会返回20
oriInvoiceCodeString否红票对应的蓝票发票代码12
oriInvoiceNumberString否红票对应的蓝票发票号码20
oldEleInvoiceNumberString否红票对应的蓝票数电发票号码20
billNoString否红字申请流水号，仅红字专票返回24
billInfoNoString否红字申请表编号，仅红字专票返回24
taxFreeAmountTotalBigDecimal否不含税金额，仅开票成功会返回15.2
taxTotalBigDecimal否税额，仅开票成功会返回15.2
taxAmountTotalBigDecimal否含税金额，仅开票成功会返回15.2
buyerNameString否浙江爱信诺购方名称，仅开票成功会返回100
buyerTaxnumString否339901999999103购方税号，仅开票成功会返回20
sellerNameString否浙江爱信诺销方名称，仅开票成功会返回100
invoiceLineString否1发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j:机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质) 仅开票成功会返回2
columnFirstString否有值就回传企业开票时传入自定义字段1
columnSecondString否有值就回传企业开票时传入自定义字段2
columnThreeString否有值就回传企业开票时传入自定义字段3
requestSrcInteger否开票方式,0:api接口 1:手工开票 2:批量导入 5:本地提取1
mailNoString否快递单号
businessTypeString否枚举值来源为基础字典配置业务类型
relatedStateInteger否有值就回传关联状态(0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败)
buyerManagerNameString否购买方经办人姓名，数电特有字段16
managerCardTypeString否101-组织机构代码证,102-营业执照,103-税务登记证, 199-其他单位证件, 201-居民身份证, 202-军官证, 203-武警警官证, 204-士兵证, 205-军队离退休干部证, 206-残疾人证, 207-残疾军人证（1-8级）, 208-外国护照, 210-港澳居民来往内地通行证, 212-中华人民共和国往来港澳通行证, 213-台湾居民来往大陆通行证, 214-大陆居民往来台湾通行证, 215-外国人居留证, 216-外交官证 299-其他个人证件经办人证件类型数电特有字段40
managerCardNoString否经办人证件号码数电特有字段，证件类型有值时必填20
billIdString否仅数电红票回传红字确认单流水号32
billConfirmNoString否仅数电红票回传红字确认单编号32
billUuidString否仅数电红票回传红字确认单UUID32
specificFactorString否

特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具

+

35 矿产品发票

2
invalidReasonInteger否数电纸票作废原因 1:销货退回;2:开票有误;3:服务中止;4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）1
specificReasonString否其他作废原因详情（作废原因为4 且回传其他信息时返回）255
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
redReasonInteger否11：销售退回2：开票有误3：服务终止4：销售折让冲红原因1
naturalPersonFlagInteger否0购买方自然人标志：0-否（默认）、1-是2
customerCodeString否客户编码64
+ +### 请求示例 + + +++ + + + + + +

{

+

"buyerName":"个人",

+

"buyerTaxnum":"339901999999142",

+

"imageUrl":"",

+

"invoiceCode":"131880930610",

+

"invoiceId":"20111014474101989690",

+

"invoiceLine":"p",

+

"invoiceNumber":"61001098",

+

"invoiceTime":1604994991000,

+

"orderNo":"20170104120207971529",

+

"pdfUrl":"https://invtest.nntest.cn/fp/tKhNlLpWjoP84chMYndBjLxrATHP7jJAEK71fHqOJVpzR7q39iU4mBTNBtjfHAANtFoj04OLAjWzfbYJIJhzhA.pdf",

+

"sellerName":"演示公司",

+

"successFlag":true,

+

"taxAmountTotal":1.09,

+

"taxFreeAmountTotal":0.09,

+

"sellerTaxnum":"339901999999610",

+

"taxTotal":0.01,

+

"taxOfficeCode":"税务机关代码",

+

"intactCertificateNum":"税务机关名称",

+

"organizationCode":"完整凭证号码",

+

"mailNo":"SF67263555514",

+

"relatedState":2,

+

"customerCode":"263555514"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | String | 是 | 0000 | | 状态码，字符串”0000”表示成功，非”0000”的字符串表示失败 | 6 | +| message | String | 是 | 同步成功 | | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": "0000",

+

"message": "业务方接收同步成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": "9999",

+

"message": "同步失败的异常信息"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传_含明细.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传_含明细.md new file mode 100644 index 0000000..c48b62f --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果回传_含明细.md @@ -0,0 +1,1825 @@ +--- +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格式接收) + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值更多限制描述最大长度
orderNoString是订单编号64
invoiceIdString是发票流水号20
createTimeDate是1615985882000创建日期13
invoiceTimeDate是1615985882000开票日期13
updateTimeDate是1615985882000更新时间13
orderDateString否2022-05-12年-月-日订单日期10
deliverDateString否2022-05-12年-月-日发货日期10
invalidTimeDate否1615985882000仅作废成功后返回作废日期13
requestSrcInteger否开票方式,0:api接口 1:手工开票 2:批量导入 5:本地提取1
invoiceCodeString否仅开票成功后返回发票代码12
invoiceNumberString否仅开票成功后返回发票号码20
allElectronicInvoiceNumberString否数电发票号码，仅数电发票（电票+纸票）开票成功会返回20
invoiceTypeInteger是发票类型：红字发票、蓝字发票2
oriInvoiceCodeString否红票对应的蓝票发票代码12
oriInvoiceNumberString否红票对应的蓝票发票号码20
oldEleInvoiceNumberString否红票对应的蓝票数电发票号码20
billNoString否红字申请流水号，仅红字专票返回24
billInfoNoString否红字申请表编号，仅红字专票返回24
taxTotalBigDecimal否价税税额（保留小数点后2位）30
taxFreeAmountTotalBigDecimal否不含税金额（保留小数点后2位）30
taxAmountTotalBigDecimal否价税合计 （保留小数点后2位）30
pdfUrlString否发票pdf地址256
ofdUrlString否发票ofd地址256
notifyEmailString否交付邮箱50
notifyPhoneString否交付手机20
buyerTaxnumString否购方税号20
buyerNameString否购方名称100
customerCodeString否123456蓝票 购方名称和客户编码二选一必填客户编码，如果未传入客户名称，则使用客户编码查询补充购方信息64
buyerPhoneString否购方电话50
buyerAddressString否购方地址100
buyerBankString否购方银行开户行100
buyerAccountString否购方银行账号30
checkCodeString否校验码35
qrCodeString否二维码30
invoiceCipherString否发票密文300
invoiceLineString否发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)1
sellerTaxnumString是销方税号20
sellerNameString否销方名称200
sellerPhoneString否销方电话20
sellerAddressString否销方地址80
sellerBankString否销方开户银行100
sellerAccountString否销方银行账号30
clerkerString否开票员20
payeeString否收款人20
checkerString否复核人20
remarkString否备注

数电电票：200(中文计算一位)

+

其他发票：230(中文计算两位)

productOilFlagInteger否

成品油标志:

+

0:非成品油;

+

1:成品油;

1
vehicleFlagInteger否0默认00：非机动车。1：机动车2
listFlagInteger否

清单标志：

+

0：非清单；

+

1：清单；

1
listGoodsNameString否清单项目名称90
extensionNumInteger否分机号5
machineNumberString否税控设备号（机器编码）12
terminalNumInteger否终端号10
imageUrlString否发票jpg图片地址（清单票发票主信息与清单信息以”,”隔开）256
paperPdfUrlString否纸票pdf地址（含底图）256
departmentIdLong否部门id50
userIdLong否开票员id50
invoiceStatusInteger是

发票处理结果: 1:开票成功、 2:开票失败、3:作废成功、4:作废失败；5:开票失败删除成功。

+

结果处于开票成功、 开票失败、作废成功、作废失败，开票失败删除成功触发回传

1
errorMessageString否开票异常信息：包括开票失败原因300
columnFirstString否有值就回传企业开票时传入自定义字段1
columnSecondString否有值就回传企业开票时传入自定义字段2
columnThreeString否有值就回传企业开票时传入自定义字段3
mailNoString否快递单号
businessTypeString否枚举值来源为基础字典配置业务类型
relatedStateInteger否有值就回传关联状态(0:未关联 1:关联中 2:关联成功 3:部分关联 4:关联失败)
specificFactorString否

特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具

+

35 矿产品发票

2
detailList否发票明细信息（非必须，根据企业资质配置）
buyerManagerNameString否购买方经办人姓名，数电特有字段16
managerCardNoString否经办人证件号码数电特有字段，证件类型有值时必填20
managerCardTypeString否101-组织机构代码证,102-营业执照,103-税务登记证, 199-其他单位证件, 201-居民身份证, 202-军官证, 203-武警警官证, 204-士兵证, 205-军队离退休干部证, 206-残疾人证, 207-残疾军人证（1-8级）, 208-外国护照, 210-港澳居民来往内地通行证, 212-中华人民共和国往来港澳通行证, 213-台湾居民来往大陆通行证, 214-大陆居民往来台湾通行证, 215-外国人居留证, 216-外交官证 299-其他个人证件经办人证件类型数电特有字段40
billIdString否仅数电红票回传红字确认单流水号32
billConfirmNoString否仅数电红票回传红字确认单编号32
billUuidString否仅数电红票回传红字确认单UUID32
invalidReasonInteger否数电纸票作废原因 1:销货退回;2:开票有误;3:服务中止;4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）1
specificReasonString否其他作废原因详情（作废原因为4 且回传其他信息时返回）255
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
redReasonInteger否11：销售退回2：开票有误3：服务终止4：销售折让冲红原因1
naturalPersonFlagInteger否0购买方自然人标志：0-否（默认）、1-是2
invoiceGoodsTransportsList否货物运输发票时必填货物运输明细最大长度2000
realPropertyRentObject否开具不动产租赁发票时必填不动产租赁发票信息
invoiceBuildingInfoObject否建筑服务发票时必填建筑服务信息
商品明细
detailIndexInteger否明细序号5
commodityCodeString否商品编码64
goodsNameString否商品名称90
goodsCodeAbbString否商品简称200
goodsUnitString否单位22
goodsPriceBigDecimal否根据含税标志决定是含税单价还是不含税单价含税单价32,16
taxFreePriceBigDecimal否根据含税标志决定是含税单价还是不含税单价不含税单价32,16
taxrateString否税率10
goodsNumBigDecimal否数量32,16
taxAmountBigDecimal否含税金额16.2
taxFreeAmountBigDecimal否不含税金额16.2
taxBigDecimal否税额16.2
specTypeString否规格型号40
goodsCodeString否税收分类编码19
selfCodeString否自行编码20
withTaxFlagInteger否

含税标识:

+

1:含税;

+

0:不含税;

detailTypeInteger否

发票行性质:

+

0:正常行;

+

1:折扣行;

+

2:被扣行;

1
zeroRateFlagString否

零税率标识:

+

空:非零税率;

+

1:免税;

+

2:不征税;

+

3:普通零税率;

1
favouredPolicyNameString否优惠政策名称（增值税特殊管理）50
favouredPolicyFlagInteger否

优惠政策标识:

+

0:不使用;

+

1:使用;

1
deductionBigDecimal否扣除额（保留两位小数）
columnFirstString否有值就回传自定义字段1
columnSecondString否有值就回传自定义字段2
columnThreeString否有值就回传自定义字段3
columnFourString否有值就回传自定义字段4
columnFiveString否有值就回传自定义字段5
favouredPolicyCodeString否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%即征即退

优惠政策编码

+

数电发票特有字段，如使用优惠政策时，该字段必填。

机动车(j)/二手车(u)明细
vehicleTypeString是发票种类为u，j时必填车辆类型40
brandModelString是发票种类为u，j时必填厂牌型号60
productOriginString是发票种类为j时必填产地32
importCertifyNumString否进口证明书号50
certificateString否合格证号36
inspectionOddNumString否商检单号32
engineNumString否发动机号码50
vehicleCodeString是发票种类为u，j时必填车辆识别单号23
intactCertificateNumString否完税凭证号码
measureUnitsString否吨位8
maxCapacityString否限乘人数12
produceCompanyNameString否厂家信息200
organizationCodeString否其他证件号30
taxOfficeCodeString否税务机关代码100
+ + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
organizeTypeString是发票种类为u时必填开票方类型：1.经营单位2.拍卖单位3.二手车市场（二手车专用）2
licenseNumberString是发票种类为u时必填车牌号码（二手车专用）20
registerCertNoString是发票种类为u时必填登记证号（二手车专用）20
vehicleManagementNameString是发票种类为u时必填转入地车辆管理所名称（二手车专用）80
salerNameString是发票种类为u时必填卖方单位/个人名称（二手车专用）80
salerNumString是发票种类为u时必填卖方单位代码/身份证号码（二手车专用）20
salerAddressString否卖方单位/个人地址（二手车专用）80
salerPhoneString否卖方电话（二手车专用）20
货物运输明细
goodsNameString否煤炭运输货物名称80
originString否北京市市辖区东城区起运地80
destinationString否北京市市辖区丰台区到达地80
transportTool否1运输工具种类：1铁路运输、2公路运输、3.水路运输、4.航空运输、5.管道运输1
transportToolNumString否车牌号DD运输工具牌号80
不动产租赁发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
rentStartDateString是2023-02-17yyyy-MM-dd格式租赁期起期10
rentEndDateString是2023-02-18yyyy-MM-dd格式租赁期止期10
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位1
建筑服务发票信息
buildingAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入建筑服务发生地-
detailedAddressString否XXXX街道XXX号建筑服务发生地+详细地址最大长度120详细地址120
landVatItemNoString否1234556土地增值税项目编号16
itemNameString是1234556项目名称80
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertySellObject否不动产销售发票时必填不动产销售发票信息
不动产销售发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位10
realPropertyContractNumberString否不动产单元代码/网签合同备案编号28
incrementTaxNumberString否土地增值税项目编号18
priceString否核定计税价格20
taxAmountString否核定计税价格有值时,实际成交含税金额必填实际成交含税金额20
invoiceTravellerTransportInfoListList否开旅客运输发票时传入出行人信息出行人信息
出行人信息
travellerString是出行人20
travelDateString是年-月-日格式出行日期 年-月-日10
travellerCardTypeString是

101-组织机构代码证

+

102-营业执照

+

103-税务登记证

+

199-其他单位证件

+

201-居民身份证

+

202-军官证

+

203-武警警官证

+

204-士兵证

+

205-军队离退休干部证

+

206-残疾人证

+

207-残疾军人证（1-8级）

+

208-外国护照

+

210-港澳居民来往内地通行证

+

212-中华人民共和国往来港澳通行证

+

213-台湾居民来往大陆通行证

+

214-大陆居民往来台湾通行证

+

215-外国人居留证

+

216-外交官证

+

217-使（领事）馆证

+

218-海员证

+

219-香港永久性居民身份证

+

220-台湾身份证

+

221-澳门特别行政区永久性居民身份证

+

222-外国人身份证件

+

224-就业失业登记证

+

225-退休证

+

226-离休证

+

227-中国护照

+

228-城镇退役士兵自谋职业证

+

229-随军家属身份证明

+

230-中国人民解放军军官转业证书

+

231-中国人民解放军义务兵退出现役证

+

232-中国人民解放军士官退出现役证

+

233-外国人永久居留身份证（外国人永久居留证）

+

234-就业创业证

+

235-香港特别行政区护照

+

236-澳门特别行政区护照

+

237-中华人民共和国港澳居民居住证

+

238-中华人民共和国台湾居民居住证

+

239-《中华人民共和国外国人工作许可证》（A类）

+

240-《中华人民共和国外国人工作许可证》（B类）

+

241-《中华人民共和国外国人工作许可证》（C类）

+

291-出生医学证明

+

299-其他个人证件

出行人证件类型5
travellerCardNoString是出行人证件号码20
travelPlaceString是出行地80
arrivePlaceString是到达地80
vehicleTypeInteger是
    +

  1. 飞机

    2. +

  2. 火车

    3. +

  3. 长途汽车

    4. +

  4. 公共交通

    5. +

  5. 出租车

    6. +

  6. 汽车

    7. +

  7. 船舶

    +

    9-其他

    8. +
交通工具类型2
vehicleLevelString否

当交通工具类型是火车、飞机、船舶时必填选择，其他交通工具时可选填

+

当交通工具类型是火车时，必填，下拉框选择，可选项是 一等座、二等座、软席（软座、软卧）、硬卧（硬座、硬卧）

+

当交通工具类型是飞机时，必填，下拉框选择，可选项是 公务舱、头等舱、经济舱

+

当交通工具类型是船舶事，必填，下拉框选择，可选项是 一等舱、二等舱、三等舱

+

当交通工具类型是其他时，选填

交通工具等级20
+ +### 请求示例 + + +++ + + + + + +

{

+

    "businessType": "0",

+

    "buyerAccount": "111111",

+

    "buyerAddress": "杭州市",

+

    "buyerBank": "中国工商银行  ",

+

    "buyerName": "冲红原因测试用蓝票",

+

    "buyerPhone": "",

+

    "buyerTaxnum": "91610132MA6W2MHJ1E",

+

    "checker": "",

+

    "clerker": "张三",

+

    "columnFirst": "主表自定义标识1",

+

    "columnSecond": "主表自定义标识2",

+

    "columnThree": "主表自定义标识3",

+

    "companyCode": "1100",

+

    "companyId": 10162,

+

    "createTime": 1643340360000,

+

    "deliverDate": "Tue Apr 19 15:48:57 CST 2022",

+

    "detail": [

+

        {

+

            "columnFirst": "详情表自定义1",

+

            "columnFive": "详情表自定义5",

+

            "columnFour": "详情表自定义4",

+

            "columnSecond": "详情表自定义2",

+

            "columnThree": "详情表自定义3",

+

            "detailIndex": 0,

+

            "detailType": 0,

+

            "favouredPolicyFlag": 0,

+

            "favouredPolicyName": "",

+

            "goodsCode": "1070101010100000000",

+

            "goodsCodeAbb": "汽油",

+

            "goodsName": "电脑",

+

            "goodsNum": -1.0000000000000000,

+

            "goodsPrice": 11.3000000000000000,

+

            "goodsUnit": "升",

+

            "selfCode": "10701010101",

+

            "specType": "Y460",

+

            "tax": -1.30,

+

            "taxAmount": -11.30,

+

            "taxFreeAmount": -10.00,

+

            "taxFreePrice": 10.0000000000000000,

+

            "taxrate": "0.13",

+

            "withTaxFlag": 0,

+

            "zeroRateFlag": ""

+

        }

+

    ],

+

    "invoiceCode": "033002000911",

+

    "invoiceLine": "p",

+

    "invoiceNumber": "36831764",

+

    "invoiceType": 2,

+

    "listFlag": 0,

+

    "listGoodsName": "详见销货清单",

+

    "orderNo": "20220223134754150666",

+

    "payee": "",

+

    "productOilFlag": 1,

+

    "remark": "对应正数发票代码:033002000911号码:36831764",

+

    "requestSrc": 6,

+

    "sellerAccount": "123",

+

    "sellerAddress": "123",

+

    "sellerBank": "213",

+

    "sellerName": "移动测试盘326",

+

    "sellerPhone": "123",

+

    "sellerTaxnum": "150301199811285326",

+

    "substituteFlag": 0,

+

    "userId": 1,

+

    "invoiceTime": "2021-03-12T14:59:25.715",

+

    "taxAmountTotal": "12.01",

+

"taxFreeAmountTotal": "12.01",

+

"taxTotal": "12.01",

+

    "mailNo": "SF67263555514",

+

"relatedState":2,

+

"customerCode":"263555514"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | String | 是 | 0000 | | 状态码，字符串”0000”表示成功，非”0000”的字符串表示失败 | 6 | +| message | String | 是 | 同步成功 | | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": "0000",

+

"message": "业务方接收同步成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": "9999",

+

"message": "同步失败的异常信息"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果查询接口.md new file mode 100644 index 0000000..b521b8f --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票结果查询接口.md @@ -0,0 +1,1995 @@ +--- +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]://\[:\]/salescore/lan/query-invoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P0 + + + +## 开票结果查询接口 + +### 接口说明 + +通过该接口提交流水号或订单号信息，查询开票结果。 + +### 接口地址 + +| | +|:-----------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/query-invoice.do | + +### 请求参数 + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值更多限制描述最大长度
invoiceIdString[]否20092114394901000002流水号列表与订单号列表、发票号码列表、数电号码四选一，单次最多支持查询50个流水号。流水号列表单个参数最大长度20
orderNoString[]否20170104120207971529

流水号列表与订单号列表、发票号码列表、数电号码四选一，单次最多支持

+

查询50个订单号。

订单号列表单个参数最大长度64
invoiceNumberString[]否["93667697", "93667694"]

流水号列表与订单号列表、发票号码列表、数电号码四选一，单次最多支持

+

查询50个发票号码

发票号码列表
invoiceCodeString否5000201530使用发票号码列表查询时必传，数电电票该字段为空，传入发票号码，未传入发票代码默认为查询数电电票发票代码
fuzzyFlagBoolean否false默认为false订单号是否模糊查询，当orderNo列表元素个数为1且本字段为true时，可以模糊查询订单号对应的发票记录1
sellerTaxnumString否7010412020797152企业税号和组织编码必填其一企业税号20
companyCodeString否企业税号和组织编码必填其一组织编码20
returnInvoiceDetailFlagBoolean否true默认为true返回发票明细标识1
allElectronicInvoiceNumberString[]否

支持

+

查询50个数电发票发票号码，流水号列表与订单号列表、发票号码列表、数电号码四选一

数电发票号码（数电电票、数电纸票都支持）单个参数最大20
+ +### 请求示例 + + +++ + + + + + +

{

+

"invoiceId": ["20111014474101989690", "20111014550501989882"],

+

"sellerTaxnum": "339901999999610",

+

"returnInvoiceDetailFlag": true

+

}

+ +### 返回参数： + + +++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值更多限制描述最大长度
codeInteger是200状态,200-成功，非200-失败6
messageString查询成功详细信息1024
dataList18081620564001000232查询成功则返回发票信息
发票信息
orderNoString否20170104120207971529订单号64
invoiceIdString否20092114394901000002流水号20
statusInteger否2开票状态(0:开票中1:开票完成2:开票失败3:发票生成2
invalidStateInteger否0发票作废状态: 0 未提交 , 1 作废成功 , 2 作废失败 , 3 已提交(作废中)。默认值02
invalidTimeString否1604576878000发票作废时间
orderDateString否2022-05-12年-月-日订单日期10
deliverDateString否2022-05-12年-月-日发货日期10
errorMessageString否[9999]HX1000 4003-发票数据写盘失败[TCD_769_25,离线发票累计金额超限！],发票代码或号码为空开票异常信息128
pdfUrlString否https://inv.jss.com.cn/group1/M00/A6/4C/wKgHPll_IU-AVELfAACNq5bmzFM769.pdf发票pdf地址255
paperPdfUrlString否PDF含底图255
imageUrlString否发票jpg地址，清单票发票主信息与清单信息以”,”隔开255
ofdUrlString否发票ofd地址255
invoiceTimeString否1604576878000开票日期19
invoiceCodeString否125999915630发票代码12
invoiceNumberString否00130865发票号码20
allElectronicInvoiceNumberString否数电发票号码20
taxFreeAmountTotalBigDecimal否不含税金额15.2
taxTotalBigDecimal否税额15.2
taxAmountTotalBigDecimal否含税金额15.2
buyerNameString否浙江爱信诺购方名称100
buyerTaxnumString否339901999999103购方税号20
buyerAddressString否浙江省杭州市万塘路购方地址100
buyerPhoneString否15858585858购方电话50
buyerBankString否购方开户行购方开户行100
buyerAccountString否购方银行账号购方银行账号30
invoiceLineString否1发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票，u：二手车发票，bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)2
checkCodeString否校验码20
qrCodeString否二维码3000
machineNumberString否机器编号12
invoiceCipherString否发票密文300
clerkerString否张三开票人20
payeeString否李四收款人20
checkerString否王五复核人20
sellerNameString否浙江爱信诺销方名称100
sellerTaxnumString否330100555190356销方税号20
sellerAddressString否杭州市西湖区万塘路销方地址100
sellerPhoneString否0571-81029365销方电话20
sellerBankString否开户行销方开户行100
sellerAccountString否开户行账号销方开户行账号30
remarkString否备注信息备注

数电电票：200(中文计算一位)

+

其他发票：230(中文计算两位)

productOilFlagInteger否0

成品油标志，

+

0:非成品油;

+

1:成品油

2
vehicleFlagInteger否0默认00：非机动车。1：机动车2
extensionNumInteger否开票请求分机号,范围为0-655355
terminalNumInteger否开票请求终端号5
notifyPhoneString否推送手机20
notifyEmailString否test@xx.com推送邮箱50
deptIdString否9F7E9439CA8B4C60A2FFF3EA3290B088部门门店id（诺诺系统中的id）32
clerkIdString否3F7EA439CA8B4C60A2FFF3EA3290B084开票员id（诺诺系统中的id）32
oriInvoiceCodeString否125999915630原发票代码12
oriInvoiceNumberString否00130865原发票号码8
oldEleInvoiceNumberString否红票对应的蓝票数电发票号码20
listFlagInteger否0

清单标志，

+

0:非清单，1:清单

2
listGoodsNameString否详见销货清单注意：税局要求清单项目名称为（详见销货清单）90
columnFirstString否业务调用方自定义字段一业务调用方自定义字段一255
columnSecondString否业务调用方自定义字段二业务调用方自定义字段二255
columnThreeString否业务调用方自定义字段三业务调用方自定义字段三255
projectCodeString否项目编码64
projectNameString否项目名称300
mailNoString否快递单号
businessTypeString否1枚举值来源为基础字典配置业务类型
buyerManagerNameString否购买方经办人姓名，数电特有字段16
managerCardTypeString否101-组织机构代码证,102-营业执照,103-税务登记证, 199-其他单位证件, 201-居民身份证, 202-军官证, 203-武警警官证, 204-士兵证, 205-军队离退休干部证, 206-残疾人证, 207-残疾军人证（1-8级）, 208-外国护照, 210-港澳居民来往内地通行证, 212-中华人民共和国往来港澳通行证, 213-台湾居民来往大陆通行证, 214-大陆居民往来台湾通行证, 215-外国人居留证, 216-外交官证 299-其他个人证件经办人证件类型数电特有字段40
managerCardNoString否经办人证件号码数电特有字段，证件类型有值时必填20
ccPhoneString否抄送手机，多个以英文逗号分隔100
ccEmailString否抄送邮箱，多个以英文逗号分隔250
specificFactorString否

特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具

+

35 矿产品发票

2
invalidReasonInteger否数电纸票作废原因 1:销货退回;2:开票有误;3:服务中止;4:其他（已作废状态下的发票，且票为数电纸票且回传其他信息时返回）1
specificReasonString否其他作废原因详情（作废原因为4 且回传其他信息时返回）255
naturalPersonFlagInteger否0购买方自然人标志：0-否（默认）、1-是2
redReasonInteger否11：销售退回2：开票有误3：服务终止4：销售折让冲红原因1
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
customerCodeString否客户编码64
invoiceGoodsTransportsList否货物运输发票时必填货物运输明细最大长度2000
发票明细
detailIndexInteger否0明细行序号5
goodsNameString否商品名称90
taxrateString否0.16税率10
withTaxFlagInteger否

单价含税标志:

+

0:不含税;

+

1:含税

2
taxFreePriceBigDecimal否不含税单价32.16
goodsPriceBigDecimal否含税单价32.16
goodsNumBigDecimal否数量32.16
taxAmountBigDecimal否含税金额15.2
taxFreeAmountBigDecimal否不含税金额15.2
taxBigDecimal否税额15.2
goodsUnitString否单位22
specTypeString否规格型号40
commodityCodeString否商品编码64
goodsCodeString否税收分类编码19
goodsCodeAbbString否税收分类编码简称200
detailTypeInteger否

明细行性质:

+

0:正常行;

+

1:折扣行;

+

2:被折扣行

2
favouredPolicyFlagInteger否

优惠政策标识:

+

0:不使用;

+

1:使用

2
favouredPolicyNameString否优惠政策内容，如：即征即退、免税、简易征收 等50
zeroRateFlagInteger否

零税率标识:

+

空:非零税率;

+

1:免税;

+

2:不征税;

+

3:普通零税率

2
selfCodeString否自行编码20
deductionBigDecimal否扣除额15.2
columnFirstString否自定义字段1255
columnSecondString否自定义字段2255
columnThreeString否自定义字段3255
columnFourString否自定义字段4255
columnFiveString否自定义字段5255
favouredPolicyCodeString否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%即征即退

优惠政策编码

+

数电发票特有字段

机动车(j)/二手车(u)发票明细
vehicleTypeString否车辆类型40
brandModelString否厂牌型号60
productOriginString否产地32
certificateString否合格证号50
importCertifyNumString否进口证明书号50
inspectionOddNumString否商检单号50
engineNumString否发动机号码50
vehicleCodeString否车辆识别代号/车架号码50
taxOfficeCodeString否主营税务机关及代码100
intactCertificateNumString否完税凭证号码50
measureUnitsString否吨位20
maxCapacityString否限乘人数10
produceCompanyNameString否生产企业名称50
organizationCodeString否339901999999103其他证件号码30
organizeTypeString是发票种类为二手车发票返回开票方类型：1.经营单位2.拍卖单位3.二手车市场（二手车专用）2
licenseNumberString是发票种类为二手车发票返回车牌号码（二手车专用）20
registerCertNoString是发票种类为二手车发票返回登记证号（二手车专用）20
vehicleManagementNameString是发票种类为二手车发票返回转入地车辆管理所名称（二手车专用）80
salerNameString是发票种类为二手车发票返回卖方单位/个人名称（二手车专用）80
salerNumString是发票种类为二手车发票返回卖方单位代码/身份证号码（二手车专用）20
salerAddressString否卖方单位/个人地址（二手车专用）80
salerPhoneString否卖方电话（二手车专用）20
货物运输明细
goodsNameString否煤炭运输货物名称80
originString否北京市市辖区东城区起运地80
destinationString否北京市市辖区丰台区到达地80
transportTool否1运输工具种类：1铁路运输、2公路运输、3.水路运输、4.航空运输、5.管道运输1
transportToolNumString否车牌号DD运输工具牌号80
不动产租赁发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
rentStartDateString是2023-02-17yyyy-MM-dd格式租赁期起期10
rentEndDateString是2023-02-18yyyy-MM-dd格式租赁期止期10
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位1
建筑服务发票信息
buildingAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入建筑服务发生地-
detailedAddressString否XXXX街道XXX号建筑服务发生地+详细地址最大长度120详细地址120
landVatItemNoString否1234556土地增值税项目编号16
itemNameString是1234556项目名称80
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertySellObject否不动产销售发票时必填不动产销售发票信息
不动产销售发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位10
realPropertyContractNumberString否不动产单元代码/网签合同备案编号28
incrementTaxNumberString否土地增值税项目编号18
priceString否核定计税价格20
taxAmountString否核定计税价格有值时,实际成交含税金额必填实际成交含税金额20
invoiceTravellerTransportInfoListList否开旅客运输发票时传入出行人信息出行人信息
出行人信息
travellerString是出行人20
travelDateString是年-月-日格式出行日期 年-月-日10
travellerCardTypeString是

101-组织机构代码证

+

102-营业执照

+

103-税务登记证

+

199-其他单位证件

+

201-居民身份证

+

202-军官证

+

203-武警警官证

+

204-士兵证

+

205-军队离退休干部证

+

206-残疾人证

+

207-残疾军人证（1-8级）

+

208-外国护照

+

210-港澳居民来往内地通行证

+

212-中华人民共和国往来港澳通行证

+

213-台湾居民来往大陆通行证

+

214-大陆居民往来台湾通行证

+

215-外国人居留证

+

216-外交官证

+

217-使（领事）馆证

+

218-海员证

+

219-香港永久性居民身份证

+

220-台湾身份证

+

221-澳门特别行政区永久性居民身份证

+

222-外国人身份证件

+

224-就业失业登记证

+

225-退休证

+

226-离休证

+

227-中国护照

+

228-城镇退役士兵自谋职业证

+

229-随军家属身份证明

+

230-中国人民解放军军官转业证书

+

231-中国人民解放军义务兵退出现役证

+

232-中国人民解放军士官退出现役证

+

233-外国人永久居留身份证（外国人永久居留证）

+

234-就业创业证

+

235-香港特别行政区护照

+

236-澳门特别行政区护照

+

237-中华人民共和国港澳居民居住证

+

238-中华人民共和国台湾居民居住证

+

239-《中华人民共和国外国人工作许可证》（A类）

+

240-《中华人民共和国外国人工作许可证》（B类）

+

241-《中华人民共和国外国人工作许可证》（C类）

+

291-出生医学证明

+

299-其他个人证件

出行人证件类型5
travellerCardNoString是出行人证件号码20
travelPlaceString是出行地80
arrivePlaceString是到达地80
vehicleTypeInteger是
    +

  1. 飞机

    2. +

  2. 火车

    3. +

  3. 长途汽车

    4. +

  4. 公共交通

    5. +

  5. 出租车

    6. +

  6. 汽车

    7. +

  7. 船舶

    +

    9-其他

    8. +
交通工具类型2
vehicleLevelString否

当交通工具类型是火车、飞机、船舶时必填选择，其他交通工具时可选填

+

当交通工具类型是火车时，必填，下拉框选择，可选项是 一等座、二等座、软席（软座、软卧）、硬卧（硬座、硬卧）

+

当交通工具类型是飞机时，必填，下拉框选择，可选项是 公务舱、头等舱、经济舱

+

当交通工具类型是船舶事，必填，下拉框选择，可选项是 一等舱、二等舱、三等舱

+

当交通工具类型是其他时，选填

交通工具等级20
+ +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message":"成功",

+

"data":[

+

{

+

"orderNo":"20170104120207971529",

+

"invoiceId":"20111014474101989690",

+

"status":1,

+

"errorMessage":null,

+

"pdfUrl":"https://invtest.nntest.cn/fp/tKhNlLpWjoP84chMYndBjLxrATHP7jJAEK71fHqOJVpzR7q39iU4mBTNBtjfHAANtFoj04OLAjWzfbYJIJhzhA.pdf",

+

"imageUrl":"",

+

"ofdUrl":null,

+

"invoiceTime":"1604994991000",

+

"invalidTime":"1604576878000",

+

"invoiceCode":"131880930610",

+

"invoiceNumber":"61001098",

+

"taxAmountTotal":"1.09",

+

"taxFreeAmountTotal":"1.00",

+

"taxTotal":"0.09",

+

"buyerName":"个人",

+

"buyerTaxnum":"339901999999142",

+

"buyerAddress":"浙江省杭州市",

+

"buyerPhone":"0571-00000000",

+

"buyerBank":"开户行",

+

"buyerAccount":"银行账号",

+

"invoiceLine":"p",

+

"checkCode":"",

+

"qrCode":"",

+

"machineNumber":"",

+

"invoiceCipher":"",

+

"clerker":"开票员",

+

"payee":"收款人",

+

"checker":"复核人",

+

"sellerName":"演示公司",

+

"sellerTaxnum":"339901999999610",

+

"sellerPhone":"0571-00000000",

+

"sellerAddress":"杭州市西湖区",

+

"sellerBank":"开户行",

+

"sellerAccount":"0000000000000000",

+

"remark":"备注信息",

+

"productOilFlag":0,

+

"extensionNum":null,

+

"terminalNum":null,

+

"notifyPhone":"",

+

"notifyEmail":"",

+

"deptId":"",

+

"clerkId":"",

+

"oriInvoiceCode":null,

+

"oriInvoiceNumber":null,

+

"listFlag":0,

+

"listGoodsName":"",

+

"mailNo": "SF67263555514",

+

"customerCode": "555514",

+

"detail":[

+

{

+

"detailIndex":0,

+

"detailType":0,

+

"goodsName":"苹果",

+

"withTaxFlag":0,

+

"goodsPrice":"1.09",

+

"taxFreePrice":"1",

+

"goodsNum":"1",

+

"taxrate":"0.09",

+

"specType":"20个",

+

"goodsUnit":"箱",

+

"goodsCode":"1010115010100000000",

+

"goodsCodeAbb":"水果",

+

"favouredPolicyFlag":0,

+

"zeroRateFlag":"",

+

"favouredPolicyName":"",

+

"selfCode":null,

+

"deduction":null,

+

"taxAmount":"1.09",

+

"taxFreeAmount":"1.00",

+

"tax":"0.09",

+

"vehicleType":"三轮运输车",

+

"brandModel":"厂牌型号",

+

"productOrigin":"产地",

+

"certificate":"合格证号",

+

"importCertifyNum":"进出口证明书号",

+

"inspectionOddNum":"商检单号",

+

"engineNum":"发动机号",

+

"vehicleCode":"车辆识别代号",

+

"measureUnits":"吨",

+

"maxCapacity":"10",

+

"organizationCode":"组织机构代码",

+

"produceCompanyName":"生产企业名称",

+

"columnFirst":"自定义字段1",

+

"columnSecond":"自定义字段2",

+

"columnThree":"自定义字段3",

+

"columnFour":"自定义字段4",

+

"columnFive":"自定义字段5"

+

}

+

]

+

},

+

{

+

"orderNo":"20201110001",

+

"invoiceId":"20111014550501989882",

+

"status":1,

+

"errorMessage":null,

+

"pdfUrl":"https://invtest.nntest.cn/fp/eu9ulvNPRnZ_0KVsgVBWhKv6Yx8mV4j5hg5-lByUWwB7yu5Jt1gj8nFXU6waJw2kZHAidBnetXYuB1SSseZCuw.pdf",

+

"imageUrl":"",

+

"ofdUrl":null,

+

"invoiceTime":"1604995415000",

+

"invoiceCode":"131880930610",

+

"invoiceNumber":"61001099",

+

"taxAmountTotal":"1.09",

+

"taxFreeAmountTotal":"1.00",

+

"taxTotal":"0.09",

+

"buyerName":"个人",

+

"buyerTaxnum":"339901999999142",

+

"buyerAddress":"浙江省杭州市",

+

"buyerPhone":"0571-00000000",

+

"buyerBank":"开户行",

+

"buyerAccount":"银行账号",

+

"invoiceLine":"p",

+

"checkCode":"",

+

"qrCode":"",

+

"machineNumber":"",

+

"invoiceCipher":"",

+

"clerker":"开票员",

+

"payee":"收款人",

+

"checker":"复核人",

+

"sellerName":"演示公司",

+

"sellerTaxnum":"339901999999610",

+

"sellerPhone":"0571-00000000",

+

"sellerAddress":"杭州市西湖区",

+

"sellerBank":"开户行",

+

"sellerAccount":"0000000000000000",

+

"remark":"备注信息",

+

"productOilFlag":0,

+

"extensionNum":null,

+

"terminalNum":null,

+

"notifyPhone":"",

+

"notifyEmail":"",

+

"deptId":"",

+

"clerkId":"",

+

"oriInvoiceCode":null,

+

"oriInvoiceNumber":null,

+

"listFlag":0,

+

"listGoodsName":"",

+

"customerCode":"263555514",

+

"detail":[

+

{

+

"detailIndex":0,

+

"detailType":0,

+

"goodsName":"苹果",

+

"withTaxFlag":0,

+

"goodsPrice":null,

+

"taxFreePrice":null,

+

"goodsNum":null,

+

"taxrate":"0.09",

+

"specType":"20个",

+

"goodsUnit":"箱",

+

"goodsCode":"1010115010100000000",

+

"goodsCodeAbb":"水果",

+

"favouredPolicyFlag":0,

+

"zeroRateFlag":"",

+

"favouredPolicyName":"",

+

"selfCode":null,

+

"deduction":null,

+

"taxAmount":"1.09",

+

"taxFreeAmount":"1.00",

+

"tax":"0.09",

+

"vehicleType":"三轮运输车",

+

"brandModel":"厂牌型号",

+

"productOrigin":"产地",

+

"certificate":"合格证号",

+

"importCertifyNum":"进出口证明书号",

+

"inspectionOddNum":"商检单号",

+

"engineNum":"发动机号",

+

"vehicleCode":"车辆识别代号",

+

"measureUnits":"吨",

+

"maxCapacity":"10",

+

"organizationCode":"组织机构代码",

+

"produceCompanyName":"生产企业名称",

+

"columnFirst":"自定义字段1",

+

"columnSecond":"自定义字段2",

+

"columnThree":"自定义字段3",

+

"columnFour":"自定义字段4",

+

"columnFive":"自定义字段5"

+

}

+

]

+

}

+

]

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":2751,

+

"message":"企业税号不能为空"

+

}

+ +### 状态码说明 + +| | | +|:----------:|:--------------------------------------------:| +| **状态码** | **描述** | +| 2751 | 企业税号不能为空 | +| 2752 | 入参发票流水号数组和订单编号数组只能选择一个 | +| 2753 | 入参长度超过50 | +| 2754 | 模糊搜索的订单数组长度不等于1 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票请求接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票请求接口.md new file mode 100644 index 0000000..96bd62d --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/开票请求接口.md @@ -0,0 +1,2056 @@ +--- +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]://\[:\]/salescore/lan/invoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：是 +> - 推荐优先级：P0 + + + +## 开票请求接口 + +### 接口说明 + +通过该接口提交订单信息，如销方、购方、开票明细等信息，发起开票请求。 + +注意：该接口仅返回是否提交开票申请成功，提交成功后，如税盘等开票成功，则开票状态会更新为开票完成；如果开票失败，则会变更为开票失败，且返回失败原因。 + +数电发票开具红票请使用快捷冲红接口，该接口暂不支持开具数电发票红票。请求开具数电发票蓝票时，需保证在开具时明细序号为从1开始的连续数字，否则不支持部分红冲业务！ + +针对特殊发票开具的要求： + +1. 货物运输发票：商品明细detail中商品名称必填、金额必填、税率必填、税额必填、单位非必填、数量非必填、单价非必填 + +2. 不动产经营租赁服务发票:商品明细detail只能有一行，且规格型号、单位不能有值，数量、单价必填 + +3. 建筑服务发票:商品明细detail只能有一行，且规格型号、单位、数量、单价都不能有值 + +4. 针对矿产品发票：只支持纸专、电普、纸普、电专开具，商品明细detail单位、数量、单价都必填，税收分类编码编码必须102开头 + +### 接口地址 + +| | +|:-----------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/invoice.do | + +### 请求参数 + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值更多限制描述最大长度
buyerNameString否个人蓝票 购方名称和客户编码二选一必填购方名称100
customerCodeString否123456蓝票 购方名称和客户编码二选一必填客户编码，如果未传入客户名称，则使用客户编码查询补充购方信息64
buyerTaxnumString否339901999999142企业要填，个人可为空购方税号开具机动车销售统一发票时，该字段仅用于填写企业税号或中国居民身份证号
buyerAddressString否浙江省杭州市企业要填，个人可为空购方地址100
buyerPhoneString否0571-00000000企业要填，个人可为空，购方地址+购方电话不得超过100个字符购方电话50
buyerBankString否开户行企业要填，个人可为空购方开户行100
buyerAccountString否银行账号企业要填，个人可为空，开户行+银行账户不得超过100个字符购方银行账号30
orderNoString是20170104120207971529每个企业唯一订单编号64
sellerNameString否演示公司不填写时，以维护在诺税通组织管理中的销方名称为准，如未维护则会报错销方名称100
sellerTaxnumString否339901999999610销方税号20
companyCodeString否如果销方税号有值，优先以销方税号为准

维护在诺税通组织管理中的“公司编码”。sellerTaxnum、companyCode至少填一个。

+

用来关联出诺税通系统内的“companyId”字段。

sellerAddressString否杭州市西湖区不填写时，以维护在诺税通开票信息中的销方地址为准，发票种类为j：机动车发票时，非必填销方地址100
sellerPhoneString否0571-00000000

不填写时，以维护在诺税通开票信息中的销方电话为准，1.发票种类为j：机动车发票时，非必填

+

2，销方地址+销方电话不得超过100个字符

销方电话20
sellerBankString否中国工商银行不填写时，以维护在诺税通开票信息中的销方开户银行为准，发票种类为j：机动车发票时，非必填销方开户银行100
sellerAccountString否0000000000000000

不填写时，以维护在诺税通开票信息中的销方银行账号为准，发票种类为j：机动车发票时，非必填；

+

开户银行+银行账户不得超过100个字符

销方银行账号30
invoiceTypeInteger是1开票类型，1:蓝票；2:红票2
checkBlueInteger是0invoiceType =2时需要传，默认0开具红票时是否校验蓝票 0.校验蓝票是否存在诺税通 1.不校验蓝票是否存在诺税通但校验可冲红金额 2.不校验蓝票是否存在诺税通且不校验可冲红金额2
invoiceLineString否p默认为电票p。发票种类，p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，b:增值税电子专用发票，j：机动车发票，u：二手车发票,bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)2
requestSrcInteger是0默认为0请求来源，0 :api接口，可自定义，但必须是诺税通已维护好的枚举值1
remarkString否备注信息冲红时，必须在备注中注明“对应正数发票代码:XXXXXXXXX号码:YYYYYYYY”文案，其中“X”为发票代码，“Y”为发票号码，否则接口会自动添加该文案；发票种类为j：机动车发票时，备注需注明：“一车一票”否则接口会自动添加该文案备注，（注意：不同开票服务器类型支持的备注长度不同，请在提交前做好确认）

数电电票：200(中文计算一位)

+

其他发票：230(中文计算两位)

clerkerString否开票员不填写时，以维护在诺税通开票信息的企业维度开票人为准，如未维护则会报错开票人20
payeeString否收款人不填写时，以维护在诺税通开票信息的企业维度收款人为准收款人20
checkerString否复核人不填写时，以维护在诺税通开票信息的企业维复核人为准复核人20
invoiceCodeString否125999915630红票必填，10位或12位，11位的发票代码请左补0至12位对应蓝票发票代码12
invoiceNumberString否00130865红票必填，增值税发票不满8位请左补0，数电发票20位对应蓝票发票号码20
notifyTypeInteger是1推送方式，-1:不推送;0:邮箱;1:手机(默认);2:邮箱、手机2
notifyPhoneString否10000000000推送手机(开票成功会短信提醒购方，推送方式为1或2时，此项必填)20
notifyEmailString否test@xx.com推送邮箱（推送方式为0或2时，此项必填）50
listFlagInteger是0默认为0。清单标志，0:非清单；1:清单，纸票超过8行自动转成清单，电票无清单概念，默认都传02
listGoodsNameString否详见销货清单listFlag为1时，此项为必填注意：税局要求清单项目名称固定为：（详见销货清单）90
extensionNumInteger否

开票设备分机号,范围为0-65535，

+

如需指定设备开票则需传入

5
terminalNumInteger否开票设备终端号，如需指定设备开票则需传入5
machineNumString否机器编号，如需指定设备开票则需传入
substituteFlagInteger是0默认为0代开标志，0:非代开;1:代开。代开蓝票备注文案要求包含：“代开企业税号:***代开企业名称:***.”；代开红票备注文案要求：“对应正数发票代码:***号码:***代开企业税号:***代开企业名称:***.”。（代开企业税号与代开企业名称之间仅支持一个空格或无符号）1
departmentIdLong否开票员所属部门id（诺税通本地系统中的id），如需在诺税通中根据部门筛选查看发票，则可传入32
departmentCodeString否如果departmentId有值，优先以departmentId为准

维护在诺税通部门管理中的“部门编码”。

+

用来关联出诺税通系统内的“departmentId”字段。

userIdLong否开票员用户id（诺税通系统中的id），如需在诺税通中根据开票员筛选查看发票，则可传入32
userCodeString否如果userId有值，优先以userId为准

维护在诺税通用户管理中的“用户编码”。

+

用来关联出诺税通系统内的“userId”字段。

specificFactorString否0开具货物运输发票时，必填04

特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票09旅客运输发票 14机动车 16农产品收购 33二手车反向开具

+

35 矿产品发票

2
naturalPersonFlagInteger否0非数电普票(电子)发票不支持自然人，传1将报错购买方自然人标志：0-否（默认）、1-是；开具数电普票(电子)时，如受票方（发票抬头）为自然人，并要求能将发票归集在个人票夹中展示，需提供姓名及身份证号（自然人纳税人识别号）；此参数传1；如受票方（发票抬头）为个体工商户，需提供社会统一信用代码或纳税人识别号，此参数传02
naturalPersonVerifyFlagInteger否0若不传，则默认取开票规则配置，若传了则以传入的为准购方名称校验：0-不强制开具，1-校验；传入0且【购方自然人标志】传入0时，若购方名称小于等于4，则会按非自然人继续开票；传入1且【购买方自然人标志】传入0时，若购方名称小于等于4，会拦截开票。1
taxNumVerifyFlagInteger否0若不传，则默认取开票规则配置，若传了则以传入的为准对购方税号校验：0-不校验（若税号在电子税局中不存在，也能继续开票），1校验（若税号在电子税局中不存在则不能开票）1
billInfoNoString否1403011904008472增值税专票冲红时，此项必填。且必须在备注中注明“开具红字增值税专用发票信息表编号ZZZZZZZZZZZZZZZZ”字样，其中“Z”为开具红字增值税专用发票所需要的长度为16位信息表编号。红字信息表编号16
columnFirstString否业务方个性化字段,本应用只作保存。255
columnSecondString否业务方个性化字段,本应用只作保存。255
columnThreeString否业务方个性化字段,本应用只作保存255
bizCallbackUrlString否业务方所请求开票的系统接收发票开票结果的回传地址业务方发票开票开票成功/失败、作废结果回调地址255
exchangeRateString否汇率
exchangeRateTimeDate否汇率日期yyyy-MM-dd格式
contractNoString否合同号
waybillNoString否提运单号
businessTypeString否默认0业务标识(基础模块设置的业务类型枚举值)
shippingFeeBigDecimal否海运费
insuranceFeeBigDecimal否保险费
shippingInsuranceFeeBigDecimal否运保费
loadingHarborString否装船口岸
destinationHarborString否目的港
foreignCurrencyAmountBigDecimal否外币港口
exportDateString否出口日期
currencyTypeenum否

AUD：澳元

+

CAD：加拿大元

+

CFP：法郎

+

CNY：人民币

+

COP：比索

+

EUR：欧元

+

GBP：英镑

+

HKD：港币

+

INR：卢比

+

JPY：日元

+

RUB：卢布

+

THB：泰铢

+

TWD：新台币

+

DEM：马克

+

USD：美元

币种
fobAmountBigDecimal否FOB金额
customsNoString否报关单号
orderDateString否年-月-日，例如2022-05-12订单日期10
deliverDateString否年-月-日，例如2022-05-12发货日期10
redReasonInteger否

1：销售退回

+

2：开票有误

+

3：服务终止

+

4：销售折让

+

当发票种类为：c/p/f/r/e的红字发票时填写

冲红原因
projectCodeString否项目编码64
projectNameString否项目名称300
emergencyFlagInteger否

0：非紧急

+

1：紧急

+

默认为：0

紧急订单标识
nextInvoiceCodeString否

下一张发票代码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

指定发票卷开票时必传12
nextInvoiceNumString否

下一张发票号码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

+

当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一

+

必填

指定发票卷开票时下一张发票号码和发票终止号码二选一必传，均不传则认为不指定票卷8
invoiceNumEndString否

发票终止号码

+

支持票种：c普通发票（纸质）f收购发票（纸质）

+

当【下一张发票代码】有值时，【下一张发票号码】和【发票终止号码】二选一

+

必填

指定发票卷开票时下一张发票号码和发票终止号码二选一必传，均不传则认为不指定票卷
buyerManagerNameString否购买方经办人姓名，数电特有字段16
managerCardTypeString否101-组织机构代码证,102-营业执照,103-税务登记证, 199-其他单位证件, 201-居民身份证, 202-军官证, 203-武警警官证, 204-士兵证, 205-军队离退休干部证, 206-残疾人证, 207-残疾军人证（1-8级）, 208-外国护照, 210-港澳居民来往内地通行证, 212-中华人民共和国往来港澳通行证, 213-台湾居民来往大陆通行证, 214-大陆居民往来台湾通行证, 215-外国人居留证, 216-外交官证 299-其他个人证件经办人证件类型数电特有字段40
managerCardNoString否经办人证件号码数电特有字段，证件类型有值时必填20
ccPhoneString否抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个100
ccEmailString否抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个250
paperInvoiceTypeString否数电纸票时才需要传入，枚举值后续会持续更新;（票种为ec时，默认04；票种为es时，默认为1130）票种为ec时，只能为04或05；票种为es时只能为1130或1140或1160或1170

数电纸票类型： 04 2016版增值税普通发票（二联折叠票）

+

05 2016版增值税普通发票（五联折叠票

+

1130 增值税专用发票（中文三联无金额限制版）

+

1140 增值税专用发票（中文四联无金额限制版）

+

1160 增值税专用发票（中文六联无金额限制版）

+

1170 增值税专用发票（中文七联无金额限制版）

12
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
detailList是电子发票明细
invoiceGoodsTransportsList否货物运输发票时必填货物运输明细最大长度2000
realPropertyRentObject否开具不动产租赁发票时必填不动产租赁发票信息
invoiceBuildingInfoObject否建筑服务发票时必填建筑服务信息
发票明细
detailIndexInteger是0明细序号5
detailTypeInteger是0明细行性质:0,正常行;1,折扣行;2,被折扣行2
commodityCodeString否商品编码64
goodsNameString是餐饮费如detailType=1，则此商品行为折扣行，此版本折扣行不允许多行折扣，折扣行必须紧邻被折扣行，项目名称必须与被折扣行一致。商品名称90
withTaxFlagInteger是1必填含税标志，0:不含税,1:含税2
goodsPriceBigDecimal否冲红时项目单价为正数

含税单价，当含税标志为：含税且不含税金额、税额、含税金额未全部传入时，必填，数量和单价必须都不填或者都必填，不可只填一个。

+

建议保留小数点后8位以上，减少计算误差。

+

开具成品油发票时必填且建议为5位小数。

16
taxFreePriceBigDecimal否冲红时项目单价为正数

不含税单价，当含税标志为：不含税且不含税金额、税额、含税金额未全部传入时，必填，数量和单价必须都不填或者都必填，不可只填一个。建议保留小数点后8位。

+

开具成品油发票时必填且建议为5位小数。

16
goodsNumBigDecimal否开具红字发票时，数量为负数

数量，数量、单价必须都不填，或都必填，不可只填一个；当数量、单价都不填时，不含税金额、税额、含税金额都必填；当数量、单价都填时，不含税金额、税额、含税金额可为空。建议保留小数点后8位以上。

+

开具成品油发票时必填且建议为5位小数。

16
taxrateString是0.13税率10
specTypeString否规格型号40
goodsUnitString否单位，开具成品油发票时必填，必须为”升”或“吨”。22
goodsCodeString否可不传入，由接口进行智能匹配，如对接口自动匹配准确率要求高的企业，建议传入税收分类编码19
selfCodeString否自行编码20
favouredPolicyFlagInteger是0默认为:0,不使用

优惠政策标识，0:不使用;1:使用

+

数电发票时为空，仅传入优惠政策编码即可

2
favouredPolicyNameString否favouredPolicyFlag为1时，此项必填

优惠政策内容，如：即征即退、免税、不征税、简易征收等

+

数电发票时为空，仅传入优惠政策编码即可

50
zeroRateFlagInteger否

零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率。

+

数电发票时为空，仅传入优惠政策编码即可

+

普通零税率，对应传值：

+

favouredPolicyFlag:0

+

zeroRateFlag:3

+

favouredPolicyName:

+

免税时，对应传值：

+

favouredPolicyFlag:1

+

zeroRateFlag:1

+

favouredPolicyName:“免税”

+

不征税，对应传值：

+

favouredPolicyFlag:1

+

zeroRateFlag:2

+

favouredPolicyName:“不征税”

2
deductionBigDecimal否

扣除额，小数点后两位。差额征收的发票目前只支持一行明细。不含税差额 = 不含税金额 - 扣除额； 税额 = 不含税差额*税率

+

注意：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00

15.2
taxFreeAmountBigDecimal否精确到小数点后面两位，红字发票为负数。不含税金额、税额、含税金额任何一个不传时，会根据传入的单价，数量进行z计算，可能和实际数值存在误差，建议都传入不含税金额15.2
taxBigDecimal否精确到小数点后面两位，红字发票为负数。不含税金额、税额、含税金额任何一个不传时，会根据传入的单价，数量进行计算，可能和实际数值存在误差，建议都传入税额15.2
taxAmountBigDecimal否精确到小数点后面两位，红字发票为负数。不含税金额、税额、含税金额任何一个不传时，会根据传入的单价，数量进行计算，可能和实际数值存在误差，建议都传入含税金额15.2
tonBigDecimal否盈亏吨数
columnFirstString否自定义字段1255
columnSecondString否自定义字段2255
columnThreeString否自定义字段3255
columnFourString否自定义字段4255
columnFiveString否自定义字段5255
favouredPolicyCodeString否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%即征即退

优惠政策编码

+

数电发票特有字段，如使用优惠政策时，该字段必填。

机动车(j)/二手车发票(u)明细（发票种类为j或u时需传入）
vehicleTypeString是发票种类为j或u时必填车辆类型40
brandModelString是发票种类为j或u时必填厂牌型号60
productOriginString是发票种类为j时必填产地32
certificateString否合格证号，国产车填写50
importCertifyNumString否进口证明书号，进口车填写36
inspectionOddNumString否商检单号32
engineNumString否发动机号50
vehicleCodeString是发票种类为j或u时必填车架号码/车辆识别代号23
measureUnitsString否吨位8
maxCapacityString限乘人数
organizationCodeString否其他证件号码，仅用于填写非中国居民证件号30
produceCompanyNameString是发票种类为j必填生产企业名称，不同税控设备要求不一致，具体以开票设备为准，金税盘选填，ukey、百旺盘必填100
intactCertificateNumString否完税凭证号码
organizeTypeString是发票种类为u时必填开票方类型：1.经营单位2.拍卖单位3.二手车市场（二手车专用）2
licenseNumberString是发票种类为u时必填车牌号码（二手车专用）20
registerCertNoString是发票种类为u时必填登记证号（二手车专用）20
vehicleManagementNameString是发票种类为u时必填转入地车辆管理所名称（二手车专用）80
salerNameString是发票种类为u时必填卖方单位/个人名称（二手车专用）80
salerNumString是发票种类为u时必填卖方单位代码/身份证号码（二手车专用）20
salerAddressString否卖方单位/个人地址（二手车专用）80
salerPhoneString否卖方电话（二手车专用）20
forceFlagInteger否发票种类为u时填写，默认0是否强制开具标记 0否 1是2
货物运输明细
goodsNameString否煤炭运输货物名称80
originString否北京市市辖区东城区起运地80
destinationString否北京市市辖区丰台区到达地80
transportTool否1运输工具种类：1铁路运输、2公路运输、3.水路运输、4.航空运输、5.管道运输1
transportToolNumString否车牌号DD运输工具牌号80
不动产租赁发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
rentStartDateString是2023-02-17yyyy-MM-dd格式租赁期起期10
rentEndDateString是2023-02-18yyyy-MM-dd格式租赁期止期10
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位1
建筑服务发票信息
buildingAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入建筑服务发生地-
detailedAddressString否XXXX街道XXX号建筑服务发生地+详细地址最大长度120详细地址120
landVatItemNoString否1234556土地增值税项目编号16
itemNameString是1234556项目名称80
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertySellObject否不动产销售发票时必填不动产销售发票信息
不动产销售发票信息
realPropertyAddressString是浙江省杭州市西湖区严格按照省市区/县层级传入不动产地址不动产地址 +不动产详细地址 最大长度120
detailAddressString是xxxxxx街xxx号

需含有"街","路","村","乡","镇","道","巷","号"中一个或多个关键字

+

不动产地址 +不动产详细地址最大长度120

不动产详细地址不动产地址 +不动产详细地址 最大长度120
crossCityFlagInteger是00-否 1-是跨地市标志1
realPropertyCertificateString否123456789产权证书/不动产权证号40
unitString是2

1-平方千米

+

2-平方米

+

3-公顷

+

4-亩

+

5-hm²

+

6-km²

+

7-㎡

面积单位10
realPropertyContractNumberString否不动产单元代码/网签合同备案编号28
incrementTaxNumberString否土地增值税项目编号18
priceString否核定计税价格20
taxAmountString否核定计税价格有值时,实际成交含税金额必填实际成交含税金额20
invoiceTravellerTransportInfoListList否开旅客运输发票时传入出行人信息出行人信息
出行人信息
travellerString是出行人20
travelDateString是年-月-日格式出行日期 年-月-日10
travellerCardTypeString是

101-组织机构代码证

+

102-营业执照

+

103-税务登记证

+

199-其他单位证件

+

201-居民身份证

+

202-军官证

+

203-武警警官证

+

204-士兵证

+

205-军队离退休干部证

+

206-残疾人证

+

207-残疾军人证（1-8级）

+

208-外国护照

+

210-港澳居民来往内地通行证

+

212-中华人民共和国往来港澳通行证

+

213-台湾居民来往大陆通行证

+

214-大陆居民往来台湾通行证

+

215-外国人居留证

+

216-外交官证

+

217-使（领事）馆证

+

218-海员证

+

219-香港永久性居民身份证

+

220-台湾身份证

+

221-澳门特别行政区永久性居民身份证

+

222-外国人身份证件

+

224-就业失业登记证

+

225-退休证

+

226-离休证

+

227-中国护照

+

228-城镇退役士兵自谋职业证

+

229-随军家属身份证明

+

230-中国人民解放军军官转业证书

+

231-中国人民解放军义务兵退出现役证

+

232-中国人民解放军士官退出现役证

+

233-外国人永久居留身份证（外国人永久居留证）

+

234-就业创业证

+

235-香港特别行政区护照

+

236-澳门特别行政区护照

+

237-中华人民共和国港澳居民居住证

+

238-中华人民共和国台湾居民居住证

+

239-《中华人民共和国外国人工作许可证》（A类）

+

240-《中华人民共和国外国人工作许可证》（B类）

+

241-《中华人民共和国外国人工作许可证》（C类）

+

291-出生医学证明

+

299-其他个人证件

出行人证件类型5
travellerCardNoString是出行人证件号码20
travelPlaceString是出行地80
arrivePlaceString是到达地80
vehicleTypeInteger是
    +

  1. 飞机

    2. +

  2. 火车

    3. +

  3. 长途汽车

    4. +

  4. 公共交通

    5. +

  5. 出租车

    6. +

  6. 汽车

    7. +

  7. 船舶

    +

    9-其他

    8. +
交通工具类型2
vehicleLevelString否

当交通工具类型是火车、飞机、船舶时必填选择，其他交通工具时可选填

+

当交通工具类型是火车时，必填，下拉框选择，可选项是 一等座、二等座、软席（软座、软卧）、硬卧（硬座、硬卧）

+

当交通工具类型是飞机时，必填，下拉框选择，可选项是 公务舱、头等舱、经济舱

+

当交通工具类型是船舶事，必填，下拉框选择，可选项是 一等舱、二等舱、三等舱

+

当交通工具类型是其他时，选填

交通工具等级20
+ +**机动车销售统一发票传参规则** + +企业购方税号、中国居民身份证号使用【购方税号：buyerTaxnum】字段传入，其他证件号码（港澳台人员证件号等）使用【其他证件号码：organizationCode】传入。 + +### 请求示例 + + +++ + + + + + +

{

+

"billInfoNo":null,

+

"bizCallbackUrl":null,

+

"buyerAccount":"银行账号",

+

"buyerAddress":"浙江省杭州市",

+

"buyerBank":"开户行",

+

"buyerName":"个人",

+

"buyerPhone":"0571-00000000",

+

"buyerTaxnum":"339901999999142",

+

"checker":"复核人",

+

"clerkId":null,

+

"clerker":"开票员",

+

"columnFirst":null,

+

"columnSecond":null,

+

"columnThree":null,

+

"departmentId":null,

+

"deptId":null,

+

"detail":[

+

{

+

"deduction":null,

+

"detailIndex":0,

+

"detailType":0,

+

"favouredPolicyFlag":0,

+

"favouredPolicyName":null,

+

"goodsCode":"1010115010100000000",

+

"goodsCodeAbb":"水果",

+

"goodsName":"苹果",

+

"goodsNum":1,

+

"goodsPrice":1.09,

+

"goodsUnit":"箱",

+

"selfCode":null,

+

"specType":"20个",

+

"tax":0.09,

+

"taxAmount":1.09,

+

"taxFreeAmount":1,

+

"taxFreePrice":1,

+

"taxrate":"0.09",

+

"withTaxFlag":0,

+

"zeroRateFlag":null,

+

"vehicleType":"三轮运输车",

+

"brandModel":"厂牌型号",

+

"productOrigin":"产地",

+

"certificate":"合格证号",

+

"importCertifyNum":"进出口证明书号",

+

"inspectionOddNum":"商检单号",

+

"engineNum":"发动机号",

+

"vehicleCode":"车辆识别代号",

+

"measureUnits":"吨",

+

"maxCapacity":"10",

+

"organizationCode":"组织机构代码",

+

"produceCompanyName":"生产企业名称",

+

"columnFirst":"自定义字段1",

+

"columnSecond":"自定义字段2",

+

"columnThree":"自定义字段3",

+

"columnFour":"自定义字段4",

+

"columnFive":"自定义字段5"，

+

"forceFlag":1,

+

}

+

],

+

"extensionNum":null,

+

"invoiceCode":null,

+

"invoiceLine":"p",

+

"invoiceNumber":null,

+

"invoiceType":1,

+

"listFlag":0,

+

"listGoodsName":null,

+

"notifyEmail":null,

+

"notifyPhone":null,

+

"notifyType":-1,

+

"orderNo":"20170104120207971529",

+

"payee":"收款人",

+

"productOilFlag":0,

+

"remark":"备注信息",

+

"requestSrc":0,

+

"sellerAccount":"0000000000000000",

+

"sellerAddress":"杭州市西湖区",

+

"sellerBank":"开户行",

+

"sellerName":"演示公司",

+

"sellerPhone":"0571-00000000",

+

"sellerTaxnum":"339901999999610",

+

"substituteFlag":0,

+

"terminalNum":null,

+

"userId":null,

+

"nextInvoiceNum": "1234456",

+

"nextInvoiceCode": "123456"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 | +| message | String | | 同步成功 | | 详细信息 | 1024 | +| data | String | | 18081620564001000232 | | 提交成功则返回发票请求流水号，支持多个。如该订单号被拆分成多张发票，则会返回多个流水号。 | 单张发票流水号最大长度：20 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message":"成功",

+

"data":"20111014474101989690"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":"2050",

+

"message":"公司不存在"

+

}

+ +### 状态码说明 + +| | | +|:--:|:--:| +| **状态码** | **描述** | +| 2505 | 公司不存在 | +| 2600 | 发票类型不能为空 | +| 2601 | 发票类型错误(1:正票 2:红票) | +| 2602 | 红票发票代码不能为空 | +| 2603 | 红票发票号码不能为空 | +| 2604 | 红票发票代码不能超过12位 | +| 2605 | 红票发票号码不能超过8位 | +| 2606 | 红票对应蓝票不存在 | +| 2607 | 发票种类不存在 | +| 2608 | 代开标志不能为空 | +| 2609 | 代开标志只能为0和1 | +| 2610 | 清单标志不能为空 | +| 2611 | 清单标志只能为0和1 | +| 2612 | 清单标志为1时,清单项目名称不能为空 | +| 2613 | 清单项目名称不能超过90位 | +| 2614 | 成品油标志不能为空 | +| 2615 | 成品油标志只能为0和1 | +| 2616 | 成品油发票不支持清单票 | +| 2617 | 成品油发票不支持收购票 | +| 2618 | 成品油发票不支持代开票 | +| 2619 | 红票和蓝票的成品油标识必需一致 | +| 2620 | 暂不支持卷票 | +| 2621 | 该服务器类型暂不支持专票冲红 | +| 2622 | 该服务器类型暂不支持纸票冲红 | +| 2623 | 暂不支持开具收购发票 | +| 2624 | 购方名称不能为空 | +| 2625 | 购方名称不能超过100位 | +| 2626 | 购方税号只支持6-20位 | +| 2627 | 税号只能包含数字和字母 | +| 2628 | 专票购方税号不能为空 | +| 2629 | 购方电话不能超过50位 | +| 2630 | 专票购方电话不能为空 | +| 2631 | 购方地址不能超过100位 | +| 2632 | 专票购方地址不能为空 | +| 2633 | 购方地址和电话不能超过100位 | +| 2634 | 购方开户行不能超过100位 | +| 2635 | 购方开户行不能为空 | +| 2636 | 购方开户账号不能超过20位 | +| 2637 | 购方开户账号不能为空 | +| 2638 | 购方开户行及账号不能超过100位 | +| 2639 | 推送方式不能为空 | +| 2640 | 目前推送方式仅支持:\[-1,0,1,2\] | +| 2641 | 通知手机号不能超过20位 | +| 2642 | 通知手机号格式错误 | +| 2643 | 手机通知时手机号不能为空 | +| 2644 | 邮箱通知时邮箱不能为空 | +| 2645 | 通知邮箱格式错误 | +| 2646 | 通知邮箱不能超过50位 | +| 2647 | 销方名称不能为空 | +| 2648 | 销方名称不能超过100位 | +| 2649 | 销方税号不能为空 | +| 2650 | 销方税号只支持15-20位 | +| 2651 | 不允许对其他企业开具的发票进行冲红 | +| 2652 | 销方地址不能为空 | +| 2653 | 销方地址电话不能超过100位 | +| 2654 | 销方电话不能为空 | +| 2655 | 销方电话不能超过20位 | +| 2656 | 销方开户行不能为空 | +| 2657 | 销方账号不能为空 | +| 2658 | 销方开户行及账号不能超过100位 | +| 2659 | 开票员不能为空 | +| 2660 | 开票员长度不能超过20位 | +| 2661 | 收款员长度不能超过20位 | +| 2662 | 复核人长度不能超过20位 | +| 2663 | 商品详情为空 | +| 2664 | 订单明细行最大支持2000行 | +| 2665 | 数据格式不正确 | +| 2666 | 卷票明细行数不能超过13行 | +| 2667 | 红票备注不能为空 | +| 2668 | 红字信息表编号不能为空 | +| 2669 | 红字申请单号不能超过24位 | +| 2670 | 专用发票红票备注需注明：开具红字增值税专用发票信息表编号\*\*\* | +| 2671 | 代开发票备注需注明：代开企业税号:\*\*\* 代开企业名称:\*\*\* | +| 2672 | 备注长度不能超过230位 | +| 2673 | 订单编号不能为空 | +| 2674 | 订单编号长度不能大于64个字符 | +| 2675 | 请求来源错误 | +| 2676 | 发票已作废，无需冲红 | +| 2677 | 第%s行明细中商品名称不能为空 | +| 2678 | 第%s行明细中商品名称不能超过90位 | +| 2679 | 第%s行明细中商品编码不能超过19位 | +| 2680 | 第%s行明细中发票行性质只能为:\[0,1,2\] | +| 2681 | 第%s行明细中优惠政策标识只能为:\[0,1\] | +| 2682 | 第%s行明细中当优惠政策标识为1时,优惠政策名称不能为空 | +| 2683 | 第%s行明细中优惠政策名称不能超过50位 | +| 2684 | 第%s行明细中零税率标识只能为:\[0,1,2,3\] | +| 2685 | 第%s行明细中自行编码不能超过20位 | +| 2686 | 第%s行明细中单价含税标志只能为:\[0,1\] | +| 2687 | 第%s行明细中含税金额不能超过16位 | +| 2688 | 第%s行明细中不含税金额不能超过16位 | +| 2689 | 第%s行明细中税额不能超过16位 | +| 2690 | 第%s行明细中(不含税金额+税额)不等于含税金额 | +| 2691 | 第%s行明细中成品油单价不能为空 | +| 2692 | 第%s行明细中项目单价为空时，含税金额、不含税金额、税额都不能为空 | +| 2693 | 第%s行明细中商品单价为空时，商品数量也必须为空 | +| 2694 | 第%s行明细中商品单价长度不能超过29位 | +| 2695 | 第%s行明细中商品单价不能为0或负数 | +| 2696 | 第%s行明细中商品数量不能为空，且长度不能超过29位 | +| 2697 | 第%s行明细中蓝票商品数量不能为0或负数 | +| 2698 | 第%s行明细中红票商品数量不能为0或正数 | +| 2699 | 第%s行明细中商品税率不能为空 | +| 2700 | 第%s行明细中支持的税率列表:\[0,0.01,0.015,0.03,0.04,0.05,0.06,0.09,0.10,0.11,0.13,0.16,0.17\] | +| 2701 | 第%s行明细中规格型号不能超过40位 | +| 2702 | 第%s行明细中成品油发票单位不能为空 | +| 2703 | 第%s行明细中成品油发票单位只能为吨或升 | +| 2704 | 第%s行明细中单位不能超过22位 | +| 2705 | 第%s行明细中折扣行必须紧挨被折扣行之后 | +| 2706 | 第%s行明细中红票不支持折扣行发票开具 | +| 2707 | 第%s行明细中蓝票折扣行金额应为负 | +| 2708 | 第%s行明细中蓝票折扣行商品数量应为负 | +| 2709 | 第%s行明细中蓝票被折扣行金额应为正 | +| 2710 | 第%s行明细中蓝票被折扣行商品数量应为正 | +| 2711 | 第%s行明细中蓝票折扣行金额不能大于被折扣行的金额 | +| 2712 | 第%s行明细中折扣行商品税率必须和被折扣行商品税率相同 | +| 2713 | 第%s行明细中折扣行的商品名称必须和被折扣行相同 | +| 2714 | 第%s行明细中红票金额必须小于0 | +| 2715 | 第%s行明细中正票金额必须大于0 | +| 2716 | 扣除额只支持两位小数 | +| 2717 | 收购发票暂不支持开具差额征税发票 | +| 2718 | 扣除额只能开具一条商品明细 | +| 2719 | 扣除额不得小于0 | +| 2720 | 扣除额最大不得超过100亿 | +| 2721 | 扣除额大于等于开票金额时，税额应为0 | +| 2722 | 备注需注明差额征税： | +| 2723 | 扣除额不得大于0 | +| 2724 | 扣除额不得小于负100亿 | +| 2725 | 差额征税红字发票备注需注明 | +| 2726 | 差额征税发票，扣除额不能为空 | +| 2727 | 第%s行明细中金额\*税率-税额大于0.06,明细行名称:%s | +| 2728 | 第%s行明细中不含税单价和数量与不含税金额误差大于0.01,明细行名称:%s | +| 2729 | 正票金额必须大于0 | +| 2730 | 红票金额必须小于0 | +| 2731 | 金额超过对应蓝票剩余含税金额: ￥ | +| 2732 | 金额超过对应蓝票剩余不含税金额：￥ | +| 2734 | 已超过最大交付次数10次 | +| 2735 | 重新交付手机和邮箱不能都为空 | +| 2736 | 纸票不能交付 | +| 2737 | 开票未完成，不可重发通知。 | +| 2738 | 订单编号不能重复 | +| 2745 | 分机号范围为0-65535 | +| 2746 | 终端号不能超过10位 | +| 2747 | 第%s行明细中商品不存在，请重新选择商品或增加新商品 | +| 2761 | 单行明细不含税金额超过单张开票限额不支持拆分开票 | +| 2762 | 折扣后不含税金额超过单张开票限额不允许拆分开票 | +| 2763 | 该订单拆分后发票金额为0，不得拆分开票 | +| 2764 | 第%s行明细中商品税率、增值税特殊管理、零税率标识逻辑关系不正确 | +| 2765 | 第%s行明细中商品零税率标识为1、2、3时，税率应为0% | +| 2766 | 发票拆分异常 | +| 2767 | 发票被拆分后明细大于%d行 | +| 2768 | 需要拆分的发票订单编号长度不能超过60位 | +| 2769 | 发票被拆分后张数大于%d张 | +| 2770 | 单张开票限额为空 | +| 2771 | 单张开票限额不能小于0.01 | +| 2772 | 需拆分发票的不含税金额不能小于0.01 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/录入自定义字段.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/录入自定义字段.md new file mode 100644 index 0000000..3faccca --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/录入自定义字段.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]] · [[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]://\[:\]/salescore/operation/definedColumn/batchSave.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 录入自定义字段 + +### 接口说明 + +根据订单号或流水号录入自定义字段信息。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/operation/definedColumn/batchSave.do | + +### 请求参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号 | 20 | +| orderNos | List | 否 | 订单号 订单号和发票流水号二选一必填，都传入则优先使用流水号 | 500 | +| invoiceIds | List | 否 | 发票流水号 订单号和发票流水号二选一必填，都传入则优先使用流水号 | 500 | +| columnFirst | String | 否 | 自定义字段一，三个自定义字段不可全为空 | \- | +| columnSecond | String | 否 | 自定义字段二，三个自定义字段不可全为空 | \- | +| columnThree | String | 否 | 自定义字段三，三个自定义字段不可全为空 | \- | + +### 请求示例 + + +++ + + + + + +

{

+

"orderNos": [

+

"123456789"

+

],

+

"sellerTaxnum": "150301199811285326"，

+

"columnFirst": "自定义字段1"，

+

"columnSecond": "自定义字段2"，

+

"columnThree": "自定义字段3"

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/快捷冲红接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/快捷冲红接口.md new file mode 100644 index 0000000..ba4de45 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/快捷冲红接口.md @@ -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]://\[:\]/salescore/lan/ fastRepeatedRedSingle.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 快捷冲红接口 + +### 接口说明 + +支持直接请求蓝字发票直接触发开具对应的红字发票或红字信息表。 + +注：数电发票使用此接口开取红票 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/ fastRepeatedRedSingle.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
sellerTaxnumString否

销方税号，15-20位

+

销方税号和组织编码必填其一

20
companyCodeString否

组织编码

+

企业税号和组织编码必填其一

20
invoiceIdString否蓝票流水号 非数电发票时必填20
invoiceCodeString否蓝票发票代码 非数电发票时必填12
invoiceNumberString否蓝票发票号码 非数电发票时必填8
billIdString否

红字确认单申请单号

+

与billNo、billUuid三选一必填

32
billNoString否

红字确认单编号 数电发票时填写

+

与billId、billUuid三选一必填

32
billUuidString否

红字确认单uuid 数电发票时填写

+

与billId、billNo三选一必填

32
fastRedTypeInteger否快捷冲红类型 不填或者0为普通快捷冲红 1:数电发票快捷冲红(数电发票必传1)1
invoiceLineString否

数电发票跨票种冲红时传入，发票票种：（非数电发票时不需要传）

+

bs:数电专票(电子),

+

pc:数电普票(电子)，

+

es:数电专票(纸质)，

+

ec:数电普票(纸质)

+

1、默认为对应蓝票数电票种；

+

2、蓝票为es 时可选择 bs、es进行冲红

+

3、蓝票为ec时可选择pc、ec进行冲红

+

4、蓝票为数电电票时只能拿原票种冲红

2
orderNoString否红字发票对应订单编号64
columnFirstString否自定义列1
columnSecondString否自定义列2
columnThreeString否自定义列3
+ +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"invoiceId": "14111111111",

+

"invoiceCode": "11111111",

+

"invoiceNumber": "22222222",

+

"billId": "22222222",

+

"billNo": "22222222",

+

"billUuid": "123456",

+

"fastRedType": 1,

+

"invoiceLine": "es",

+

"orderNo": "123456908888",

+

"columnFirst": "c1",

+

"columnSecond": "c2",

+

"columnThree": "c3"

+

}

+ +### 返回参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
codeInteger是

状态,200-成功，非200-失败

+

不代表冲红成功/失败

6
messageString是详细信息1024
dataObject
data内字段说明
sellerTaxnumString是销方税号20
blueInvoiceIdString否蓝票流水号 非数电发票时必填20
blueInvoiceCodeString否蓝票代码 非数电发票时必填12
blueInvoiceNumberString否蓝票号码 非数电发票时必填8
redInvoiceIdString否(蓝票非专票时的字段)红票流水号，非专票时必有值20
redOrderNoString否(蓝票非专票时的字段)红票orderNo，非专票时必有值64
redBillNoString否(蓝票专票时的字段)红字信息表流水号(billNo),不是billInfoNo。专票时必有值24
reasonString否失败原因，冲红失败时才会有值2000
billIdString否红字确认单申请单号32
billNoString否红字确认单编号 数电发票时必填32
billUuidString否红字确认单uuid 数电发票时必填32
fastRedTypeInteger否快捷冲红类型 不填或者0为普通快捷冲红 1:数电快捷冲红(数电发票必传1)1
+ +### 返回示例 + +成功示例： + + +++ + + + + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"blueInvoiceId": "21122410310201000295",

+

"blueInvoiceCode": "111100020026",

+

"blueInvoiceNumber": "92482083",

+

"redInvoiceId": "12312312312",

+

"redOrderNo": "12123123123123",

+

"redBillNo": null,

+

"billId": "22222222",

+

"billNo": "22222222",

+

"billUuid": "123456",

+

"fastRedType": 1,

+

"reason": ""

+

}

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"blueInvoiceId": "21122410310201000295",

+

"blueInvoiceCode": "111100020026",

+

"blueInvoiceNumber": "92482083",

+

"redInvoiceId": null,

+

"redOrderNo": null,

+

"redBillNo": null,

+

"redBillNo": null,

+

"billId": "22222222",

+

"billNo": "22222222",

+

"billUuid": "123456",

+

"fastRedType": 1,

+

"reason": "未知异常"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/成品油库存下载接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/成品油库存下载接口.md new file mode 100644 index 0000000..2fb8c6d --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/成品油库存下载接口.md @@ -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]://\[:\]/salescore/lan/oilStock/downloadProductOil.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 成品油库存下载接口 + +### 接口说明 + +触发从税局局端下载成品油库存到税盘的接口 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/oilStock/downloadProductOil.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 是 | 分机号，纯数字 | \- | +| machineNumber | String | 否 | 机器编号，12位数字 | 12 | +| taxCode | String | 是 | 税收分类编码 | 19 | +| num | Double | 是 | 下载数量（升） | \- | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

"num": 1,

+

"sellerTaxnum": "150301199811285326",

+

"taxCode": "1070101060100000000"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 913,

+

"message": "[AA99]库存不够！",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量查询发票xmlUrl接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量查询发票xmlUrl接口.md new file mode 100644 index 0000000..3008589 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量查询发票xmlUrl接口.md @@ -0,0 +1,124 @@ +--- +title: 批量查询发票xmlUrl接口 +aliases: + - 批量查询发票xmlUrl接口 + - 诺税通批量查询发票xmlUrl接口 + - 车辆辅助与回传-批量查询发票xmlUrl接口 +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 +--- +# 批量查询发票xmlUrl接口 + +> [!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]://\[:\]/salescore/lan/queryInvoiceXml.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 批量查询发票xmlUrl接口 + +### 接口说明 + +获取发票的xmlUrl + +### 接口地址 + +| | +|:-------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/queryInvoiceXml.do | + +### 请求参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 企业税号 | 20 | +| dataStream | Integer | 否 | 是否返回数据流 0不返回 1返回 | \- | +| invoiceCodeAndNumbers | List\ | 否 | 发票查询信息 | 50 | +| InvoiceCodeNumDto发票信息参数 | | | | | +| invoiceCode | String | 否 | 发票代码 | 8 | +| invoiceNumber | String | 是 | 发票号码 | 20 | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"dataStream": 1,

+

"invoiceCodeAndNumbers": [

+

{

+

"invoiceCode": "12345678",

+

"invoiceNumber": "2302171651331000014"

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | +| data | Object | 是 | | 查询对象 | | +| sellerTaxnum | String | 是 | 150301199811285326 | 企业税号 | | +| invoiceCode | String | 是 | 12345678 | 发票代码 | | +| invoiceNumber | String | 是 | 2302171651331000014 | 发票号码 | | +| xmlUrl | String | 是 | | 发票xml地址(存在xml则返回) | | +| dataStream | String | 否 | | 发票xml数据流(Base64) | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

[

+

{

+

"dataStream": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5kYWxvbmU9InllcyI/Pgo8RUludm9pY2U+CiAgICA8SGVhZGVyPgogICAgICAgIDxFSWlkPjIyNDQyMDAwMDAwMDAyMDQwMjYxPC9FSWlkPgogICAgICAgIDxFSW52b2ljZVRhZz5TV0VJNDQwMDwvRUludm9pY2VUYWc+CiAgICAgICAgPFZlcnNpb24+MC4yPC9WZXJzaW9uPgogICAgICAgIDxJbmhlcmVudExhYmVsPgogICAgICAgICAgICA8SW5Jc3N1VHlwZT4KICAgICAgICAgICAgICAgIDxMYWJlbENvZGU+WTwvTGFiZWxDb2RlPgogICAgICAgICAgICAgICAgPExhYmVsTmFtZT7mmK/lkKbok53lrZflj5HnpajmoIflv5c8L0xhYmVsTmFtZT4KICAgICAgICAgICAgPC9Jbklzc3VUeXBlPgogICAgICAgICAgICA8RUludm9pY2VUeXBlPgogICAgICAgICAgICAgICAgPExhYmVsQ29kZT4wMTwvTGFiZWxDb2RlPgogICAgICAgICAgICAgICAgPExhYmVsTmFtZT7nlLXlrZDlj5Hnpag8L0xhYmVsTmFtZT4KICAgICAgICAgICAgPC9FSW52b2ljZVR5cGU+CiAgICAgICAgICAgIDxHZW5lcmFsT3JTcGVjaWFsVkFUPgogICAgICAgICAgICAgICAgPExhYmVsQ29kZT4wMjwvTGFiZWxDb2RlPgogICAgICAgICAgICAgICAgPExhYmVsTmFtZT7mma7pgJrlj5Hnpag8L0xhYmVsTmFtZT4KICAgICAgICAgICAgPC9HZW5lcmFsT3JTcGVjaWFsVkFUPgogICAgICAgICAgICA8VGF4cGF5ZXJUeXBlPgogICAgICAgICAgICAgICAgPExhYmVsQ29kZT4xPC9MYWJlbENvZGU+CiAgICAgICAgICAgICAgICA8TGFiZWxOYW1lPuS4gOiIrOe6s+eojuS6ujwvTGFiZWxOYW1lPgogICAgICAgICAgICA8L1RheHBheWVyVHlwZT4KICAgICAgICA8L0luaGVyZW50TGFiZWw+CiAgICAgICAgPFVuZGVmaW5lZExhYmVsPgogICAgICAgICAgICA8TGFiZWw+CiAgICAgICAgICAgICAgICA8TGFiZWxUeXBlPuS8geS4muihjOS4muaAp+i0qOexu+agh+etvjwvTGFiZWxUeXBlPgogICAgICAgICAgICAgICAgPExhYmVsQ29kZT4zNiwxNywwMiwzNyw0MCwwMywwOCxEUywxMSwyMDwvTGFiZWxDb2RlPgogICAgICAgICAgICAgICAgPExhYmVsTmFtZT7lhpzkuqflk4HmlLbotK3kvIHkuJos5Y2354Of55Sf5Lqn5LyB5LiaLOaIkOWTgeayuee7j+mUgOS8geS4mizlhYnkvI/mlLbotK3kvIHkuJos5YaN55Sf6LWE5rqQ5Zue5pS2LOWbveWGheacuuWKqOi9pueUn+S6p+S8geS4mizkuozmiYvovabnu4/plIDkvIHkuJosRFMs56iA5Zyf5Ya254K85YiG56a75LyB5LiaLOeUn+S6p+Wei+WHuuWPo+S8geS4mjwvTGFiZWxOYW1lPgogICAgICAgICAgICA8L0xhYmVsPgogICAgICAgICAgICA8TGFiZWw+CiAgICAgICAgICAgICAgICA8TGFiZWxUeXBlPuWPkeelqOW8gOWFt+aWueW8j+agh+etvjwvTGFiZWxUeXBlPgogICAgICAgICAgICAgICAgPExhYmVsQ29kZT4xPC9MYWJlbENvZGU+CiAgICAgICAgICAgICAgICA8TGFiZWxOYW1lPue9kemhteW8gOelqDwvTGFiZWxOYW1lPgogICAgICAgICAgICA8L0xhYmVsPgogICAgICAgIDwvVW5kZWZpbmVkTGFiZWw+CiAgICA8L0hlYWRlcj4KICAgIDxFSW52b2ljZURhdGE+CiAgICAgICAgPFNlbGxlckluZm9ybWF0aW9uPgogICAgICAgICAgICA8U2VsbGVySWROdW0+MTAxMjJBQUZGQUQ1N0NEM0U8L1NlbGxlcklkTnVtPgogICAgICAgICAgICA8U2VsbGVyTmFtZT7kuIDoiKznurPnqI7kurrogqHku73mnInpmZDlhazlj7g8L1NlbGxlck5hbWU+CiAgICAgICAgICAgIDxTZWxsZXJBZGRyPuaWsOWfjuWMuumUoeael+i3r+ihl+mBk+WKnuS6i+WkhDIzNDIzNDIzNDwvU2VsbGVyQWRkcj4KICAgICAgICAgICAgPFNlbGxlclRlbE51bT4xMzAyMjIyODg4ODwvU2VsbGVyVGVsTnVtPgogICAgICAgICAgICA8U2VsbGVyQmFua05hbWU+5YyX5Lqs6ZO26KGM5rW35reA5Yy65riF5rKz5pSv6KGMPC9TZWxsZXJCYW5rTmFtZT4KICAgICAgICAgICAgPFNlbGxlckJhbmtBY2NOdW0+NDQzMDAwMDEwNTAwMTY2MzE8L1NlbGxlckJhbmtBY2NOdW0+CiAgICAgICAgPC9TZWxsZXJJbmZvcm1hdGlvbj4KICAgICAgICA8QnV5ZXJJbmZvcm1hdGlvbj4KICAgICAgICAgICAgPEJ1eWVySWROdW0+OTExMTAxMDhNQTAxRUxISDlQPC9CdXllcklkTnVtPgogICAgICAgICAgICA8QnV5ZXJOYW1lPuWwj+inhOaooee6s+eojuS6uuiCoeS7veaciemZkOWwj+inhOaooee6s+eojuS6uuiCoeS7veaciemZkOWwjyAgICAg5qih57qz56iO5Lq66IKh5Lu95pyJ6ZmQ5bCP6KeE5qih57qz56iO5Lq66IKh5Lu95pyJ6ZmQ5bCP6KeE5qih57qz56iO5Lq66IKh5Lu95pyJ6ZmQPC9CdXllck5hbWU+CiAgICAgICAgICAgIDxCdXllckFkZHI+5LiA5LqM5LiJ5Zub5LqU5YWt5LiD5YWr5Lmd5Y2B5LiA5LqM5LiJ5Zub5LqU5YWt5LiD5YWr5Lmd5Y2B5LiA5LqM5LiJ5Zub5LqU5YWt5LiD5YWr5Lmd5Y2B5LiA5LqM5LiJ5Zub5LqU5YWt5LiD5YWr5Lmd5Y2B5LiA5LqM5LiJ5Zub5LqU5YWt5LiD5YWr5Lmd5Y2BPC9CdXllckFkZHI+CiAgICAgICAgICAgIDxCdXllclRlbE51bT4xMjM0NTY3ODkwMTIzNDU2NzA8L0J1eWVyVGVsTnVtPgogICAgICAgICAgICA8QnV5ZXJCYW5rTmFtZT7kuK3lm70gIOmTtuihjOW5v+W3nuesrOS4gOaUr+ihjOS4reWbvemTtuihjOW5v+W3niDnrKzkuIDmlK/ooYzkuK3lm73pk7booYzlub/lt57nrKzkuIDmlK/ooYzkuK3lm73pk7booYzlub/lt57nrKzkuIDmlK/ooYzkuK3lm73pk7booYzlub/lt57nrKzkuIDmlK/ooYw8L0J1eWVyQmFua05hbWU+CiAgICAgICAgICAgIDxCdXllckJhbmtBY2NOdW0+MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM2Nzg5MDwvQnV5ZXJCYW5rQWNjTnVtPgogICAgICAgICAgICA8QnV5ZXJIYW5kbGluZ05hbWU+PC9CdXllckhhbmRsaW5nTmFtZT4KICAgICAgICA8L0J1eWVySW5mb3JtYXRpb24+CiAgICAgICAgPEJhc2ljSW5mb3JtYXRpb24+CiAgICAgICAgICAgIDxUb3RhbEFtV2l0aG91dFRheD45OC4yMzwvVG90YWxBbVdpdGhvdXRUYXg+CiAgICAgICAgICAgIDxUb3RhbFRheEFtPjEyLjc3PC9Ub3RhbFRheEFtPgogICAgICAgICAgICA8VG90YWxUYXgtaW5jbHVkZWRBbW91bnQ+MTExLjAwPC9Ub3RhbFRheC1pbmNsdWRlZEFtb3VudD4KICAgICAgICAgICAgPFRvdGFsVGF4LWluY2x1ZGVkQW1vdW50SW5DaGluZXNlPuWjueS9sOWjueaLvuWjueWchuaVtDwvVG90YWxUYXgtaW5jbHVkZWRBbW91bnRJbkNoaW5lc2U+CiAgICAgICAgICAgIDxEcmF3ZXI+5byg55uK6L6+PC9EcmF3ZXI+CiAgICAgICAgICAgIDxSZXF1ZXN0VGltZT4yMDIyLTA5LTIxPC9SZXF1ZXN0VGltZT4KICAgICAgICA8L0Jhc2ljSW5mb3JtYXRpb24+CiAgICAgICAgPElzc3VJdGVtSW5mb3JtYXRpb24+CiAgICAgICAgICAgIDxJdGVtTmFtZT4q5aKo5rC0KumSoueslOaZrumAmumbtjwvSXRlbU5hbWU+CiAgICAgICAgICAgIDxTcGVjTW9kPjwvU3BlY01vZD4KICAgICAgICAgICAgPE1lYVVuaXRzPjwvTWVhVW5pdHM+CiAgICAgICAgICAgIDxRdWFudGl0eT4xPC9RdWFudGl0eT4KICAgICAgICAgICAgPFVuUHJpY2U+OTguMjMwMDg4NDk1NTc1MjwvVW5QcmljZT4KICAgICAgICAgICAgPEFtb3VudD45OC4yMzwvQW1vdW50PgogICAgICAgICAgICA8VGF4UmF0ZT4wLjEzMDAwMDwvVGF4UmF0ZT4KICAgICAgICAgICAgPENvbVRheEFtPjEyLjc3MDAwMDwvQ29tVGF4QW0+CiAgICAgICAgICAgIDxUb3RhbHRheEluY2x1ZGVkQW1vdW50PjExMS4wMDAwMDA8L1RvdGFsdGF4SW5jbHVkZWRBbW91bnQ+CiAgICAgICAgICAgIDxUYXhDbGFzc2lmaWNhdGlvbkNvZGU+MTA2MDQwNDAyMDAwMDAwMDAwMDwvVGF4Q2xhc3NpZmljYXRpb25Db2RlPgogICAgICAgIDwvSXNzdUl0ZW1JbmZvcm1hdGlvbj4KICAgICAgICA8U3BlY2lmaWNJbmZvcm1hdGlvbi8+CiAgICAgICAgPEFkZGl0aW9uYWxJbmZvcm1hdGlvbi8+CiAgICA8L0VJbnZvaWNlRGF0YT4KICAgIDxTZWxsZXJBdXRoZW50aWNhdGlvbj4KICAgICAgICA8QXV0aGVudGljYXRpb25NZXRob2RzPjAyPC9BdXRoZW50aWNhdGlvbk1ldGhvZHM+CiAgICA8L1NlbGxlckF1dGhlbnRpY2F0aW9uPgogICAgPFRheFN1cGVydmlzaW9uSW5mbz4KICAgICAgICA8SW52b2ljZU51bWJlcj4yMjQ0MjAwMDAwMDAwMjA0MDI2MTwvSW52b2ljZU51bWJlcj4KICAgICAgICA8SXNzdWVUaW1lPjIwMjItMDktMjEgMjA6MTY6Mjg8L0lzc3VlVGltZT4KICAgICAgICA8VGF4QnVyZWF1Q29kZT4xNDQwMDAwMDAwMDwvVGF4QnVyZWF1Q29kZT4KICAgICAgICA8VGF4QnVyZWF1TmFtZT7lm73lrrbnqI7liqHmgLvlsYDlub/kuJznnIHnqI7liqHlsYA8L1RheEJ1cmVhdU5hbWU+CiAgICA8L1RheFN1cGVydmlzaW9uSW5mbz4KICAgIDxUYXhCdXJlYXVTaWduYXR1cmU+CiAgICAgICAgPFJlZmVyZW5jZSBVUkk9Ii9FaW52b2ljZS9IZWFkZXJ8L0VpbnZvaWNlL0VpbnZvaWNlRGF0YXwvRWludm9pY2UvU2VsbGVyQXV0aGVudGljYXRpb258L0VpbnZvaWNlL1RheFN1cGVydmlzaW9uSW5mb3wvRWludm9pY2UvVGF4QnVyZWF1U2lnbmF0dXJlL1NpZ25hdHVyZVRpbWUiLz4KICAgICAgICA8U2lnbmF0dXJlQWxnb3JpdGhtPjEuMi4xNTYuMTAxOTcuMS41MDE8L1NpZ25hdHVyZUFsZ29yaXRobT4KICAgICAgICA8U2lnbmF0dXJlRm9ybWF0PkRFVEFDSDwvU2lnbmF0dXJlRm9ybWF0PgogICAgICAgIDxTaWduYXR1cmVUaW1lPjIwMjItMDktMjMgMjA6MTc6NDI8L1NpZ25hdHVyZVRpbWU+CiAgICAgICAgPFNpZ25hdHVyZVZhbHVlPjwvU2lnbmF0dXJlVmFsdWU+CiAgICAgICAgPEtleUluZm8vPgogICAgPC9UYXhCdXJlYXVTaWduYXR1cmU+CjwvRUludm9pY2U+Cg==",

+

"invoiceCode": "12345678",

+

"invoiceNumber": "2302171651331000014",

+

"sellerTaxnum": "9151010020260067X4",

+

"xmlUrl": "https://cmp-brh.nntest.cn/fd/M00/BC/5D/wKjScGPjCLaAVgJkAAASx_Qt__k274.xml"

+

}

+

]

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取信息转换配置接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取信息转换配置接口.md new file mode 100644 index 0000000..bc71eeb --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取信息转换配置接口.md @@ -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]://\[:\]/salescore/lan/infoConvert/batch.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 批量获取信息转换配置接口 + +### 接口说明 + +批量获取信息转换配置，供应链使用，最多支持500个税号的查询。 + +### 接口地址 + +| | +|:---------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"taxnum": "150301199811285326",

+

"goodsOpenFlag": 1,

+

"goodsProcessNode": "INVOICE",

+

"customerOpenFlag": 1,

+

"customerProcessNode": "INVOICE"

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取备注配置信息接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取备注配置信息接口.md new file mode 100644 index 0000000..bf78d87 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/批量获取备注配置信息接口.md @@ -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]://\[:\]/salescore/lan/config/remarkConf/batch.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 批量获取备注配置信息接口 + +### 接口说明 + +批量获取备注配置信息，供应链使用，最多支持500组数据的查询。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/config/remarkConf/batch.do | + +### 请求参数 + +| | | | | | +|:------------:|:--------:|:--------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| taxnum | String | 否 | 企业税号 | 20 | +| businessType | String | 否 | 业务标识 | 2 | +| processNode | String | 否 | 处理节点 | 100 | +| buyerTaxnum | String | 否 | 购方税号 | 20 | +| buyerName | String | 否 | 购方名称 | 100 | + +### 请求示例 + + +++ + + + + + +

[

+

{

+

"businessType": "1",

+

"buyerName": "",

+

"buyerTaxnum": "",

+

"processNode": "INVOICE",

+

"taxnum": "3333333333333333"

+

}

+

]

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | | **类型** | **必填** | **描述** | **长度** | +| 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 | | | 购方名称 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"taxnum": "3333333333333333",

+

"businessType": "1",

+

"processNode": "INVOICE",

+

"buyerName": "",

+

"buyerTaxnum": "",

+

"configs": [

+

{

+

"idx": 0,

+

"rowNo": 1,

+

"remarkTitle": "出口",

+

"paramCode": "",

+

"valSource": 1

+

},

+

{

+

"idx": 1,

+

"rowNo": 2,

+

"remarkTitle": "外币金额:",

+

"paramCode": "FOREIGN_CURRENCY_AMOUNT",

+

"valSource": 1

+

}

+

]

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/抄报清卡.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/抄报清卡.md new file mode 100644 index 0000000..da8fa5a --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/抄报清卡.md @@ -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]://\[:\]/salescore/extensioninfo/reportAndClear.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 抄报清卡 + +### 接口说明 + +触发抄报清卡 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/extensioninfo/reportAndClear.do | + +### 请求参数 + +| | | | | | +|:------------:|:--------:|:--------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| taxnum | String | 是 | 销方税号 | 20 | +| extensionNum | String | 否 | 分机号 | | +| machineNum | String | 否 | 机器号 | | + +### 请求示例 + + +++ + + + + + +

{

+

"taxnum": "150301199811285326",

+

"extensionNum": "1",

+

"machineNum": "123456789123"

+

}

+ +### 返回参数 + +| | | | | | +|:------------:|:--------:|:--------:|:--------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | String | 否 | 触发失败的原因以及设备信息 | | +| extensionNum | String | 否 | 分机号 | | +| machineNum | String | 否 | 机器号 | | +| reason | String | 否 | 触发失败的原因 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败返回示例： + + +++ + + + + + +

{

+

"code": 400,

+

"message": "税号不能为空",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/授信额度刷新接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/授信额度刷新接口.md new file mode 100644 index 0000000..1ea352e --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/授信额度刷新接口.md @@ -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]://\[:\]/salescore/lan/creditQuota/query.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 授信额度刷新接口 + +### 接口说明 + +获取数电发票税局最新授信额度,该接口根据不同设备类型，返回不同结果。如果乐企模式，则同步返回授信额度数据。如果非乐企模式，为异步查询，需搭配接口3.57使用，来获取查询结果。 + +### 接口地址 + +| | +|:---------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/creditQuota/query.do | + +### 请求参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 | +| type | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 请求类型 0:乐企 1:数电普通 | \- | +| extensionNum | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 分机号 | 0-99999 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"type": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | 授信额度更新时间 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": "200",

+

"message": "查询成功" ,

+

"data": {

+

"creditFlag": "Y",

+

"creditQuotaAmount": "10000.00" ,

+

"downloadAmount": "10000.00",

+

"downloadRemainAmount": "10000.00",

+

"remainAmount": "10000.00",

+

"taxnum": "150301199811285326",

+

"vestPeriod": "202303",

+

"creditUpdateTime": "2023-03-06 00:00:00"

+

}

+

}

+

非乐企:

+

{

+

"code": "200",

+

"message": "查询成功" ,

+

"data": ""

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/收票入库接口_本地提取发票.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/收票入库接口_本地提取发票.md new file mode 100644 index 0000000..bf87bbd --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/收票入库接口_本地提取发票.md @@ -0,0 +1,1148 @@ +--- +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]://\[:\]/salescore/lan/ receiveLocalInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 收票入库接口（本地提取发票） + +### 接口说明 + +将第三方的发票通过此接口推送至诺税通销项发票系统。 + +### 接口地址 + +| | +|:------------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/ receiveLocalInvoice.do | + +注：此接口以 application/json 方式提交数据 + +### 请求参数 + + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必须示例值更多限制描述最大长度
sellerTaxnumString否　　销方税号和组织编码必填其一销方税号20
sellerNameString是　　销方名称100
companyCodeString否销方税号和组织编码必填其一组织编码20
businessTypeString否业务标识(基础模块设置的业务类型枚举值)业务标识2
sellerAddressString否　　销方地址100
sellerPhoneString否　　销方电话20
sellerBankString否　　销方开户银行100
sellerAccountString否　　销方银行账号30
clerkerString是　　开票员20
payeeString否　　收款人20
checkerString否　　复核人20
buyerNameString是　　购方名称100
buyerTaxnumString否　　购方税号20
buyerAddressString否　　购方地址100
buyerPhoneString否　　购方电话50
buyerBankString否　　购方开户银行100
buyerAccountString否　　购方银行账户30
orderNoString否　　订单编号64
orderDateString否2022-05-12年-月-日订单日期10
deliverDateString否2022-05-12年-月-日发货日期10
invoiceTypeString是　　1：蓝票；2：红票。发票类型2
taxAmountTotalBigDecimal是　　含税金额　
taxFreeAmountTotalBigDecimal是　　不含税金额　
taxTotalBigDecimal是　　合计税额　
invoiceLineString是　　p:电子增值税普通发票，c:增值税普通发票(纸票)，s:增值税专用发票，e:收购发票(电子)，f:收购发票(纸质)，r:增值税普通发票(卷式)，b:增值税电子专用发票，j：机动车发票发票种类2
createTimeDate否　　创建时间　
invoiceTimeDate是　　开票时间　
invalidTimeDate否　　作废时间　
invalidStateInteger否　0 未提交 , 1 作废成功 , 2 作废失败 , 3 已提交(作废中)作废状态2
requestSrcInteger否　0-API调用，1-手工开票，2-批量导入，3-防伪开票，4-扫码开票，5-本地提取，6-诺诺发票，默认5请求来源1
remarkString否　　备注

数电电票：200(中文计算一位)

+

其他发票：230(中文计算两位)

invoiceCodeString是　不足请左补0发票代码12
invoiceNumberString是　不足请左补0发票号码8
oriInvoiceCodeString否　不足请左补0对应蓝票代码12
oriInvoiceNumberString否　不足请左补0对应蓝票号码8
listFlagInteger是　　清单标志2
listGoodsNameString否　　清单发票项目名称90
extensionNumInteger否　　分机号5
machineNumerString否　　机器编号12
terminalNumInteger否　　终端号5
pdfUrlString否　　发票pdf地址255
paperPdfUrlString否　　纸票pdf地址255
imageUrlString否　　图片地址(多个图片使用逗号隔开)255
checkCodeString否　　校验码32
qrCodeString否　　二维码100
invoiceCipherString否　　发票密文200
ofdUrlString否　　ofd地址255
pictureUrlString否　　发票详情地址255
substituteFlagInteger是　0非代开;1代开。默认值0代开标志2
departmentIdLong否　　部门门店id20
userIdLong否　　开票员Id20
productOilFlagInteger是　0非成品油，1成品油成品油标志2
vehicleFlagInteger否0非机动车，1机动车，默认为0专票机动车标志2
billInfoNoString否　　对应红字信息表编号24
columnFirstString否　　自定义列一255
columnSecondString否　　自定义列二255
columnThreeString否　　自定义列三255
bizCallbackUrlString否　　业务系统回调地址255
departCodeString否部门编码50
projectCodeString否项目编码64
projectNameString否项目名称300
freshInvoiceLimitFlagInteger否0-不更新，1-更新，默认-0是否更新项目开票限额标志
detailList是　明细数组电子发票明细　
detailIndexInteger是　明细行索引。机动车非必填明细序号5
detailTypeInteger是　0,正常行;1,折扣行;2,被折扣行。机动车非必填明细行性质2
goodsNameString是　非机动车发时，必填。机动车非必填。商品名称90
withTaxFlagInteger是　

0:不含税,1:含税。

+

机动车票非必填。机动车非必填。

单价含税标志2
goodsPriceBigDecimal否　　含税单价　
taxFreePriceBigDecimal否　　不含税单价　
goodsNumBigDecimal否　　数量　
taxrateString是　红票时选填税率10
specTypeString否　　规格型号40
goodsUnitString否　　单位22
goodsCodeString否　　税收分类编码19
goodsCodeAbbString否　　税收分类编码简称200
selfCodeString否　　自行编码20
favouredPolicyFlagInteger是　0：不使用，1：使用。机动车票非必填。优惠政策标识2
favouredPolicyNameString否　标识为1时内容必填。优惠政策内容50
zeroRateFlagString否　零税率标识:空-非零税率;1-免税;2-不征税;3-普通零税率零税率标识2
deductionBigDecimal否　　扣除额　
taxAmountBigDecimal否　机动车必填。含税金额　
taxFreeAmountBigDecimal否　机动车必填。不含税金额　
taxBigDecimal否　机动车必填。税额　
columnFirstString否明细自定义列1255
columnSecondString否明细自定义列2255
columnThreeString否明细自定义列3255
columnFourString否明细自定义列4255
columnFiveString否明细自定义列5255
subjectAccountCodeString否T123核算主体编码维护在诺税通的“核算主体编码”200
subjectAccountString否核算主体名称核算主体名称核算主体名称200
机动车发票明细机动车发票明细
vehicleTypeString否　机动车发票时必填车辆类型40
brandModelString否　机动车发票时必填厂牌型号60
productOriginString否　机动车发票时必填产地32
certificateString否　　合格证号50
importCertifyNumString否　　进口说明书号50
inspectionOddNumString否　　商检单号50
engineNumString否　　发动机号50
vehicleCodeString否机动车发票时必填车架号码/车辆识别代号50
measureUnitsString否　　吨位20
maxCapacityString否　　限乘人数10
organizationCodeString否　机动车发票时必填身份证号/组织机构代码25
produceCompanyNameString否　　生产企业名称50
taxOfficeCodeString否　　税务机关代码100
taxOfficeNameString否　　税务机关名称100
intactCertificateNumString否　　完整凭证号码50
+ +### 请求示例 + + +++ + + + + + +

{

+

"buyerName": "测试购方企业",

+

"clerker": "小红",

+

"vehicleFlag" : 1,

+

"detail": [

+

{

+

"tax": "3",

+

"taxrate": "0.03",

+

"taxFreeAmount": "100",

+

"taxAmount": "103",

+

"vehicleType": "轿车",

+

"brandModel": "宝马3系",

+

"productOrigin": "北京",

+

"certificate": "WDL042613263551",

+

"importCertifyNum": "646464",

+

"engineNum": "1001111",

+

"vehicleCode": "LHGK43284342384234",

+

"intactCertificateNum": "1221",

+

"measureUnits": "3",

+

"maxCapacity": "5",

+

"taxOfficeCode": "665",

+

"taxOfficeName": "0564"

+

}

+

],

+

"machineNumber": "5454",

+

"terminalNum": "5454",

+

"extensionNum": "5454",

+

"invoiceCode": "000011112955",

+

"invoiceNumber": "00001111",

+

"invoiceLine": "j",

+

"invoiceTime": "2021-03-12T14:59:25.715",

+

"invoiceType": 1,

+

"listFlag": 0,

+

"productOilFlag": 0,

+

"requestSrc": 5,

+

"sellerName": "移动测试盘326",

+

"sellerTaxnum": "150301199811285326",

+

"substituteFlag": 0,

+

"taxAmountTotal": "12.01",

+

"taxFreeAmountTotal": "12.01",

+

"taxTotal": "12.01"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | Integer | 是 | 200 | | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | | 收票状态 | | +| data | String | | | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": ""

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 2505,

+

"message": "公司不存在"

+

}

+ +### 状态码说明 + +| | | +|:--:|:--:| +| **状态码** | **描述** | +| 2505 | 公司不存在 | +| 2686 | 含税标识错误 | +| 26960 | 明细中（单价、商品数量）和（不含税金额、含税金额、税额）不能同时为空 | +| 2696 | 明细中商品数量不能为空，且长度不能超过29位 | +| 2705 | 明细中折扣行必须紧挨被折扣行之后 | +| 26770 | 明细中序号不能为空 | +| 2680 | 发票行性质错误 | +| 2800 | 车辆类型必填 | +| 2801 | 车辆类型超长 | +| 2802 | 厂牌号必填 | +| 2803 | 厂牌号超长 | +| 2804 | 产地必填 | +| 2805 | 产地超长 | +| 2806 | 车架号必填 | +| 2807 | 车架号超长 | +| 2808 | 身份证号必填 | +| 2809 | 身份证号超长 | +| 2810 | 生产企业名称必填 | +| 2811 | 生产企业名称超长 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/新增_修改企业开票信息.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/新增_修改企业开票信息.md new file mode 100644 index 0000000..85cb4e9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/新增_修改企业开票信息.md @@ -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]://\[:\]/salescore/lan/seller/save.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 新增/修改企业开票信息 + +### 接口说明 + +创建/修改企业开票信息接口 + +### 接口地址 + +| | +|:---------------------------------------------------------------| +| http\[s\]://\\[:\\]/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个字符 + +### 请求示例 + + +++ + + + + + +

{

+

  "taxNum": "33333333333333333",

+

  "useScope": 1,

+

  "clerker": "13655554433",

+

  "sellerAddress": "地址",

+

  "sellerTel": "tel",

+

  "sellerAccount": "account",

+

  "sellerBank": "bank",

+

  "payee": "",

+

  "checker": "",

+

"projectCode": "test123",

+

  "departmentName": "测试部门"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/更新发票票据关联状态接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/更新发票票据关联状态接口.md new file mode 100644 index 0000000..fb6d05f --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/更新发票票据关联状态接口.md @@ -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]://\[:\]/salescore/lan/updateInvoiceAssociationStatus.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 更新发票票据关联状态接口 + +### 接口说明 + +更新发票票据关联状态接口。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/updateInvoiceAssociationStatus.do | + +### 请求参数(用json格式接收) + +| | | | | | | +|:---------------------:|:--------:|:--------:|:--------------:|:---:|:--------:| +| **名称** | **类型** | **必填** | **描述** | | **长度** | +| sellerTaxnum | String | 是 | 销方税号 | | 20 | +| uploadStatus | String | 是 | 工信部上传状态 | | 12 | +| **发票代码+发票号码** | | | | | | +| invoiceCode | String | 是 | 发票代码 | 12 | | +| invoiceNumber | String | 是 | 发票号码 | 8 | | + +### 请求示例 + + +++ + + + + + +

{

+

"invoiceAssociations": [

+

{

+

"invoiceCode": "1500020560",

+

"invoiceNumber": "87609473"

+

}

+

],

+

"sellerTaxnum": "150301199811285326",

+

"uploadStatus": "上传成功"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

    "code":200,

+

    "message":"成功",

+

    "data":  null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询可下载发票库存列表接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询可下载发票库存列表接口.md new file mode 100644 index 0000000..703e901 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询可下载发票库存列表接口.md @@ -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]://\[:\]/salescore/lan/stock/getDownloadableStock.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 查询可下载发票库存列表接口 + +### 接口说明 + +查询诺税通库中可下载发票库存列表 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/stock/getDownloadableStock.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 否 | 分机号，纯数字 | \- | +| machineNumber | String | 否 | 机器编号，12位数字 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 28,

+

"machineNumber": "661103844159",

+

"sellerTaxnum": "110101999999999618"

+

}

+ +### 返回参数 + +| | | | | | +|:------------------:|:----------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | | 更新时间 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"sellerTaxnum": "110101999999999618",

+

"extensionNum": 28,

+

"machineNumber": "661103844159",

+

"invoiceLine": "p",

+

"invoiceCode": "050002000208",

+

"num": 39899,

+

"singleBillingLimit": null,

+

"invoiceNumStart": "93666868",

+

"invoiceNumEnd": null,

+

"updatedTime": "2022-05-25 13:24:54"

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询成品油库存列表接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询成品油库存列表接口.md new file mode 100644 index 0000000..936d06c --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询成品油库存列表接口.md @@ -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]://\[:\]/salescore/lan/oilStock/getOilStockInfoList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 查询成品油库存列表接口 + +### 接口说明 + +查询诺税通库中成品油库存列表接口，包括税盘可使用的和局端可下载的。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/oilStock/getOilStockInfoList.do | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| extensionNum | Integer | 是 | 分机号，纯数字 | \- | +| machineNumber | String | 否 | 机器编号，12位数字 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | 是 | 更新时间 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

    "code":200,

+

    "message":"成功",

+

    "data":[

+

        {

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum": 0,

+

"machineNumber": "661565671900",

+

            "oilType":"汽油",

+

            "taxCode":"1070101010100000000",

+

            "downloadedStockAmount":"8366796.99",

+

            "downloadableStockAmount":"0.00",

+

            "updateTime":"2021-12-24 14:06:37"

+

        }

+

    ]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询授信额度数据.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询授信额度数据.md new file mode 100644 index 0000000..ae9343c --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询授信额度数据.md @@ -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]://\[:\]/salescore/lan/creditQuota/queryLocalData.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 查询授信额度数据 + +### 接口说明 + +获取数电发票授信额度,该接口根据不同设备类型，返回不同结果。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/creditQuota/queryLocalData.do | + +### 请求参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| taxNum | String | 是 | 需要查询的企业税号 | 企业税号 | 20 | +| type | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 请求类型 0:乐企 1:数电普通 | \- | +| extensionNum | Integer | 否 | 分机号与请求类型二选一必填，均传入已分机号匹配到的设备为准 | 分机号 | 0-99999 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"type": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | 否 | 分机信息不存在 | 查询失败原因 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": "200",

+

"message": "查询成功",

+

"data":{

+

"creditFlag": "Y",

+

"creditQuotaAmount": "10000.00" ,

+

"downloadAmount": "10000.00",

+

"downloadRemainAmount": "10000.00",

+

"remainAmount": "10000.00",

+

"taxnum": "150301199811285326",

+

"vestPeriod": "202303",

+

"creditUpdateTime": "2023-03-06 00:00:00"

+

}

+

}

+

非乐企:

+

{

+

"code": "200",

+

"message": "查询成功",

+

"data": {

+

"creditQuotaAmount": "10000.00",

+

"downloadAmount": "10000.00",

+

"queryStatus":1,

+

"creditUpdateTime": "2023-03-06 00:00:00",

+

"message": "分机信息不存在"

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询获取车架号是否可开票结果接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询获取车架号是否可开票结果接口.md new file mode 100644 index 0000000..bd3f582 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/查询获取车架号是否可开票结果接口.md @@ -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]://\[:\]/salescore/lan/query/queryVehicleCodeIsInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 查询获取车架号是否可开票结果接口 + +### 接口说明 + +获取车架号是否可开票结果接口。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/salescore/lan/query/queryVehicleCodeIsInvoice.do | + +### 请求参数(用json格式接收) + +| | | | | | +|:---------------:|:----------:|:--------:|:----------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| sellerTaxnum | String | 是 | 销方税号，15-20位 | 20 | +| vehicleCodeList | String\[\] | 是 | 车架号，支持最多2000个 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"vehicleCodeList": [

+

"111"

+

]

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"sellerTaxnum": "150301199811285326",

+

"companyCode": "1100",

+

"vehicleCode": "111",

+

"status": 2,

+

"certificate": "1",

+

"machineNum": "134874514782",

+

"importCertifyNum": "13242234",

+

"message": "未查询到合格证信息，不允许开具发票",

+

"requestSrc": "3",

+

"brandModel": "",

+

"engineNum": "",

+

"vehicleType": "",

+

"inspectionOddNum": "",

+

"productOrigin": ""

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/根据业务标识查询对应值列表接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/根据业务标识查询对应值列表接口.md new file mode 100644 index 0000000..f03c6c3 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/根据业务标识查询对应值列表接口.md @@ -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]://\[:\]/salescore/lan/oa/getOaOptionList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 根据业务标识查询对应值列表接口 + +### 接口说明 + +根据业务标识查询对应的值列表，给OA审批流使用 + +### 接口地址 + +| | +|:----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/oa/getOaOptionList.do | + +### 请求参数 + +| | | | | +|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | +| type | String | 是 | 业务类型：开票方式:requestSrc,发票种类:invoiceLine,组织名称:organize,部门名称:dept,开票员:clerk,作废来源：invalidSrc | +| name | String | 否 | 名称，根据名称模糊查询 | +| pageNum | int | 否 | 当前页，默认为1 | +| pageSize | int | 否 | 分页条数，默认为15 | + +### 请求示例 + + +++ + + + + + +

{

+

"pageNum": 1,

+

"pageSize": 15,

+

"type": "dept",

+

"name": "测试部门2"

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **更多限制** | **描述** | **最大长度** | +| 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时返回 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"total": "9",

+

"list": [

+

{

+

"key": "201127",

+

"name": "测试部门2-2",

+

"companyName": "移动测试盘326",

+

"companyId": "10162"

+

}

+

],

+

"pageNum": 1,

+

"pageSize": 2,

+

"pages": 5

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/登录扫码认证确认接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/登录扫码认证确认接口.md new file mode 100644 index 0000000..601ef96 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/登录扫码认证确认接口.md @@ -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]://\[:\]/salescore/lan/auth/authAffirm.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 登录扫码认证确认接口 + +### 接口说明 + +用于3.53获取登录扫码认证二维码（对应qrCodeType=1、2、3、4）后的二次确认登录操作 + +注意：电子税务局认证操作的数电账号（分机号） 和 登录二次确认操作的数电账号（分机号）必须为同一个 + +### 接口地址 + +| | +|:-------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/auth/authAffirm.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString是税号20
extensionNumInteger否分机号，分机号和数电账号任一必填-
accountString否数电账号，分机号和数电账号任一必填20
opTypeInteger否

操作类型：

+

0-扫码登录验证完成操作（默认）

+

1-查询扫码登录结果

+

2-短信登录提交登录（此时填写verifyCode）

+

3-查询短信登录结果

1
verifyCodeString否

短信验证码（当数电发票开具进行短信验

+

证码登录时才需要传）

10
+ +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326"，

+

"extensionNum": 1，

+

"account": "123456"，

+

"opType": 2，

+

"verifyCode": "1236"

+

}

+ +### 返回参数 + + ++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填示例值描述长度
codeInteger是200状态,200-成功，非200-失败6
messageString是成功详细信息1024
dataObject结果
statusString10-登录执行中；1-成功；2-失败
messageString登录成功结果信息（登录成功/失败原因）
loginTypeInteger

登录方式：

+
    +

  1. 扫码登录

    2. +

  2. 短信验证码登录

    3. +
taxNumString339901999999199税号
extensionNumInteger100分机号
accountString138****1234用户名/手机号（脱敏处理）
+ +### 返回示例 + +成功示例： + + +++ + + + + + +

{
+"code":200,
+"message": "成功"，

+

"data":

+

{

+

"account": "123456",

+

"taxNum": "1234567890",

+

"status": "1",

+

"message": "登录成功",

+

"loginType": 2,

+

"extensionNum": 123

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/票源下载接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/票源下载接口.md new file mode 100644 index 0000000..ac29db9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/票源下载接口.md @@ -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]://\[:\]/salescore/lan/stock/downInvoiceSource.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 票源下载接口 + +### 接口说明 + +票源下载接口 + +### 接口地址 + +| | +|----| +| http\[s\]://\\[:\\]/salescore/lan/stock/downInvoiceSource.do | + +### 请求参数 + +| | | | | | | +|:------------:|:--------:|:--------:|:--------------------------:|:--------:|:--------:| +| **名称** | **类型** | **必填** | **更多限制** | **描述** | **长度** | +| sellerTaxnum | String | 是 | | 销方税号 | 20 | +| extensionNum | String | 否 | 至少分机号或机器号任一必填 | 分机号 | 5 | +| machineNum | String | 否 | 至少分机号或机器号任一必填 | 机器号 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum":"0",

+

"machineNum":"661565671900",

+

"sellerTaxnum":"150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | + +### 返回示例 + +成功示例 + + +++ + + + + + +

{

+

    "code": 200,

+

    "message": "成功",

+

    "data": null

+

}

+ +失败示例 + + +++ + + + + + +

{

+

    "code": 27761,

+

    "message": "请传入分机号或机器编号",

+

    "data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/空白发票作废申请.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/空白发票作废申请.md new file mode 100644 index 0000000..0776788 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/空白发票作废申请.md @@ -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]://\[:\]/salescore/lan/blankInvoiceInvalid.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 空白发票作废申请 + +### 接口说明 + +空白发票作废申请接口 + +### 接口地址 + +| | +|:-----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum":" 1",

+

"machineNum":" 661929539468",

+

"invoiceLine": "c"

+

"invoiceCode":" 033001800105",

+

"invoiceNum":" 33111355",

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | String | | 查询成功则返回申请流水号 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": "123456789"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表_红字确认单回传.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表_红字确认单回传.md new file mode 100644 index 0000000..e17a028 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表_红字确认单回传.md @@ -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时，回传红字信息表结果。 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
backTypeInteger是回传类型, 1: 红字信息表 2：红字确认单2
billNoString是申请单号24
billTypeString否

信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回

+

4、矿产品类专用信息表（涉及销售数量和金额变更）

+

5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）

1
oriInvoiceCodeString否对应蓝票代码12
oriInvoiceNumberString否对应蓝票号码8
oriInvoiceTimeString否

对应蓝票开票日期

+

yyyy-MM-dd HH:mm:ss

19
taxTypeString否税种类别(0:营业税 1:增值税)1
taxRateString否税率：单税率就保存税率，如0.13；多税率M1
buyerNameString否购方名称100
buyerTaxnumString否购方税号20
buyerAddressString否购方地址100
buyerPhoneString否购方电话50
buyerBankString否购方银行100
buyerAccountString否购方账号30
sellerNameString否销方名称100
sellerTaxnumString否销方税号20
taxFreeAmountTotaldecimal否不含税金额15.2
taxTotaldecimal否合计税额15.2
billTimeString否

填开时间

+

yyyy-MM-dd HH:mm:ss

19
applyRemarkString否申请说明（购方已抵扣：1100000000,购方未抵扣：1010000000,销售方申请：0000000100）10
businessTaxCodeString否营业税标志10
billInfoNoString否信息表编号24
billStatusString否

信息表状态(-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销

+

-2:删除成功)

2
billMessageString否[信息表状态代码]信息表状态描述300
pdfUrlString否申请表pdf url255
detailListList是明细列表
specificFactorString否

特定要素：0普通发票 01成品油 03建筑服务 04货物运输发票 05不动产销售发票 06不动产租赁发票 09旅客运输发票 14机动车 16农产品收购 33二手车反向开具

+

35 矿产品发票

50
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **商品明细** 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，则回传红字确认单。 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
backTypeInteger是回传类型, 1: 红字信息表 2：红字确认单2
billIdString是申请单号32
billNoString否确认单编号32
billUuidString否确认单uuid32
billStatusString是

确认单状态

+

-1 提交失败

+

00 提交中

+

01 无需确认

+

02 销方录入待购方确认

+

03 购方录入待销方确认

+

04 购销双方已确认

+

05 作废（销方录入购方否认）

+

06 作废（购方录入销方否认）

+

07 作废（超72小时未确认）

+

08 作废（发起方撤销）

+

09 作废（确认方撤销）

+

15 提交税局中

+

16 提交税局失败

4
billMessageString否[确认单状态代码]确认单状态描述300
openStatusString否

开具状态

+

0：未开具

+

1：已开具

2
applySourceString是

申请来源

+

0 销方

+

1 购方

2
billTimeString否

填开时间

+

yyyy-MM-dd HH:mm:ss

19
taxFreeAmountTotaldecimal否不含税金额15.2
taxTotaldecimal否合计税额15.2
taxAmountTotaldecimal否含税金额15.2
blueInvoiceNumberString否对应蓝票号码20
blueInvoiceNoString否蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)8
blueInvoiceCodeString否蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)12
blueInvoiceLineString否

蓝票票种

+

bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)

+

p:电子增值税普通发票，

+

c:增值税普通发票(纸票)，

+

s:增值税专用发票，

+

b:增值税电子专用发票

5
sellerNameString否销方名称100
sellerTaxnumString否销方税号20
buyerNameString否购方名称100
buyerTaxnumString否购方税号20
vatUsageString否蓝字发票增值税用途2
saleTaxUsageString否蓝字发票消费税用途2
accountStatusString否发票入账状态2
redReasonString是

冲红原因

+

1开票有误

+

2销货退回

+

3服务中止

+

4销售折让

2
detailList否确认单明细
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **确认单明细** 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) | + +### 请求示例 + +成功示例： + + +++ + + + + + +

{

+

"billNo": "12345678901234567890097q",

+

"billType": "0",

+

"oriInvoiceCode": "005000181530",

+

"oriInvoiceNumber": "45625450",

+

"oriInvoiceTime": null,

+

"taxType": "1",

+

"taxRate": "0",

+

"buyerName": "officia in irure",

+

"buyerTaxnum": "CILLUM",

+

"sellerName": "Excepteur dolor ",

+

"sellerTaxnum": "150301199811285326",

+

"taxFreeAmountTotal": "-1.00",

+

"taxTotal": "-1.00",

+

"billTime": "2020-05-26 03:14:15",

+

"applyRemark": "0000000100",

+

"businessTaxCode": "0000000000",

+

"billInfoNo": "",

+

"billStatus": 2,

+

"billMessage": "[B900006]申请单号不能为空或者格式不正确",

+

"pdfUrl": "",

+

"detailList": [

+

{

+

"detailIndex": 1,

+

"goodsName": "Ut min",

+

"withTaxFlag": null,

+

"goodsPrice": "0.0000000000000000",

+

"taxFreePrice": "0.0900000000000000",

+

"goodsNum": "-1.0000000000000000",

+

"taxrate": "0.09",

+

"specType": "nost",

+

"goodsUnit": "aliqu",

+

"goodsCode": "esseonsequ",

+

"goodsCodeAbb": "irure in",

+

"favouredPolicyFlag": 0,

+

"zeroRateFlag": "",

+

"favouredPolicyName": "",

+

"selfCode": "sed Lorem",

+

"deduction": "0.00",

+

"taxAmount": "-0.01",

+

"taxFreeAmount": "-0.09",

+

"tax": "-0.01"

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | String | 是 | 0000 | | 状态码，字符串”0000”表示成功，非”0000”的字符串表示失败 | 6 | +| message | String | 是 | 同步成功 | | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": "0000",

+

"message": "业务方接收同步成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": "9999",

+

"message": "同步失败的异常信息"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表下载接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表下载接口.md new file mode 100644 index 0000000..017423c --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表下载接口.md @@ -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]://\[:\]/salescore/lan/red-apply-down` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字信息表下载接口 + +### 接口说明 + +销方可调用专用发票红字信息表下载接口下载购买方申请的红字信息表。仅触发下载指令，需配合红字信息表查询接口获取详细的信息表信息。 + +### 接口地址 + +| | +|:---------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/red-apply-down | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
invoiceLineString是发票种类2
billInfoNoString否信息表编号24
sellerTaxnumString是销方税号20
buyerTaxnumString否购方税号20
redApplyStartTimeString否红字申请时间-查询起期（yyyyMMdd），时间跨度不能超过30天8
redApplyEndTimeString否

红字申请时间-查询止期（yyyyMMdd）

+

时间跨度不能超过30天

8
userIdLong否开票人id-
extensionNumInteger否分机号-
machineNumberString否机器编号12
+ +注意： + +1.查询开始时间、结束时间允许同时为空，或者同时不为空 + +2.如果时间同时为空，则信息表编号必填 + +### 请求示例 + + +++ + + + + + +

{

+

"billInfoNo": "",

+

"sellerTaxnum": "150301199811285326",

+

"buyerTaxnum": "339901999999513",

+

"invoiceLine": "s",

+

"redApplyStartTime": "20201201",

+

"redApplyEndTime": "20201229",

+

"userId": 1,

+

"extensionNum": 0,

+

"machineNumber": "661565671900"

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表撤销接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表撤销接口.md new file mode 100644 index 0000000..c520c2d --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表撤销接口.md @@ -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]://\[:\]/salescore/lan/red-apply-cancel` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字信息表撤销接口 + +### 接口说明 + +专用发票红字信息表撤销申请接口。 + +### 接口地址 + +| | +|:-----------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/red-apply-cancel | + +### 请求参数 + +| | | | | | +|:-------------:|:--------:|:--------:|:----------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| billInfoNo | String | 是 | 信息表编号 | 24 | +| userId | Long | 否 | 开票人id | \- | +| extensionNum | Integer | 否 | 分机号 | \- | +| machineNumber | String | 否 | 机器编号 | 12 | + +### 请求示例 + + +++ + + + + + +

{

+

"billInfoNo": "1403011905003535",

+

"userId": 1,

+

"extensionNum": 0,

+

"machineNumber": "661565671900"

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表查询接口.md new file mode 100644 index 0000000..dbf7022 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表查询接口.md @@ -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]://\[:\]/salescore/lan/red-apply-query` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字信息表查询接口 + +### 接口说明 + +专用发票红字信息表查询接口。 + +### 接口地址 + +| | +|:----------------------------------------------------------------| +| http\[s\]://\\[:\\]/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天。 + +### 请求示例 + + +++ + + + + + +

{

+

"billInfoNo": "",

+

"billNo": "",

+

"buyerTaxnum": "339901999999513",

+

"redApplyEndTime": "2020-12-29 23:00:00",

+

"redApplyStartTime": "2020-11-01 00:00:00",

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
codeInteger是状态,200-成功，非200-失败6
messageString是详细信息1024
dataList查询成功则返回红字申请信息
发票信息
billNoString否信息表流水号(12位税盘编号+12位蓝票开票时间YYMMDDHHMMSS)24
billTypeString否

信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回

+

4、矿产品类专用信息表（涉及销售数量和金额变更）

+

5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）

1
oriInvoiceCodeString否对应蓝票代码12
oriInvoiceNumberString否对应蓝票号码8
oriInvoiceTimeString否

对应蓝票开票日期

+

yyyy-MM-dd HH:mm:ss

19
taxTypeString否税种类别(0:营业税 1:增值税)1
taxRateString否多税率标志(0:一票一税率 1:一票多税率)1
buyerNameString否购方名称100
buyerTaxnumString否购方税号20
buyerAddressString否购方地址100
buyerPhoneString否购方电话50
buyerBankString否购方银行100
buyerAccountString否购方账号30
sellerNameString否销方名称100
sellerTaxnumString否销方税号20
taxFreeAmountTotaldecimal否不含税金额15.2
taxTotaldecimal否合计税额15.2
billTimeString否

填开时间

+

yyyy-MM-dd HH:mm:ss

19
applyRemarkString否申请说明（购方已抵扣：1100000000,购方未抵扣：1010000000,销售方申请：0000000100）10
businessTaxCodeString否营业税标志10
billInfoNoString否信息表编号24
billStatusString否信息表状态(-1:未提交 0:申请中 1:审核成功 2:审核失败 3:申请成功 4:申请失败 5:已开具 6:撤销中 7:撤销失败 8:已撤销)2
billMessageString否[信息表状态代码]信息表状态描述300
pdfUrlString否申请表pdf url255
specificFactorString否

特定要素特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票

+

注：开具矿产品发票时必传，此时billType只能为4或5

50
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **商品明细** 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) | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"billNo": "12345678901234567890097q",

+

"billType": "0",

+

"oriInvoiceCode": "005000181530",

+

"oriInvoiceNumber": "45625450",

+

"oriInvoiceTime": null,

+

"taxType": "1",

+

"taxRate": "0",

+

"buyerName": "officia in irure",

+

"buyerTaxnum": "CILLUM",

+

"sellerName": "Excepteur dolor ",

+

"sellerTaxnum": "150301199811285326",

+

"taxFreeAmountTotal": "-1.00",

+

"taxTotal": "-1.00",

+

"billTime": "2020-05-26 03:14:15",

+

"applyRemark": "0000000100",

+

"businessTaxCode": "0000000000",

+

"billInfoNo": "",

+

"billStatus": 2,

+

"billMessage": "[B900006]申请单号不能为空或者格式不正确",

+

"pdfUrl": "",

+

"detailList": [

+

{

+

"id": "178",

+

"billNo": "12345678901234567890097q",

+

"detailIndex": 1,

+

"goodsName": "Ut min",

+

"withTaxFlag": null,

+

"goodsPrice": "0.0000000000000000",

+

"taxFreePrice": "0.0900000000000000",

+

"goodsNum": "-1.0000000000000000",

+

"taxrate": "0.09",

+

"specType": "nost",

+

"goodsUnit": "aliqu",

+

"goodsCode": "esseonsequ",

+

"goodsCodeAbb": "irure in",

+

"favouredPolicyFlag": 0,

+

"zeroRateFlag": "",

+

"favouredPolicyName": "",

+

"selfCode": "sed Lorem",

+

"deduction": "0.00",

+

"taxAmount": "-0.01",

+

"taxFreeAmount": "-0.09",

+

"tax": "-0.01",

+

"createTime": "2020-06-04 11:13:00",

+

"updateTime": "2020-06-04 11:13:00"

+

}

+

]

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_不支持拆分_不推荐使用.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_不支持拆分_不推荐使用.md new file mode 100644 index 0000000..0b6c08d --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_不支持拆分_不推荐使用.md @@ -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]://\[:\]/salescore/lan/red-apply-submit` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字信息表申请接口（不支持拆分，不推荐使用） + +### 接口说明 + +针对专用发票进行红字信息表申请接口，不支持机动车专票按退货方式（信息表类型为2时）申请红字信息表时，自动拆分成8行一个信息表。 + +### 接口地址 + +| | +|:-----------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/red-apply-submit | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
invoiceLineString是发票种类2
billNoString否24位申请单号（12位开票设备编号+12位流水）24
billTypeString否

信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更）

+

5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）

+

默认为：0正常

+

注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单）

+

若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填。

2
oriInvoiceCodeString否对应蓝票代码12
oriInvoiceNumberString否对应蓝票号码8
oriInvoiceTimeString否

蓝票填开时间（yyyy-MM-dd HH:mm:ss）

+

除了购方已抵扣，若没有对应的蓝票信息，oriInvoiceTime需必填

19
blueInvoiceTimeString否

蓝票填开时间（YYYYMM）

+

除了购方已抵扣，若没有对应的蓝票信息，blueInvoiceTime需必填，新局端要求上传对应蓝字发票开具时间（年月）

19
sellerNameString是销方名称100
sellerTaxnumString是销方税号20
buyerNameString是购方名称100
buyerTaxnumString是购方税号20
buyerAddressString否购方地址100
buyerPhoneString否购方电话50
buyerBankString否购方银行100
buyerAccountString否购方账号30
operatorString否经办人20
applyRemarkString是

申请说明

+

(购方已抵扣：1100000000 购方未KJ抵扣：1010000000 销售方申请：0000000100)

10
productOilFlagString否

成品油标识 0,非成品油;1,成品油

+

若没有对应的蓝票信息，productOilFlag必填

1
extensionNumberString否分机号11
terminalNumberString否终端号11
machineNumberString否机器号12
deptIdString否部门门店id（本地系统中的id）20
userIdString否开票人id（本地系统中的id）20
bizCallbackUrlString否业务系统回调地址255
detailListList是商品明细无
specificFactorString否

特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票

+

注：开具矿产品发票时必传，此时billType只能为4或5，成品油发票特定要素和成品油标识选一即可，均传以特定要素为准。

50
notifyPhoneString否交付手机号码20
notifyEmailString否交付邮箱地址50
ccPhoneString否抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个100
ccEmailString否抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个250
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **商品明细** 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) | + +### 请求示例 + + +++ + + + + + +

{

+

"invoiceLine": "s",

+

"billNo": "",

+

"billType": "0",

+

"oriInvoiceCode": "5000201530",

+

"oriInvoiceNumber": "67523624",

+

"oriInvoiceTime": "2020-11-12 00:00:00",

+

"sellerName": "移动测试盘326",

+

"sellerTaxnum": "150301199811285326",

+

"buyerName": "326专26",

+

"buyerTaxnum": "339901999999513",

+

"operator": "超级管理员",

+

"applyRemark": "0000000100",

+

"productOilFlag": 0,

+

"extensionNumber": "",

+

"terminalNumber": "",

+

"departmentId": "",

+

"userId": "",

+

"detailList": [

+

{

+

"deduction": 0.0,

+

"detailIndex": 1,

+

"favouredPolicyFlag": 1,

+

"favouredPolicyName": "即征即退",

+

"goodsCode": "商品编码",

+

"goodsCodeAbb": "商品编码简称",

+

"goodsName": "商品名称",

+

"goodsNum": -1,

+

"goodsPrice": 1,

+

"goodsUnit": "元",

+

"selfCode": "企业自行编码",

+

"specType": "规格型号",

+

"tax": -0.03,

+

"taxAmount": -1.03,

+

"taxFreeAmount": -1,

+

"taxFreePrice": 1,

+

"taxrate": "0.03",

+

"withTaxFlag": 0,

+

"zeroRateFlag": "1"

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 查询成功 | 详细信息 | 1024 | +| data | String | 否 | "661545615505210618135603" | 提交成功则返回billNo申请编号 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message":"成功",

+

"data": "661545615505210618135603"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":"400",

+

"message":"参数校验失败"

+

}

+ +### 状态码说明 + +| | | +|:-----------|:-------------| +| **状态码** | **描述** | +| 200 | 查询成功 | +| 400 | 参数校验失败 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_支持拆分.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_支持拆分.md new file mode 100644 index 0000000..4fe0ff4 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字信息表申请接口_支持拆分.md @@ -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]://\[:\]/salescore/lan/red-apply-submit-split` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字信息表申请接口（支持拆分） + +### 接口说明 + +专用发票红字信息表申请接口，支持机动车专票按退货方式（信息表类型为2时）申请红字信息表时自动拆分成8行一个信息表。 + +### 接口地址 + +| | +|:-----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/red-apply-submit-split | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
invoiceLineString是发票种类2
billNoString否24位申请单号（12位开票设备编号+12位蓝票开票时间YYMMDDHHMMSS）24
billTypeString否

信息表类型(0:正常 1:逾期(仅销方开具)，2:机动车专票-退货和开具错误，3:机动车专票-销售折让和合格证不退回)，4、矿产品类专用信息表（涉及销售数量和金额变更）

+

5、矿产品类专用信息表（仅涉及销售金额变更，不涉及数量变动）

+

默认为：0正常

+

注：信息表类型为2：退货时，信息表展示蓝票所有明细行，每次提交信息表开具时，不允许超过8行，且不转换成固定一行明细（详见正数发票及清单）

+

若根据蓝票代码号码匹配不到对应的蓝票机动车标识，billType需必填。

2
oriInvoiceCodeString否对应蓝票代码12
oriInvoiceNumberString否对应蓝票号码8
blueInvoiceTimeString否

蓝票填开时间（YYYYMM）

+

除了购方已抵扣，若没有对应的蓝票信息，blueInvoiceTime需必填，新局端要求上传对应蓝字发票开具时间（年月）

19
sellerNameString是销方名称100
sellerTaxnumString是销方税号20
buyerNameString是购方名称100
buyerTaxnumString是购方税号20
buyerAddressString否购方地址100
buyerPhoneString否购方电话50
buyerBankString否购方银行100
buyerAccountString否购方账号30
operatorString否经办人20
applyRemarkString是

申请说明

+

(购方已抵扣：1100000000 ，购方未抵扣：1010000000， 销售方申请：0000000100)

10
productOilFlagString否

成品油标识 0,非成品油;1,成品油

+

若没有对应的蓝票信息，productOilFlag必填

1
extensionNumberString否分机号11
terminalNumberString否终端号11
machineNumberString否机器编号12
deptIdString否部门门店id（本地系统中的id）20
userIdString否开票人id（本地系统中的id）20
bizCallbackUrlString否业务系统回调地址255
detailListList是商品明细无
specificFactorString否

特定要素：0普通发票（默认）01成品油 14机动车 31建安发票 32房地产销售发票 34电子烟发票、35矿产品发票

+

注：开具矿产品发票时必传，此时billType只能为4或5，成品油发票特定要素和成品油标识选一即可，均传以特定要素为准。

50
notifyPhoneString否交付手机号码20
notifyEmailString否交付邮箱地址50
ccPhoneString否抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个100
ccEmailString否抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个250
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **商品明细** 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) | + +### 请求示例 + + +++ + + + + + +

{

+

"invoiceLine": "s",

+

"billNo": "",

+

"billType": "0",

+

"oriInvoiceCode": "5000201530",

+

"oriInvoiceNumber": "67523624",

+

"oriInvoiceTime": "2020-11-12 00:00:00",

+

"sellerName": "移动测试盘326",

+

"sellerTaxnum": "150301199811285326",

+

"buyerName": "326专26",

+

"buyerTaxnum": "339901999999513",

+

"operator": "超级管理员",

+

"applyRemark": "0000000100",

+

"productOilFlag": 0,

+

"extensionNumber": "",

+

"terminalNumber": "",

+

"departmentId": "",

+

"userId": "",

+

"detailList": [

+

{

+

"deduction": 0.0,

+

"detailIndex": 1,

+

"favouredPolicyFlag": 1,

+

"favouredPolicyName": "即征即退",

+

"goodsCode": "商品编码",

+

"goodsCodeAbb": "商品编码简称",

+

"goodsName": "商品名称",

+

"goodsNum": -1,

+

"goodsPrice": 1.03,

+

"goodsUnit": "元",

+

"selfCode": "企业自行编码",

+

"specType": "规格型号",

+

"tax": -0.03,

+

"taxAmount": -1.03,

+

"taxFreeAmount": -1,

+

"taxFreePrice": 1,

+

"taxrate": "0.03",

+

"withTaxFlag": 0,

+

"zeroRateFlag": "1"

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 查询成功 | 详细信息 | 1024 | +| data | String | 否 | "661545615505210618135603,661545615505210618135604" | 提交成功则返回billNo申请编号，多个以英文逗号分隔 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message":"成功",

+

"data": "661545615505210618135603,661545615505210618135604"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":"400",

+

"message":"参数校验失败"

+

}

+ +### 状态码说明 + +| | | +|:-----------|:-------------| +| **状态码** | **描述** | +| 200 | 查询成功 | +| 400 | 参数校验失败 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单下载接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单下载接口.md new file mode 100644 index 0000000..dc5d097 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单下载接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/download.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字确认单下载接口 + +### 接口说明 + +数电发票红字确认单下载接口。 + +### 接口地址 + +| | +|:-----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/download.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString是税号20
identityInteger是

购销身份：

+

0：我是销售方

+

1：我是购买方

2
billUuidString否红字确认单uuid32
billStatusString否

购销身份为1：我是购买方时，必填

+

确认单状态，0.待确认 1.已确认 2.已过期 3.销方否认 4.已撤销

4
startTimeString否填开起始时间（确认单billuuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd）-
endTimeString否填开结束时间(确认单编号有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd)-
extensionNumInteger否分机号-
departmentIdLong否部门门店id（诺税通中的部门id）20
userIdLong否开票人id（诺税通中的用户id）20
+ +注意： + +1、有红字确认单uuid时，走精确查询；（查询的税号需要符合红字确认单中的销方或购方） + +2、无红字确认单uuid时，必须传购销身份及确认单填开的起始结束时间 + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"identity": 0,

+

"billUuid": "1fdsafda350301132998",

+

"startTime": "2020-11-12",

+

"endTime": "2020-11-14",

+

"extensionNum": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单撤销接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单撤销接口.md new file mode 100644 index 0000000..ec91185 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单撤销接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/cancel.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字确认单撤销接口 + +### 接口说明 + +数电发票红字确认单撤销接口。 + +### 接口地址 + +| | +|:---------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/cancel.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString否税号（和组织编码任一必填）20
companyCodeString否组织编码-
identityInteger是

撤销方身份：

+

0：销方

+

1：购方

2
billUuidString否红字确认单uuid32
billIdString否红字确认单申请单号32
billNoString否红字确认单编号32
extensionNumInteger否分机号-
departmentIdLong否部门门店id（诺税通中的部门id）20
userIdLong否开票人id（诺税通中的用户id）20
+ +注： + +3. 有红字确认单申请号、红字确认单编号、红字确认单uuid任一必传 + +4. 税号和企业编码任一必填，可通过企业编码转换为税号 + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"companyCode": "1234324231",

+

"identity": 0,

+

"billUuid": "1fdsafda350301132998",

+

"extensionNum": 1，

+

"userId": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单查询接口.md new file mode 100644 index 0000000..d82a828 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单查询接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/query.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字确认单查询接口 + +### 接口说明 + +数电发票红字确认单查询接口。 + +### 接口地址 + +| | +|:--------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/query.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString是税号20
applySourceInteger是

申请方身份：

+

0 销方

+

1 购方

2
billStatusString否

红字确认单状态：

+

01 无需确认

+

02 销方录入待购方确认

+

03 购方录入待销方确认

+

04 购销双方已确认

+

05 作废（销方录入购方否认）

+

06 作废（购方录入销方否认）

+

07 作废（超72小时未确认）

+

08 作废（发起方撤销）

+

09 作废（确认方撤销）

4
billIdString否红字确认单申请单号32
billNoString否红字确认单编号32
billUuidString否红字确认单uuid32
startTimeString否填开起始时间（确认单申请号/编号/uuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd）-
endTimeString否填开结束时间(确认单申请号/编号/uuid有值时，可为空，允许最大查询范围为90天 yyyy-MM-dd)-
+ +注： + +1、有红字确认单申请号、红字确认单编号、红字确认单uuid时（一个或多个时），走精确查询；（查询的税号需要符合红字确认单中的销方或购方） + +2、无红字确认单申请号、红字确认单编号、红字确认单uuid时，必须传申请方身份及确认单填开的起始结束时间 + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"applySource": 1,

+

"billStatus": "01",

+

"billId": "342234232432432423",

+

"billNo": "32432f342df324sewerwe",

+

"billUuid": "3423423dgv324234dfg43r34g43",

+

"startTime": "2022-06-22",

+

"endTime": "2022-06-23"

+

}

+ +### 返回参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
codeInteger是状态,200-成功，非200-失败6
messageString是详细信息1024
dataList查询成功则返回红字确认单信息
发票信息
billIdString是申请单号32
billNoString否确认单编号32
billUuidString否确认单uuid32
billStatusString是

确认单状态

+

-1 提交失败

+

00 提交中

+

01 无需确认

+

02 销方录入待购方确认

+

03 购方录入待销方确认

+

04 购销双方已确认

+

05 作废（销方录入购方否认）

+

06 作废（购方录入销方否认）

+

07 作废（超72小时未确认）

+

08 作废（发起方撤销）

+

09 作废（确认方撤销）

+

15 提交税局中

+

16 提交税局失败

4
billMessageString否[确认单状态代码]确认单状态描述300
openStatusString否

开具状态

+

0：未开具

+

1：已开具

2
applySourceString是

申请来源

+

0 销方

+

1 购方

2
billTimeString否

填开时间

+

yyyy-MM-dd HH:mm:ss

19
taxFreeAmountTotaldecimal否不含税金额15.2
taxTotaldecimal否合计税额15.2
taxAmountTotaldecimal否含税金额15.2
blueInvoiceNumberString否对应蓝票数电号码20
blueInvoiceNoString否蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)8
blueInvoiceCodeString否蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)12
blueInvoiceLineString否

蓝票票种

+

bs:数电专票(电子),pc:数电普票(电子)，es:数电专票(纸质)；ec:数电普票(纸质)

+

p:电子增值税普通发票，

+

c:增值税普通发票(纸票)，

+

s:增值税专用发票，

+

b:增值税电子专用发票

5
sellerNameString否销方名称100
sellerTaxnumString否销方税号20
buyerNameString否购方名称100
buyerTaxnumString否购方税号20
vatUsageString否蓝字发票增值税用途2
saleTaxUsageString否蓝字发票消费税用途2
accountStatusString否发票入账状态2
redReasonString是

冲红原因

+

1开票有误

+

2销货退回

+

3服务中止

+

4销售折让

2
detailList否确认单明细
+ +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **确认单明细** 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) | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [

+

{

+

"billId": "12345678901234567890097q",

+

"billNo": "12345678901234567890097q",

+

"billUuid": "sdfcvs3g3554y5y4y54y55445t54",

+

"billStatus": "01",

+

"billMessage": "[B900006]申请单号不能为空或者格式不正确",

+

"openStatus": 1,

+

"applySource": 1,

+

"billTime": "2020-05-26 03:14:15",

+

"taxFreeAmountTotal": "-1.00",

+

"taxTotal": "-1.00",

+

"taxAmountTotal": "-1.00",

+

"blueInvoiceNumber": "45625450",

+

"blueInvoiceTime": null,

+

"blueInvoiceLine": "bs",

+

"sellerName": "Excepteur dolor ",

+

"sellerTaxnum": "150301199811285326",

+

"buyerName": "officia in irure",

+

"buyerTaxnum": "150301199811285326",

+

"vatUsage": "2",

+

"saleTaxUsage": "1",

+

"accountStatus": "1",

+

"redReason": "1",

+

"detailList": [

+

{

+

"billId": "12345678901234567890097q",

+

"detailIndex": 1,

+

"blueDetailIndex": 2,

+

"goodsName": "Ut min",

+

"withTaxFlag": 0,

+

"goodsPrice": "0.0000000000000000",

+

"taxFreePrice": "0.0900000000000000",

+

"goodsNum": "-1.0000000000000000",

+

"taxrate": "0.09",

+

"specType": "nost",

+

"goodsUnit": "aliqu",

+

"goodsCode": "esseonsequ",

+

"goodsCodeAbb": "irure in",

+

"favouredPolicyFlag": 0,

+

"zeroRateFlag": "",

+

"favouredPolicyName": "",

+

"selfCode": "sed Lorem",

+

"deduction": "0.00",

+

"taxAmount": "-0.01",

+

"taxFreeAmount": "-0.09",

+

"tax": "-0.01"

+

}

+

]

+

}

+

]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单申请接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单申请接口.md new file mode 100644 index 0000000..34ca3f8 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单申请接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/apply.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字确认单申请接口 + +### 接口说明 + +数电发票红字确认单申请接口。 + +注：对数电蓝票进行部分冲红确认单申请时，明细中蓝票序号对应冲红蓝票的明细序号，在开具蓝票时，需保证蓝票的序号为从1开始的连续数字。 + +开具蓝票为增值税发票(只支持专票、普票)的红字确认单，暂只支持乐企开票模式。 + +### 接口地址 + +| | +|:--------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/apply.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
billIdString否红字确认单申请单号（需要保持唯一，不传的话系统自动生成一个）32
applySourceInteger是

申请方身份：

+

0 销方

+

1 购方

2
taxNumString否税号(税号、组织编码其一必填)20
companyCodeString否组织编码(税号、组织编码其一必填)20
billTimeString否

填开时间

+

默认当前时间

+

yyyy-MM-dd HH:mm:ss

-
blueInvoiceNumberString否对应蓝票数电号码（数电普票、数电专票都需要，蓝票为数电票必填）20
blueInvoiceNoString否蓝字增值税发票号码(如果蓝票为增值税发票，则增值税代号码必填)8
blueInvoiceCodeString否蓝字增值税发票代码(如果蓝票为增值税发票，则增值税代号码必填)12
blueInvoiceLineString否

蓝票未在系统时，需要必填

+

蓝票数电发票种类:

+

bs:数电专票(电子),

+

pc:数电普票(电子)，

+

es:数电专票(纸质)；

+

ec:数电普票(纸质)，

+

p:电子增值税普通发票，

+

c:增值税普通发票(纸票)，

+

s:增值税专用发票，

+

b:增值税电子专用发票

5
sellerNameString否销方名称100
sellerTaxnumString否销方税号20
buyerNameString否购方名称100
buyerTaxnumString否购方税号20
vatUsageString否蓝字发票增值税用途（预留字段可为空）2
saleTaxUsageString否蓝字发票消费税用途（预留字段可为空）2
accountStatusString否发票入账状态（预留字段可为空）2
redReasonString是

冲红原因：

+

1销货退回

+

2开票有误

+

3服务中止

+

4销售折让

2
bizCallbackUrlString否业务系统回调地址255
extensionNumInteger否分机号11
departmentIdLong否部门门店id（诺税通中的部门id）20
userIdLong否开票人id（诺税通中的用户id）20
notifyPhoneString否交付手机号码20
notifyEmailString否交付邮箱地址50
ccPhoneString否抄送手机号，当推送手机notifyPhone有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个100
ccEmailString否抄送邮箱，当推送邮箱notifyEmail有值时，才允许填写，多个中间用英文逗号隔开，最多可填写5个250
+ + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
确认单明细 details
名称类型必填描述长度
blueDetailIndexInteger是对应数电蓝票的明细序号5
goodsNameString是商品名称90
goodsUnitString否单位22
specTypeString否规格型号40
withTaxFlagint是单价含税标志，0:不含税,1:含税1
goodsPricedecimal否含税单价decimal(32,16)
taxFreePricedecimal否不含税单价decimal(32,16)
goodsNumdecimal否数量（传负数）decimal(32,16)
taxFreeAmountdecimal是不含税金额（传负数）(15,2)
taxdecimal是税额（传负数）(15,2)
taxAmountdecimal是含税金额（传负数）(15,2)
taxrateString是税率10
goodsCodeString否税收分类编码19
goodsCodeAbbString否税收分类编码简称200
selfCodeString否自行编码20
favouredPolicyFlagString否

优惠政策标识

+

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%即征即退

10
favouredPolicyNameString否优惠政策内容，如：即征即退、免税、不征税、简易征收等50
zeroRateFlagString否零税率标识，空:非零税率;1:免税;2:不征税;3:普通零税率2
deductiondecimal否扣除额：传空或字段不传，都表示非差额征税；传0.00才表示差额征税:0.00(15,2)
+ +注： + +1\. 确认单明细不填时，进行全额冲红申请，填写明细信息，为部分冲红申请。 + +### 请求示例 + + +++ + + + + + +

{

+

"billId": "661545615505210618135603",

+

"applySource": 1,

+

"billTime": "2020-11-12 00:00:00",

+

"blueInvoiceNumber": "5000201530",

+

"blueInvoiceLine": "bs",

+

"sellerName": "移动测试盘326",

+

"sellerTaxnum": "150301199811285326",

+

"buyerName": "326专26",

+

"buyerTaxnum": "339901999999513",

+

"vatUsage": "1",

+

"saleTaxUsage": "2",

+

"accountStatus": "1",

+

"redReason": "1",

+

"extensionNum": "0",

+

"departmentId": 123,

+

"userId": 1,

+

"details": [

+

{

+

"blueDetailIndex": 2,

+

"favouredPolicyName": "",

+

"goodsCode": "1070304080000000000",

+

"goodsCodeAbb": "中成药",

+

"goodsName": "胶囊",

+

"goodsNum": -1,

+

"goodsPrice": 13.56,

+

"goodsUnit": "盒",

+

"specType": "中成药胶囊1",

+

"tax": -1.56,

+

"taxAmount": -13.56,

+

"taxFreeAmount": -12.00,

+

"taxFreePrice": 12,

+

"taxrate": "0.13",

+

"withTaxFlag": 1,

+

"zeroRateFlag": ""

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 查询成功 | 详细信息 | 1024 | +| data | String | 否 | "661545615505210618135603" | 提交成功则返回billId申请编号 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message":"成功",

+

"data": "661545615505210618135603"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code":"400",

+

"message":"参数校验失败"

+

}

+ +### 状态码说明 + +| | | +|:-----------|:-------------| +| **状态码** | **描述** | +| 200 | 查询成功 | +| 400 | 参数校验失败 | diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单确认接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单确认接口.md new file mode 100644 index 0000000..b40bd94 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/红字确认单确认接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/confirm.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 红字确认单确认接口 + +### 接口说明 + +数电发票红字确认单确认接口。 + +### 接口地址 + +| | +|:----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/confirm.do | + +### 请求参数 + + +++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
名称类型必填描述长度
taxNumString否税号（和组织编码任一必填）20
companyCodeString否组织编码-
identityInteger是

确认方身份：

+

0：销方

+

1：购方

2
billUuidString否红字确认单uuid32
billIdString否红字确认单申请单号32
billNoString否红字确认单编号32
confirmAgreementInteger是处理意见 0拒绝 1同意2
confirmReasonString否处理理由200
extensionNumInteger否分机号-
departmentIdLong否部门门店id（诺税通中的部门id）20
userIdLong否开票人id（诺税通中的用户id）20
+ +注： + +1. 有红字确认单申请号、红字确认单编号、红字确认单uuid任一必传 + +2. 税号和企业编码任一必填，可通过企业编码转换为税号 + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326",

+

"companyCode": "1234324231",

+

"identity": 0,

+

"billUuid": "1fdsafda350301132998",

+

"confirmAgreement": 0,

+

"confirmReason": "通过",

+

"extensionNum": 1，

+

"userId": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--------:|:--------:|:--------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| code | Integer | 是 | 200 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 成功 | 详细信息 | 1024 | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/自定义票源下载接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/自定义票源下载接口.md new file mode 100644 index 0000000..a3f4760 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/自定义票源下载接口.md @@ -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]://\[:\]/salescore/lan/stock/downloadStockCustomize.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 自定义票源下载接口 + +### 接口说明 + +仅支持开票服务器类型为诺诺机柜、诺诺开票。下载成功之后客户端会重新上报可下载库存，之后可以调用查询接口刷新列表数据。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/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 | 是 | 想要下载的份数，**需要小于等于可下载数量** | | + +### 请求示例 + + +++ + + + + + +

{

+

"extensionNum":0,

+

"machineNumber":"661565671900",

+

"sellerTaxnum":"150301199811285326",

+

"downloadableStockList":[

+

{

+

"invoiceCode":"5000201530",

+

"invoiceLine":"p",

+

"invoiceNumStart":"93669589",

+

"downloadNum":10

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | Object | | | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": null

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": 900,

+

"message": "下载份数要小于等于发票份数",

+

"data": null

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取DAT加密包文件流接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取DAT加密包文件流接口.md new file mode 100644 index 0000000..4a765e9 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取DAT加密包文件流接口.md @@ -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]://\[:\]/salescore/lan/getEncryptedStream.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取DAT加密包文件流接口 + +### 接口说明 + +获取加密包文件流接口，最多支持获取500张发票的加密包。 + +### 接口地址 + +| | +|:----------------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/getEncryptedStream.do | + +### 请求参数(用json格式接收) + +| | | | | | | +|:---------------------:|:--------:|:--------:|:--------:|:---:|:--------:| +| **名称** | **类型** | **必填** | **描述** | | **长度** | +| sellerTaxnum | String | 是 | 销方税号 | | 20 | +| **发票代码+发票号码** | | | | | | +| invoiceCode | String | 是 | 发票代码 | 12 | | +| invoiceNumber | String | 是 | 发票号码 | 8 | | + +### 请求示例 + + +++ + + + + + +

{

+

"invoiceAssociations": [

+

{

+

"invoiceCode": "1500020560",

+

"invoiceNumber": "87609473"

+

}

+

],

+

"sellerTaxnum": "150301199811285326"

+

}

+ +### 返回参数 + +| | | | | | +|:--------:|:--------:|:--------:|:-------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| code | Integer | 是 | 状态,200-成功，非200-失败 | 6 | +| message | String | 是 | 详细信息 | 1024 | +| data | String | | 返回base64加密的文件内容 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"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=="

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取下一张发票号码代码接口_A9机柜.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取下一张发票号码代码接口_A9机柜.md new file mode 100644 index 0000000..b4a176f --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取下一张发票号码代码接口_A9机柜.md @@ -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]://\[:\]/salescore/lan/getNextInvoice.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取下一张发票号码代码接口（A9+机柜） + +### 接口说明 + +获取下一张发票号码代码，全本地（A9+机柜），半本地（机柜） + +### 接口地址 + +| | +|:------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum":" 1",

+

"machineNum":" 661929539468",

+

"invoiceLine": "c"

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | 否 | 剩余发票份数 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": [{

+

"invoiceLine": "c",

+

"nextInvoiceCode": "150010020011",

+

"nextInvoiceNum": "23499027",

+

"remainNum": 487

+

},{

+

"invoiceLine": "c",

+

"nextInvoiceCode": "150010020011",

+

"nextInvoiceNum": "23499028",

+

"remainNum": 486

+

}]

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取关联发票接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取关联发票接口.md new file mode 100644 index 0000000..7fa0e32 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取关联发票接口.md @@ -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]://\[:\]/salescore/lan/queryInvoiceAsscciationList.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取关联发票接口 + +### 接口说明 + +获取关联发票接口。 + +### 接口地址 + +| | +|:---| +| http\[s\]://\\[:\\]/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条 | | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"dateType": 0,

+

"startDate": "2021-09-20 10:00:00",

+

"endDate": "2021-09-21 10:00:00",

+

"certificateOwnership": "三厂",

+

"uploadStatus": "上传成功",

+

"buyerName": "浙江师范大学",

+

"invoiceLines": [

+

"p"

+

],

+

"productNatures": [

+

0

+

],

+

pageNum:1

+

}

+ +### 返回参数 + +| | | | | | +|:----------------:|:----------:|:--------:|:--------------------------:|:--------:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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\[\] | 是 | 规格型号列表 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"data": {

+

"pageNum": 1,

+

"pageSize": 20,

+

"pages": 1,

+

"total": 1,

+

"list": [

+

{

+

"buyerName": "浙江师范大学",

+

"buyerTaxnum": "339901999999142",

+

"invoiceCode": "1500020560",

+

"invoiceNumber": "87609471",

+

"specTypes": [

+

"得力0231"

+

]

+

}

+

]

+

},

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取发票勾选入账状态接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取发票勾选入账状态接口.md new file mode 100644 index 0000000..923729b --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取发票勾选入账状态接口.md @@ -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]://\[:\]/salescore/lan/redConfirm/queryFpgxStatus.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取发票勾选入账状态接口 + +### 接口说明 + +销方通过接口查询到蓝票的勾选入账状态,接口异步 + +核心逻辑： 先进行operateType=1进行数据从数据初始化查询，间隔一会儿之后再进行operateType=0进行查询数据的获取 + +限制条件： + +1. operateType=1请求30s一次 + +2. 税号+数电账号，每天最多20次 + +### 接口地址 + +| | +|----| +| http\[s\]://\\[:\\]/salescore/lan/redConfirm/queryFpgxStatus.do | + +### 请求参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **说明** | **描述** | **长度** | +| saleTaxNum | String | 是 | 销方税号 | 销售发票的纳税人识别号或统一社会信用代码 | 15-20 | +| elecInvoiceNumber | String | 否 | 蓝字数电票号码 | 数电号码、蓝票号码代码必须选择其一 | 20 | +| invoiceCode | Stirng | 否 | 蓝票发票代码 | | | +| invoiceNumber | String | 否 | 蓝票发票号码 | | | +| operateType | Integer | 是 | 操作类型 | 操作类型，0-查询，1-税局获取 | 1 | +| extensionNum | String | 否 | 分机号 | | | + +### 请求示例 + + +++ + + + + + +

{

+

    "saleTaxNum":"339901999999008",

+

    "elecInvoiceNumber":"23312000000000540819",

+

    "invoiceCode":"",

+

    "invoiceNumber":"",

+

    "extensionNum":"1",

+

    "operateType":0

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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:已入账 | | + +### 返回示例 + +失败示例 + + +++ + + + + + +

{

+

    "code": 900,

+

    "message": "该功能暂停使用或访问，请稍后再试！",

+

    "data": null

+

}

+ +成功示例 + + +++ + + + + + +

{

+

    "code": 200,

+

    "message": "成功",

+

    "data": {

+

        "invoiceCode": "",

+

        "invoiceNumber": "20882305231323060035",

+

        "elecInvoiceNumber": "20882305231323060035",

+

        "sellerTaxnum": "339902999999789109",

+

        "sellerName": "航信培训企业789109",

+

        "buyerTaxnum": "915110247729829567",

+

        "buyerName": "威远县和平洗煤设备",

+

        "invoiceTime": "2023-06-08 13:00:22",

+

        "taxFreeAmountTotal": "0.92",

+

        "taxAmountTotal": "1.00",

+

        "taxTotal": "0.08",

+

        "vatUsageCode": "00",

+

        "saleTaxUsageCode": "00",

+

        "accountStatus": "01"

+

    }

+

}

+ +# 附录 diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取指定票种当前代码号码.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取指定票种当前代码号码.md new file mode 100644 index 0000000..4e338e8 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取指定票种当前代码号码.md @@ -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]://\[:\]/salescore/lan/getInvoiceCode.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取指定票种当前代码号码 + +### 接口说明 + +指定票种当前代码号码查询接口。 + +目前仅支持全自建-A9服务器。 + +### 接口地址 + +| | +|:------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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 | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum":" 1",

+

"terminalNum":" 1",

+

"invoiceLine": "p"

+

}

+ +### 返回参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| 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 | 否 | 剩余发票份数 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code": 200,

+

"message": "成功",

+

"data": {

+

"sellerTaxnum": "150301199811285326",

+

"extensionNum": "1",

+

"machineNum": null,

+

"terminalNum": "1",

+

"invoiceLine": "p",

+

"invoiceCode": "150010020011",

+

"invoiceNum": "23499027",

+

"remainNum": 487

+

}

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取查询数电登录认证_开票实名认证二维码.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取查询数电登录认证_开票实名认证二维码.md new file mode 100644 index 0000000..7ae2102 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取查询数电登录认证_开票实名认证二维码.md @@ -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]://\[:\]/salescore/lan/auth/authQr.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 获取查询数电登录认证、开票实名认证二维码 + +### 接口说明 + +用于数电发票开具时登录扫码认证、短信验证 或 开票实名认证的时候，进行获取或查询认证二维码 + +### 接口地址 + +| | +|:---------------------------------------------------------------| +| http\[s\]://\\[:\\]/salescore/lan/auth/authQr.do | + +### 请求参数 + +| | | | | | +|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **描述** | **长度** | +| taxNum | String | 是 | 税号 | 20 | +| extensionNum | Integer | 否 | 分机号，分机号和数电账号任一必填 | \- | +| account | String | 否 | 数电账号，分机号和数电账号任一必填 | 20 | +| opType | Integer | 否 | 操作类型 0：刷新(认证二维码) 1：查询(认证二维码) 2：刷新(登录二维码) 3：查询(登录二维码) 4：发送短信验证码（短信验证码登录时）5：查询短信验证发送状态,默认1 | 1 | + +### 请求示例 + + +++ + + + + + +

{

+

"taxNum": "150301199811285326"，

+

"extensionNum": 1，

+

"account": "123456"，

+

"opType": 1

+

}

+ +### 返回参数 + +| | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必填** | **示例值** | **描述** | **长度** | +| 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 | \- | + +### 返回示例 + +成功示例： + + +++ + + + + + +

{
+"code":200,
+"message": "成功"，

+

"data":

+

{

+

"account": "123456",

+

"taxNum": "1234567890",

+

"qrCodeType": "1",

+

"status": "0",

+

"message": "获取中",

+

"qrCode": "1fsd34s"

+

}
+}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取纸票打印编号接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取纸票打印编号接口.md new file mode 100644 index 0000000..4d62bcd --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/获取纸票打印编号接口.md @@ -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 | 是 | | | 价税合计 | | + +### 请求示例 + + +++ + + + + + +

{

+

"sellerTaxnum": "150301199811285326",

+

"invoiceCodeNumbers": [

+

{

+

"invoiceCode": "5000191650",

+

"invoiceNumber": "54523588",

+

"taxAmountTotal": "1.09"

+

}

+

]

+

}

+ +### 返回参数 + +| | | | | | | | +|:--:|:--:|:--:|:--:|:--:|:--:|:--:| +| **名称** | **类型** | **必须** | **示例值** | **更多限制** | **描述** | **最大长度** | +| code | String | 是 | 200 | | 状态码，字符串”200”表示成功，非”200”的字符串表示失败 | 6 | +| message | String | 是 | 同步成功 | | 详细信息 | 1024 | +| data | String | | | | 用以拉起打印助手的参数，拼接规则如下“webprint: 2,150301199811285326%215d09ed6548424aed811e8cfd39583a03%2102”即可拉起打印助手 | | + +\#####注意拼接规则 webprint:+data (不要带加号) + +### 返回示例 + +成功示例： + + +++ + + + + + +

{

+

"code":200,

+

"data":"2,150301199811285326%215d09ed6548424aed811e8cfd39583a03%2102",

+

"message":"成功"

+

}

+ +失败示例： + + +++ + + + + + +

{

+

"code": "9999",

+

"message": ""

+

}

diff --git a/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/蓝字发票剩余可冲红的金额_税额查询接口.md b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/蓝字发票剩余可冲红的金额_税额查询接口.md new file mode 100644 index 0000000..8bae074 --- /dev/null +++ b/docs/guides/NUOSHUITONG_INTERFACE_SPEC/interfaces/蓝字发票剩余可冲红的金额_税额查询接口.md @@ -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]://\[:\]/salescore/lan/scm/query-invoice-red.do` +> - 请求方式：`POST` +> - 是否回调：否 +> - 是否主链路：否 +> - 推荐优先级：扩展/按需 + + + +## 蓝字发票剩余可冲红的金额、税额查询接口 + +### 接口说明 + +提供蓝字发票剩余可冲红的金额、税额查询接口 + +### 接口地址 + +| | +|--------------------------------------------------------------------------| +| http\[s\]://\\[:\\]/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\ | 是 | 发票种类 | | +| goodsName | String | 否 | 商品名称，模糊匹配，只要商品明细中包含传入商品名称就返回对应发票信息 | | +| invoiceType | Integer | 是 | 发票类型 1,蓝票 | | +| invoiceIds | List\ | 否 | 发票流水号 | | +| invoiceCode | String | 否 | 发票代码 | | +| allElectronicInvoiceNumber | String | 否 | 数电发票号码 | | +| pageNum | Integer | 否 | 当前页，默认为1 | | +| pageSize | Integer | 否 | 分页条数，默认为15 | | + +### 请求参数示例 + + +++ + + + + + +

{

+

"buyerName": "浙江师范大学",

+

"goodsName": "谷物细粉",

+

"invoiceLine": [

+

"p",

+

"j"

+

],

+

"invoiceType": 1,

+

"pageNum": 1,

+

"pageSize": 15,

+

"sellerTaxnum": "150301199811285326",

+

"invoiceIds": ["21102610281401000004"]

+

}

+ +### 返回参数 + +| | | | | +|:--------------------------:|:----------:|:-------------------------:|:--------:| +| **名称** | **类型** | **描述** | **长度** | +| 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 | 总条数 | | + +### 返回示例 + +成功示例： + + +++ + + + + + +
+++ + + + + + +

{

+

"code": 200,

+

"data": {

+

"list": [

+

{

+

"buyerName": "浙江师范大学",

+

"buyerTaxnum": "339901999999142",

+

"imageUrl": "https://invtest.nntest.cn/fp/4ZVOcdXd-2mNx4YoP3hNXrINJSHYL3HA4gm70TaLrdGz3G1YmhriRKQyCM8qH1k5xu0zgSkfY9RvPW2qY442Fw.jpg",

+

"invoiceCode": "011001901011",

+

"invoiceId": "21092615495801000039",

+

"invoiceLine": "p",

+

"invoiceNumber": "92446751",

+

"invoiceTime": 1632642784000,

+

"ofdUrl": "",

+

"orderNo": "458fe678107c4f45867ce1d441a9626d",

+

"pdfUrl": "https://invtest.nntest.cn/fp/4ZVOcdXd-2mNx4YoP3hNXsj5w-6soDHl59Y-RJmc3-_OBpMxMxMjDRKdB-P36JpWGj5uUtg51-_NjiIgM7LTiw.pdf",

+

"redTaxAmount": 1.03,

+

"redTaxFreeAmount": 1.00,

+

"redTaxTotal": 0.03,

+

"taxAmountTotal": 1.03,

+

"taxFreeAmountTotal": 1.00,

+

"taxTotal": 0.03

+

},

+

{

+

"buyerName": "浙江师范大学",

+

"buyerTaxnum": "339901999999142",

+

"imageUrl": "",

+

"invoiceCode": "",

+

"invoiceId": "21102610460701000007",

+

"invoiceLine": "p",

+

"invoiceNumber": "",

+

"orderNo": "c7ab4c44656146d799930c29ca9befb4",

+

"pdfUrl": "",

+

"redTaxAmount": 1.03,

+

"redTaxFreeAmount": 1.00,

+

"redTaxTotal": 0.03,

+

"taxAmountTotal": 1.03,

+

"taxFreeAmountTotal": 1.00,

+

"taxTotal": 0.03

+

}

+

],

+

"pageNum": 1,

+

"pageSize": 15,

+

"pages": 9,

+

"total": 121

+

},

+

"message": "成功"

+

}

diff --git a/docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md b/docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md new file mode 100644 index 0000000..e58691f --- /dev/null +++ b/docs/guides/NUOSHUITONG_PG_OPENGAUSS_DDL_GUIDE.md @@ -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 迁移脚本编排建议 diff --git a/docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md b/docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md new file mode 100644 index 0000000..0868380 --- /dev/null +++ b/docs/guides/NUOSHUITONG_SAAS_INTEGRATION_CHECKLIST.md @@ -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` 接口组作为主实施口径。