OMS 对外开放接口说明

OMS 对外开放接口说明


上传产品

<h5>简要描述</h5> <ul> <li>上传产品接口</li> </ul> <h5>请求URL</h5> <ul> <li><code>/v1/product/create</code> </li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>请求参数示例</h5> <pre><code>[ { "accessoryFlag": 0, "attachmentUrl": "string", "brandName": "string", "declareNameCn": "declareNameCn", "declareNameEn": "declareNameEn", "declarePrice": 0, "height": 10, "hsCode": "string", "imageUrl": "string", "includeBattery": false, "includeLiquid": false, "includeMagnetic": false, "dangerFlag": true, "nineTagFlag": true, "shapeTagFlag": true, "productModel": "test_e8d1845d9e74", "length": 10, "materialDescription": "string", "notes": "string", "originCountry": "string", "productCodingList": [ "string" ], "productName": "SKU-YTD-RED-0001-name", "productUrl": "string", "salePrice": 0, "sku": "SKU-YTD-RED-0001", "weight": 10.5, "width": 10, "insuranceAmount": 1.1, "snFlag": 0, "manufactureBatchFlag": false } ] </code></pre> <h5>json字段说明</h5> <table> <thead> <tr> <th style="text-align: left;">字段名</th> <th style="text-align: left;">必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">sku</td> <td style="text-align: left;">是</td> <td>string</td> <td>sku编码</td> </tr> <tr> <td style="text-align: left;">productName</td> <td style="text-align: left;">是</td> <td>string</td> <td>产品名称</td> </tr> <tr> <td style="text-align: left;">length</td> <td style="text-align: left;">是</td> <td>number</td> <td>长 单位CM</td> </tr> <tr> <td style="text-align: left;">width</td> <td style="text-align: left;">是</td> <td>number</td> <td>宽 单位CM</td> </tr> <tr> <td style="text-align: left;">height</td> <td style="text-align: left;">是</td> <td>number</td> <td>高 单位CM</td> </tr> <tr> <td style="text-align: left;">weight</td> <td style="text-align: left;">是</td> <td>number</td> <td>重量 单位kg</td> </tr> <tr> <td style="text-align: left;">accessoryFlag</td> <td style="text-align: left;">否</td> <td>int</td> <td>配件 0=非配件,1=配件</td> </tr> <tr> <td style="text-align: left;">attachmentUrl</td> <td style="text-align: left;">否</td> <td>string</td> <td>产品证书</td> </tr> <tr> <td style="text-align: left;">brandName</td> <td style="text-align: left;">否</td> <td>string</td> <td>品牌名称</td> </tr> <tr> <td style="text-align: left;">declareNameCn</td> <td style="text-align: left;">否</td> <td>string</td> <td>报关中文名</td> </tr> <tr> <td style="text-align: left;">declareNameEn</td> <td style="text-align: left;">否</td> <td>string</td> <td>报关英文名</td> </tr> <tr> <td style="text-align: left;">declarePrice</td> <td style="text-align: left;">否</td> <td>number</td> <td>报关价值</td> </tr> <tr> <td style="text-align: left;">hsCode</td> <td style="text-align: left;">否</td> <td>string</td> <td>海关编码</td> </tr> <tr> <td style="text-align: left;">imageUrl</td> <td style="text-align: left;">否</td> <td>string</td> <td>产品图片</td> </tr> <tr> <td style="text-align: left;">includeBattery</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>是否含电</td> </tr> <tr> <td style="text-align: left;">includeLiquid</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>是否含液体</td> </tr> <tr> <td style="text-align: left;">includeMagnetic</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>是否包含磁性</td> </tr> <tr> <td style="text-align: left;">dangerFlag</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>危险品</td> </tr> <tr> <td style="text-align: left;">nineTagFlag</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>九类标签</td> </tr> <tr> <td style="text-align: left;">shapeTagFlag</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>异形标签</td> </tr> <tr> <td style="text-align: left;">productModel</td> <td style="text-align: left;">否</td> <td>string</td> <td>产品型号</td> </tr> <tr> <td style="text-align: left;">materialDescription</td> <td style="text-align: left;">否</td> <td>string</td> <td>材质说明</td> </tr> <tr> <td style="text-align: left;">notes</td> <td style="text-align: left;">否</td> <td>string</td> <td>备注</td> </tr> <tr> <td style="text-align: left;">originCountry</td> <td style="text-align: left;">否</td> <td>string</td> <td>原产地</td> </tr> <tr> <td style="text-align: left;">productCodingList</td> <td style="text-align: left;">否</td> <td>array</td> <td>第三方自定义条码</td> </tr> <tr> <td style="text-align: left;">productUrl</td> <td style="text-align: left;">否</td> <td>string</td> <td>产品链接</td> </tr> <tr> <td style="text-align: left;">salePrice</td> <td style="text-align: left;">否</td> <td>number</td> <td>销售价格</td> </tr> <tr> <td style="text-align: left;">insuranceAmount</td> <td style="text-align: left;">否</td> <td>number</td> <td>保险金额</td> </tr> <tr> <td style="text-align: left;">snFlag</td> <td style="text-align: left;">否</td> <td>int</td> <td>一物一码 0=否,1=是</td> </tr> <tr> <td style="text-align: left;">manufactureBatchFlag</td> <td style="text-align: left;">否</td> <td>boolean</td> <td>是否开启生产批次:true=是, false=否</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ "msg": "操作成功", "code": 200, "data": [ { "sku": "Test-B-api-0003", "productCode": "XOD6000183" } ] } </code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>消息</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>无</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">array</td> <td>无</td> </tr> <tr> <td style="text-align: left;">sku</td> <td style="text-align: left;">string</td> <td>Sku编号</td> </tr> <tr> <td style="text-align: left;">productCode</td> <td style="text-align: left;">string</td> <td>产品编码</td> </tr> </tbody> </table> <h5>失败返回示例</h5> <pre><code>{ "errcode": "00000", "msg": "上传产品异常1:null", "code": 500 } </code></pre> <h5>失败返回示例的参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">errcode</td> <td style="text-align: left;">string</td> <td>错误代码</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>消息</td> </tr> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>Code</td> </tr> </tbody> </table>

页面列表

ITEM_HTML