- 对外开放接口
- 发票查询
- 税收分类编码维护
- 进项红字增值税专用发票
- 发票类型目录
- 开票订单
- 驳回和开票结果回传
- 电子发票版式文件
开票申请单传输接口
POST
/extInvoiceOrder/receiveInvoiceOrder
版本变更历史:2025-03-31增加旅客运输服务业务类型
蓝票支持开具票种:普通发票、成品油发票、建筑服务发票、货物运输服务发票、不动产销售服务发票、不动产租赁服务发票、旅客运输发票、机动车、二手车
红票支持:全额红冲及部分红冲
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token示例:
Authorization: Bearer ********************
Header 参数
U_ID
string
可选
默认值:
yangjie_icss
Body 参数application/json
invoiceOrder
object
开票订单表
openApplyCode
string
开票申请单号
>= 1 字符<= 100 字符
businessTypeCode
enum<string>
开票业务类型编码
枚举值:
021009006003020005002001023018099011025008007022098019010004017013014015016024012026027028029030036
businessTypeName
string
开票业务类型名称
billDate
string
单据日期
默认值:
bukrs
enum<string>
账套编码
枚举值:
W92
默认值:
W92
openInvoiceType
enum<string>
开票类型
枚举值:
012
默认值:
0
invoiceType
enum<string>
发票类型
枚举值:
020300402010402802028040203609007026104004025010101030101106010260501027030202703020110602026050103609010280401120102915
applyDate
string
申请开票日期
purchaserTaxpayerNo
enum<string>
纳税人识别号(购买方)
枚举值:
9122222222222A0390
purchaserEmail
string
电子邮箱(购买方)
purchaserCellphone
string
手机号码(购买方)
purchaserTaxpayerCode
string
购买方编码
purchaserTaxpayerName
string
购买方名称
purchaserAddress
string
购买方地址
purchaserPhone
string
购买方电话
purchaserBank
string
购买方开户行
purchaserBankNo
string
购买发开户行账号
receivePurchaserInfo
enum<string>
接收购买方信息
枚举值:
10
invoiceAmtInclTax
number
发票金额(含税)
invoiceAmt
enum<number>
发票金额(不含税)
枚举值:
10
invoiceTax
enum<number>
发票税额
枚举值:
1.3
remark
string
备注
invoiceSource
enum<string>
单据来源
枚举值:
134
默认值:
1
applicantType
enum<string>
购/销方发起红字申请
枚举值:
12
默认值:
2
redInvoiceInfoNo
string
红字发票信息表编号
originInvoiceDate
string
蓝字发票开票日期
blueInvoiceCode
string
对应蓝字发票代码
blueInvoiceNumber
string
对应蓝字发票号码
contractNumber
string
合同编号
createUser
string
创建人
applyCancelReason
string
申请作废说明
redConfirmUuid
string
红字确认单UUID
emailCarbonCopy
string
抄送人邮箱
amtInclTaxSign
enum<string> | enum<null>
是否传含税金额标志
枚举值:
12
invoiceOrderSub
array [object {28}]
开票订单子表
invoiceOrderBuildingSub
array [object {17}]
不动产子表
invoiceOrderTransportSub
array [object {7}]
货物运输子表
invoiceOrderPassengerTransportSub
array [object {12}]
旅客运输发票子表
redVatInvoiceInfoLog
object
销项红字增值税专用发票信息表
openApplyCode
string
开票申请单号
bukrs
string
账套编码
purchaserTaxpayerNo
string
纳税人识别号(购买方)
purchaserTaxpayerName
string
购买方名称
purchaserAddress
string
购买方地址
purchaserPhone
string
购买方电话
purchaserBank
string
购买方开会行
purchaserEmail
string
购买方邮箱
purchaserCellphone
string
购买方手机号
purchaserTaxpayerCode
string
购买方编码
totalAmt
string
红字发票金额(合计)(不含税)
totalAmtInclTax
number
红字发票金额(合计)(含税)
totalTax
number
红字发票税额(合计)
applyRedReasons
string
申请红冲原因
blueInvoiceCode
string
对应蓝字发票代码
blueInvoiceNumber
string
对应蓝字发票号码
originInvoiceDate
string
蓝字发票开票日期
applyDate
string
申请开票日期
reason
string
申请说明
invoiceSource
enum<string>
单据来源
枚举值:
134
redVatInvoiceInfoLogSub
array [object {12}]
销项红字增值税专用发票信息子表
示例
{
"invoiceOrder": {
"amtInclTaxSign": "1",
"applyDate": "2024-08-20 17:40:48",
"billDate": "2024-08-20 17:40:48",
"bukrs": "VB5",
"businessTypeCode": "098",
"businessTypeName": "整车销售",
"createUser": "sunzhimin3",
"invoiceAmt": 5327.44,
"invoiceAmtInclTax": 6020.0,
"invoiceOrderSub": [
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": 48.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "2",
"materialGroup": "HQ",
"model": "THFC1BLCC1Q1QD160",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "0",
"pageSize": 0,
"price": 48.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFC1BLCC1Q1QD160",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": -38.00,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "1",
"materialGroup": "HQ",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "1",
"pageSize": 0,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"vehicleNo": "THFC1BLCC1Q1QD160",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": 48.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "2",
"materialGroup": "HQ",
"model": "THFC1BLCC1Q1QD009",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "2",
"pageSize": 0,
"price": 48.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFC1BLCC1Q1QD009",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": -38.00,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "1",
"materialGroup": "HQ",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "3",
"pageSize": 0,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"vehicleNo": "THFC1BLCC1Q1QD009",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFCECMCC2J2JDY0001",
"amtInclTax": 6000.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7201HA6TA智联旗畅版(2024款)",
"invoiceLineNature": "0",
"materialGroup": "HQ",
"model": "THFCECMCC2J2J1270",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "4",
"pageSize": 0,
"price": 6000.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFCECMCC2J2J1270",
"vehicleType": "CA7201HA6TA智联旗畅版(2024款)20TD-GPF"
}
],
"invoiceSource": "7",
"invoiceTax": 692.56,
"invoiceType": "0112",
"openApplyCode": "zcxs1825830330588741634",
"openInvoiceType": "0",
"purchaserTaxpayerCode": "DJL606",
"purchaserTaxpayerName": "吉林省神州红旗汽车销售服务有限公司",
"purchaserTaxpayerNo": "dddddmarkForTax",
"receivePurchaserInfo": "1"
}
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sit-rep-tax-tmf.faw.cn/FA-0101_APP_TBF/api-dev/invoice/extInvoiceOrder/receiveInvoiceOrder' \
--header 'U_ID: yangjie_icss' \
--header 'Content-Type: application/json' \
--data-raw '{
"invoiceOrder": {
"amtInclTaxSign": "1",
"applyDate": "2024-08-20 17:40:48",
"billDate": "2024-08-20 17:40:48",
"bukrs": "VB5",
"businessTypeCode": "098",
"businessTypeName": "整车销售",
"createUser": "sunzhimin3",
"invoiceAmt": 5327.44,
"invoiceAmtInclTax": 6020.0,
"invoiceOrderSub": [
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": 48.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "2",
"materialGroup": "HQ",
"model": "THFC1BLCC1Q1QD160",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "0",
"pageSize": 0,
"price": 48.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFC1BLCC1Q1QD160",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": -38.00,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "1",
"materialGroup": "HQ",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "1",
"pageSize": 0,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"vehicleNo": "THFC1BLCC1Q1QD160",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": 48.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "2",
"materialGroup": "HQ",
"model": "THFC1BLCC1Q1QD009",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "2",
"pageSize": 0,
"price": 48.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFC1BLCC1Q1QD009",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFC1BLCC1Q1QDY0000",
"amtInclTax": -38.00,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7151HA6T智联旗悦版(2023款)",
"invoiceLineNature": "1",
"materialGroup": "HQ",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "3",
"pageSize": 0,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"vehicleNo": "THFC1BLCC1Q1QD009",
"vehicleType": "CA7151HA6T智联旗悦版(2023款)红旗H5-2 1.5T"
},
{
"MaterialCode": "HFCECMCC2J2JDY0001",
"amtInclTax": 6000.0,
"businessScope": "H5-2",
"currentPage": 0,
"factoryPlateModel": "H5-2",
"goodsName": "CA7201HA6TA智联旗畅版(2024款)",
"invoiceLineNature": "0",
"materialGroup": "HQ",
"model": "THFCECMCC2J2J1270",
"openApplyCode": "zcxs1825830330588741634",
"originRowNo": "4",
"pageSize": 0,
"price": 6000.0,
"quantity": 1,
"searchCount": true,
"taxLevel2Code": "1090305",
"taxonomyCode": "1090305010300000000",
"taxrate": 0.13,
"unit": "辆",
"vehicleNo": "THFCECMCC2J2J1270",
"vehicleType": "CA7201HA6TA智联旗畅版(2024款)20TD-GPF"
}
],
"invoiceSource": "7",
"invoiceTax": 692.56,
"invoiceType": "0112",
"openApplyCode": "zcxs1825830330588741634",
"openInvoiceType": "0",
"purchaserTaxpayerCode": "DJL606",
"purchaserTaxpayerName": "吉林省神州红旗汽车销售服务有限公司",
"purchaserTaxpayerNo": "dddddmarkForTax",
"receivePurchaserInfo": "1"
}
}'
返回响应
🟢200成功
application/json
Body
success
boolean
必需
code
integer
必需
message
string
必需
data
null
必需
示例
{
"success": true,
"code": 200,
"message": "接收订单成功!",
"data": null
}