SKUCreation v3 - Open-API

This API is used to sync Seller's SKU from 3PP to OC.
The seller has SKUs maintained on the 3PP site, and they want to enroll in the eBay fulfillment program. Then they sync their SKUs that already existed on the 3PP site to the OC platform. This API support batch sync.
The max number of SKU in a single request is 2000.
In one call, 3PP should sync no more than 200 SKUs.

Request

Header Params

Body Params application/json

Example

{
    "data": [
        {
            "batteryForm": "PB",
            "batteryNumber": 3,
            "batteryType": "OLB",
            "SKUdescription": "Alte Berufe",
            "countryOfOrigin": "GB",
            "SKUPictureURLList": [
                {
                    "SKUPictureURL": "https://mf-seller-static-cn.orangeconnex.com//attachement/2020/8/10/400242276476911680.jpg"
                }
            ],
            "leafCategoryID": "85980",
            "leafCategoryDescription": "Godsmack",
            "dimensionUnit": "cm",
            "serviceRegionList": [
                {
                    "serviceRegion": "DE",
                    "ebayCustomLabel": "",
                    "withBrand": "AFOB",
                    "brandName": "Apple",
                    "ResponsiblePersonCode": "4324343243",
                    "vasCode": "A18"
                },
                {
                    "serviceRegion": "UK",
                    "ebayCustomLabel": "",
                    "withBrand": "AFOB",
                    "brandName": "Apple",
                    "ResponsiblePersonCode": "4324343243"
                }
            ],
            "fileList": [
                {
                    "fileType": "MSDS",
                    "fileUrl": "https://mf-seller-static-cn.orangeconnex.com/attachement/2020/10/29/429312232363393088.pdf"
                },
                {
                    "fileType": "CE",
                    "fileRegion": "DE",
                    "fileUrl": "https://mf-seller-static-cn.orangeconnex.com/attachement/2020/10/29/429312232363393088.pdf"
                },
                {
                    "fileType": "BRANDAUTH",
                    "fileRegion": "DE",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "UN",
                    "fileRegion": "",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "DOT",
                    "fileRegion": "US",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "CPC",
                    "fileRegion": "US",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                }
            ],
            "registeredHeight": 43,
            "registeredLength": 12,
            "registeredWeight": 24,
            "registeredWidth": 24,
            "remark": "phone",
            "SKUNameList": [
                {
                    "SKUName": "iphone X-车灯",
                    "languageCode": "en-US",
                    "attributeDescription": "Green, Large"
                }
            ],
            "salesURL": "https://i.ebay.com/100004770263.html",
            "referenceSKUID": "3PP20254545154546566753",
            "itemID": "43325436546546554354654",
            "hscodeList": [
                {
                    "destinationCountry": "OEU",
                    "hsCode": "12345678",
                    "declaredValue": "1",
                    "currency": "EUR"
                },
                {
                    "destinationCountry": "IE",
                    "hsCode": "0123456789",
                    "declaredValue": "1",
                    "currency": "EUR"
                }
            ],
            "tag": "PO",
            "weightUnit": "kg",
            "withBattery": true,
            "SIOC": true
        }
    ],
    "messageId": "20200430022533014",
    "timestamp": 1588227933039
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi-stage-hk.orangeconnex.com/openapi/3pp/sku/v3/creation' \
--header 'clientKey;' \
--header 'vAuthorization;' \
--header 'Access-Token;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "batteryForm": "PB",
            "batteryNumber": 3,
            "batteryType": "OLB",
            "SKUdescription": "Alte Berufe",
            "countryOfOrigin": "GB",
            "SKUPictureURLList": [
                {
                    "SKUPictureURL": "https://mf-seller-static-cn.orangeconnex.com//attachement/2020/8/10/400242276476911680.jpg"
                }
            ],
            "leafCategoryID": "85980",
            "leafCategoryDescription": "Godsmack",
            "dimensionUnit": "cm",
            "serviceRegionList": [
                {
                    "serviceRegion": "DE",
                    "ebayCustomLabel": "",
                    "withBrand": "AFOB",
                    "brandName": "Apple",
                    "ResponsiblePersonCode": "4324343243",
                    "vasCode": "A18"
                },
                {
                    "serviceRegion": "UK",
                    "ebayCustomLabel": "",
                    "withBrand": "AFOB",
                    "brandName": "Apple",
                    "ResponsiblePersonCode": "4324343243"
                }
            ],
            "fileList": [
                {
                    "fileType": "MSDS",
                    "fileUrl": "https://mf-seller-static-cn.orangeconnex.com/attachement/2020/10/29/429312232363393088.pdf"
                },
                {
                    "fileType": "CE",
                    "fileRegion": "DE",
                    "fileUrl": "https://mf-seller-static-cn.orangeconnex.com/attachement/2020/10/29/429312232363393088.pdf"
                },
                {
                    "fileType": "BRANDAUTH",
                    "fileRegion": "DE",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "UN",
                    "fileRegion": "",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "DOT",
                    "fileRegion": "US",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                },
                {
                    "fileType": "CPC",
                    "fileRegion": "US",
                    "fileUrl": "https://mf-seller-static-pre-release-cn.orangeconnex.com/attachement/sku/brand_registration/2021/6/18/513398518610657280.pdf"
                }
            ],
            "registeredHeight": 43,
            "registeredLength": 12,
            "registeredWeight": 24,
            "registeredWidth": 24,
            "remark": "phone",
            "SKUNameList": [
                {
                    "SKUName": "iphone X-车灯",
                    "languageCode": "en-US",
                    "attributeDescription": "Green, Large"
                }
            ],
            "salesURL": "https://i.ebay.com/100004770263.html",
            "referenceSKUID": "3PP20254545154546566753",
            "itemID": "43325436546546554354654",
            "hscodeList": [
                {
                    "destinationCountry": "OEU",
                    "hsCode": "12345678",
                    "declaredValue": "1",
                    "currency": "EUR"
                },
                {
                    "destinationCountry": "IE",
                    "hsCode": "0123456789",
                    "declaredValue": "1",
                    "currency": "EUR"
                }
            ],
            "tag": "PO",
            "weightUnit": "kg",
            "withBattery": true,
            "SIOC": true
        }
    ],
    "messageId": "20200430022533014",
    "timestamp": 1588227933039
}'

Responses

🟢200OK

application/json

Body

Examples

SuccessException

{
    "code": 0,
    "data": [
        {
            "MFSKUID": "OC0123456789012",
            "referenceSKUID": "3PP43434565786y6"
        },
        {
            "MFSKUID": "OC0123456789013",
            "referenceSKUID": "3PP43892432473"
        }
    ],
    "message": "Interface call succeeded.",
    "messageId": "20200430022533014"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found