1. 简介

千易第三方平台标准接口文档

2. 环境要求及基础约定

授权: accessId（客户ID/平台应用ID）、secretKey（密钥/平台秘钥，用于验证报文信息）。

接口地址：第三方提供服务地址供千易调用。

请求方式：

• Method: POST
• Content-Type: application/x-www-form-urlencoded

公共请求:

header参数:

AuthorInfo 授权具体信息

公共响应:

签名方式:

1、将accessId和content组成json字符串{"accessId":"accessId","content":"具体业务参数"}，content为空时{"accessId":"accessId"}

2、将第三方分配的客户secretKey添加到json的末尾，得到待加密字串{"accessId":"accessId","content":"具体业务参数"}secretKey

3、对待加密字串做sha1加密得到签名（org.apache.commons.codec.digest.DigestUtils.sha1Hex(待加密字串)）

4、将签名赋值到公共请求的sign字段

服务请求地址(Service Endpoints)

请求域名: 由对接服务商提供对应请求地址

平台授权字段映射关系

3. 获取Token

方法名:

• getToken

POST /extApi/platform/getToken

接口参数:

返回信息:

请求示例:

{

}

返回示例:

4. 刷新Token

方法名:

• refreshToken

POST /extApi/platform/refreshToken

接口参数:

返回信息:

请求示例:

返回示例:

5. 推送授权信息(千易ERP推送至外部服务)

方法名:

• pushAuthorizationInfo

POST /extApi/platform/pushAuthorizationInfo

接口参数:

返回信息:

请求示例:

{
    "accessId": "787878787",
    "content": "{\"platform\":\"MOMO\",\"shopId\":108894,\"wobHookUrl\":\"https://www.qianyierp.com\"}",
    "sign": "18a5182a8d3f09577dd48ac4ef2da615809d25ba",
    "method": "pushAuthorizationInfo"
}

返回示例:

{
    "success": true,
    "message": "",
    "shopId": 108894
}

6. 获取订单信息

方法名:

• getOrder

POST /extApi/platform/getOrder

接口参数:

返回信息:

orderInfo(订单详情)

orderTag(订单标记)

buyerInfo(买家信息)

onlineOrderInfo(线上报文信息)

orderSku(线上订单明细)

请求示例:{

{
    "accessId": "787878787",
    "content": "{\"onlineOrderIdList\":[\"111\"],\"pageNo\":1,\"pageSize\":100,\"platform\":\"MOMO\",\"shopId\":108874}",
    "sign": "856e36c54c62b6c501df7a9801e84a9adff80e06",
    "method": "getOrder"
}

返回示例:

{
    "success": true,
    "message": "",
    "isLastPage": true,
    "currentPageNo": 1,
    "pageCount": 5,
    "extraPlatform": "examplePlatform",
    "orderInfoList": [
        {
            "shopId": 108874,
            "onlineShopId": "shop123",
            "onlineOrderId": "order1234567",
            "payTime": 1735641983000,
            "createTime": 1735641983000,
            "onlineOrderStatus": "cancel",
            "erpOrderStatus": "CLOSED",
            "buyerMessage": "Please ship fast",
            "sellerRemarks": "Special discount applied",
            "platformShippingTime": 1735641983000,
            "platformDeliveryTime": 1735641983000,
            "lastShipTime": 1735641983000,
            "shippingServiceSelected": "Express",
            "carrier": "Carrier123",
            "carrierName": "Example Carrier",
            "trackingNumber": "track123",
            "platformWarehouseId": "warehouse123",
            "platformWarehouse": "Main Warehouse",
            "currency": "USD",
            "paymentMethod": "PAY_ONLINE",
            "codPayAmount": 100,
            "freight": 10,
            "totalAmount": 110,
            "sellerDiscount": 5,
            "platformRebate": 2,
            "totalDiscount": 7,
            "buyerPaidShippingFee": 8,
            "platformReturnToSeller": 3,
            "orderTags": {
                "onlineShipped": 1,
                "platformFulfillment": 0,
                "preSale": 0
            },
            "buyerInfo": {
                "buyerName": "John Doe",
                "receiverName": "Jane Doe",
                "country": "USA",
                "province": "California",
                "city": "Los Angeles",
                "district": "Downtown",
                "postCode": "90001",
                "address": "123 Main St",
                "phone": "123-456-7890",
                "email": "john.doe@example.com"
            },
            "onlineOrderInfo": {
                "onlineOrderId": "order123",
                "lastModifyTime": 1735641983006,
                "orderJson": "{\"key\":\"value\"}"
            },
            "orderSkuList": [
                {
                    "onlineTransactionId": "trans123",
                    "onlineSkuTitle": "Product Title",
                    "onlineSkuCode": "sku123",
                    "onlineItemId": "item123",
                    "currency": "USD",
                    "onlineSkuQuantity": 2,
                    "itemPrice": 50,
                    "totalTax": 5,
                    "shippingPrice": 2,
                    "originalPrice": 60,
                    "paymentPrice": 55,
                    "payAmount": 110,
                    "itemTax": 3,
                    "shippingTax": 1,
                    "discountPrice": 5,
                    "totalDiscountedPrice": 50,
                    "discountFromPlatform": 2,
                    "discountFromSeller": 3
                }
            ]
        }
    ]
}

7. 推送订单信息(外部服务推送至千易ERP)

方法名:

• pushOrder

POST /extApi/platform/pushOrder

接口参数:

orderTag(订单标记)

buyerInfo(买家信息)

onlineOrderInfo(线上报文信息)

orderSku(线上订单明细)

返回信息:

请求示例:

{
  "accessId": "787878787",
  "method": "pushOrder",
  "sign": "856e36c54c62b6c501df7a9801e84a9adff80e06",
  "content": "{
            "shopId": 108874,
            "onlineShopId": "shop123",
            "onlineOrderId": "order1234567",
            "payTime": 1735641983000,
            "createTime": 1735641983000,
            "onlineOrderStatus": "cancel",
            "erpOrderStatus": "CLOSED",
            "buyerMessage": "Please ship fast",
            "sellerRemarks": "Special discount applied",
            "platformShippingTime": 1735641983000,
            "platformDeliveryTime": 1735641983000,
            "lastShipTime": 1735641983000,
            "shippingServiceSelected": "Express",
            "carrier": "Carrier123",
            "carrierName": "Example Carrier",
            "trackingNumber": "track123",
            "platformWarehouseId": "warehouse123",
            "platformWarehouse": "Main Warehouse",
            "currency": "USD",
            "paymentMethod": "PAY_ONLINE",
            "codPayAmount": 100,
            "freight": 10,
            "totalAmount": 110,
            "sellerDiscount": 5,
            "platformRebate": 2,
            "totalDiscount": 7,
            "buyerPaidShippingFee": 8,
            "platformReturnToSeller": 3,
            "orderTags": {
                "onlineShipped": 1,
                "platformFulfillment": 0,
                "preSale": 0
            },
            "buyerInfo": {
                "buyerName": "John Doe",
                "receiverName": "Jane Doe",
                "country": "USA",
                "province": "California",
                "city": "Los Angeles",
                "district": "Downtown",
                "postCode": "90001",
                "address": "123 Main St",
                "phone": "123-456-7890",
                "email": "john.doe@example.com"
            },
            "onlineOrderInfo": {
                "onlineOrderId": "order123",
                "lastModifyTime": 1735641983006,
                "orderJson": "{\"key\":\"value\"}"
            },
            "orderSkuList": [
                {
                    "onlineTransactionId": "trans123",
                    "onlineSkuTitle": "Product Title",
                    "onlineSkuCode": "sku123",
                    "onlineItemId": "item123",
                    "currency": "USD",
                    "onlineSkuQuantity": 2,
                    "itemPrice": 50,
                    "totalTax": 5,
                    "shippingPrice": 2,
                    "originalPrice": 60,
                    "paymentPrice": 55,
                    "payAmount": 110,
                    "itemTax": 3,
                    "shippingTax": 1,
                    "discountPrice": 5,
                    "totalDiscountedPrice": 50,
                    "discountFromPlatform": 2,
                    "discountFromSeller": 3
                }
            ]
        }"  
}

返回示例:

{
    result: {
        "shopId": 108874,
        "onlineShopId": "shop123",
        "onlineOrderId": "order1234567"
    },
    state: "success"
}

8. 获取订单线上状态信息

方法名:

• getOrderOnlineStatus

POST /extApi/platform/getOrderOnlineStatus

接口参数:

返回信息:

OnlineStatus:

请求示例:

返回示例:

9. 反馈平台发货(RTS)

方法名:

• readyToShip

POST /extApi/platform/readyToShip

接口参数:

onlineOrderItem(包裹商品明细)

返回信息:

请求示例:

{
    "accessId": "787878787",
    "content": "{\"onlineSkuId\":\"item123\",\"platform\":\"MOMO\",\"shopId\":108874}",
    "sign": "4be109ea00dd93be2a5fad16f477a8bbec989e16",
    "method": "readyToShip"
}

返回示例:

{
  "success": true,
  "message": "",
  "onlineShopId": "shop123",
  "onlineOrderId": "order1234567"
}

10. 获取商品信息

方法名:

• getProduct

POST /extApi/platform/getProduct

接口参数:

返回信息:

itemInfo(商品详情信息)

warehouseStock(多仓库存信息)

请求示例:

{
    "accessId": "787878787",
    "content": "{\"onlineItemId\":[\"2222\"],\"pageNo\":1,\"pageSize\":100,\"platform\":\"MOMO\",\"shopId\":108874}",
    "sign": "eb79547647d81907691d2033106b28171c05bc7e",
    "method": "getProduct"
}

返回示例:

{
    "success": true,
    "message": "",
    "isLastPage": true,
    "currentPageNo": 1,
    "pageCount": 5,
    "extraPlatform": "examplePlatform",
    "shopId": 1234567890,
    "onlineShopId": "shop123",
    "itemInfoList": [
        {
            "onlineItemId": "item123dfdf",
            "onlineSkuId": "sku123dfdf",
            "extraSkuId": "extrasku12dfdf3",
            "onlineSkuCode": "sku123cvcv",
            "imageUrl": "https://example.com/image.jpg",
            "onlineSkuStatus": "ACTIVE",
            "onlineSkuTitle": "Product Title",
            "onlineSkuName": "Product Name",
            "onlineSKuStock": 100,
            "weight": 0.5,
            "weightUnit": "kg",
            "color": "Red",
            "size": "M",
            "length": 30,
            "width": 20,
            "height": 10,
            "dimensionUnit": "cm",
            "price": 29.99,
            "warehouseStockList": [
                {
                    "platformWarehouseId": "warehouse123",
                    "availableStock": 50
                },
                {
                    "platformWarehouseId": "warehouse456",
                    "availableStock": 30
                }
            ]
        },
        {
            "onlineItemId": "item456",
            "onlineSkuId": "sku456",
            "extraSkuId": "extrasku456",
            "onlineSkuCode": "code456",
            "imageUrl": "https://example.com/image2.jpg",
            "onlineSkuStatus": "INACTIVE",
            "onlineSkuTitle": "Another Product Title",
            "onlineSkuName": "Another Product Name",
            "onlineSKuStock": 200,
            "weight": 1,
            "weightUnit": "kg",
            "color": "Blue",
            "size": "L",
            "length": 40,
            "width": 30,
            "height": 20,
            "dimensionUnit": "cm",
            "price": 49.99,
            "warehouseStockList": [
                {
                    "platformWarehouseId": "warehouse789",
                    "availableStock": 100
                }
            ]
        }
    ]
}

11. 获取商品状态

方法名:

• getProductStatus

POST /extApi/platform/getProductStatus

接口参数:

返回信息:

OnlineStatus:

请求示例:

返回示例:

12. 更新商品库存

方法名:

• updateInventory

POST /extApi/platform/updateInventory

接口参数:

SellerStock(平台库存信息)

返回信息:

Failure(失败信息)

请求示例:

{
    "accessId": "787878787",
    "content": "{\"onlineSkuId\":\"item123\",\"platform\":\"MOMO\",\"shopId\":108874}",
    "sign": "4be109ea00dd93be2a5fad16f477a8bbec989e16",
    "method": "updateInventory"
}

返回示例:

{
    "success": true,
    "message": "",
    "failureList": [
    {
        "onlineItemId":"123",
            "onlineSkuId":"item123"
    }
     ]
}

13. 平台物流

13.1. 初始化物流信息

方法名:

• initLogistics

POST /extApi/platform/initLogistics

接口参数:

返回信息:

LogisticsInfo 线上物流信息

请求示例:

{
    "accessId":"787878787",
    "content":"{\"platform\":\"MOMO\",\"shopId\":108874}",
    "sign":"ec8e3bd387bc177db22ca4d8fdd4d8af49a52e4b"
}

返回示例:

{
    "success":true,
    "message":"",
    "onlineShopId":"1111",
    "shopId":1234,
    "logisticsInfoList":[
        {"logisticsCode":"物流code1","logisticsName":"物流name1"},
        {"logisticsCode":"物流code2","logisticsName":"物流name2"}
    ]
}

13.2. 获取运单号

方法名:

• getTrackNumber

POST /extApi/platform/getTrackNumber

接口参数:

onlineItemInfo(线上商品信息)

返回信息:

labelData(面单数据信息)

请求示例:

{"accessId":"787878787","content":"{\"logisticsCode\":\"物流code1\",\"logisticsName\":\"物流name1\",\"onlineItemInfoList\":[{\"onlineItemId\":\"item123\",\"onlineSkuId\":\"sku123\",\"quantity\":2}],\"onlineOrderId\":\"order12345\",\"platform\":\"MOMO\",\"shopId\":108874}","sign":"3b95dae713298b5d63b679956874c1b3267e01f3"}

返回示例:

{"success":true,"message":"","onlineShopId":"1111","trackNumber":"123123123","shippingCarrier":"123123","labelDataList":[{"labelType":"URL","labelData":"1111111"}]}

13.3. 取消运单号

方法名:

• cancelLogisticsOrder

POST /extApi/platform/cancelLogisticsOrder

接口参数:

onlineItemInfo(线上商品信息)

返回信息:

请求示例:

返回示例:

13.4. 获取面单

方法名:

• getLabelData

POST /extApi/platform/getLabelData

接口参数:

onlineItemInfo(线上商品信息)

返回信息:

labelData(面单数据信息)

请求示例:

{"accessId":"787878787","content":"{\"onlineOrderId\":\"order12345\",\"platform\":\"MOMO\"}","sign":"3e93d3736a0ed6a0da1da39ae7ead2fd2a7493eb"}

返回示例:

{"success":true,"message":"","onlineOrderId":"1111","labelDataList":[{"labelType":"URL","labelData":"https://seller.pgmall.my//index.php?route=common/order_details/printNinjaVanConnote&oid=1472701&h=1472701&ipr_token=7075e26c696f676f6c6431323f343e36123"}]}

13.5. 物流节点信息获取

方法名:

• getTrackingInfo

POST /extApi/platform/getTrackingInfo

接口参数:

返回信息:

LogisticsEvent(物流详情信息)

请求示例:

返回示例:

14. 获取平台仓库

方法名:

• getPlatformWarehouse

POST /extApi/platform/getPlatformWarehouse

接口参数:

返回信息:

platformWarehouse(平台仓库信息)

请求示例:

{
    "accessId": "787878787",
    "content": "{\"extraPlatform\":\"MOMO\",\"shopId\":108874}",
    "sign": "1ac97de2845109b8f32d1d3c9303221064d33deb",
    "method": "getPlatformWarehouse"
}

返回示例:

{
    "success": true,
    "messgae": "",
    "shopId": 1111,
    "onlineShopId": "sdsd",
    "platformWarehouseList": [
        {
            "platformWarehouseCode": "12112",
            "platformWarehouseName": "wwweww"
        },
        {
            "platformWarehouseCode": "32323",
            "platformWarehouseName": "sfaf"
        }
    ]
}