文档中心 > 酒店通用分销

补开发票

更新时间:2024/07/02 访问次数:688

补开发票

方法名称

taobao.xhotel.order.distribution.invoicing

使用说明

概述

基于用户提供的开票信息,补开订单发票。

开票流程


注意事项

仅支持卖家开票商品

API入参

字段

类型

可为空

示例值

描述

dis_order_id

Number

Y

1234568

外部订单号,飞猪订单号与外部订单号不能都为空

hotel_invoice_do

Object

N


发票详细信息

ex_params

Map

Y


扩展信息

distributor

String

N

kuaipao

分销渠道

fliggy_order_id

Number

Y

3947227959157214604

飞猪订单号,飞猪订单号与外部订单号不能都为空

hotel_invoice_do节点

invoice_type枚举类型:
0, 增值税普通发票(纸质)
1, 增值税专用发票(纸质)
2, 增值税普通发票(电子)
21, 增值税普通发票(电子)
22, 增值税普通发票(电子)
23, 全电发票(普票)
24, 全电发票(专票)

字段

类型

可为空

示例值

描述

invoice_content

String

N

代订房费

开票内容,传递验价结果invoice_type中仍一

receiver_do

Object

Y


发票收件信息

invoice_type

Number

N

21

需要开票的类型,电子普票/纸质普票等,在验价结果support_invoice_type中选择

sp_invoice_do

Object

Y


专票信息,开专票或公司主体开票时必填

invoice_email

String

Y

yanwu@alibaba-inc.com

发票接收邮箱

invoice_category

String

N

1

开票主体,0:公司 ,1:个人

invoice_title

String

Y

飞猪网络技术有限公司

发票抬头,开专票或公司主体开票时必填

invoice_remark

String

Y


发票备注

receiver_do节点

纸质票需要邮寄时必填。

字段

类型

可为空

示例值

描述

receiver_address

String

Y

中国浙江省杭州市余杭区文一西路969号

发票收件人完整地址

receiver_tel

String

Y

18888888888

发票收件人联系电话

receiver_name

String

Y

言五

发票收件人姓名

express_payer_type

Number

Y

2

邮费承担方,0:未知,1:卖家承担,2:买家承担。在验价结果postage_provider中选择。

sp_invoice_do节点

开专票或公司主体开票时必填。

字段

类型

可为空

示例值

描述

account_no

String

Y

测试银行账户

银行账户

register_addr

String

Y

中国浙江省杭州市余杭区文一西路969号

公司注册地址

tel

String

Y

18888888888

公司电话

tax_no

String

Y

52430400MJJ1176700

公司税号,开专票或公司主体开票必填

opening_bank

String

Y

中国银行余杭支行

公司开户行

API出参

字段

类型

可为空

示例值

描述

result

Boolean

N


结果体,是否开票成功

is_success

Boolean

N

false

请求是否成功

error_msg

String

Y

系统异常,请稍后重试

错误信息

error_resp_code

Number

Y

101

错误码

msg_for_dev

String

Y

参数错误

开发查看的错误信息

atrributes

Map<String,String>

Y


扩展对象

错误码解释

错误码

解释

解决方案

101

请求参数有误

检查请求参数是否符合要求

105

税号不能为空

检查请求参数是否符合要求,开专票时,税号不能为空。

106

发票抬头不能为空

检查请求参数是否符合要求,开专票时,发票抬头不能为空。

111

该订单不属于此分销渠道,不可操作

检查请求订单号是否符合要求

113

专票信息(入参)不能为空

检查请求参数是否符合要求,公司主体开票或开专票时,专票信息不能为空。

207

商品上的发票规则为空,不允许补开发票

检查请求订单验价结果是否支持开票,若正常,联系飞猪同学排查

208

补开发票失败,发票由酒店前台开具

检查请求订单验价结果是否支持卖家开票,若正常,联系飞猪同学排查

209

不支持开具专票

检查请求订单验价结果是否支持开专票,若正常,联系飞猪同学排查

210

发票类型不支持

检查请求订单验价结果是否支持开该类发票,若正常,联系飞猪同学排查

220

发票内容不支持

检查请求订单验价结果是否支持开该类发票内容,若正常,联系飞猪同学排查

304

发票信息补开失败,请稍后重试

重试,若一直失败,联系飞猪同学排查。

FAQ

关于此文档暂时还没有FAQ
返回
顶部