A must to-do at Client end when we have to onboard such client:

This needs to be done because in technosys API payload we don't get SKU field, So we create SKU by using above mentioned fields. (For reference, sharing the payload we receive from Technosys):

{
        "Id": 616487,
        "Barcode": "10009596",
        "Brand": "MARKHOR",
        "Color": "TEL",
        "CreatedAt": "2023-05-31T16:18:02.18",
        "Detail": "",
        "Flavor": "PLAIN",
        "GenericSetup": null,
        "HSCode": "6114",
        "IsDecimalAllow": false,
        "IsParent": null,
        "IsPrintableBarcode": true,
        "Manufacturer": null,
        "Name": "CASUAL SHIRT CS-LNN-1618-23-A-0256-00 TEL 2XL 0523 ",
        "PackaingType": "1",
        "ProductArticle": "CS-LNN-1618-23-A-0256-00",
        "ProductCategory": "CASUAL SHIRT (2023)",
        "ProductCategoryId": 24178,
        "ProductDesign": "1618",
        "ProductPackageDescription": null,
        "ProductType": "Purchase and Sale",
        "Region": "None",
        "SaleRate": 4750,
        "Season": "0523",
        "ShortName": "CASUAL SHIRT 1618 TEAL 2XL 0523",
        "Size": "2XL",
        "TaxCalculation": "Tax on Sale Rate excl. disc.",
        "TaxGroupId": 1,
        "TaxRate": 15,
        "TopLevelProductCategory": "CASUAL SHIRTS",
        "TopLevelProductCategoryId": 24112,
        "UpdatedAt": "2024-06-07T19:15:32.753",
        "Variant": "LINEN",
        "Vendor": null
    }

Action Items

Details

Additional Details

Onboard brand on XAP

via API

Install app on Shopify store

Onboard brand on OE

via API

Get these details from Client:

  1. Technosys Base URL

  2. Username and password for API authentication (basic Auth)

  3. Location details (Location name and location ID on technosys)

  4. Courier details (Courier name and merchant ID)

  5. Also pls confirm if you will be treating barcodes of your products as SKU or not ?

  6. We also need to get TSapp_key from technosys.

1,2, 3 will be provided by BX team.

We need to add locations of BX in OE

APIs needed :

  1. Brand creation

  2. Get brand details

  3. Update brand details

  1. curl --location 'http://localhost:8080/oe-adapter/technosys/api/createBrand' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Allure Beauty",
    "username:": "E00102005",
    "password": "E00102005",
    "status": true,
    "locations": [
        {
            "OELocationId": 1162,
            "enable": true,
            "locationId": 2002,
            "name": "Dolmen Mall Clifton"
        },
        {
            "OELocationId":1163 ,
            "enable": true,
            "locationId": 3,
            "name": "Habit Market"
        }
    ],
    "OEBrandId": "862",
    "OEUsername": "oe.adapters@xstak.com",
    "OEPassword": "Admin12345@",
    "OERealm": "7cac3f9f84136400",
    "TSBaseUrl": "http://178.18.246.105:9820/TSBE/EStore",
    "TSAuthToken": "Basic RTAwMTAyMDA1OkUwMDEwMjAwNQ==",
    "TSKey": "limitless",
    "prodMappingConfig": false,
    "discountApiConfig": false,
    "couriers": [
        {
            "name": "test",
            "merchantId": "testing123"
        }
    ],
    "brandEmail": "noreen.ayesha@xstak.com",
    "inventorySyncPause": false,
    "productSyncPause": true
}'

  2. curl --location 'https://oeprocessing.shopistan.pk/oe-adapter/technosys/api/getBrandDetails/812'

  3. curl --location --request PUT 'http://localhost:8080/oe-adapter/technosys/api/updateBrand/862' \
--header 'authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJEV1FoVVpkWWhGTlEzUVBPS0JoNTV5eTRER1ZyUFBLMF9SNkNkcXFwckEwIn0.eyJleHAiOjE2ODYyMTg4ODUsImlhdCI6MTY4NjIxODU4NSwianRpIjoiNDVlNjBiN2YtYmM3My00NzZhLWE2ZTgtOGU4MjM2YTkzNzIwIiwiaXNzIjoiaHR0cHM6Ly9rZXljbG9hay1saXZlLnhzdGFrLmNvbS9hdXRoL3JlYWxtcy94c3RhazEiLCJhdWQiOiJhY2NvdW50Iiwic3ViIjoiMDU4NWQxNGUtOTgxMC00ZmU5LTgyZGMtMzhiNGYwNmNhODMwIiwidHlwIjoiQmVhcmVyIiwiYXpwIjoiY29waWxvdCIsInNlc3Npb25fc3RhdGUiOiI3Mjg3YzUwYy01YzNkLTRmYjItOTFlMi0wMTUyYjNjMjhiNjYiLCJhY3IiOiIxIiwicmVhbG1fYWNjZXNzIjp7InJvbGVzIjpbIm9lIiwib2ZmbGluZV9hY2Nlc3MiLCJkZWZhdWx0LXJvbGVzLXhzdGFrMSIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiY29waWxvdCI6eyJyb2xlcyI6WyJ2aWV3X2Rhc2hib2FyZCIsInZpZXdfdXNlcnMiLCJlZGl0X3VzZXJzIiwiYWRkX3VzZXJzIl19LCJhY2NvdW50Ijp7InJvbGVzIjpbIm1hbmFnZS1hY2NvdW50IiwibWFuYWdlLWFjY291bnQtbGlua3MiLCJ2aWV3LXByb2ZpbGUiXX19LCJzY29wZSI6InByb2ZpbGUgZW1haWwiLCJzaWQiOiI3Mjg3YzUwYy01YzNkLTRmYjItOTFlMi0wMTUyYjNjMjhiNjYiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsIm5hbWUiOiJhYnViYWthciBraGFuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiYWJ1YmFrYXIua2hhbkBzaG9waXN0YW4ucGsiLCJnaXZlbl9uYW1lIjoiYWJ1YmFrYXIiLCJmYW1pbHlfbmFtZSI6ImtoYW4iLCJlbWFpbCI6ImFidWJha2FyLmtoYW5Ac2hvcGlzdGFuLnBrIn0.mHTMnIZQcjwCWv6xG7ciUbSKJ9Pj6fKV1nxN5msuEsmsydVwtV5gqoFGJIjjeZw1P9rhHDqbmAo3BP81kOiM7sR4flmsz6kO3-y1AtnbJnvV_X67XovyOBZVr0A0f8wnD-IOa0UoG__uKUdMQm0X3uP9uFZOUlzaUWOrq0WEtTOC7uM7YRk0C7LJZR-Vk3-lOaJtghfwE0sxJ7HOrqYe4Rgzb9ybmgYJZBOdeRxLKKq7QEDGORantPH_cwZzkPdRcZafeN3RWfRq6LdAgdEE4YrLbbUmPkuM-kga_TpemkX7vHMj7kNG0ibFdccnNrZoi3Rr29pAPYnMvWKbnFPYCA' \
--header 'Content-Type: application/json' \
--data '{
    "couriers": [
        {
            "name": "PostEx-Allure Beauty-AB-",
            "merchantId": "6"
        },
        {
            "name": "Swyft-Allure Beauty-AB-",
            "merchantId": "6"
        },
        {
            "name": "Call Courier-Allure Beauty-AB-",
            "merchantId": "6"
        }
    ]
}'

Delivery team don’t have to run any of these APIs as all this is to be done by product team.

Cron Set up

Testing Phase