/
OE x Technosys Integration

OE x Technosys Integration

Owned by Noreen Ayesha
Last updated: Jul 29, 2024 by Delivery Team (Deactivated)
2 min read

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

  • All products on Technosys should be Visible to web. This steps needs to be done for all products for which they want the changes of Price and inventory to reflect on Shopify via OE.

  • If the barcode of a product on BX is not the SKU of that product on Shopify then client have to update their SKUs on Shopify in a specific format i.e. (product_article_color_size ). Consider an SKU , SH00272-2PC-STR_RED_M . In this SKU, SH00272-2PC-STR is the product_article field, RED is the color field and M is the size field of this product on BX. So, SKU should be created by combining these three field of BX.

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

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

 

 

Related content