diff --git a/doc/docs/业务流程/2026-09-20-应收结算与开票申请同步金蝶设计.md b/doc/docs/业务流程/2026-09-20-应收结算与开票申请同步金蝶设计.md index 1d61052a..80920a97 100644 --- a/doc/docs/业务流程/2026-09-20-应收结算与开票申请同步金蝶设计.md +++ b/doc/docs/业务流程/2026-09-20-应收结算与开票申请同步金蝶设计.md @@ -129,6 +129,8 @@ | buyerproperty | 0(企业) | | | buyertaxno / buyername | 申请单快照 taxpayerNo / receiverName | | | salername / salertaxno | 申请单快照 issuerName(结算单收款方/开票单位);按开票单位查客商档案(全称/简称)取统一社会信用代码 | A303-5 的 sellerTaxpayerId 同源,不走 Nacos 配置 | +| buyeraddr + showbuyeraddresstel / buyerbank + showbuyerbank | 申请单受票方快照 注册地址+联系电话、开户行+银行账号(新增/编辑选择开票信息时落库) | 展示开关固定 true;DTO 非必填,金蝶是否强校验待联调确认 | +| saleraddr + showsaleraddresstel / salerbank + showsalerbank | 客商档案注册地址+联系电话、客商开票信息(启用默认优先)开户行+银行账号;两个展示开关固定 true | DTO 标非必填,数电专票金蝶强校验(缺失即报错),随地址/银行值一同送 | | totalamount | invoiceAmount(价税合计) | | | invoiceamount / totaltax | 明细不含税合计 / 税额合计 | | | customnameid_number | receiverCustomerId → 客商档案客商编码 | 未维护报错 | diff --git a/doc/docs/业务流程/2026-09-21-应收结算与开票申请同步金蝶全链路业务流程(A302-2保存-A302-4勾稽-A303-1新增-A303-4预检-A303-5回写).md b/doc/docs/业务流程/2026-09-21-应收结算与开票申请同步金蝶全链路业务流程(A302-2保存-A302-4勾稽-A303-1新增-A303-4预检-A303-5回写).md index e8e814f9..b0a24a2b 100644 --- a/doc/docs/业务流程/2026-09-21-应收结算与开票申请同步金蝶全链路业务流程(A302-2保存-A302-4勾稽-A303-1新增-A303-4预检-A303-5回写).md +++ b/doc/docs/业务流程/2026-09-21-应收结算与开票申请同步金蝶全链路业务流程(A302-2保存-A302-4勾稽-A303-1新增-A303-4预检-A303-5回写).md @@ -133,7 +133,7 @@ kingdeeSyncStatus:unsynced ──A302-2成功──> synced(终态) 1. 校验:approved;已 synced/invoiced 幂等返回(invoiced 终态);申请单号非空。 2. **A302-4 前置校验**:逐关联结算单组装应收单防重键批量查询,任一结算单的财务应收单未在金蝶生成 → 拦截报错「请先在正式付款单页面同步金蝶」(即先完成环节一)。 3. **A303-4 幂等预检**:billno=开票申请单号查询,金蝶已生成 → 直接回填单号 + synced(勾稽回填,防断链重推重复)。 -4. 取数校验(任一不满足报错):开票单位(销方)非空;**销方税号=开票单位按全称/简称匹配客商档案的统一社会信用代码**;部门邮箱(发票推送邮箱)、购方识别号、申请部门编码、受票方客商编码均已维护;每条商品行已有税收分类编码快照与税率(历史单据缺失时提示编辑重选开票内容)。 +4. 取数校验(任一不满足报错):开票单位(销方)非空;**销方税号=开票单位按全称/简称匹配客商档案的统一社会信用代码**;销方地址电话(客商档案注册地址+联系电话)与销方开户行账号(客商开票信息开户行+账号)均已维护(数电专票金蝶强校验);部门邮箱(发票推送邮箱)、购方识别号、申请部门编码、受票方客商编码均已维护;每条商品行已有税收分类编码快照与税率(历史单据缺失时提示编辑重选开票内容)。 5. **A303-1 新增**,主表入参来源: | 接口字段 | 含义 | 必填 | 来源 | 前端字段(来源页面) | @@ -146,8 +146,12 @@ kingdeeSyncStatus:unsynced ──A302-2成功──> synced(终态) | taxationstyle | 征税方式 | 是 | 固定 0(普通征税) | 无 | | buyeremail | 发票推送邮箱 | 是 | 部门邮箱(客商开票信息邮箱多选,`;` 拼接) | 页面「部门邮箱」 | | buyerproperty / buyertaxno / buyername | 购方企业类型/税号/名称 | 是 | 固定 0(企业)/ 申请单快照 taxpayerNo / receiverName | 页面「受票方单位」选择带出 | + | buyeraddr / showbuyeraddresstel | 购方地址及电话 / 展示买方地址电话 | 否(金蝶是否强校验待联调确认) | 申请单受票方快照 注册地址+联系电话拼接,展示开关固定 true | 页面「注册地址」「联系电话」(受票方开票信息带出) | + | buyerbank / showbuyerbank | 购方开户行及账号 / 展示买方银行 | 否(待联调确认) | 申请单受票方快照 开户行+银行账号拼接,展示开关固定 true | 页面「开户银行」「银行账号」(受票方开票信息带出) | | salername | 销方名称 | 是 | 申请单快照开票单位 issuerName(=结算单收款方) | 页面「开票单位」(结算单带出) | | salertaxno | 销方纳税人识别号 | 是 | 开票单位 → 客商档案统一社会信用代码(**A303-5 sellerTaxpayerId 同源**) | 客商档案「统一社会信用代码」 | + | saleraddr / showsaleraddresstel | 销方地址及电话 / 展示卖方地址电话 | 否(数电专票强校验必传) | 客商档案注册地址+联系电话拼接,展示开关固定 true | 客商档案「注册地址」「联系电话」 | + | salerbank / showsalerbank | 销方开户行及账号 / 展示卖方银行 | 否(数电专票强校验必传) | 客商开票信息(启用、默认优先)开户行+银行账号拼接,展示开关固定 true | 客商开票信息「开户银行」「银行账号」 | | totalamount / invoiceamount / totaltax | 价税合计/不含税合计/税额合计 | 是 | 申请单开票金额 / 商品行不含税合计 / 税额合计 | 页面「本次开票金额」、商品行自动计算 | | customnameid_number | 客户.编码 | 是 | 受票方客商档案客商编码(未维护报错) | 客商档案「客商编号」 | | awrp_project_number | 项目.项目编码 | 是 | 联调期 999 | — |