当前位置: API文档

stock_transfer_query.php(查询调拨单)

¥标准

1.接口说明

1.1 接口描述:获取旺店通ERP的调拨及货品明细信息
1.2 适用版本:客户端 V2.6.0.8及以上版本
1.3 增量获取:按照旺店通ERP调拨单的最后修改时间增量获取数据,请求时输入start_time和end_time作为时间跨度的筛选条件。
1.4 时间跨度:start_time和end_time最大跨度为30天,开始时间和结束时间取值范围为闭区间取值,例如2018-11-01 00:00:00至2018-11-30 23:59:59,建议根据获取数据量的多少适当减小时间跨度。
1.5 注意事项:请求参数如果不传值返回所有调拨单数据,如果传值根据所传参数返回调拨单数据。

2.调用场景

2.1 线下ERP、财务系统、数据分析等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://sandbox.wangdian.cn/openapi2/stock_transfer_query.php
正式环境https://api.wangdian.cn/openapi2/stock_transfer_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 业务请求参数

名称字段类型长度必须描述
源仓库from_warehouse_novarchar40源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
目标仓库to_warehouse_novarchar40目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
调拨单号transfer_novarchar20系统调拨单的编号,默认TF开头
调拨单状态statustinyint4调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成  (不传该字段默认返回全部状态的单据)
开始时间start_timedate
最后修改时间,例如:2000-01-01 00:00:00
结束时间end_timedate
最后修改时间,例如:2000-01-01 23:59:59
页码page_noint11页码,从0页开始,默认值0。page_no=0时,返回total_count
分页大小page_sizeint11每页返回条数,输入值范围1~100,不传此参数默认page_size=40,使用举例单击这里
外部API单号api_outer_novarchar40外部系统调拨单的唯一单据编号,需要按照时间和单号同时调用(创建调拨单时所传outer_no字段)

4.响应参数

   4.1 公共响应参数

名称字段类型长度必须描述
错误码codeint40状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint10符合条件的数据条数,用来分页 当page_no = 0 时返回
调拨单数据transfer_listdata[ ]
调拨单数据节点

   4.2 业务响应参数

   transfer_list

名称字段类型长度必须描述
调拨主键idtransfer_idint11调拨主键id
调拨单号transfer_novarchar20系统调拨单的编号,默认TF开头
调拨类型typetinyint4调拨类型(0:分步调拨,1:快速调拨)
调拨模式modetinyint4调拨模式(0单品调拨 1货位调拨 2明细调拨)
源仓库from_warehouse_novarchar40源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
目标仓库to_warehouse_novarchar40目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
主键rec_id int11
主键
锁定策略IDlock_idint11锁定策略ID
接口外部单号api_outer_novarchar40接口外部单号
调出仓储单号from_wms_order_novarchar40递交的出库仓库内的单号
出库外部单号outer_no1varchar40递交的出库委外单号
入库外部单号outer_no2varchar40递交的入库委外单号
调入仓储单号to_wms_order_novarchar40递交的入库仓库内的单号
仓储错误信息error_infovarchar255仓储错误信息
操作状态wms_statusint11操作状态0待处理  1推送失败 2推送成功  3接口取消成功  4服务器正在处理  5WMS返回发货信息  6异步标记,推送申请成功
调出仓库from_warehouse_idsmallint6调出仓库的id
目标仓库to_warehouse_id smallint6目标仓库的id,货位调拨时,与from_warehouse_id相等
目标仓库地址address varchar255目标仓库地址
物流方式logistics_id int11物流方式
调出货品金额out_goods_amountdecimal(19,4)调出货品金额(成本价之和)
调入货品金额(in_goods_amountdecimal(19,4)调入货品金额(成本价之和)
便签条数note_countsmallint6便签条数
标记flag_id  int11标记
调拨单状态statustinyint4调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成
外部单号outer_novarchar40同api_outer_no,接口外部单号
制单员IDcreator_idint11制单员ID
制单人姓名creator_namevarchar40调拨单管理的“创建者”字段
联系人contactvarchar40联系人
联系电话telnovarchar40联系电话
物流类型logistics_typesmallint6物流类型
物流编号logistics_novarchar20代表物流所有属性的唯一编码,用于物流区分,ERP内支持自定义(ERP物流界面设置)
物流名称logistics_namevarchar40旺店通里设置的物流公司名称
物流单号logistics_codevarchar40物流公司的运单号
货品数量goods_countdecimal(19,4)货品数量
货品种类数量goods_type_countdecimal(19,4)调拨单管理界面的“货品种类”字段
入库数量goods_in_countdecimal(19,4)入库数量
出库数量goods_out_countdecimal(19,4)出库数量
最后修改时间modifieddatedatetime最后修改时间,格式:YYYY-MM-DD HH:MM:SS
创建时间createddatedatetime创建时间,格式:YYYY-MM-DD HH:MM:SS
备注remarkvarchar255备注
目标仓库地址
to_warehouse_addressvarchar255目标仓库地址
sku详情节点details_listData[]
sku详情节点

   details_list

名称字段类型长度必须描述
调拨主键idtransfer_idint11调拨主键id
调拨明细主键idrec_idint11调拨明细主键id
货品编号goods_novarchar40代表SPU所有属性的唯一编号,用于系统货品的区分,SPU概念介绍,单击这里
商家编码spec_novarchar40代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里
规格码spec_codevarchar40规格码
规格名称spec_namevarchar100规格名称
单位unit smallint6单位
辅助数量num2decimal(19,4)辅助数量
货品规格spec_idvarchar40货品规格
计算平均成本价时的精度丢失cost_diff  decimal(19,4)计算平均成本价时的精度丢失
标记flag_idint11标记
 最后修改时间modified datetime
 最后修改时间
创建时间createddatetime
创建时间
条码barcodevarchar40条码
调出总成本out_cost_totaldecimal(19,4)调出总成本
批次IDbatch_idint11批次ID
货品批次batch_novarchar40
货品批次
批次备注batch_remarkvarchar255
批次备注
源货位from_positionvarchar20源货位
目标货位to_positionvarchar20目标货位
有效期expire_datedatedatetime有效期
库存stock_numdecimal(19,4)调拨时的库存(显示用,不做依据)
调拨数量numdecimal(19,4)调拨数量
出库数量out_numdecimal(19,4)出库数量
入库数量in_numdecimal(19,4)入库数量
基本单位unit_nameVarchar20基本单位
辅助单位aux_unit_nameVarchar20辅助单位
辅助数量aux_numdecimal(19,4)辅助数量
备注remarkvarchar255备注
品牌brand_namevarchar64品牌名称

5.请求示例

PHP
<?php
    require_once ('../WdtClient.php');
    $c = new WdtClient();
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/stock_transfer_query.php';
    
    $c->putApiParam('start_time', '2018-05-05 00:00:00');
    $c->putApiParam('end_time', '2018-05-30 23:59:59');
    $c->putApiParam('status', '40');
    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
package com.wangdian.api.stock;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import com.wangdian.api.WdtClient;

public class StokcTransferQuery {

    public static void main(String[] args) {
        // TODO Auto-generated method stub
        WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url");
        //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看,测试环境url=https://sandbox.wangdian.cn/openapi2/
        //调用正式环境时请将sid、appkey、appsecret切换为实际参数,参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看,调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/
        
        Map<String, String> params = new HashMap<String, String>();
        params.put("start_time", "2018-12-01 00:00:00");
        params.put("end_time", "2018-12-11 17:00:00");
        try {
            String response = client.execute("stock_transfer_query.php", params);
            System.out.println(response);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}
C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;

namespace StockTransferQuery
{
    class StockTransferQuery
    {
        static void Main(string[] args)
        {
            WdtClient client = new WdtClient();
            client.sid = "";
            client.appkey = "";
            client.appsecret = "";
            client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/stock_transfer_query.php";

            client.putParams("start_time", "2017-04-05 00:00:00");
            client.putParams("end_time", "2017-04-05 23:59:59");

            string result = client.wdtOpenapi();
            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}
python
import WdtClient

t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/')
params = {}
params.update({"transfer_no": ''})
params.update({"start_time": '2021-01-01 00:00:00'})
params.update({"end_time": '2021-01-01 00:59:59'})
params.update({"page_size": '40'})
params.update({"page_no": '0'})

response = t.execute("stock_transfer_query.php", params)
print(response)

6.响应示例

   6.1 正常响应示例 

JSON
{
	"code": 0,
	"transfer_list": [{
		"address": "北京北京市东城区区域间",
		"api_outer_no": "",
		"contact": "羊多多",
		"created": "2020-05-14 15:35:31",
		"creator_id": "25",
		"creator_name": "黄小强",
		"details_list": [{
			"aux_num": "1.0000",
			"aux_unit_name": "",
			"barcode": "20200513-2",
			"batch_id": "0",
			"batch_no": "",
			"batch_remark": "",
			"cost_diff": "0.0000",
			"created": "2020-05-14 15:35:31",
			"expire_date": "0000-00-00 00:00:00",
			"flag_id": "0",
			"from_position": "ZANCUN",
			"goods_no": "20200513-2",
			"in_num": "0.0000",
			"modified": "2020-05-14 15:35:31",
			"num": "1.0000",
			"num2": "1.0000",
			"out_cost_total": "0.0000",
			"out_num": "0.0000",
			"rec_id": "43",
			"remark": "",
			"spec_code": "",
			"spec_id": "2055",
			"spec_name": "默认规格",
			"spec_no": "20200513-2",
			"stock_num": "100.0000",
			"to_position": "ZANCUN",
			"transfer_id": "16",
			"unit": "0",
			"unit_name": ""
		}],
		"error_info": "",
		"flag_id": "0",
		"from_warehouse_id": "43",
		"from_warehouse_no": "hxq",
		"from_wms_order_no": "",
		"goods_count": "1.0000",
		"goods_in_count": "0.0000",
		"goods_out_count": "0.0000",
		"goods_type_count": "1",
		"in_goods_amount": "0.0000",
		"lock_id": "0",
		"logistics_code": "",
		"logistics_id": "60",
		"logistics_name": "zsy的物流",
		"logistics_no": "zsy001",
		"logistics_type": "2",
		"mode": "1",
		"modified": "2020-05-14 15:42:04",
		"note_count": "0",
		"out_goods_amount": "0.0000",
		"outer_no": "",
		"outer_no1": "",
		"outer_no2": "",
		"rec_id": "16",
		"remark": "",
		"status": "20",
		"telno": "",
		"to_warehouse_address": "北京北京市东城区区域间",
		"to_warehouse_id": "24",
		"to_warehouse_no": "SH-001",
		"to_wms_order_no": "",
		"transfer_id": "16",
		"transfer_no": "TF202005140001",
		"type": "0",
		"wms_status": "0"
	}],
	"total_count": 1,
	"message": "ok"
}

   6.2 异常响应示例

JSON
{
    "code": 2104,
    "message": "start_time与end_time时间跨度不能超过最大范围 30天"
}



常用工具