Salla Integration to Shipedge

In this article, we are going to show you how to create a Salla integration.

There are two procedures to establish a successful connection. One on the Salla platform and the second one on the Shipedge system.

TABLE OF CONTENTS

• Salla Initial Steps
• Shipedge Steps
• Salla Final Steps

Salla Initial Steps

1. Log in to https://salla.partners/ go to the left-hand menu and click on the create an APP button.
2. Select “Private App”. Click on continue.
3. There are 4 fields to complete information in this section. App Name, App Description, App website, and support email.We are going to explain what should be placed on those fields.
   1. Name, we highly suggest you keep the name simple like storeName_Shipedge. So it is easy to recognize.
      1. Note: There is a language switch that toggles between Arabic and English. The app name has to be submitted in both formats, click on the icon at the right edge of the app name box to switch the language.
   2. This is personal for you but is ok to have a complete description. Something like: This application integrates with Shipedge OMS for: Getting Orders, Update Tracking, and Sync Inventory.
   3. The App website is: https//www.shipedge.com
   4. The App support email is: help@shipedge.com
   5. Click on Create App.
4. The next view is the App’s general settings view.
5. In this section, make sure that the Custom Mode is checked.
6. In the next section, Callback URLs are as follows:
   1. https://shipedge.com/get-started-shipedge/https://dev2integration.shipedge.com/MultiChannel/salla/app_callbackhttps://oauth.pstmn.io/v1/browser-callback
7. In the following section, App Scope, the following attributes must be checked with the read and write option.
   1. – orders – metadata – shipping – webhooks – products
   2. The other attributes must have the read-only option checked.
8. The webhook/notification field must be filled out with this URL:  https://connector.shipedge.com/app_callback/salla
9. Choose the Merchant Store field. This option is at the bottom of the configuration page.
   1. In this section you have to place the store URL you are willing to connect. Navigate to the Stores option on the left-side menu and click on the Store URL to copy the URL. (This is a demo account so the image is just a guide).
   2. Go back to the app configuration panel. and paste the URL in the Choose Merchant field. Do not click on Request access just yet. Before that, we need to request the connection from the Shipedge platform. We are going to get back to this section to complete this procedure soon.
   3. IMPORTANT NOTE your store URL is a long URL code. If we copy/paste that URL in the merchant store field the connection will fail, and an error message will be displayed indicating that that URL does not exist. To solve this issue you have to take a closer look at your URL.
   4. Ex https://salla.sa/dev-e_yourstore_code?expires=1669920429&identifier=643119423&utm_source=portal&signature=c74bc4d0a56c15fc3eb6eae55124fcbb2d6b35185ab371cba46f165fa3119f71
   5. In the example above we just need the info before the question mark, whatever it is after the question mark is not needed including the question mark. The URL to use will look like this.
   6. https://salla.sa/dev-e_yourstore_code Please keep this in mind.

Shipedge Steps

1. To integrate Salla, simply go to Shipedge OMS > My Account > Preferences > Channel Automation and look for Salla. Add a specific name for your integration. and click on add store. if any alert comes up click on OK
2. New options will be available. API Parameters is the first one.
   1. Under this section, you will be asked for the client ID and Client’s Secret both can be found under the private app created in Salla previously.
   2. Salla client’s ID and client’s secret.
   3. Copy those credentials and place them into the Shipedge API parameters section.
   4. Now, click on Authorize., a red button is placed above the client id field. A prompt to log in to Salla will pop up. The mail field here is the one from the Salla platform.This mail must be placed here in addition to the password.
   5. On this screen you can click on authorize app.
   6. This message will appear in the response.
3. To finish the Shipedge connection you can check the following sections. Orders, Sync Inventory, and Update tracking number. You can fill the order section with the format DD:MM:YY.
   1. For the inventory.
   2. ****We highly suggest you do NOT check these two boxes in the Update Inventory section until your SKUs have been received into the Warehouse Management System. This will prevent any discrepancies in your inventory quantities on Salla.
4. Address Verification, Residential Check, and Ship Method Translator.
   1. Hover on the Orders section and then select Integrations. Then, look up the Salla integration name you set up before.
   2. Click on the tool icon and check the Address Verification & Residential Check.
   3. Ship Methods and API Errors.
      1. As this is considered a new integration some orders may initially come in with an API Error. As they do please be sure to map the shipping methods to prevent errors on future orders.
         
         You can also map the Ship Methods by clicking the Checklist Icon and then selecting ShipMethod Translator.
5. You are all set up on the Shipedge side. Let’s continue the final steps on the Salla side.

Salla Final Steps

1. Right where we left off on the Salla configuration. Now you can click on Update Request Access. your screen will look like this.
2. To approve this request now you have to go to your store menu and click on dashborad.
3.  On this view go to the right-hand side menu and look up the Installed Applications and click on it.
4. There you will have an alert asking you to consent or reject the requested connection, click on consent.
5. On the next view click on authorize App. And that will conclude with the connection process.
6. Your previous page now will display the connection established thru the private app.