开具发票查询

接口说明

该接口作为异步通知接口补充，开发者可通过此接口查询订单开票信息（正常情况下平台将通过异步通知返回开票结果，如无特殊情况无需调用该接口）。

地址

/tax-api/invoice/query/v1

请求参数

参数名称	类型	必填	最大长度	描述	示例
seller_taxpayer_num	string	是	20	销方纳税人识别号（销方票面信息）：即统一社会信用代码（一般是15、17、18、20位长度位数字或大写字母，字母I、O、S、V、Z除外）	91469027MA5RH09M0R
order_id	string	否	64	商户订单号：开发者接入方业务订单唯一标识(开具蓝票开具时填入值)此字段与order_sn不能同时为空	gd_1904242006002627690
order_sn	string	否	64	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识(开具蓝票时返回值)此字段与order_id不能同时为空	6590128277141372177
is_red	uint8	否	1	发票种类： 0：蓝票 1：红票【该字段默认为0， 如果需要查询红票信息，本字段必须传1，否则可能查询不到需要的发票信息】	0

响应参数

字段	类型	必须	说明
order_id	string	是	商户订单号：开发者接入方业务订单唯一标识，此字段与order_sn不会同时为空
order_sn	string	是	高灯方商户订单号：开发者商户订单号对应的高灯方商户订单唯一标识，此字段与order_id不会同时为空
status	string	是	发票状态 0：无效状态 1：开票中 2：开票失败 3：开票成功 4：开票成功作废中 5：开票成功作废失败 6：开票成功作废成功
message	string	是	开票描述
ticket_date	string	是	开票日期
ticket_sn	string	是	发票号码
ticket_code	string	是	发票代码
check_code	string	是	检验码
amount_with_tax	string	是	含税金额(元)
amount_without_tax	string	是	不含税金额(元)
tax_amount	string	是	税额(元)
is_red_washed	string	是	是否被红冲：0、未红冲，1、已红冲
pdf_url	string	是	版式文件地址

请求示例

{
    "order_sn":"6561574963747404440",
    "seller_taxpayer_num":"111112222233333"
}

响应示例

{
    "code": 0,
    "data": {
        "order_sn": "6561574963747404440",
        "status": 5,
        "message": "SUCCESS",
        "ticket_date": "2019-07-29",
        "ticket_sn": "00253001",
        "ticket_code": "845031909110",
        "check_code": "ddf94",
        "amount_with_tax": "103",
        "amount_without_tax": "100",
        "tax_amount": "3",
        "is_red_washed": 0,
        "pdf_url": "https://upload.yewifi.com/center/prod_make/20190729/invoice_845031909110_00253001_dbaf0828c92d4785dc38359cdb687fce.pdf"
    },
    "message": "success"
}