Shein Ship Orders

All validations, triggers and standardizations which are not mentioned here are as per : Order management general requirements Order General Shipment

Shein DO support partial shipping so we want to incorporate this as well. Also they have a list with carriers which we can obtain via API.

Get Carrier List

Please note the carriers are per country so we want to incorporate a prefix when displaying the value in the UI. <v1.4> When we have multiple Shein channels from different countries we want to make sure we store all carriers and do not overwrite them </v1.4>

API Call: POST /open-api/order/express-channel API Docs: https://open.sheincorp.com/documents/apidoc/detail/3000241-2000001 Body: {{no body required}}

Sample Response:

{
    "code": "0",
    "msg": "OK",
    "info": {
        "expressChannels": [
            {
                "site": "shein-fr",
                "expressIdCode": "AAAAA SASAS",
                "expressChannelCode": "SHeMXZFH-MEX-SS-PC-B-B1-AM"
            },
            {
                "site": "shein-fr",
                "expressIdCode": "Amazon Logistic",
                "expressChannelCode": "SHeMXZFH-MEX-SS-PC-B-B1-AMZ"
            },
            {
                "site": "shein-fr",
                "expressIdCode": "HDCL",
                "expressChannelCode": "SHeMXZFH-MEX-SS-PC-B-B1-"
            },
            {
                "site": "shein-fr",
                "expressIdCode": "HJAHHAH DHJAHJDAH",
                "expressChannelCode": "SHeMXZFH-MEX-SS-PC-B-BZ"
            }
        ]
    },
    "bbl": {}
}

Response Mapping:

To ship an order, the order must be with Orders > Status “Ready for shipping“ or “Partially Shipped”

We want to introduce Courier mapping. Thus we need to create a dependant table under Courier called “Shein Courier Mapping”. In this table we need to have a dropdown field with all the carriers.

Have all this structure the mapping will works based on: If Order Shipment > Carrier match Courier > Name we send the selected courier from Shien Courier Mapping > Shein Courier

We also would like to introduce a default case in Account Shein called “Default Carrier” where again the same list with carriers to be able to select one specific carrier.

This way the logic will be first we are checking if there is any mapping set in Shein Courier Mapping and if we match any of the couriers we push the mapped value If not We are checking if there is default carrier set in Account Shein which we will be using If not we want to return an error in Order Error table.

Ship Orders

API Call: POST /open-api/order/import-batch-multiple-express API Docs: https://open.sheincorp.com/documents/apidoc/detail/3000190-2000001 Body:

{
    "orderNo": "GSON7W18T000009",
    "infoList": [
        {
            "expressCode": 423423234,
            "expressIdCode": "UPS",
            "goodsId": 3000000000019227,
            "status": 2
        }
    ]
}

Request Parameters (Request Body)

Sample request: POST https://openapi.sheincorp.com/**open-api/order/import-batch-multiple-express**

Body:

{
    "orderNo": "GSON7W18T000009",
    "infoList": [
        {
            "expressCode": 423423234,
            "expressIdCode": "UPS",
            "goodsId": 3000000000019227,
            "status": 2
        }
    ]
}

Sample Response: **200OK

Partial Success**

If the interface request succeeds but partly fails, the failed waybill will be returned on info, response code = 0

{
"Code": 0,
"Msg": "",
"Info": [
{"goodsId": xxx, "expressCode": "xxxx", "expressIdCode": "DHL ecommerce", "errorMsg": "xxxxxx", "status": 2}
]
}

If we have a partially shipped order because some of the products return error in order to handle this correctly we want to use our Order Shipment Row > Successfully shipped lines which hold the successfully shipped quantity and based on this field we will know if the whole order is shipped or we have a partial shipment so we will know what Order > Status we have to assign for the order. In such cases the whole shipment is treated as Order Shipment > Status = “Completed” only in cases where we receive all order items with errorMesg we want to set the Order Shipment > Status = “Error” and do not mark the order as “Shipped” or “Partially Shipped”

<v1.3> Once we have successfully shipped an order (fully or partially) the status should remain either Shipped or Partially shipped. We should not change the status back to Ready for Shipping, regardless of what Shein order status we have received</v1.3>

Success

If the interface request succeeds without any failure, no waybill information will be returned, info will be empty, response code = 0

{
"Code": 0,
"Msg": "",
"Info": [
]
}

Error if request error (eg.api request limit), response code! = 0, info will be a object

{
"Code": 99999,
"Msg": "api request limit 10/s",
"Info": {}
}

Response Mapping: