当前位置: API文档

查询开票数据(vip_invoice_info_query.php)

¥增值 

1.接口说明

1.1 接口描述:获取税控等开发票系统需要的开票数据
1.2 适用版本:客户端 V2.4.3.0及以上版本
1.3 增量获取:按照ERP中发票的最后修改时间增量获取数据,请求时输入start_time和end_time作为时间跨度的筛选条件。
1.4 时间跨度:start_time和end_time最大跨度为30天。
1.5 注意事项:淘宝、天猫的开票数据无法从本接口获取,如需开票请联系旺店通销售开通“阿里电子发票”增值功能进行发票的开具。

2.调用场景

2.1 开票系统(金壬、航天金税等)接入ERP

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://sandbox.wangdian.cn/openapi2/vip_invoice_info_query.php
正式环境http://api.wangdian.cn/openapi2/vip_invoice_info_query.php


   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString
本开放平台“自助对接”功能模块内自助申请,申请流程单击这里
时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度
必须描述
开始时间start_timedata

按最后修改时间增量获取数据,start_time作为开始时间,格式: YYYY-MM-DD HH:MM:SS
结束时间end_timedata

按最后修改时间增量获取数据,end_time作为结束时间,格式: YYYY-MM-DD HH:MM:SS
分页大小page_sizeint

每页返回的数据条数,默认30,最大100条单击这里
页号page_noint

不传值默认从0页开始
发票状态statusint4

输入可选值:0  已取消  60 待开票  80 开票成功

开票服务商子类别category_orderint11
可选值:1 金壬 (纸质票)399其他(电子票,除阿里电子发票之外的服务商使用)
店铺编号shop_novarchar40按照店铺维度进行数据请求,V2.4.3.0及以上版本可使用此参数请求
订单编号trade_novarchar40
发票对应的erp系统内生成的销售订单编号
原始订单号src_tidvarchar255发票对应的平台的销售订单编号,ERP系统手工新建订单
发票编号invoice_novarchar20发票编号,ERP系统内部自动生成,在ERP发票管理为唯一编号

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint11状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint11只有page_no = 0 时才返回的符合条件的数据总条数,用来分页
发票列表节点infodata[ ]

响应参数的1级数据节点,包含当前页的xxxx的数据节点,节点下数据字段详见下述“xxx”节点和"xxx"节点

   4.2 业务响应参数

       info

名称字段类型长度
必须描述
发票idinvoice_idint11

发票主键
发票编号invoice_novarchar20系统内部自动生成的发票编号,ERP发票管理唯一
订单IDtrade_idint11
ERP内系统订单id,系统订单主键
订单编号trade_novarchar40ERP内订单编号
店铺编号shop_novarchar20店铺编号
店铺名称shop_namevarchar128店铺名称(待新增)
下载地址file_pathvarchar1024
下载地址
发票状态statustinyint
4

发票状态值:0  已取消 60 待开票 80 开票成功

发票红蓝字typetinyint
4 1 蓝字发票; 2 红字发票
抬头类型
payer_typetinyint
4发票抬头类型 1 商家对个人开具 2 商家对企业开具
发票抬头payer_namevarchar64订单付款方的名称
税务登记证号payer_register_novarchar40付款方税务登记证号,如果对企业开具,必填
付款方联系电话payer_phonevarchar20付款方联系电话,如果为增值税专用发票的话,必填
付款方emailpayer_emailvarchar64付款方email
地址payer_addressvarchar255付款方地址
银行名称payer_bankvarchar255付款方银行名称
银行账户
payer_accountvarchar20付款方银行账户
开票人payee_operatorvarchar20开票人
收款人payee_receivervarchar20收款人
复核人payee_checkervarchar20复核人
收件人receiver_namevarchar20收件人
收件人联系方式receiver_phonevarchar20收件人联系电话
收件人地址receiver_addressvarchar255收件人详细地址
总金额invoice_amountdecimal(19,4)开票总金额(实际合计金额+实际合计税额)
合计金额goods_amountdecimal(19,4)货品合计金额(未扣除折扣)等于明细中sum_price的总和
合计税额goods_taxdecimal(19,4)货品合计税额(未扣除折扣)等于明细中tax的总和
税前折扣金额 discountdecimal(19,4)税前折扣金额 等于明细中discount的总和
折扣税额discount_taxdecimal(19,4)折扣税额等于明细中discount_tax的总和
实际合计金额sum_pricedecimal(19,4)实际合计金额(货品合计金额-税前折扣金额) goods_amount减去discount等于sum_price
实际合计税额sum_taxdecimal(19,4)实际合计税额(货品合计税额-折扣税额)goods_tax减去discount_tax等于sum_tax
发票备注invoice_remarkvarchar255发票备注
发票类型device_noint4发票类型:1普通发票 2增值税普通发票3增值专用税发票
发票种类invoice_categorytinyint4发票种类:0纸质发票 1电子发票
备注remarkvarchar255备注
收款方公司idpayee_idint11收款方公司id
收款方公司名称payee_namevarchar64收款方公司名称
收款方地址payee_addressvarchar255收款方地址
收款方联系电话payee_telnovarchar20收款方联系电话
收款方银行payee_bank_namevarchar64收款方银行
收款方银行账户payee_bank_accountvarchar64收款方银行账户
收款方备注payee_remarkvarchar255收款方备注
开票服务商idinvoice_provider_idint11开票服务商id
开票服务商名称invoice_provider_namevarchar40开票服务商名称
开票时间createdtimestamp
开票时间,格式: YYYY-MM-DD HH:MM:SS
最后修改时间modifiedtimestamp
发票最后修改时间,格式: YYYY-MM-DD HH:MM:SS
发票号码invoice_no_outvarchar20发票号码
发票代码invoice_codevarchar20发票代码
关联发票号码relation_invoice_no_outvarchar20红字发票对应蓝票的发票号码
关联发票代码relation_invoice_codevarchar20红字发票对应蓝票的发票代码
红字发票申请单号red_invoice_apply_novarchar40增值税专票红字冲销时的红字发票通知单号(待新增,V2.4.3.0及以上版本可响应此参数请求)
发票明细节点
detailsdata[ ]
响应参数的2级数据节点,包含系统发票明细所有属性信息的数据节点,节点下数据字段详见下述"details"

   details

名称字段类型长度
必须描述
发票项目名称item_namevarchar40发票项目名称,即商品名称
发票项目编码item_novarchar40发票项目编码,即规格编码
单位unitvarchar20单位
数量numdecimal(19,4)数量
税务编码tax_codevarchar40税务编码
税率tax_ratedecimal(19,4)税率
税前单价pricedecimal(19,6)税前单价(未扣除折扣)
税前总价sum_pricedecimal(19,4)税前总价(未扣除折扣)
税额taxdecimal(19,4)税额(未扣除折扣)
总价sum_amountdecimal(19,4)总价(未扣除折扣),税额+税前总价
税前折扣金额discountdecimal(19,4)税前折扣金额
折扣税额discount_taxdecimal(19,4)折扣税额
折扣总价discount_amountdecimal(19,4)折扣总价(折扣税额+税前折扣金额)
是否折扣discount_flagtinynit
4是否有折扣: 0 无  1 有
备注remarkvarchar255备注


5.请求示例

PHP

JAVA

C#

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "OK",
    "info": [
        {
            "invoice_id": "177",
            "invoice_no": "DZ201703170013",
            "trade_id": "7830975",
            "trade_no": "JY201703170005",
            "status": "50",
            "type": "1",
            "payer_type": "1",
            "payer_name": "123",
            "payer_register_no": "",
            "payer_phone": "1",
            "payer_email": "",
            "payer_address": "",
            "payer_bank": "",
            "payer_account": "",
            "payee_operator": "托马斯穆勒",
            "payee_receiver": "里贝里",
            "payee_checker": "罗本",
            "receiver_name": "",
            "receiver_phone": "132****4563",
            "receiver_address": "",
            "invoice_category": "1",
            "invoice_amount": "100.0000",
            "goods_amount": "66.6700",
            "goods_tax": "33.3300",
            "discount": "0.0000",
            "discount_tax": "0.0000",
            "sum_price": "66.6700",
            "sum_tax": "33.3300",
            "invoice_remark": "",
            "device_no": "2",
            "remark": "",
                        "invoice_no_out": "7890987890",                         
                        "invoice_code": "45678232",   
             "relation_invoice_no_out":"13789876"
            "payee_id": "13",
            "payee_name": "掌上先机网络科技有限公司",
            "payee_address": "花园路",
            "payee_telno": "1728732",
            "payee_bank_name": "工商银行",
            "payee_bank_account": "374238",
            "payee_remark": "掌上先机",
            "invoice_provider_id": "14",
            "invoice_provider_name": "阿里电子发票服务",
            "created": "2017-06-26 15:02:04",
            "modified": "2017-06-26 15:02:00",
            "details": [
                {
                    "item_name": "朵望鳕鱼肝油软胶囊-香草味30粒(0-1岁)",
                    "item_no": "M",
                    "unit": "台",
                    "num": "1.0000",
                    "tax_code": "1010401000000000000",
                    "tax_rate": "0.5000",
                    "price": "66.670000",
                    "sum_price": "66.6700",
                    "tax": "33.3300",
                    "sum_amount": "100.0000",
                    "discount": "0.0000",
                    "discount_tax": "0.0000",
                    "discount_amount": "0.0000",
                    "discount_flag": "0",
                    "remark": ""
                }
            ]
        }
    ],
    "total": "1"

   6.2 异常响应示例

JSON
{
    "code": 1060,
    "message": "充值余额为0或应用已欠费,请联系商务充值 "
}



常用工具