当前位置: API文档
wms.stockout.PurchaseReturn.queryWithDetail(采购退货出库单查询)
1.1 接口描述:获取ERP采购退货出库单信息 |
1.2 适用版本:客户端 V1.2.5.6及以上版本 |
1.3 增量获取:支持增量获取 |
1.4 时间跨度:start_time和end_time最大跨度为30天 |
1.5 注意事项:【权限校验】:仓库权限 |
2.1举例说明:财务系统、SAP、线下ERP、数据分析等系统的对接 |
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/ |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | Y | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | Y | 由旺店通分配appkey, 在发送的数据中对应 key 字段 | |
盐 | salt | String | Y | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | Y | 调用的接口名称 | |
版本号 | v | String | Y | 1.0 | |
秒级时间戳 | timestamp | int | Y | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | Y | 签名 | |
分页大小 | page_size | int | N | 分页大小,分页查询必传 | |
分页编号 | page_no | int | N | 分页编号,分页查询必传 | |
是否计算查询结果的总条数 | calc_total | int | N | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
查询参数 | params | Map<String, Object> | Y | 查询参数 | |
分页 | pager | Pager | Y | 分页 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
开始时间 | out_start_time | String | 40 | N | 起始时间(出库时间),若无出库单号或采购退货单号,则为必填。 |
结束时间 | out_end_time | String | 40 | N | 结束时间(出库时间),上同开始时间 |
开始时间 | create_start_time | String | 40 | N | 起始时间(出库单创建时间),若无出库单号或采购退货单号,则为必填。 |
结束时间 | create_end_time | String | 40 | N | 结束时间(出库单创建时间),上同开始时间 |
仓库编号 | warehouse_no | String | 40 | N | 限普通仓库 |
出库单号 | stockout_no | String | 40 | N | 出库单号 |
采购退货单号 | src_order_no | String | 40 | N | 采购退货单号 |
是否按货位分组 | position | Int | N | 等于0为否,不等于0为是,不填为否 | |
出库单状态 | status | String | 40 | N | 由逗号分隔的整数数组 出库单状态: |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
分页大小 | page_size | Int | 4 | N | 分页大小 |
页号 | page_no | Int | 4 | N | 从0开始 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | Y | 返回0为正常 | |
错误信息 | message | String | Y | 无错误信息不返回 | |
出库单信息 | data | Map<String, Object> | N | 出库信息 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
总数 | total_count | Int | 11 | N | 查询条件总单据数 |
单据数据 | order | List<Map<String, Object>> | Y | 出库单相关数据 |
字段名称 | 字段类型 | 长度 | 描述 | 是否必填 |
---|---|---|---|---|
stockout_id | Int | 11 | 出库单id | Y |
order_no | String | 40 | 出库单号 | Y |
src_order_no | String | 40 | 采购退货单号 | Y |
warehouse_no | String | 40 | 仓库编号 | Y |
consign_time | String | 40 | 发货时间 | Y |
goods_count | Decimal(19,4) | 货品数量 | Y | |
logistics_no | String | 40 | 物流编号 | Y |
post_fee | Decimal(19,4) | 预估邮费 | Y | |
package_fee | Decimal(19,4) | 包装费 | Y | |
receiver_name | String | 40 | 收货人姓名 | Y |
receiver_province | Int | 11 | 省份id | Y |
receiver_city | Int | 11 | 城市id | Y |
receiver_district | Int | 11 | 地区id | Y |
receiver_address | String | 256 | 收件人地址 | Y |
receiver_telno | String | 40 | 固话 | Y |
remark | String | 255 | 备注 | Y |
weight | Decimal(19,4) | 重量 | Y | |
provider_no | String | 20 | 供应商编号 | Y |
provider_name | String | 64 | 供应商名称 | Y |
last_load_purchase_no | String | 20 | 最后一次引用的采购单号 | Y |
goods_total_cost | Decimal(19,4) | 总成本价 | Y | |
goods_total_amount | Decimal(19,4) | 总货款 | Y | |
details_list | List<Map<String, Object>> | 出库单明细 | Y |
字段名称 | 字段类型 | 长度 | 描述 | 是否必填 |
---|---|---|---|---|
rec_id | Int | 11 | 出库单明细ID(主键) | Y |
stockout_id | Int | 11 | 出库单ID | Y |
spec_no | String | 40 | 商家编码 | Y |
goods_count | Decimal(19,4) | 货品数量 | Y | |
total_amount | Decimal(19,4) | 货品总额 | Y | |
sell_price | Decimal(19,4) | 折后价 | Y | |
remark | String | 255 | 备注 | Y |
brand_no | String | 32 | 品牌编号 | Y |
brand_name | String | 64 | 品牌名称 | Y |
goods_name | String | 255 | 货品名称 | Y |
goods_no | String | 40 | 货品编号 | Y |
spec_name | String | 100 | 规格名 | Y |
spec_code | String | 40 | 规格码 | Y |
cost_price | Decimal(19,4) | 成本价 | Y | |
weight | Decimal(19,4) | 重量 | Y | |
goods_type | Int | 11 | 货品类型 | Y |
goods_unit | String | 20 | 单位 | Y |
batch_no | String | 40 | 批次号 | Y |
expire_date | String | 40 | 如果没有则返回空字符串 | Y |
position_no | String | 20 | 货位编号 | Y |
position_goods_count | Decimal(19,4) | 默认货位货品数,传入参数(position)不为0时返回 | Y |
{ "status": 0, "data": { "total_count": 4, "order": [{ "order_no": "CK2019122517", "details_list": [{ "rec_id": 22316, "stockout_id": 8193, "spec_no": "daba1", "goods_count": 2.0000, "total_amount": 2.0000, "sell_price": 1.0000, "remark": "", "brand_no": "BRAND", "brand_name": "无", "goods_name": "美国原装进口rumbatime手表女正品腕表女石英表防水宝石时尚123", "goods_no": "daba1", "spec_name": "默认规格123", "spec_code": "红宝石123", "cost_price": 0.4400, "weight": 10.0000, "goods_type": 1 }], "consign_time": 1577240320000, "post_fee": 0.0000, "receiver_city": 0, "goods_type_count": 1, "remark": "", "goods_count": 2.0000, "stockout_id": 8193, "src_order_no": "CR201912250001", "warehouse_no": "zmw01", "receiver_telno": "", "receiver_zip": "", "receiver_name": "", "receiver_country": 0, "provider_name": "小饼干供应商", "provider_no": "1108", "seq_no": 1, "receiver_area": "", "create_time": 1577240319000, "receiver_province": 0, "logistics_no": "", "receiver_district": 0, "weight": 0.0000, "goods_total_amount": 2.0000, "receiver_mobile": "", "operator_name": "张美薇", "goods_total_cost": 0.8800, "last_load_purchase_no": "", "receiver_address": "", "status": 110 }, { "order_no": "CK2019122511", "details_list": [{ "rec_id": 22312, "stockout_id": 8189, "spec_no": "daba3", "goods_count": 20.0000, "total_amount": 0.0000, "sell_price": 0.0000, "remark": "", "brand_no": "BD201807130002", "brand_name": "牛牛2", "goods_name": "阳台桌椅真藤椅茶几三件套五件套组合庭院户外花园客厅阳台藤椅子", "goods_no": "daba3", "spec_name": "默认规格", "spec_code": "藤椅*1", "cost_price": 5.8385, "weight": 1.2500, "goods_type": 1 }], "consign_time": 1577238894000, "post_fee": 0.0000, "receiver_city": 0, "goods_type_count": 1, "remark": "", "goods_count": 20.0000, "stockout_id": 8189, "src_order_no": "CR201912240001", "warehouse_no": "zmw01", "receiver_telno": "", "receiver_zip": "", "receiver_name": "", "receiver_country": 0, "provider_name": "小饼干供应商", "provider_no": "1108", "seq_no": 2, "receiver_area": "", "create_time": 1577238890000, "receiver_province": 0, "logistics_no": "", "receiver_district": 0, "weight": 0.0000, "goods_total_amount": 0.0000, "receiver_mobile": "", "operator_name": "张美薇", "goods_total_cost": 116.7700, "last_load_purchase_no": "", "receiver_address": "", "status": 110 }] } } |
{ "status": 100, "message": "参数中必须包含起止时间" } |