当前位置: API文档
Y_stockout_order_query_trade.php(销售出库单)
奇门接口url wdt.stockout.order.query.trade
| 1.1 接口描述:查询销售出库单// Y目前没有走销售出库流程 目前没有,直接使用已发货的订单作为替代 |
| 1.2 时间跨度:时间跨度:start_time和end_time最大跨度为30天。建议根据获取数据量的多少适当减小时间跨度。 |
1.5注意事项:权限校验:【店铺、仓库权限】 为了达到保护用户隐私数据安全的目的,本接口不返回淘系、拼多多及系统供销平台订单数据,相关平台规则点击这里,淘系及系统供销平台数据获取办法点击这里,拼多多请自行对接平台获取。 本接口中涉及到用户隐私的字段数据仅有自有平台及线下平台订单返回。 |
2.调用场景
| 2.1 查询平台原始订单 |
| 环境 | HTTP地址 |
|---|---|
| 测试环境 | https://openapitest.huice.com/openapi/stockout_order_query_trade.php |
| 正式环境 | https://openapi.huice.com/openapi/stockout_order_query_trade.php |
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
| 接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
| 时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
| 签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
| 名称 | Y字段 | 描述 | 必须 |
| 开始时间 | start_time | 修改起始时间,若无订单号/物流单号,则为必填。示例:“ 2021-11-11 00:00:00” | 时间开始和结束 和系统单号不能同时为空 |
| 结束时间 | end_time | 修改结束时间,上同开始时间。示例:“ 2021-11-11 01:00:00” | |
| 时间类型 | time_type | 时间类型 默认不填为 修改时间 1 修改时间 2 发货时间 | 否 |
| 系统订单号 | src_order_no | 系统订单号,多个用,分隔 | 传入系统订单号可以不传时间 |
| 状态类型 | status_type | 1-已发货及以后 2-已审核及以后 默认已发货及以后 | |
| 是否仅获取库存数据 | fetch_stock_only | 1-是, 0-否, 默认为否 | |
| 分页大小 | page_size | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为100,使用举例单击这里 | 否 |
| 页号 | page_no | 页号,不传默认从0页开始 | 否 |
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
| 错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
| 错误描述 | message | varchar | 255 | 是 | 错误描述 |
| 条数 | total_count | varchar | 255 | 是 | 符合查询条件的总数量,只有page_no = 0 时才有值。 |
| 原始单节点 | stockout_list | data[] | 是 | 业务数据的一级节点,数组形式的订单数据,需要循环读取。 |
stockout_list
| 名称 | Y字段 | Y父级字段 | 是否必须 | 默认值 | 是否可变更 |
| 销售出库单id | stockout_id | 是 | 否 | ||
| 销售出库单号 | order_no | 是 | 否 | ||
| 订单状态 | status | 是 | 4 已取消(可恢复) 5 已取消 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货 | 是 | |
| 订单退款状态 | refund_status | 是 | 订单退款状态 0-无退款 1-申请退款 2-部分退款 3-全部退款 | ||
| 系统订单号 | src_order_no | 是 | 否 | ||
| 仓库id | warehouse_id | 是 | 是 | ||
| 出库时间 | consign_time | 是 | 是 | ||
| 包装费 | 无 | 是 | 是 | ||
| 邮资成本 | post_fee | 是 | 是 | ||
| 物流公司id | logistics_id | 是 | 是 | ||
| 物流编号 | logistics_no | 是 | 是 | ||
| 平台Id | platform_id | 点击查看平台ID详情 | |||
| 供应商编码 | provider_nick_no | 是 | 供应商编码 | 是 | |
| 订单来源 | trade_from | 是 | 订单来源1、API抓单2、手工建单3、导入4、复制订单5、接口推送6 、补发订单7、PDA选货开单8、分销补发订单 | ||
| 供应商名称 | provider_name | 是 | 供应商名称 | 是 | |
| 分销商编码 | fenxiao_nick_no | 是 | 分销商编码 | 是 | |
| 分销商名称 | fenxiao_nick_name | 是 | 分销商名称 | 是 | |
| 平台单号 | src_tids | 是 | |||
| 店铺id | shop_id | ||||
| 备注 | remark | 是 | 是 | ||
| 最后修改时间 | modified | 是 | 是 | ||
| 称重重量 | weight | 是 | 是 | ||
| 快递重量 | post_weight | 是 | 是 | ||
| 是否本系统发货 | trade_status_type | 1 平台发货 2 erp发货 | |||
| 是 | |||||
审单员姓名 | auditman_name | 是 | |||
货品总额 | goods_amount | 是 | |||
| 货品列表 | details_list | 是 | |||
| 销售出库明细id | rec_id | details_list | 是 | 否 | |
| 货品明细id | spec_id | details_list | 是 | 否 | |
| 原始子订单号 | src_oid | details_list | |||
| 子单原始单号 | src_tid | details_list | |||
| 子单退款状态 | refund_status | details_list | 是 | 子单退款状态 0-无退款,1-取消退款,2-已申请退款,3-等待退货,4-等待收货,5-退款成功 | |
| 出库单主键Id | stockout_id | details_list | |||
| 出库单明细id 关联系统订单id | src_order_detail_id | details_list | |||
| 系统订单明细id | stockin_detail_id | details_list | 是 | 否 | |
| 数量 | num | details_list | 是 | 是 | |
| 分摊邮费 | share_post | details_list | 否 | null | 是 |
| 分摊后总价 | share_amount | details_list | 是 | 是 | |
零售价 | retail_price | details_list | 是 | 零售价 | 是 |
| 商家编码 | spec_no | details_list | 是 | 是 | |
| 货品编号 | goods_no | details_list | 是 | 是 | |
| 规格编号 | spec_code | details_list | 是 | 是 | |
| 预估重量 | weight | details_list | 是 | 是 | |
| 成本价 | cost_price | details_list | 是 | 是 | |
| 销售价 | sell_price | details_list | 平台的销售价 | 是 | |
| 是否包装 | 无 | details_list | 是 | 否 | |
| 备注 | 无 | details_list | 是 | 是 | |
| 商品名称 | goods_name | details_list | 是 | 是 | |
| 规格名称 | spec_name | details_list | 是 | 是 | |
| 批次号 | 无 | details_list | 否 | null | 是 |
| 最后修改时间 | modified | details_list | 是 | 是 | |
| 删除标记 | details_list | 否 | 0 | 是 | |
| 出库批次号 | batch_no | details_list | 否 | 否 | |
| 主播id | anchor_id | details_list | 否 | 否 | |
| 主播名称 | anchor_name | details_list | 否 | 否 | |
| 组合装拆分合并标识 | suit_flag | details_list | 否 | 是 | |
| 组合装ID | suite_id | details_list | 否 | 0 | 是 |
| 货位批次明细数据 | position_list | details_list | 否 | 是 | |
| 出库单明细或者订单明细Id | stockout_order_detail_id | position_list | 否 | 是 | |
| 入库单号明细id | stock_spec_detail_id | position_list | 否 | 是 | |
| 货位主键id | rec_id | position_list | 否 | 是 | |
| 货位ID | position_id | position_list | 否 | 是 | |
| 批次号 | batch_no | position_list | 否 | 是 | |
| 有效期 | expire_date | position_list | 否 | 是 | |
| 生产日期 | production_date | position_list | 否 | 是 | |
| 出库数量 | num | position_list | 否 | 是 | |
| 成本价 | cost_price | position_list | 否 | 是 | |
| 最后修改时间 | modified | position_list | 否 | 是 |