TMS V2.0

owo

相关文档

1. 【物流】封箱交接
2. 前端排期

需求分解

所有铺货/补货/上新 抽象为任务，根据不同任务类型走不同流程, 流程图 密码: 12345。

1. 任务概览

显示 问题反馈入口, 任务信息, 任务步骤信息, 单据关联的物流周转箱列表
操作 拣货, 拣货完成
接口

FTL: // 任务概览

// 获取任务信息(基础接口, 每个步骤都需要)
// GET: //tms/**/{taskId}
// Request: {}
// Response: 
{
    code: 200,
    data: {
        货架名,
        货架省市区+地址,
        任务备注
        步骤信息
        当前步骤
        问题反馈(销售电话,企业联系人电话)
        周转箱列表(UI?)
            每个周转箱编号,状态(已扫描,未扫描)
        未完成页面地址
    }
}
// 扫描周转箱
// POST: //tms/**/scan
// Request: 
{
    code: '123123'
}
// Response: 
{
    code: 200,
    data: {
        // none
    }
}
{
    code: 400,
    msg: '该周转箱不属于你'
}
// 拣货完成
// POST: //tms/**/pick
// Request: 
{
    taskId: '123123'
}
// Response: 
{
    code: 200,
    data: {
        // 当前页面刷新,无需地址
    }
}
// 开始任务
// POST: //tms/**/start
// Request: 
{
    taskId: '123123'
}
// Response: 
{
    code: 200,
    data: {
        url: '', // 任务开始页面地址
    }
}

2. 退货

显示 任务步骤信息, 退货商品列表
操作 下一步
接口

FTL: // 退货

// 退货商品列表
// GET /tms/**/return/{taskId}
// Request: {},
// Response: 
{
    code: 200,
    data: {
        commodities: [
            退货商品...
        ]
    }
}
// 退货下一步
// POST /tms/**/return/{taskId}
// Request: 
{
commodities: [
            退货商品...
        ]
}
// Respose: 
{
    code: 200,
    data: {
        url: '', // 下一步URL
    }
}

3. 调整陈列

显示 任务步骤信息, 货架商品陈列
操作 下一步
接口

FTL: // 货架陈列

// 货架陈列
// GET /tms/**/layout/{taskId}
// Request: {},
// Response: 
{
    code: 200,
    data: {
        commodities: [
            rows: [
                ... 每层商品
            ]
        ]
    }
}
// 下一步
// POST /tms/**/layout/{taskId}
// Request: 
{
}
// Respose: 
{
    code: 200,
    data: {
        url: '', // 下一步URL
    }
}

4. 退货明细

显示 任务步骤信息, 退货商品列表
操作 增加商品 下一步
接口

FTL: // 退货明细

// 退货商品列表
// GET /tms/**/return/{taskId}
// Request: {},
// Response: 
{
    code: 200,
    data: {
        commodities: [
            退货商品...
        ]
    }
}
// 增加商品 列表
// GET /tms/**/return/list/{taskId}
// Request: {},
// Response: 
{
    code: 200,
    data: {
        commodities: [
             {
                可退货商品...
             }
        ]
    }
}
// 退货商品提交
// POST /tms/**/return/{taskId}
// Request: 
{
    commodities: [
            退货商品...
        ]
},
// Response: 
{
    code: 200,
    data: {
        url: '', // 下一步URL
    }
}

5. 盘点

显示 任务步骤信息, 商品陈列
操作 提交
接口

FTL: // 盘点

// 货架陈列
// GET /tms/**/layout/{taskId}
// Request: {},
// Response: 
{
    code: 200,
    data: {
        rows: [
            {
                name: '第一层',
                commodities: {
                    ...
                }
            }
        ]
    }
}
// 提交
// POST /tms/**/inventory/{taskId}
// Request: 
{
    rows: [
        {
            id: 0,
            name: '第一层',
            commodities: {
                ...
            }
        }
    ]
}
// Respose: 
{
    code: 200,
    data: {
        url: '', // 下一步URL
    }
}

6. 拍照

显示 问题反馈入口, 任务步骤信息
操作 提交
接口

FTL: // 拍照

// 提交
// POST /tms/**/photo/{taskId}
// Request: 
{
    taskId: '',
    note: '',
    picUrl: ''
}
// Respose: 
{
    code: 200,
    data: {
        url: '', // 下一步URL
    }
}

7. 未完成说明

显示 问题反馈入口, 未完成原因选择列表
操作 提交
接口

FTL: // 未完成

// 获取选择原因列表
// POST /tms/**/reasons
// Request: {}
// Respose: 
{
    code: 200,
    data: {
        reasons: [
            {
                type: 1, // 补货/铺货/上新
                id: 1,
                text: '公司休息'
            }
        ]
    }
}
// 提交
// POST /tms/**/photo/{taskId}
// Request: 
{
    taskId: '',
    reason: 1,
    note: '',
    picUrl: ''
}
// Respose: 
{
    code: 200,
    data: {
        url: '' // 下一步URL
    }
}