Merge remote-tracking branch 'origin/bfasrs' into bfasrs

TQS

2023-03-14 2a04430662e40f78cb209389c173380a236d49e7

Merge remote-tracking branch 'origin/bfasrs' into bfasrs

 src/main/webapp/views/api_index.html

@@ -119,8 +119,8 @@
            <p>请求头：</p>
            <table border="1">
                <tr><th>参数名</th><th>描述</th></tr>
                <tr><td>Method</td><td>http://{prefix}/open/asrs/order/matSync/default/v1</td></tr>
                <tr><td>Url</td><td>Post</td></tr>
                <tr><td>Method</td><td>Post</td></tr>
                <tr><td>Url</td><td>http://{prefix}/open/asrs/order/matSync/default/v1</td></tr>
                <tr><td>Content-Type</td><td>application/json;charset=UTF-8</td></tr>
                <tr><td>appkey</td><td>ea1f0459efc02a79f046f982767939ae</td></tr>
            </table>
@@ -176,6 +176,238 @@
                <tr><td>createTime</td><td>是</td><td>Date</td><td>添加时间</td></tr>
                <tr><td>memo</td><td>是</td><td>字符串</td><td>备注</td></tr>
            </table>
            <p>请求示例：</p>
            <div class="code language-css">
                <pre>
                    <code>
                        {
"createTime":"2022-04-1109:28:10",
"matDetails":[
{
"matnr":"Y9000P",
"maktx":"联想拯救者电脑",
"groupCode":"A01",
"groupName":"laptop",
"name":"联想笔记本电脑",
"specs":"3070显卡",
"model":"非公模具",
"color":"黑色",
"brand":"联想",
"unit":"台",
"price":10999,
"sku":"无sku",
"units":1000,
"barcode":"90000001",
"origin":"中国",
"manu":"中国联想",
"manuDate":"2022-04-1109:28:10",
"itemNum":"1000",
"safeQty":30,
"weight":5,
"length":3,
"volume":10,
"threeCode":"无三方编码",
"supp":"浙江中扬立库",
"suppCode":"supp01",
"beBatch":1,
"deadTime":"2022-08-1109:28:10",
"deadWarn":1,
"source":1,
"inspect":1,
"danger":2,
"status":1,
"createBy":1,
"createTime":"2022-08-1109:28:10",
"memo":"测试用"
}
]
}
                    </code>
                </pre>
            </div>
            <h3>返回值</h3>
            <p>响应字段：</p>
            <table border="1">
                <tr><th>字段名称</th><th>类型</th><th>说明</th></tr>
                <tr><td>code</td><td>数字</td><td>响应码</td></tr>
                <tr><td>msg</td><td>字符串</td><td>响应描述</td></tr>
                <tr><td>data</td><td>列表</td><td>响应内容</td></tr>
            </table>
            <p>响应示例：</p>
            <div class="code language-css">
                <pre>
                    <code>
{
"msg":"操作成功",
"code":200
}
                    </code>
                </pre>
            </div>
            <h2>生成入库单据</h2>
            <h3>接口前言</h3>
            <ul>
                <li>接口提供方：AS/RS</li>
                <li>接口调用方：ERP</li>
                <li>业务类型：入库作业</li>
                <li>场景描述：根据ERP入库单据（生产、采购、调拨、销售退回、其他等）进行入库作业，此任务仅为
                    生成AS/RS入库通知单数据，然后由现场人员操作PDA进行入库，并不表示调用此接口后即表示入库完成。
                </li>
            </ul>
            <h3>请求规范</h3>
            <p>请求头:</p>
            <table border="1">
                <tr><th>参数名</th><th>描述</th></tr>
                <tr><td>Method</td><td>Post</td></tr>
                <tr><td>Url</td><td>Post</td></tr>
                <tr><td>Content-Type</td><td>application/json;charset=UTF-8</td></tr>
                <tr><td>appkey</td><td>ea1f0459efc02a79f046f982767939ae</td></tr>
            </table>
            <p>注：appkey、prefix由管理员提供</p>
            <p>请求体：</p>
            <table border="1">
                <tr><th>字段名称</th><th>必需</th><th>类型</th><th>说明</th></tr>
                <tr><td>orderNo</td><td>是</td><td>字符串</td><td>单据编号</td></tr>
                <tr><td>orderType</td><td>是</td><td>字符串</td><td>单据类型</td></tr>
                <tr><td>orderTime</td><td>是</td><td>字符串</td><td>单据时间（yyyy-MM-ddHH:mm:ss）</td></tr>
                <tr><td>orderDetails</td><td>是</td><td>列表</td><td>单据明细</td></tr>
            </table>
            <p>注：JSON提交</p>
            <p>注:如果orderDetails中出现两条有相同商品编号(matnr)和相同生产批号(batch)的
                信息,立库仅会生成一条,并将数量累加.</p>
            <p>orderDetails列表对象：</p>
            <table border="1">
                <tr><th>字段名称</th><th>必需</th><th>类型</th><th>说明</th></tr>
                <tr><td>matnr</td><td>是</td><td>字符串</td><td>商品编号（确保此商品已同步至立库）</td></tr>
                <tr><td>batch</td><td>否</td><td>字符串</td><td>生产批号</td></tr>
                <tr><td>anfme</td><td>是</td><td>数字型</td><td>入库数量</td></tr>
            </table>
            <p>请求示例：</p>
            <div class="code language-css">
                <pre>
                    <code>
{
"orderNo":"963007546090586112",
"orderTime":"2022-04-1109:28:10",
"orderType":"采购入库单",
"orderDetails":[
{
"matnr":"MDH020030530",
"anfme":18.0,
"batch":"500"
},
{
"matnr":"LSH90152025",
"anfme":50.0
}
]
}
                    </code>
                </pre>
            </div>
            <h3>返回值</h3>
            <p>响应字段：</p>
            <table border="1">
                <tr><th>字段名称</th><th>类型</th><th>说明</th></tr>
                <tr><td>code</td><td>数字</td><td>响应码</td></tr>
                <tr><td>msg</td><td>字符串</td><td>响应描述</td></tr>
                <tr><td>data</td><td>列表</td><td>响应内容</td></tr>
            </table>
            <p>响应示例：</p>
            <div class="code language-css">
                <pre>
                    <code>
{
"msg":"操作成功",
"code":200
}
                    </code>
                </pre>
            </div>
            <h2>入库完成回写</h2>
            <h3>接口前言</h3>
            <ul>
                <li>接口提供方：ERP</li>
                <li>接口调用方：AS/RS</li>
                <li>业务类型：入库作业</li>
                <li>场景描述：AS/RS执行ERP入库单据，完成货物的组托、入库后，上报已入库完成
                    数量。入库完成策略以整个单据为单位上报。</li>
            </ul>
            <h3>请求规范</h3>
            <p>请求头：</p>
            <table border="1">
                <tr><th>参数名</th><th>描述</th></tr>
                <tr><td>Method</td><td>Post</td></tr>
                <tr><td>Url</td><td>http://{prefix}/open/asrs/order/matSync/default/v1</td></tr>
                <tr><td>Content-Type</td><td>application/json;charset=UTF-8</td></tr>
                <tr><td>appkey</td><td>ea1f0459efc02a79f046f982767939ae</td></tr>
            </table>
            <p>注：appkey、prefix由管理员提供</p>
            <p>请求体：</p>
            <table border="1">
                <tr><th>字段名称</th><th style="width: 50px">必需</th><th style="width: 50px">类型</th><th>说明</th></tr>
                <tr><td>orderNo</td><td>否</td><td>字符串</td><td>单据编号（此参数为空时，获取所有已
                    完成的入库单据，数据被获取后，下次
                    请求此接口，数据不会重复出现；反
                    之，则获取指定单据编号数据，指定单
                    据数据可重复出现。</td></tr>
            </table>
            <h3>返回值</h3>
            <p>响应字段：</p>
            <table border="1">
                <tr><th>字段名称</th><th>类型</th><th>说明</th></tr>
                <tr><td>code</td><td>数字</td><td>响应码</td></tr>
                <tr><td>msg</td><td>字符串</td><td>响应描述</td></tr>
                <tr><td>data</td><td>列表</td><td>响应内容</td></tr>
            </table>
            <p>data列表对象：</p>
            <table border="1">
                <tr><th>字段名称</th><th>类型</th><th>说明</th></tr>
                <tr><td>orderNo</td><td>字符串</td><td>单据编号</td></tr>
                <tr><td>orderType</td><td>字符串</td><td>单据类型</td></tr>
                <tr><td>orderTime</td><td>字符串</td><td>单据时间（yyyy-MM-ddHH:mm:ss）</td></tr>
                <tr><td>orderDetails</td><td>列表</td><td>单据明细</td></tr>
            </table>
            <p>orderDetails列表对象：</p>
            <table border="1">
                <tr><th>字段名称</th><th>类型</th><th>说明</th></tr>
                <tr><td>matnr</td><td>字符串</td><td>商品编号</td></tr>
                <tr><td>batch</td><td>字符串</td><td>生产批号</td></tr>
                <tr><td>anfme</td><td>数字型</td><td>入库数量</td></tr>
                <tr><td>orderNo</td><td>字符串</td><td>单据编号</td></tr>
            </table>
            <p>响应示例：</p>
            <div class="code language-css">
                <pre>
                    <code>
{
    "msg":"操作成功",
    "code":200,
    "data":[
        {
            "orderNo":"963007546090586112",
            "orderType":"采购入库单",
            "orderTime":"2022-04-11 09:30:35",
            "orderDetils":[
                    {
                        "orderNo":"963007546090586112",
                        "matnr":"MDH020030530",
                        "batch":"500",
                        "anfme":18.0
                    },
                    {
                        "orderNo":"963007546090586112",
                        "matnr":"MDH020030530",
                        "batch":"500",
                        "anfme":18.0
                    }
            ]
        }
    ]
}
                    </code>
                </pre>
            </div>
        </div>
    </div>
</body>