批量添加发票（关联业务类型）

简要描述：

未关联业务类型的发票关联业务类型 By周自豪

操作表：

exp_accounting(发票夹)

exp_business_temp(发票类型表)

spc_check_bill(对账账单表)

逻辑说明：

1，前端传入发票集合expAccountingS,用户信息和业务类型编码businessTypeCode,业务businessId,业务的序号 serialNum

2, 根据发票的id查询是否已添加,如已存在,则抛出提示”请勿重复提交”

3, 根据业务类型编码businessTypeCode和业务Id查找对应的业务类型,如已存在,则只保存发票和orderInfo,
不存在,则保存业务类型和发票

改动点：

版本	改动日期	改动点	改动人
v2.1	-	入参增加: serialNum 业务序号	-
v2.2	-	入参增加: serialNum 发票类型序号	-
v2.3	-	入参增加: invoiceTaxRate 发票税率 invoiceTitleCode 发票抬头编码 invoiceTitleName 发票抬头名称 remark 发票号码	-
v2.5	-	1.先根据发票内容(模糊)与业务编码businessTypeCode(精确)匹配会计科目SAP,如果匹配多条或没有则根据发票内容(模糊)取会计科目SAP 2.当业务为采购时,发票的会计科目SAP则为2202960101-应付账款-暂估入库	-
v2.7	-	1. 可重新关联业务，根据发票的id查询是否已添加,如已存在，则物理删除发票,重新添加.(采购业务/用餐业务除外)当为采购业务,将普通的增值发票税额清除,当税率为中文(免税/不征税),处理为0%	-
v2.8	-	入参增加: personCode 工号 planNo 需求编号 taxRate srm订单税率amountExplain 发票金额说明 bindingOrderDTOS 绑定的行项目对象集合逻辑增加:有合同采购业务时,需要校验与合同下srm订单税率是否一致,如有发票抬头时,需要校验与合同甲方是否一致.	-
v2.9	-	1.当添加发票的业务为用餐,会计科目SAP为6638010101-业务招待费,添加发票成功后回写i美食.	-
7/19	-	入参增加: serialNum 业务序号	-
7/26	-	学术会议增加3个子类型(BTY001B/BTY001C/BTY001D).	-
v3.0	-	1.调研增加 2个子类(BTY002C/BTY002D) 增加字段品类标记serviceFlag .2.绑定srm采购订单区分运营服务和非运营服务,serviceFlag为 0 时,发票SAP对应应付账款-暂估入库,其他按照发票走费用凭证	-
v3.3	-	入参增加发票标识 invoiceFlag(1:微信电子发票 2:支付宝电子发票)	-
v3.3.1	-	1.当添加发票的业务为采购BTY011F -全部为维修工单时,判断绑定模式(一对多,多对一),发票SAP走费用凭证-有非维修工单和维修工单混合/绑定模式(多对多),抛出提示	-
v3.5	-	会议活动(BTY001E),调研(BTY002F,BTY002G),团建(BTY005B),项目(BTY009E,BTY009F,BTY009G),培训(BTY010B),采购需求(BTY011G),公共服务(BTY013E,BTY013F,BTY013G,BTY013H)入参增加收货单(orderInfo),合同号(contractCode)	-
v3.9	-	增加币种校验，采购业务增加自采、集采标识（purchaseType ）区分，采购业务会保存orderInfo表入参增加: currency 币种代码（CNY）purchaseType 采购类型标记；orderInfo提取最外层，expAccountingS 不再传orderInfo；计算公式：税额=（含税的收货或验收金额/（1+税率））*税率，保留小数点后两位,四舍五入。	-
v4.0.5	2022-07-23	入参增加全电发票,对普通发票全电发票的税额处理为0,税率处理为0%	-
v4.0.6	2022-08-02	入入参增加 invoiceCode 发票代码	-
v4.2.0	2023-06-09	入参增加 noContractExplain 无合同说明； companyCode 公司编码	-
v4.3.0	2023-10-18	入参增加 checkBillList 账单列表； differentReason 差异原因	-
v4.2.4	2023-10-26	入参增加 invoiceSellTaxNum (售货方纳税人识别号)	-
v4.2.4	2023-11-13	入参增加 invoiceSellTaxName (售货方公司名称)	-

请求参数

Body 参数application/json

cid

string | null

用户cid

可选

name

string | null

用户name

可选

appSource

string | null

应用来源

可选

reqSource

string | null

请求来源

可选

personCode

string | null

工号

可选

serialNum

integer | null

业务序号

必需

businessTypeCode

string | null

业务类型编码

可选

businessTypeName

string | null

业务类型名称

可选

businessId

string | null

业务id

可选

businessName

string | null

业务名称

可选

businessExtend

string | null

业务扩展

可选

planNo

string | null

计划ID

可选

taxRate

string | null

srm订单税率

可选

amountExplain

string | null

合同号

可选

orderInfo

string | null

可选

@NotBlank(message = "orderInfo不能为空")

expAccountingS

array[object (ExpAccountDTO) {24}] | null

发票集合

可选

invoiceId

string | null

可选

invoiceClassify

string | null

可选

invoiceCreateTime

string | null

可选

invoiceAmount

number | null

必需

invoiceTax

number | null

可选

invoicePayee

string | null

可选

invoiceComment

string | null

可选

extend

string | null

可选

serialNum

integer | null

发票类型序号

必需

invoiceTaxRate

string | null

税率

可选

invoiceTitleCode

string | null

发票抬头编码

可选

invoiceTitleName

string | null

发票抬头名称

可选

remark

string | null

备注

可选

invoiceFlag

string | null

发票标识

可选

currency

string | null

币种

可选

invoiceCode

string | null

发票号码

可选

invoiceSellTaxNum

string | null

售货方纳税人识别号

可选

invoiceSellTaxName

string | null

售货方纳税人名称

可选

mainInvoiceId

string | null

主票id

可选

mainInvoiceAmount

number | null

主票金额

可选

taxExt

number | null

代收车船税

可选

taxExtReal

number | null

实报代收车船税

可选

invoiceCompanyCode

string | null

可选

v4.5.0.1 新增发票所属公司编码

invoiceCompanyName

string | null

可选

v4.5.0.1 新增发票所属公司名称

bindingOrderDTOS

array[object (BindingOrderReqDTO) {8}] | null

可选

@NotEmpty(message = "绑定收货/验收单非空")

serviceFlag

integer | null

可选

amountExplain

string | null

可选

orderDetailId

integer | null

可选

purchaseType

string | null

可选

currency

string | null

可选

receiveNos

array[string] | null

可选

checkedNos

array[string] | null

可选

poType

string | null

可选

v4.3.5 新增，PUR-采购订单；REF-退货订单

contractCode

string | null

合同号

可选

noContractExplain

string | null

可选

v4.2.0 新增无合同说明（自采需求单时，需将此字段返回给前端）

companyCode

string | null

可选

v4.2.0 新增公司编码

threeMatchFlag

integer | null

可选

是否需要三单匹配 0 否 1 是

示例

{
  "cid": "string",
  "name": "string",
  "appSource": "string",
  "reqSource": "string",
  "personCode": "string",
  "serialNum": 0,
  "businessTypeCode": "string",
  "businessTypeName": "string",
  "businessId": "string",
  "businessName": "string",
  "businessExtend": "string",
  "planNo": "string",
  "taxRate": "string",
  "amountExplain": "string",
  "orderInfo": "string",
  "expAccountingS": [
    {
      "invoiceId": "string",
      "invoiceClassify": "string",
      "invoiceCreateTime": "string",
      "invoiceAmount": 0,
      "invoiceTax": 0,
      "invoicePayee": "string",
      "invoiceComment": "string",
      "extend": "string",
      "serialNum": 0,
      "invoiceTaxRate": "string",
      "invoiceTitleCode": "string",
      "invoiceTitleName": "string",
      "remark": "string",
      "invoiceFlag": "string",
      "currency": "string",
      "invoiceCode": "string",
      "invoiceSellTaxNum": "string",
      "invoiceSellTaxName": "string",
      "mainInvoiceId": "string",
      "mainInvoiceAmount": 0,
      "taxExt": 0,
      "taxExtReal": 0,
      "invoiceCompanyCode": "string",
      "invoiceCompanyName": "string"
    }
  ],
  "bindingOrderDTOS": [
    {
      "serviceFlag": 0,
      "amountExplain": "string",
      "orderDetailId": 0,
      "purchaseType": "string",
      "currency": "string",
      "receiveNos": [
        "string"
      ],
      "checkedNos": [
        "string"
      ],
      "poType": "string"
    }
  ],
  "contractCode": "string",
  "noContractExplain": "string",
  "companyCode": "string",
  "threeMatchFlag": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/app/exp/addExpAccountingBatch' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cid": "string",
    "name": "string",
    "appSource": "string",
    "reqSource": "string",
    "personCode": "string",
    "serialNum": 0,
    "businessTypeCode": "string",
    "businessTypeName": "string",
    "businessId": "string",
    "businessName": "string",
    "businessExtend": "string",
    "planNo": "string",
    "taxRate": "string",
    "amountExplain": "string",
    "orderInfo": "string",
    "expAccountingS": [
        {
            "invoiceId": "string",
            "invoiceClassify": "string",
            "invoiceCreateTime": "string",
            "invoiceAmount": 0,
            "invoiceTax": 0,
            "invoicePayee": "string",
            "invoiceComment": "string",
            "extend": "string",
            "serialNum": 0,
            "invoiceTaxRate": "string",
            "invoiceTitleCode": "string",
            "invoiceTitleName": "string",
            "remark": "string",
            "invoiceFlag": "string",
            "currency": "string",
            "invoiceCode": "string",
            "invoiceSellTaxNum": "string",
            "invoiceSellTaxName": "string",
            "mainInvoiceId": "string",
            "mainInvoiceAmount": 0,
            "taxExt": 0,
            "taxExtReal": 0,
            "invoiceCompanyCode": "string",
            "invoiceCompanyName": "string"
        }
    ],
    "bindingOrderDTOS": [
        {
            "serviceFlag": 0,
            "amountExplain": "string",
            "orderDetailId": 0,
            "purchaseType": "string",
            "currency": "string",
            "receiveNos": [
                "string"
            ],
            "checkedNos": [
                "string"
            ],
            "poType": "string"
        }
    ],
    "contractCode": "string",
    "noContractExplain": "string",
    "companyCode": "string",
    "threeMatchFlag": 0
}'

返回响应

🟢200成功

application/json

Body

com.cttq.framework.common.base.Result

msgCode

string | null

消息码

可选

message

string | null

消息描述

可选

sysMessage

string | null

消息描述

可选

responseData

object ()

业务数据

可选

ext

object (Object)

扩展数据

可选

iTotalRecords

integer | null

可选

datatable分页使用

iTotalDisplayRecords

integer | null

可选

datatable分页使用

示例

{
  "msgCode": "",
  "message": "",
  "sysMessage": "",
  "responseData": {},
  "ext": {},
  "iTotalRecords": 0,
  "iTotalDisplayRecords": 0
}

批量添加发票（关联业务类型）

简要描述：#

操作表：#

逻辑说明：#

改动点：#

请求参数

示例代码

返回响应

简要描述：

操作表：

逻辑说明：

改动点：