接口描述

请求地址： /ticketInterface/3_8/modify

接口编号：FSSC-API-000083

接口诞生版本：3.8

所属系统：发票池

所属微服务：zfs-op

接口说明：我方采集发票数据，调用外部查验接口进行发票查验，查验反馈不是实时的，与结果返回接口为两个不同的接口，外部查验接口发票查验完成后回传查验结果至我方系统。通过发票信息更新接口更新发票查验状态和查验后的信息；

单次调用最大条数：100

注意事项：

1.此接口是实时调用;

2.此接口为发票更新信息的接口，支持外系统调用该接口对沉淀在发票池中的进项发票数据进行信息修改。该接口适用接口平台承接外系统的标准处理方式，仅适用于外系统，不适用内部系统；

3.当第三方查验接口返回的发票明细有一行“详见销货清单”时，需要将该明细行过滤掉，否则接口会报错“不含税金额或税额之和与主表区金额不对”，因为“详见销货清单”是其他明细的合计，如果不将其过滤掉，则明细金额和税额相当于重复算了一遍，这样便会导致明细的“不含税金额或税额之和与主表区金额不对”。

请求参数

参数名	中文名称	参数类型	是否必填	示例	参数说明
▼data	请求数据	array	Y	XY	请求数据
authState	认证状态	string	N	RZZT0001	认证状态，未认证-RZZT0001、无需认证-RZZT0002、认证中-RZZT0003、已认证-RZZT0004、认证失败-RZZT0005 （1）发票类型=增值税电子普通发票（通行费）/18、增值税专用发票/14、增值税专用发票（成品油）/15、增值税电子专用发票/21、机动车销售统一发票/12时，如果为空，则默认=原值否则，为输入值（未认证、认证中、已认证、认证失败）（2）其他类型发票（包括税额=0的增值税电子普通发票（通行费）/18），默认=无需认证
airNumber	电子客票号码	string	N	1234123	电子客票号码
agentcode	销售单位代码	string	N	SZH88812345678	销售单位代码
arriveCityCode	下车车站/到达城市	string	N	430100	下车车站/到达城市
boeNo	单据编号	string	N	XY-2022081324	（1）已报销-3时，字段不支持修改（2）未报销-1、已拆票-4、无需报销-5时，字段为空（3）报销中-2时，字段必填，如果为空，则默认=原值；否则，为输入值
buyerAddressAndPhone	购方地址、电话	string	N	洛阳市伊滨区庞村镇西庞村十组15137468329	购方地址、电话
buyerNumber	购方识别号/买方单位代码/身份证号码	string	N	12100010435931505A	购方识别号/买方单位代码/身份证号码
billingTime	开票日期/日期	string	N	2022/7/8	开票日期/日期，格式：“YYYY-MM-DD”，2022-07-08
billingNo	发票代码	string	N	1234567890	发票代码，10或12位数字或字母，全电发票为空
buyerName	购方名称/买方单位/个人	string	N	西北工业大学	购方名称/(买方单位/个人)
billingCode	发票号码	string	N	12345678	发票号码/车票号码，8位数字或字母、20位（全电发票）
buyerBankAccount	购方开户行及账号	string	N	河南偃师农村商业银行股份有限公司66911024400000263	购方开户行及账号
budgetLevel	预算级次	string	N	一级	所对应发票的预算等级和优先级
carCode	车架号/车辆识别代码	string	N	LJU7524S89G0008	车架号/车辆识别代码
carEngineCode	发动机号码	string	N	123989	发动机号码
certificateNumber	合格证号	string	N	WAE091833415	合格证号
companySeal	是否有公司印章	string	N	1	是否有公司印章，仅限输入0/1,有=1，无=0
checkCode	校验码	string	N	12345	校验码，发票类型编码=11、16、17、18、19时必填
currencyName	币种	string	N	人民币	币种
caacDevelopmentFund	民航发展基金	string	N	50	民航发展基金
carModel	厂牌型号	string	N	奥迪SMA7135E3	厂牌型号
dataSource	来源系统	string	N	1	来源系统，发票邮箱：6；开票协同：5；影像ocr：4；影像录入：3；票联系统：1；报账系统；2 否则，为集团下有效编码的值
executedOnDate	填开日期	string	N	2022/7/8	填开日期，格式：“YYYY-MM-DD”，2022-07-08
fare	票价	string	N	1250	票价
formType	发票是第几联	string	N	第一联	发票是第几联，第一联-第一联、第二联-第二联、第三联-第三联、第四联-第四联、第五联-第五联、第六联-第六联
formName	发票联次	string	N	发票联	发票联次，发票联-发票联、抵扣联-抵扣联、记账联-记账联、存根联-存根联、副联-副联
fillingCompany	填制单位	string	N		缴款书填制单位名称，该选项可选择填写或不填写
fee	价税合计/总金额/票价/合计金额	string	N	15	价税合计，等于金额+税额/增值税税额，等于税前金额+增值税税额/总金额/总额/票价/合计金额
flightNumber	车次	string	N	D2312	车次
feeWithoutTax	金额/税前金额	string	N	12.12	金额，不含税金额/税前金额
fuelSurcharge	燃油附加费	string	N	50	燃油附加费
id	发票ID	string	Y	asdfzxcvasdzqaxz123adf43134	发票唯一标识
issueBy	填开单位	string	N	阿斯兰航空服务（上海）有限公司	填开单位
insurance	保险费	string	N	12	保险费
isReplacementTicket	是否补票	string	N	1	是否补票，仅限输入0/1,是=0，否=1
invoiceCount	票据数量	string	N	123	票据数量
identityNumber	身份证号	string	N	4300*************0515	身份证号
kind	发票消费类型	string	N	abc	发票消费类型
licensePlate	车牌号	string	N	湘A666FC	车牌号
▼list	发票明细	array	N		发票明细（list），查验成功-3时，明细行必填
taxNumber	税号	string	N	90262000	位于下方发票明细栏目，该选项为非必填项目
sum	项目不含税金额	string	N	1264.15	项目不含税金额
tax	项目税额	string	N	75.85	项目税额
flightNumber	航班号	string	N	MF1250	航班号
goodserviceName	项目名称	string	N	住宿服务住宿	项目名称
number	项目数量	string	N	5	项目数量
taxRate	项目税率	string	N	6%	项目税率
carrier	承运人	string	N	张三	承运人
destinationCode	到达城市	string	N	430100	到达城市
unit	项目单位	string	N	晚	项目单位
price	项目单价	string	N	252.8301887	项目单价
departDate	乘机日期	string	N	2022/7/8	乘机日期，格式：“YYYY-MM-DD”，2022-07-08
model	项目规格	string	N	/	项目规格
originCode	出发城市	string	N	430100	出发城市
time	乘机时间	string	N	2022/7/8	乘机时间，格式：“YYYY-MM-DD”，2022-07-08
seatLevel	座位级别	string	N	JT11	座位级别
extendS1	备用字段1	string	N		备用字段1
extendS2	备用字段2	string	N		备用字段2
extendS3	备用字段3	string	N		备用字段3
extendS4	备用字段4	string	N		备用字段4
extendS5	备用字段5	string	N		备用字段5
leCode	核算主体	string	N	XYTX	核算主体，（1）已报销-3时，字段不支持修改（2）未报销-1、已拆票-4、无需报销-5时，字段为空（3）报销中-2时，字段必填，如果为空，则默认=原值；否则，为输入值，取核算主体编码，账套+核算主体编码联动校验；
machineCode	机打代码	string	N	1234567890	机打代码
marketNumber	二手车市场纳税人识别号	string	N	6.10186E+13	二手车市场纳税人识别号
marketName	二手车市场	string	N	西安市阿宫旧机动车交易市场有限公司	二手车市场
mileage	里程	string	N	16.9	里程，默认单位是km，示例：16.9
machineNumber	机打号码	string	N	1234567890	机打号码
numberOfGpOrder	公务机票号	string	N	XXXX-ZTC202307150001	不限制传入格式
operationTypeCode	业务大类	string	N	111	业务大类，（1）已报销-3时，字段不支持修改（2）未报销-1、已拆票-4、无需报销-5时，字段为空（3）报销中-2时，字段必填，如果为空，则默认=原值；否则，为输入值，取业务类型编码
oilMark	成品油标志	string	N	Y	成品油标志，仅限输入Y/N,Y代表是，N代表否
operationSubTypeCode	业务小类	string	N	11101	（1）已报销-3时，字段不支持修改（2）未报销-1、已拆票-4、无需报销-5时，字段为空（3）报销中-2时，字段必填，如果为空，则默认=原值；否则，为输入值，取业务类型编码
obsoleteState	状态	string	N	5	状态，已红冲-0、已作废-1、正常-5 如果为空，则默认=原值否则，为输入值
paymentPeriod	缴款期限	string	N	2023/9/18	格式标准如下：yyyy-MM-dd，需对日期格式进行格式校验。
postState	入账状态	string	N	RZZT02	入账状态，未入账-RZZT01、已入账-RZZT02、无需入账-RZZT03 如果为空，则默认=原值；否则，为输入值
personnelAttribution	人员标记	string	N	1	人员标记,内部人员-1，外部人员-2
passengerName	乘客名称	string	N	张三	乘客名称
passengerCode	工号	string	N	912	工号
revenueSystem	收入系统	string	N	湖南省财政厅收入系统	对应海关缴款书收入系统，该选项为非必填
registrationNumber	登记证号	string	N	6.10002E+11	登记证号
rowNum	行号	string	Y	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
receivingTreasury	收款国库	string	N	北京市海淀区代理国库	所对应海关缴款书的收款国库具体名称
recordedDate	入账时间	string	N	2022/7/8 9:10	入账时间，其他情况默认为空入账状态=已入账时，必填格式：“YYYY-MM-DD hh-mm-ss” 2022-07-08 09:10:22
rowId	行ID	string	N	38ffbdb043f045ed544eb1b9b2ae034b	该参数由接口自动处理，无需传值
remarks	备注	string	N	这是一条备注信息	备注
revenueAgency	收入机关	string	N	中国工商银行长沙岳麓区分行	海关缴款书所对应的收入机关，该选项为必填
sellerAccount	缴款单位账号	string	N	3.92984E+12	缴款单位对应账号
sellerName	销方名称/卖方单位/个人	string	N	洛阳市伊滨区庞村镇凯帝办公家具销售部	销方名称/卖方单位/个人
sellerNumber	销方识别号/卖方单位代码/身份证号码	string	N	12100010435931505A	销方识别号/卖方单位代码/身份证号码
seatLevel	座位级别	string	N	JT11	座位级别/交通工具
sellerBankAccount	销方开户行及账号	string	N	河南偃师农村商业银行股份有限公司66911024400000263	销方开户行及账号
subject	科目	string	N	进口关税	对应海关缴款书的预算科目，该选项非必填
sellerBank	缴款单位开户行	string	N	中国工商银行长沙分行	开户行名称
sellerAddressAndPhone	销方地址、电话	string	N	洛阳市伊滨区庞村镇西庞村十组15137468329	销方地址、电话
startOffCityCode	上车车站/出发城市	string	N	430100	上车车站/出发城市/市
sobCode	账套	string	N	ZT001	账套，1）已报销-3时，字段无需修改（2）未报销-1、已拆票-4、无需报销-5时，字段为空（3）报销中-2时，字段必填；取账套编码
timeGeton	上车时间	string	N	21:55	上车时间，格式：“hh:mm”，21:55
typeOfBusiness	退改签标志	string	N	1	有效值： 1：退票 2：退差当该参数为空时，视为正常购票，对应我方发票池中退改签标志为空情况
transitMark	通行费标志	string	N	N	通行费标志，仅限输入Y/N,Y代表是，N代表否
tripDate	乘车日期	string	N	2022/7/8	乘车日期，格式：“YYYY-MM-DD”，2022-07-08/火车票格式为 YYYY-MM-DD hh:mm:ss
timeGetoff	下车时间	string	N	23:55	下车时间
tax	税额/增值税税额/其他税费	string	N	2.88	税额/增值税税额/税费
taxRate	增值税税率或征收率（%）	string	N	13.00%	增值税税率或征收率（%）
title	标题	string	N	江苏省旅客运输专用发票	标题
taxOfficeName	主管税务机关及代码	string	N	110023471W	主管税务机关及代码
time	乘车时间	string	N	21:55	乘车时间
userCode	拥有人	string	N	912	拥有人，集团下有效用户编码
vendorCode	供应商编码	string	N	C05	供应商编码
voucherNum	凭证编号	string	N	7,893,454,312,754	凭证编号
validState	验真状态	string	N	1	验真状态，待查验-001、查验失败-002、查验成功-003、无需查验-004 如果为空，则默认=原值否则，为输入值
voucherDate	凭证时间	string	N	2022-09-07,2022-05-17	凭证时间，格式：“YYYY-MM-DD”,2022-07-08 多值逗号隔开
extendS1	备用字段1	string	N		备用字段1
extendS2	备用字段2	string	N		备用字段2
extendS3	备用字段3	string	N		备用字段3
extendS4	备用字段4	string	N		备用字段4
extendS5	备用字段5	string	N		备用字段5
extendS6	备用字段6	string	N		备用字段6
extendS7	备用字段7	string	N		备用字段7
extendS8	备用字段8	string	N		备用字段8
extendS9	备用字段9	string	N		备用字段9
extendS10	备用字段10	string	N		备用字段10

返回参数

参数名	中文名称	参数类型	是否必填	示例	参数说明
msg	信息	string	N	全部成功	消息提示
code	编码	string	Y	0	0-全部成功;1-全部失败;2-部分成功
successNum	成功条数	string	N	0	成功条数
failNum	失败条数	string	N	1	失败条数
▼data	数据	array	N		返回数据
rowId	行ID	string	N	38ffbdb043f045ed544eb1b9b2ae034b	接口平台数据同步标识
rowNum	行号	string	Y	1	行号
errMsg	错误信息	string	Y		每行错误消息

请求参数示例

{
  "data": [
    {
      "boeNo": "XY-2022081324",
      "fare": "1250.00",
      "vendorCode": "C05",
      "revenueSystem": "湖南省财政厅收入系统",
      "licensePlate": "湘A666FC",
      "carCode": "LJU7524S89G0008",
      "sellerAccount": "3929839104981",
      "buyerAddressAndPhone": "洛阳市伊滨区庞村镇西庞村十组15137468329",
      "id": "asdfzxcvasdzqaxz123adf43134",
      "formType": "第一联",
      "machineCode": "1234567890",
      "marketNumber": "61018573595345",
      "issueBy": "阿斯兰航空服务（上海）有限公司",
      "extendS10": "备用字段10",
      "carEngineCode": "123989",
      "paymentPeriod": "2023-9-18",
      "timeGeton": "21:55",
      "sellerName": "洛阳市伊滨区庞村镇凯帝办公家具销售部",
      "buyerNumber": "12100010435931505A",
      "voucherNum": "789345,4312754",
      "userCode": "0912",
      "operationTypeCode": "111",
      "validState": "001",
      "executedOnDate": "2022-07-08",
      "sellerNumber": "12100010435931505A",
      "formName": "发票联",
      "typeOfBusiness": "1",
      "seatLevel": "JT11",
      "transitMark": "N",
      "billingTime": "2022-07-08",
      "postState": "RZZT02",
      "billingNo": "1234567890",
      "buyerName": "西北工业大学",
      "billingCode": "12345678",
      "marketName": "西安市阿宫旧机动车交易市场有限公司",
      "certificateNumber": "WAE091833415",
      "tripDate": "2022-07-08",
      "registrationNumber": "610001824777",
      "fillingCompany": "",
      "sellerBankAccount": "河南偃师农村商业银行股份有限公司66911024400000263",
      "numberOfGpOrder": "XXXX-ZTC202307150001",
      "timeGetoff": "23:55",
      "insurance": "12.00",
      "buyerBankAccount": "河南偃师农村商业银行股份有限公司66911024400000263",
      "subject": "进口关税",
      "fee": "15.00",
      "sellerBank": "中国工商银行长沙分行",
      "sellerAddressAndPhone": "洛阳市伊滨区庞村镇西庞村十组15137468329",
      "personnelAttribution": "1",
      "extendS9": "备用字段9",
      "rowNum": "1",
      "voucherDate": "2022-09-07,2022-05-17",
      "isReplacementTicket": "1",
      "mileage": "16.9",
      "authState": "RZZT0001",
      "receivingTreasury": "北京市海淀区代理国库",
      "kind": "abc",
      "budgetLevel": "一级",
      "extendS8": "备用字段8",
      "invoiceCount": "123",
      "extendS7": "备用字段7",
      "oilMark": "Y",
      "extendS6": "备用字段6",
      "tax": "2.88",
      "companySeal": "1",
      "extendS5": "备用字段5",
      "extendS4": "备用字段4",
      "list": [
        {
          "taxNumber": "90262000",
          "sum": "1264.15",
          "tax": "75.85",
          "extendS5": "备用字段5",
          "extendS4": "备用字段4",
          "extendS3": "备用字段3",
          "extendS2": "备用字段2",
          "extendS1": "备用字段1",
          "flightNumber": "MF1250",
          "goodserviceName": "*住宿服务*住宿",
          "number": "5.00",
          "taxRate": "6%",
          "carrier": "张三",
          "destinationCode": "430100",
          "unit": "晚",
          "price": "252.830188679245",
          "departDate": "2022-07-08",
          "model": "/",
          "originCode": "430100",
          "time": "2022-07-08",
          "seatLevel": "JT11"
        }
      ],
      "extendS3": "备用字段3",
      "extendS2": "备用字段2",
      "checkCode": "12345",
      "extendS1": "备用字段1",
      "flightNumber": "D2312",
      "taxRate": "13.00%",
      "machineNumber": "1234567890",
      "dataSource": "1",
      "airNumber": "1234123",
      "passengerName": "张三",
      "startOffCityCode": "430100",
      "feeWithoutTax": "12.12",
      "sobCode": "ZT001",
      "title": "江苏省旅客运输专用发票",
      "agentcode": "SZH88812345678",
      "arriveCityCode": "430100",
      "currencyName": "人民币",
      "identityNumber": "4300*************0515",
      "passengerCode": "0912",
      "operationSubTypeCode": "11101",
      "caacDevelopmentFund": "50.00",
      "recordedDate": "2022-07-08 09:10:22",
      "taxOfficeName": "110023471W",
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b",
      "obsoleteState": "5",
      "time": "21:55",
      "fuelSurcharge": "50.00",
      "leCode": "XYTX",
      "remarks": "这是一条备注信息",
      "revenueAgency": "中国工商银行长沙岳麓区分行",
      "carModel": "奥迪SMA7135E3"
    }
  ]
}

返回参数示例

{
  "msg": "成功",
  "code": "0",
  "successNum": "1"
  "failNum": "1",
  "data": [
    {
      "rowId": "38ffbdb043f045ed544eb1b9b2ae034b"
      "rowNum": "1",
      "errMsg": "错误",

    }
  ]
}

进项发票更新接口

进项发票更新接口

关于作者

目录