当前位置: API文档

stock_transfer_query.php(查询调拨单)

¥标准

1.接口说明

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

2.调用场景

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

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://sandbox.wangdian.cn/openapi2/stock_transfer_query.php
正式环境http://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=30,使用举例单击这里

4.响应参数

   4.1 公共响应参数

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

   4.2 业务响应参数

   trade_list

名称字段类型长度必须描述
调拨主键idtransfer_idint11调拨主键id
调拨单号transfer_novarchar20系统调拨单的编号,默认TF开头
调拨类型typetinyint4调拨类型(0:分步调拨,1:快速调拨)
调拨模式modetinyint4调拨模式(0单品调拨 1货位调拨 2明细调拨)
源仓库from_warehouse_novarchar40源仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
目标仓库to_warehouse_novarchar40目标仓库编号,代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置)
调拨单状态statustinyint4调拨单状态10已取消 20编辑中 30待审核 40已审核 42出库单待推送 44出库单推送失败 46待出库 50部分出库 60全部出库 62入库单待推送 64入库单推送失败 66待入库 70部分入库 80待结算 90调拨完成
外部单号outer_novarchar40外部单号
制单人姓名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
商家编码spec_novarchar40代表所单品(sku)所有属性的唯一编码,用于获取系统单品的数据,SKU概念介绍,单击这里
规格码spec_codevarchar40规格码
规格名称spec_namevarchar100规格名称
条码barcodevarchar40条码
批次IDbatch_idint11批次ID
源货位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备注

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("", "", "", "");
        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();
        }
    }
}

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "total_count": "1",
    "transfer_list": [{
        "transfer_id": "38",
        "transfer_no": "TF201905180002",
        "type": "0",
        "mode": "0",
        "status": "40",
        "contact": "",
        "telno": "",
        "goods_count": "5.0000",
        "goods_type_count": "1",
        "goods_in_count": "0.0000",
        "goods_out_count": "0.0000",
        "modified": "2019-05-18 19:03:08",
        "created": "2019-05-18 18:46:07",
        "remark": "",
        "outer_no": "WBTF201905180001",
        "from_warehouse_no": "xyp2test",
        "to_warehouse_no": "xyp22test",
        "logistics_no": "",
        "logistics_name": "无",
        "logistics_type": "0",
        "logistics_code": "",
        "creator_name": "外部接口",
        "to_warehouse_address": "北京 北京市 朝阳区",
        "details_list": [{
            "rec_id": "61",
            "transfer_id": "38",
            "expire_date": "0000-00-00 00:00:00",
            "batch_id": "0",
            "stock_num": "95.0000",
            "num": "5.0000",
            "out_num": "0.0000",
            "in_num": "0.0000",
            "remark": "",
            "aux_num": "0.0000",
            "spec_no": "WDTPDA-BLACK006",
            "spec_code": "BLACK006",
            "spec_name": "旺店通手持终端黑色006型",
            "barcode": "WDTPDA-BLACK006",
            "from_position": "ZANCUN",
            "to_position": "ZANCUN",
            "unit_name": null,
            "aux_unit_name": null
        }]
    }]
}

   6.2 异常响应示例

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



常用工具