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

简要描述：

未关联业务类型的发票关联业务类型 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

消息码

可选

message

string

消息描述

可选

sysMessage

string

消息描述

可选

responseData

object ()

业务数据

可选

ext

object

扩展数据

可选

iTotalRecords

integer

可选

datatable分页使用

iTotalDisplayRecords

integer

可选

datatable分页使用

示例

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

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

简要描述：#

操作表：#

逻辑说明：#

改动点：#

请求参数

示例代码

返回响应

简要描述：

操作表：

逻辑说明：

改动点：