Lingxing
切换旧版

查询入库单列表

POST/erp/sc/routing/storage/inbound/getOrders

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/inbound/getOrdersHTTPSPOST1

请求参数

offsetinteger
分页偏移量,默认0
lengthinteger
分页长度,默认20,上限200
widinteger
系统仓库id
search_field_timestring
日期筛选类型:
创建时间 create_time
入库时间 opt_time
更新时间 increment_time
start_datestring
日期查询开始时间,格式:Y-m-d
当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
end_datestring
日期查询结束时间,格式:Y-m-d
当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
order_snstring
入库单单号,多个使用英文逗号分隔
inbound_idempotent_codestring
客户参考单号,多个使用英文逗号分隔
statusinteger
入库单状态:
10 待提交
20 待入库
40 已完成
50 已撤销
121 待审批
122 已驳回
typeinteger
入库类型:
-1 其他入库(含所有自定义类型)
1 其他入库(非自定义类型)
2 采购入库
3 调拨入库
4 赠品入库
26 退货入库
27 移除入库

请求示例

{
    "offset": 0,
    "length": 20,
    "wid": "1",
    "search_field_time": "create_time",
    "start_date": "2024-07-30",
    "end_date": "2024-07-30",
    "order_sn": "IB240730005",
    "inbound_idempotent_code": "IB240730005",
    "status": 40,
    "type": 2
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 BD36FCD8-E32E-E9E1-6BEC-06DE331C95AB
response_timestring必填
响应时间
示例 2021-06-15 17:49:16
totalinteger必填
总数
示例 100
dataarray<object>必填
响应数据
隐藏子属性
increment_timestring必填
单据数据更新时间
示例 2021-08-22 10:14:46
custom_fieldsarray<object>必填
自定义字段
隐藏子属性
idstring必填
字段ID
namestring必填
字段名
val_textstring必填
字段值
opt_realnamestring必填
入库人姓名
opt_timestring必填
入库时间
示例 2021-08-22 10:14:46
opt_uidinteger必填
操作人id
示例 475
inbound_timestring必填
自定义入库时间
示例 2022-12-02 12:14:46
commit_realnamestring必填
提交人名称
commit_uidinteger必填
提交人id
示例 475
commit_timestring必填
提交时间
示例 2021-08-22 10:14:46
order_snstring必填
入库单号
示例 IB210822001
statusinteger必填
入库单状态
status_textstring必填
入库单状态名称
create_timestring必填
创建时间
示例 2021-08-22 10:14:46
create_uidinteger必填
创建人id
create_realnamestring必填
创建人名称
purchase_order_snstring必填
采购单号
custom_purchase_order_snstring必填
采购单自定义单号
receipt_order_snstring必填
收货单号
示例 CR230825001
revoke_realnamestring必填
撤销人名称
revoke_uidinteger必填
撤销人id
revoke_timestring必填
撤销时间
supplier_idstring必填
供应商id
supplier_namestring必填
供应商名称
示例 1
source_snstring必填
关联单据号
order_amountstring必填
单据入库成本
示例 100.00
cg_uidinteger必填
采购员id
return_pricestring必填
运费
示例 0.00
currencystring必填
运费币种
other_feestring必填
其他费用
示例 0.00
fee_part_typestring必填
费用分摊方式
示例 不分配
fee_part_type_textstring必填
费用分摊方式名称
typeinteger必填
入库类型
type_textstring必填
入库类型名称
示例 其他入库
custom_type_idinteger必填
自定义类型ID
示例 0
custom_type_namestring必填
自定义类型名称
示例 ""
cg_realnamestring必填
采购员姓名
widstring必填
仓库id
ware_house_namestring必填
仓库名称
示例 仓库2
remarkstring必填
单据备注
inbound_idempotent_codestring必填
(入库单)客户参考号, 该字段校验唯一不可重复
item_listarray<object>必填
产品明细
隐藏子属性
product_namestring必填
品名
示例 痛仰
skustring必填
sku
示例 sku-1
fnskustring必填
fnsku
seller_idstring必填
系统店铺id
purchase_item_idinteger必填
采购单子项id
示例 45
pricestring必填
采购单价
示例 10.0000
amountstring必填
入库成本
示例 100.00
fee_coststring必填
费用
示例 0.00
product_good_numinteger必填
良品量
示例 10
product_bad_numinteger必填
次品量
product_qc_numinteger必填
待检量
product_totalinteger必填
入库量
示例 10
product_amountsstring必填
货值
示例 100.00
single_feestring必填
单位费用
示例 0.0000
single_stock_coststring必填
单位入库成本
示例 10.0000
product_remarkstring必填
产品备注
示例 产品备注
custom_fieldsarray<object>必填
自定义字段
隐藏子属性
idstring必填
字段ID
namestring必填
字段名
val_textstring必填
字段值

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "26BEDD0E-4DC9-F663-7E29-4C0C66142D50",
    "response_time": "2024-07-31 16:16:52",
    "data": [
        {
            "order_sn": "IB240730005",
            "wid": 1,
            "purchase_order_sn": "PO240729025",
            "custom_purchase_order_sn": "",
            "opt_uid": 61,
            "opt_time": "2024-07-30 10:20:42",
            "inbound_time": "2024-07-30 10:20:42",
            "create_uid": 61,
            "create_time": "2024-07-30 10:20:42",
            "commit_uid": 61,
            "commit_time": "2024-07-30 10:20:42",
            "revoke_uid": 0,
            "revoke_time": "",
            "supplier_id": 1788,
            "supplier_name": "中山市羽翼照明科技有限公司",
            "order_amount": "0.000000",
            "cg_uid": 116,
            "return_price": "0.00",
            "other_fee": "0.00",
            "fee_part_type": 0,
            "fee_part_type_text": "不分配",
            "opt_realname": "刘可怡",
            "type": 2,
            "type_text": "采购入库",
            "custom_type_id": 0,
            "custom_type_name": "",
            "status": 40,
            "status_text": "已完成",
            "source_sn": "PO240729025",
            "receipt_order_sn": "CR240730005",
            "currency": "¥",
            "cg_realname": "陈志杰",
            "create_realname": "刘可怡",
            "commit_realname": "刘可怡",
            "revoke_realname": "",
            "ware_house_name": "wcn测试仓库测试改名",
            "remark": "采购单号:PO240729025,预检",
            "increment_time": "2024-07-30 10:20:43",
            "custom_fields": [],
            "item_list": [
                {
                    "product_name": "单品B-new",
                    "sku": "SINGLE-B",
                    "fnsku": "",
                    "seller_id": "120",
                    "product_total": 50,
                    "product_good_num": 0,
                    "product_bad_num": 2,
                    "product_qc_num": 0,
                    "product_onshelf_num": 0,
                    "product_shelf_num": 48,
                    "price": "0.0000",
                    "amount": "0.00",
                    "fee_cost": "0.00",
                    "head_way_fee": "0.00",
                    "product_amounts": "0.00",
                    "single_fee": "0.0000",
                    "unit_head_fee": "0.0000",
                    "single_stock_cost": "0.0000",
                    "purchase_item_id": 114411,
                    "product_remark": "",
                    "custom_fields": []
                }
            ]
        }
    ],
    "total": 1
}