Import order

  • 导入订单 （前置校验）
    • 前置校验：导入订单前，先进行地址校验（地址错误不允许出单）

Request

  • Path: oms/oms/order/importOrder
  • Method: POST
  • Header:
    • Authorization: Basic c2FiZXI6c2FiZXJfc2VjcmV0
    • Blade-Auth: access_token
  • Request body example:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
[
    {
        "orderNo": "订单编号",
        "consigneeCountryName": "韩国",
        "deliveryNo": "运单号，非必填（不填，系统将自动分配）",
        "consigneeDes": "收件人",
        "consigneePhone": "收件人电话",
        "consigneePostcode": "收件人邮编",
        "consigneeAddressDes": "收件人韩文地址",
        "consigneeAddressDesEn": "收件人英文地址",
        "ordererName": "购买人姓名",
        "ordererPhone": "购买人电话",
        "iccs": "通关符",
        "weight": 0.2,
        "vendorType": "渠道类型",
        "freightCollect": "付款方式",
        "remark": "备注",
        "cnLogist": "国内物流单号",
        "orderType": "订单类型",
        "warehouse: "发货仓库"
        "listOrderDetailAPIDTO": [
            {
                "orderProductName": "中文商品名",
                "orderProductNameEn": "英文商品名",
                "declareProductName": "申报中文名，可为空",
                "declareProductNameEn": "申报中文名，可为空",
                "sku": "商品SKU",
                "spec": "规格",
                "quantity": "2",
                "price": "2",
                "hscode": "303030",
                "isHaveElectric": "0",
                "currencyName": "美元"
            },
            {
                "orderProductName": "中文商品名",
                "orderProductNameEn": "英文商品名",
                "declareProductName": "申报中文名，可为空",
                "declareProductNameEn": "申报中文名，可为空",
                "sku": "商品SKU",
                "spec": "规格",
                "quantity": "2",
                "hscode": "303030",
                "price": "2",
                "isHaveElectric": "1",
                "currencyName": "美元"
            }
        ]
    }
]

Response

  • Response body example:
1
2
3
4
5
6
{
    "code": 20002,
    "success": false,
    "data": {},
    "msg": "地址错误"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
    "code": 200,
    "success": true,
    "data": {
        "listFailOrder": [
            {
                "orderNo": "20210531-demo-001"
            }
        ],
        "listSuccessOrder": [
            {
                "markStr": "SZA",
                "areaCode": "4D10-2",
                "20210531-demo-001": "388135888888",
                "isIsolatedAreas": "1",
                "uuid": "563053",
                "orderNo": "20210531-demo-001",
                "deliveryNo": "388135888888",
                "expressCompany": "CJGLS",
                "iccsError": "1",
                "addressError": "0",
                "areacodeError": "0",
                "isStrikeArea": "0",
            }
        ]
    },
    "msg": "操作成功"
}

  • Possible value of {markStr}:

    • 渠道分类信息，在面单上显示

  • Possible value of {areaCode}:

    • 区域码 在面单上显示

  • Possible value of {freightCollect}:

    • 付款方式
    • 0 寄付
    • 1 到付

  • Possible value of {iccsError}:

    • 通关符是否正确
    • 0 正确
    • 1 错误

  • Possible value of {addressError}:

    • 地址是否正确
    • 0 正确
    • 1 错误

  • Possible value of {areacodeError}:

    • 区域编码是否正确
    • 0 正确
    • 1 错误

  • Possible value of {isIsolatedAreas}:

    • 是否偏远地区
    • 0 非偏远地区
    • 1 偏远地区

  • Possible value of {isStrikeArea}:

    • 是否罢工区域
    • 0 否
    • 1 是

  • Possible value of {isHaveElectric}:

    • 是否带电
    • 0 否
    • 1 是

  • Possible value of {expressCompany}:

    • 快递公司
    • CJGLS 韩国CJ
    • EPOST EPOST
    • HANJIN 韩进
    • ILYANG 一阳
    • KDEXP KDEXP
    • DAESIN 大信
    • LETIAN 乐天

  • Possible value of {cnLogist}:

    • 国内物流单号，多个值以逗号连接

  • Possible value of {vendorType}:

    • 渠道类型
    • 3 海运
    • 4 韩国直发
    • 5 深圳飞
    • 6 深圳加急飞
    • 7 威海飞
    • 8 韩国直发N

  • Possible value of {orderType}:

    • 订单类型
    • 1 备货 (备货订单，若在韩国备货、发货仓为仁川备货仓， 国内备货选择威海一号仓)
    • 2 一件代发 (发货仓库可为空)
    • 3 自贴面单 (发货仓库可为空)
    • 4 海外改派 (改派订单须选择韩国直发渠道、且发货仓为仁川退件仓)
    • 5 M订单

  • Possible value of {warehouse}:

    • 发货仓库
    • WH001 威海一号仓
    • WH002 威海二号仓
    • KRRC01 仁川备货仓
    • KRRC02 仁川退件仓
    • SZLJ01 深圳良基仓

  • 重要说明：渠道类型、发货仓库、订单类型三者的关联关系

    • 1、韩国直发渠道，订单类型只能选备货和海外改派；发货仓库：分别对应仁川备货仓和仁川退件仓
    • 2、海运 可以选备货、一件代发和自贴面单，不能选海外改派；发货仓库：威海一号仓
    • 3、空运 可以选备货、一件代发和自贴面单，不能选海外改派；发货仓库：威海飞选威海仓，深圳飞和深圳加急飞选东莞仓

  • 常用的渠道：

    • 韩国直发备货 vendorType=4 orderType=1 warehouse=’KRRC01’
    • 韩国直发改派 vendorType=4 orderType=4 warehouse=’KRRC02’
    • 海运备货 vendorType=3 orderType=1 warehouse=’WH001’
    • 海运一件代发 vendorType=3 orderType=2 warehouse=’WH001’
    • 海运自贴面单 vendorType=3 orderType=3 warehouse=’WH001’
    • 威海飞备货 vendorType=7 orderType=1 warehouse=’WH001’
    • 威海飞一件代发 vendorType=7 orderType=2 warehouse=’WH001’
    • 威海飞自贴面单 vendorType=7 orderType=3 warehouse=’WH001’
    • 深圳飞自贴面单 vendorType=5 orderType=3 warehouse=’SZLJ01’
    • 深圳加急飞自贴面单 vendorType=6 orderType=3 warehouse=’SZLJ01’

  • 不常用：

    • 深圳飞备货 vendorType=5 orderType=1 warehouse=’SZLJ01’
    • 深圳飞一件代发 vendorType=5 orderType=2 warehouse=’SZLJ01’
    • 深圳加急飞备货 vendorType=6 orderType=1 warehouse=’SZLJ01’
    • 深圳加急飞一件代发 vendorType=6 orderType=2 warehouse=’SZLJ01’