API文档

vip_stockout_sales_weight_push.php（重量回传）

¥标准

1.接口说明

1.1 接口描述：将重量回传写入旺店通ERP销售订单

1.2 适用版本：网页版

2.调用场景

2.1 举例说明：自动化称重机、自动化分拣系统、仓储设备控制系统等称重以后，将重量回传写入ERP销售订单出库单。

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/vip_stockout_sales_weight_push.php
正式环境	https://openapi.huice.com/openapi/vip_stockout_sales_weight_push.php

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	appkey	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里
时间戳	timestamp	int	是	秒级时间戳, 当前时间戳减去 1970-01-01 08:00:00起, 时间与服务器时间差120s内即合法。
签名	sign	String	是	API输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
物流单号	logistics_no	varchar		是	物流单号
重量	weight	decimal	(19,4)	是	重量重量必须转成kg
校验重量是否超限	is_setting	tinyint	1	否	0：不校验，1：校验，默认为0不进行校验（重量超限校验根据客户端配置进行校验，路径：配置>基本设置>称重超限提示
是否判断退款状态	is_check_trade_status	tinyint	1	否	0：不判断，1判断；默认为0
打包员编号	packager_no	varchar	40	否	打包员编号
长	length	decimal	(19,4)	否	只需要写入数字，单位cm
宽	width	decimal	(19,4)	否	只需要写入数字，单位cm
高	height	decimal	(19,4)	否	只需要写入数字，单位cm

4.响应参数

4.1公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
物流类型	logistics_name	String	40	否	物流名称
物流通道编码	channel_no	String	64	否	物流公司的通道编码
物流方式	logistics_type	smallint	6	否	响应值为代表物流方式的数字 sheet页枚举中系统物流公司编码

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ""; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/vip_stockout_sales_weight_push.php'; $c->putApiParam('logistics_no', '8888888888887'); $c->putApiParam('weight', '1.15'); $c->putApiParam('is_check_trade_status', 0);//是否判断退款状态。0：不判断，1判断；默认为0 $c->putApiParam('is_setting', 1);//校验重量是否超限。0：不校验，1：校验，默认为0 $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

JSON	{ "code": 0, "message": "", "channel_no": "", "logistics_name": "中通快递2", "logistics_type": "54" }

JSON	{ "code": 11000301, "message": "订单已发货，发货时间：2026-03-13 15:33:37 操作人：openapi", "channel_no": null, "logistics_name": null, "logistics_type": null }

常用工具