淘宝开放平台

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	描述
interfaceCode	String	必须	createInvoice	接口编码
zipCode	String	必须	0	压缩标识
encryptCode	String	必须	0	加密方式：0-不加密，2-CA加密
access_token	String	必须	ALI	平台编码
datagram	CreateInfo	必须		申请开票数据
└ hddz String 可选 https://xx.com 回调地址 fpkjxx_fptxx TitleInfo 必须发票头信息 └ byzd5 String 可选 5 备用字段 5 └ byzd4 String 可选 4 备用字段 4 └ byzd3 String 可选 3 备用字段 3 └ byzd2 String 可选 2 备用字段 2 └ byzd1 String 可选 1 备用字段 1 └ spbmjc_bz String 必须 1 商品编码简称 └ dybz String 必须 0 打印标志 └ bz String 可选备注备注 └ hjse String 可选 1.00 合计税额，所有商品行税额之和 └ hjbhsje String 可选 1.00 合计不含税金额，所有商品行不含税金额之和 └ kphjje String 必须 1.00 价税合计金额 └ tschbz String 必须 0 特殊冲红标志。0 正常冲红(电子发票蓝字发票开具、红字发票开具) 1 特殊冲红(冲红纸质等) └ chyy String 可选冲红冲红原因 └ qd_bz String 可选 0 清单标志 └ yfp_hm String 可选 01234567 原发票号码 └ yfp_dm String 可选 0123456789 原发票代码 └ fpzl_dm String 必须 51 发票种类代码。0:专票 2:普票 41:卷票 51:电子票 └ kprq String 可选 2020-01-01 00:00:00 开票日期。格式 YYYY-MM-DD HH:MM:SS └ kplx String 必须 1 开票类型。1-蓝票，2-红票 └ fhr String 可选张三复核人 └ sky String 可选张三收款员 └ kpy String 必须张三开票员 └ hy_mc String 可选餐饮行业名称 └ hy_dm String 可选 11 行业代码 └ ghf_email String 可选 xx@nn 购货方邮箱 └ ghf_sj String 可选 13011112222 购货方手机 └ ghf_yhzh String 可选 123412341234 购货方银行账号 └ ghf_dzdh String 可选深圳市南山区软件园购货方地址、电话 └ ghf_nsrsbh String 可选 2015020123185 购货方纳税人识别号 └ ghfmc String 必须张三购货方名称 └ ghfqylx String 必须 01 购货方企业类型。 └ xhf_yhzh String 可选 123412341234 销货方银行账号 └ xhf_dzdh String 必须深圳市南山区软件园销货方地址、电话 └ xhf_nsrsbh String 必须 2015020123123 销货方企业纳税人识别号 └ xhfmc String 必须测试企业销货方名称 └ bmb_bbh String 可选 33.0 编码表版本号 └ kpxm String 必须电视机主要开票项目 └ pydm String 可选 000001 票样代码。全部固定为”000001” └ sgbz String 可选 0 收购标志。收购发票必填，默认为空 └ dkbz String 必须 1 代开标志。自开(0)，代开(1) └ fjh String 可选 1 分机 └ swjg_dm String 可选 xxx 税务机构代码 └ nsrsbh String 必须 2015020123123 开票方纳税人识别号 └ nsrmc String 必须张三开票方纳税人名称 └ jffs String 必须 0 交付方式。0:不交付，1:手机邮件交付; └ cplx String 必须 0 产品类型。固定为 0 └ ddh String 必须 201808222100100134590603482 订单号 └ fpqqlsh String 必须 201808222100100134590603609 发票请求唯一流水号 └ req_index String 必须 123456 开票请求的唯一索引 fpkjxx_xmxxs ItemInfo [] 可选 http://*** 项目明细 └ fphxz String 必须 0 发票行性质 └ xmmc String 必须电视机项目名称 └ xmdw String 可选台项目单位 └ ggxh String 可选 55寸规格型号 └ xmsl String 可选 1 项目数量 └ hsbz String 必须 0 含税标志 └ xmdj String 可选 1.00 项目单价 └ spbm String 必须 001 商品编码 └ zxbm String 可选 002 自行编码 └ yhzcbs String 必须 1 优惠政策标识 └ lslbs String 可选 1 零税率标识 └ zzstsgl String 可选免税增值税特殊管理 └ xmje String 必须 1.00 项目金额 └ sl String 必须 0.01 税率 └ se String 必须 0.01 税额 └ kce String 可选 0.01 扣除额 └ byzd1 String 可选备用字段 1 备用字段 1 └ byzd2 String 可选备用字段 2 备用字段 2 └ byzd3 String 可选备用字段 3 备用字段 3 └ byzd4 String 可选备用字段 4 备用字段 4 └ byzd5 String 可选备用字段 5 备用字段 5
signtype	String	可选	1	签名方式
signature	String	可选	xxx	签名值

名称	类型	示例值	描述
resultCode	String	001	错误代码
msg	String	xxx	错误描述
interfaceCode	String	createInvoice	接口编码
zipCode	String	0	压缩标识
encryptCode	String	0	加密方式：0-不加密，2-CA加密
access_token	String	ALI	平台编码
datagram	String	{}	数据对象
signtype	String	1	签名方式
signature	String	xxx	签名值
success	String	success	成功标识

{"access_token":"ALI","zipCode":"0","signature":"xxx","datagram":{"fpkjxx_fptxx":{"dybz":"0","kplx":"1","hy_dm":"11","byzd5":"5","tschbz":"0","yfp_dm":"0123456789","byzd2":"2","byzd1":"1","yfp_hm":"01234567","byzd4":"4","byzd3":"3","cplx":"0","sgbz":"0","ghf_sj":"13011112222","ghf_email":"xx@nn","sky":"张三","fjh":"1","ghf_nsrsbh":"2015020123185","ghfmc":"张三","kpxm":"电视机","xhf_yhzh":"123412341234","dkbz":"1","nsrsbh":"2015020123123","kpy":"张三","ghfqylx":"01","jffs":"0","xhfmc":"测试企业","xhf_dzdh":"深圳市南山区软件园","fpqqlsh":"201808222100100134590603609","kphjje":"1.00","xhf_nsrsbh":"2015020123123","bmb_bbh":"33.0","kprq":"2020-01-01 00:00:00","bz":"备注","hjbhsje":"1.00","spbmjc_bz":"1","qd_bz":"0","hjse":"1.00","swjg_dm":"xxx","pydm":"000001","nsrmc":"张三","fpzl_dm":"51","ddh":"201808222100100134590603482","chyy":"冲红","ghf_dzdh":"深圳市南山区软件园","fhr":"张三","hy_mc":"餐饮","ghf_yhzh":"123412341234","req_index":"123456"},"hddz":"https://xx.com","fpkjxx_xmxxs":[{"ggxh":"55寸","xmdj":"1.00","yhzcbs":"1","zzstsgl":"免税","xmje":"1.00","byzd5":"备用字段 5","kce":"0.01","byzd2":"备用字段 2","byzd1":"备用字段 1","byzd4":"备用字段 4","byzd3":"备用字段 3","xmdw":"台","zxbm":"002","fphxz":"0","lslbs":"1","hsbz":"0","se":"0.01","xmmc":"电视机","xmsl":"1","sl":"0.01","spbm":"001"}]},"signtype":"1","encryptCode":"0","interfaceCode":"createInvoice"}

{
    "resultCode":"001",
    "msg":"xxx",
    "interfaceCode":"createInvoice",
    "zipCode":"0",
    "encryptCode":"0",
    "access_token":"ALI",
    "datagram":"{}",
    "signtype":"1",
    "signature":"xxx",
    "success":"success"
}

{"msg":"Illegal request","success":"不等于success","resultCode":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

电子发票

qimen.alibaba.einvoice.hangxin.invoice.create (航信开票申请)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ