税务发票平台
  1. 开票订单
税务发票平台
  • 对外开放接口
    • 发票查询
      • 对外税务发票查询分页接口
      • 普票查验及结果返回接口
      • 底账库发票查询接口
      • 税务发票查询接口
      • 报账单发票关联/取消关联接口TAXIM_006
      • 税务发票进项销项查询接口
    • 税收分类编码维护
      • 税收分类编码查询接口
    • 进项红字增值税专用发票
      • 进项红字发票信息表/确认单编号查验接口TAXIM_009
    • 发票类型目录
      • 发票类型编码查询接口
    • 开票订单
      • 机动车销售开票申请单传输接口
        POST
      • 开票申请单传输接口
        POST
    • 驳回和开票结果回传
      • 开票申请单驳回
      • 开票结果回传
    • 电子发票版式文件
      • 销项/进项发票板式文件
  1. 开票订单

开票申请单传输接口

POST
/extInvoiceOrder/receiveInvoiceOrder
开放API接口地址:/JT/FA/FA-0101/TIF/TAX/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> 
开票类型
必需
0,蓝票;1,红票;2,作废【数电票不能作废】
枚举值:
012
默认值:
0
invoiceType
enum<string> 
发票类型
必需
可以通过调用/JT/FA/FA-0101/TIF/TAX/extQueryInvoiceType 接口获取该值
枚举值:
020300402010402802028040203609007026104004025010101030101106010260501027030202703020110602026050103609010280401120102915
applyDate
string 
申请开票日期
必需
申请开票日期
purchaserTaxpayerNo
enum<string> 
纳税人识别号(购买方)
必需
纳税人识别号(购买方)
枚举值:
9122222222222A0390
purchaserEmail
string 
电子邮箱(购买方)
可选
发票为电票(026 & 028)时,电子邮箱必填
purchaserCellphone
string 
手机号码(购买方)
可选
手机号码非必填
purchaserTaxpayerCode
string 
购买方编码
可选
业务系统自定义,当receivePurchaserInfo字段为1时,该字段必填
purchaserTaxpayerName
string 
购买方名称
可选
当receivePurchaserInfo字段为1时,该字段必填
purchaserAddress
string 
购买方地址
可选
purchaserPhone
string 
购买方电话
可选
purchaserBank
string 
购买方开户行
可选
purchaserBankNo
string 
购买发开户行账号
可选
receivePurchaserInfo
enum<string> 
接收购买方信息
可选
1接收 0/null不接收,当为1时会接收业务系统传过来的购买方信息并保存到发票系统
枚举值:
10
invoiceAmtInclTax
number 
发票金额(含税)
必需
发票金额(含税)
invoiceAmt
enum<number> 
发票金额(不含税)
可选
发票金额(不含税)
枚举值:
10
invoiceTax
enum<number> 
发票税额
必需
发票税额
枚举值:
1.3
remark
string 
备注
可选
备注
invoiceSource
enum<string> 
单据来源
必需
1-收入平台/2-税务系统/3-ERPV4 4-营销平台
枚举值:
134
默认值:
1
applicantType
enum<string> 
购/销方发起红字申请
可选
1-购方,2-销方
枚举值:
12
默认值:
2
redInvoiceInfoNo
string 
红字发票信息表编号
可选
购方开红票时必传
originInvoiceDate
string 
蓝字发票开票日期
可选
开红票时必传,yyyy-MM-dd HH:mm:ss
blueInvoiceCode
string 
对应蓝字发票代码
可选
对应蓝字发票代码
blueInvoiceNumber
string 
对应蓝字发票号码
可选
对应蓝字发票号码
contractNumber
string 
合同编号
可选
合同编号
createUser
string 
创建人
可选
创建人
applyCancelReason
string 
申请作废说明
可选
申请作废说明,开作废申请单时必填
redConfirmUuid
string 
红字确认单UUID
可选
购方开红票时必传
emailCarbonCopy
string 
抄送人邮箱
可选
抄送人邮箱(购买方)抄送人邮箱,多个用英文逗号隔开,最多5个抄送人信息
amtInclTaxSign
enum<string>  | enum<null> 
是否传含税金额标志
可选
传含税标志 1:含税金额,2/null:不含税金额 默认不含税金额必填,如果为1 invoiceAmtInclTax字段不能为空 如果为2或者为空invoiceAmt和invoiceTax不能为空
枚举值:
12
invoiceOrderSub
array [object {28}] 
开票订单子表
必需
开票订单子表
invoiceOrderBuildingSub
array [object {17}] 
不动产子表
可选
当开票业务类型编码是011、026、027时,该字段必填
invoiceOrderTransportSub
array [object {7}] 
货物运输子表
可选
当开票业务类型编码是028时,该字段必填
invoiceOrderPassengerTransportSub
array [object {12}] 
旅客运输发票子表
可选
当开票业务类型编码是036时,填写该字段,票面会有旅客运输相关信息,不填写该字段票面没有旅客运输相关信息
redVatInvoiceInfoLog
object 
销项红字增值税专用发票信息表
可选
当开红票该字段必传,销项红字增值税专用发票信息表
openApplyCode
string 
开票申请单号
必需
开票申请单号
bukrs
string 
账套编码
必需
账套编码
purchaserTaxpayerNo
string 
纳税人识别号(购买方)
必需
纳税人识别号(购买方)
purchaserTaxpayerName
string 
购买方名称
可选
当receivePurchaserInfo字段为1时,该字段必传
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 
蓝字发票开票日期
必需
yyyy-MM-dd HH:mm:ss
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
}
上一页
机动车销售开票申请单传输接口
下一页
开票申请单驳回
Built with