当前位置: API文档

finance.settle.process.search(生产结算单查询)

¥标准

1.接口说明

1.1 接口描述:获取ERP生产结算单信息
1.2 适用版本:客户端 V1.5.9.6及以上版本
1.3 增量获取:
1.4 时间跨度:

1.5注意事项:

2.调用场景

2.1 举例说明:自研商城、SCMSRM、财务系统、SAP等系统的对接

3.请求参数说明

   3.1 请求地址

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

  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
分页编号,分页查询必传,标准接口page_no从0开始
是否计算查询结果的总条数calc_totalInt
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数

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

查询参数

params

Map<String, Object>


查询参数

分页

pagerPager
分页

params

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

生产单号

process_no

String


生产单号

结算单号

settle_no

String


结算单号

生产商编码
producer_noString
生产商编码
开始时间
start_timeString
开始时间(生产结算单的创建时间)
结束时间end_timeString
结束时间(生产结算单的创建时间)

pager

名称字段类型长度
必须描述
分页大小page_sizeInt4分页大小,最大1000
页号page_noInt4

从0开始

4.响应参数

返回值为一个Map<String, Object>

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

状态码,0表示正常

错误信息messageString

无错误信息不返回

单据信息data

Map<String, Object>


单据信息

data

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

数据

order

List<Map<String, Object>>


明细数据

总数

total_count

Int

11

查询条件总单据数

order

名称字段类型长度
必须描述
结算单主键

settle_id

Int
结算单主键
结算单号

settle_no

String
结算单号
结算状态

status

String

结算状态

10:编辑中

20:待审核
30:已审核

40:已取消

生产商名称

producer_name

String
生产商名称
生产商编号

producer_no

String
生产商编号
生产商id

producer_id

Int
生产商id
生产单id

process_id

Int
生产单id
备注remarkString
备注
分摊其它费用is_share_other_fee
Int

分摊其它费用

0:否

1:是

货品总数goods_count
String
货品总数
原料成本
material_amountString
原料成本
生产费用
process_feeString
生产费用
其他费用
other_feeDecimal(19,4)
其他费用
建单时间
createdString
建单时间
结算单明细
detail_listList<Map<String, Object>>
结算单明细

detail_list

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

结算单主键

settle_idInt
结算单主键
生产单主键process_idInt
生产单主键

生产单号

process_no

String


生产单号

商家编码spec_noString
商家编码
残次品defectInt

残次品

0:正品

1:残次品

批次号
batch_noString
批次号
有效期
expire_dateString
有效期
单位
base_unit_nameString
单位
结算数量
settle_numDecimal(19,4)
结算数量
结算单价
costString
结算单价
参考成本
cost_priceString
参考成本
分配比例
proportionString
分配比例
结算总金额cost_totalString
结算总金额
分摊其他费用
share_other_feeString
分摊其他费用
入库结算单价
stockin_priceString
入库结算单价

5.请求示例

json格式请求报文

[{"start_time":"2025-05-16 13:48:29","end_time":"2025-06-14 13:48:29"}]
PHP
<php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
   
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
   
$parMap = new stdClass();
$parMap->start_time = "2025-05-16 13:48:29";
$parMap->end_time = "2025-06-14 13:48:29";

   
   
$pager = new Pager(1, 0, true);
$data = $client->pageCall("finance.settle.process.search", $pager, $parMap);
   
?>
JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON
{
    "data": {
        "total_count": 2,
        "order": [
            {
                "settle_id": 507,
                "settle_no": "JS202505280004",
                "status": 20,
                "producer_id": 30,
                "process_id": 2016,
                "goods_count": 2,
                "settler_id": 553,
                "remark": "自动结算,业务单号:PS2024121307",
                "producer_no": "PV2021120104",
                "producer_name": "nff333",
                "created": "2025-05-28 10:26:54",
                "is_share_other_fee": 0,
                "material_amount": "3.1936",
                "process_fee": "0.0000",
                "other_fee": "0.0000",
                "detail_list": [
                    {
                        "settle_id": 507,
                        "rec_id": 1001,
                        "process_id": 2016,
                        "spec_id": 8666,
                        "batch_no": "00PS2024121307DFH20250528cp002",
                        "expire_date": "",
                        "settle_num": 1,
                        "proportion": 0.4545,
                        "warehouse_id": 319,
                        "cost_total": 1.4514,
                        "stockin_price": 1.4514,
                        "process_no": "PS2024121307",
                        "spec_code": "cp002",
                        "spec_name": "",
                        "base_unit_id": 2,
                        "spec_no": "cp002",
                        "barcode": "cp002",
                        "remark": "",
                        "cost": "1.4514",
                        "defect": 0,
                        "cost_price": "11.1000",
                        "share_other_fee": "0.0000",
                        "warehouse_name": "nff正品仓",
                        "base_unit_name": "支"
                    },
                    {
                        "settle_id": 507,
                        "rec_id": 1002,
                        "process_id": 2016,
                        "spec_id": 8667,
                        "batch_no": "00PS2024121307DFH20250528cp003",
                        "expire_date": "",
                        "settle_num": 1,
                        "proportion": 0.5455,
                        "warehouse_id": 319,
                        "cost_total": 1.7421,
                        "stockin_price": 1.7421,
                        "process_no": "PS2024121307",
                        "spec_code": "cp003",
                        "spec_name": "",
                        "base_unit_id": 2,
                        "spec_no": "cp003",
                        "barcode": "cp003",
                        "remark": "",
                        "cost": "1.7421",
                        "defect": 0,
                        "cost_price": "6.5900",
                        "share_other_fee": "0.0000",
                        "warehouse_name": "nff正品仓",
                        "base_unit_name": "支"
                    }
                ]
            },
            {
                "settle_id": 506,
                "settle_no": "JS202505280003",
                "status": 20,
                "producer_id": 30,
                "process_id": 2016,
                "goods_count": 3,
                "settler_id": 553,
                "remark": "自动结算,业务单号:PS2024121307",
                "producer_no": "PV2021120104",
                "producer_name": "nff333",
                "created": "2025-05-28 09:56:24",
                "is_share_other_fee": 0,
                "material_amount": "4.3546",
                "process_fee": "0.0000",
                "other_fee": "0.0000",
                "detail_list": [
                    {
                        "settle_id": 506,
                        "rec_id": 998,
                        "process_id": 2016,
                        "spec_id": 8665,
                        "batch_no": "PS2024121307DFH20250528202505cp001",
                        "expire_date": "2025-05-30",
                        "settle_num": 1,
                        "proportion": 0.2666,
                        "warehouse_id": 319,
                        "cost_total": 1.1609,
                        "stockin_price": 1.1609,
                        "process_no": "PS2024121307",
                        "spec_code": "cp001",
                        "spec_name": "",
                        "base_unit_id": 2,
                        "spec_no": "cp001",
                        "barcode": "cp001",
                        "remark": "",
                        "cost": "1.1609",
                        "defect": 0,
                        "cost_price": "17.5800",
                        "share_other_fee": "0.0000",
                        "warehouse_name": "nff正品仓",
                        "base_unit_name": "支"
                    },
                    {
                        "settle_id": 506,
                        "rec_id": 999,
                        "process_id": 2016,
                        "spec_id": 8666,
                        "batch_no": "PS2024121307DFH20250528202505cp002",
                        "expire_date": "2025-05-31",
                        "settle_num": 1,
                        "proportion": 0.3333,
                        "warehouse_id": 319,
                        "cost_total": 1.4513,
                        "stockin_price": 1.4513,
                        "process_no": "PS2024121307",
                        "spec_code": "cp002",
                        "spec_name": "",
                        "base_unit_id": 2,
                        "spec_no": "cp002",
                        "barcode": "cp002",
                        "remark": "",
                        "cost": "1.4513",
                        "defect": 0,
                        "cost_price": "11.1000",
                        "share_other_fee": "0.0000",
                        "warehouse_name": "nff正品仓",
                        "base_unit_name": "支"
                    },
                    {
                        "settle_id": 506,
                        "rec_id": 1000,
                        "process_id": 2016,
                        "spec_id": 8667,
                        "batch_no": "PS2024121307DFH20250528202505cp003",
                        "expire_date": "2025-06-01",
                        "settle_num": 1,
                        "proportion": 0.4001,
                        "warehouse_id": 319,
                        "cost_total": 1.7422,
                        "stockin_price": 1.7422,
                        "process_no": "PS2024121307",
                        "spec_code": "cp003",
                        "spec_name": "",
                        "base_unit_id": 2,
                        "spec_no": "cp003",
                        "barcode": "cp003",
                        "remark": "",
                        "cost": "1.7422",
                        "defect": 0,
                        "cost_price": "6.5900",
                        "share_other_fee": "0.0000",
                        "warehouse_name": "nff正品仓",
                        "base_unit_name": "支"
                    }
                ]
            }
        ]
    },
    "status": 0
}

   6.2 异常响应示例

JSON

{
	"status": 100,
	"message": "参数中必须包含起止时间"
}










常用工具