当前位置: API文档

finance.settle.Purchase.search(采购结算单查询)

¥标准

1.接口说明

1.1 接口描:获取ERP采购结算单信息
1.2 适用版本:客户端 V1.2.2.8及以上版本
1.3 增量获取:支持
1.4 时间跨度:start_time和end_time最大跨度为30天。
1.5注意事项:【权限校验】:仓库权限

2.调用场景

2.1 举例说明:财务系统、SAP、线下ERP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数

名称字段类型长度
必须描述
查询参数paramsMap<String, Object>
Y

查询参数

分页pager

Pager


Y分页

params

名称字段类型长度
必须描述
仓库编号warehouse_noString40N

仓库编号

供应商编号provider_no

String

20N供应商编号
采购员姓名purchaser_name

String

50N采购员姓名
结算单号settle_no

String

64N结算单号
采购单号purchase_no

String

20N采购单号
结算单状态status

int


N10:编辑中,20:待审核,30:已审核,40 已取消.不传默认显示全部.
创建起始时间create_from

date


N创建起始时间
创建结束时间create_to

date


N创建结束时间
修改开始时间modified_from

date


N修改开始时间
修改结束时间modified_to

date


N修改结束时间

pager

名称字段类型长度
必须描述
分页大小page_sizeint4N

分页大小

页号page_no

int

4N从0开始

4.响应参数

名称字段类型长度
必须描述
状态码statusint

0表示调用成功,在调用错误时候不返回该值。

错误信息message

String


无错误信息不返回
单据数据
dataList<Map<String, Object>>
单据数据

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据淘系平台不返回,其他平台正常返回

名称字段类型长度
必须描述
单据数据

order

List<Map<String, Object>>


单据数据

总条数

total_count

int


总条数

order

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

总税额

tax_amount

Decimal(19,4)
Y
总税额

物流公司名称

logistics_type_name

String
Y物流公司名称,参考附录物流对照表

审核员

checker_name

String
Y审核员

运费

post_free

Decimal(19,4)


Y

运费

总金额

total_cost

Decimal(19,4)


Y

总金额

总货款

goods_amount

Decimal(19,4)


Y

总货款

创建时间

created

timestamp


Y

创建时间

发票号码

invoice_no

String


Y

发票号码

备注

remark

String


Y

备注

含税总货款

tax_goods_amount

Decimal(19,4)


Y

含税总货款

标记名称

flag_name

String


Y

标记名称

结算单号

settle_no

String


Y

结算单号

仓库编号

warehouse_no

String


Y

仓库编号

物流单号

logistics_no_list

String


Y

物流单号

是否分摊运费

is_share_post_fee

Decimal(19,4)


Y

是否分摊运费

发票类型

invoice_type

int


Y

0:无,1: 普通发票,2: 增值税发票,3: 专用增值税发票

状态

status

int


Y

状态

供应商编号

provider_no

String


Y

供应商编号

结算员

settler_name 

String


Y

结算员

结算单详情

detail_list

List<Map<String, Object>>


Y

结算单详情

detail_list




换算系数

unit_ratio

Decimal(19,4)


Y

采购单位与基本单位之间的换算系数

结算数量

settle_num

Decimal(19,4)


Y

结算数量

开票数量

invoice_num

Decimal(19,4)


Y

开票数量

单价

price

Decimal(19,4)


Y

单价

折扣

discount

Decimal(19,4)


Y

折扣

税前折扣价

dis_price

Decimal(19,4)


Y

税前折扣价

税率

tax_rate

Decimal(19,4)


Y

税率

含税单价

tax_price

Decimal(19,4)


Y

含税单价

税额

total_tax_amount

Decimal(19,4)


Y

税额

货款

total_amount

Decimal(19,4)


Y

货款

分摊运费

share_post_fee

Decimal(19,4)


Y

分摊运费

含税货款

tax_total_amount

Decimal(19,4)


Y

含税货款

采购单号

purchase_no

String


Y

采购单号

货品名称

goods_name

String


Y

货品名称

货品编号

goods_name

String


Y

货品编号

规格码

spec_code

String


Y

规格码

规格名称

spec_name

String


Y

规格名称

商家编码

spec_no

String


Y

商家编码

条码

barcode

String


Y

条码

供应商货号

provider_goods_no

String


Y

供应商货号

备注

remark

String


Y

备注

创建时间

created

timestamp


Y

创建时间

基本单位

unit_name

String


Y

基本单位

采购单位名称

purchase_unit_name

String


Y

采购单位名称

品牌名称

brand_name

String


Y

品牌名称

5.请求示例

Json格式请求报文
[{"warehouse_no":"1001" }]
PHP

<?php
header("Content-Type: text/html; charset=UTF-8");
require_once('wdtsdk.php');
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
$parMap = new stdClass();
$parMap->warehouse_no = "1001";

$pager = new Pager(1, 0, true);
$data = $client->pageCall("finance.settle.Purchase.search", $pager, $parMap);
$php_json = json_encode($data, JSON_UNESCAPED_UNICODE);
echo $php_json;
?>

JAVA

C#

6.响应示

   6.1 正常响应示例 

JSON

{
    "status":0,
    "data":{
        "total_count":392,
        "order":[
            {
                "tax_amount":3592.974,
                "purchase_no":"CG202006190001",
                "post_fee":555,
                "total_cost":16346.554,
                "detail_list":[
                    {
                        "unit_ratio":1,
                        "settle_num":3,
                        "invoice_num":3,
                        "price":1111,
                        "discount":0.98,
                        "dis_price":1088.78,
                        "tax_rate":1.1,
                        "tax_price":2286.438,
                        "total_tax_amount":3592.974,
                        "total_amount":3266.34,
                        "share_post_fee":244.5104,
                        "tax_total_amount":6859.314,
                        "purchase_no":"CG202006190001",
                        "goods_name":"赵阳的货品02 RPG",
                        "goods_no":"098812",
                        "spec_code":"",
                        "spec_name":"",
                        "spec_no":"088804",
                        "barcode":"",
                        "provider_goods_no":"",
                        "remark":"",
                        "created":1592794124000,
                        "unit_name":"个",
                        "purchase_unit_name":"无",
                        "brand_name":"无"
                    },
                    {
                        "unit_ratio":1,
                        "settle_num":4,
                        "invoice_num":4,
                        "price":2222,
                        "discount":0.98,
                        "dis_price":2177.56,
                        "tax_rate":0,
                        "tax_price":2177.56,
                        "total_tax_amount":0,
                        "total_amount":8710.24,
                        "share_post_fee":310.4896,
                        "tax_total_amount":8710.24,
                        "purchase_no":"CG202006190001",
                        "goods_name":"赵阳的货品01 M4A1",
                        "goods_no":"09811",
                        "spec_code":"",
                        "spec_name":"",
                        "spec_no":"088805",
                        "barcode":"",
                        "provider_goods_no":"",
                        "remark":"",
                        "created":1592794124000,
                        "unit_name":"个",
                        "purchase_unit_name":"无",
                        "brand_name":"赵阳品牌01"
                    }],
                "remark":"",
                "goods_count":7,
                "flag_name":"无",
                "settle_no":"JS202006220001",
                "is_share_other":true,
                "warehouse_no":"",
                "is_share_post_fee":true,
                "invoice_type":1,
                "other_total":222,
                "provider_no":"085400",
                "settler_name":"系统",
                "checker_name":"系统",
                "goods_amount":11976.58,
                "created":1592794124000,
                "invoice_no":"",
                "tax_goods_amount":15569.554,
                "stockin_no":"",
                "logistics_no_list":"",
                "logistics_type_name":"未知",
                "status":10
            }]
    }
}

   6.2 异常响应示例

JSON
{
"status": 100,
"message": "仓库不存在"
}




常用工具