To read your products, nashir needs an API key from your EasyOrders store. You create it yourself in your EasyOrders dashboard. It takes about 2 minutes and you do not need a developer.
What to know before you start:
- The key needs one permission only: Read Products. With only that permission it can read your products and nothing else. It cannot change your store, your orders or your customers.
- The key is yours. You can delete it or turn it off at any time, and nashir stops reading at once.
- Products you hid in EasyOrders and products with no price are not imported.
You will copy two values into nashir: your store address and the API key.
Step 1: Find your store address
Your store address is the one your customers open. Every EasyOrders store has an address that ends in .myeasyorders.com, for example yourstore.myeasyorders.com. If you connected your own domain, you can use it instead.
If you are not sure, open Domain Settings in your EasyOrders dashboard, or open your store in the browser and copy the address.
Step 2: Create the key
- In your EasyOrders dashboard, open Settings (in the Arabic dashboard: الأعدادات).
- Open Public API, then Public API again.
- Press Create (in the Arabic dashboard: إنشاء).
- In description, write
nashir. - Under Permissions, tick Read Products only. In the Arabic dashboard it is called الوصول الي المنتجات.
- Make sure Is Active is on.
- Save.
Step 3: Copy the key
EasyOrders now shows the key. Copy it now: it may not be shown again. If you lose it, create a new key.
Treat the key like a password: do not send it in a chat or an email.
Step 4: Connect in nashir
- Open the Stores page in nashir:
- Open EasyOrders, then fill in the Store address and the API key, and choose the business.
- Press Check store. nashir shows how many products it will import, the first few as it read them, and the currency of the prices. Nothing is imported yet.
- If nashir cannot tell your store's currency from its settings (for example, your store shows prices with "$"), it asks you to choose the currency from a list, then to check again.
- Press Connect and import. If the business already has products you added by hand, nashir shows how many will be replaced and asks you to confirm first.
After the first import, nashir reads your products again every 6 hours by itself. New products are added, prices and stock are updated, and products you deleted or hid are archived. To update at once, press Re-run import on the card.
What is imported
| From your store | In nashir |
|---|---|
| Products that are not hidden and have a price | Imported |
| Products with options (colour, size…) | Imported with each option and its own price and stock |
| Price and sale price | Both. The sale price is used when it is lower than the price |
| Stock, when you track the quantity of a product | Imported. With quantity 0 and Disable When Out of Stock on, the product is out of stock |
| Photos, categories, the product link | Imported |
| A hidden product (Hidden Product) | Not imported. If you hide a product later, it is archived in nashir at the next sync |
| A product with no price | Not imported |
Language. EasyOrders keeps one name and one description per product. nashir reads them as they are.
Currency. Prices are imported in your store's currency. A product with its own currency (Custom Currency) keeps it. If a product's own currency cannot be read, that product is left out and the check screen says so.
Fake stock. The "fake stock" counter some stores show ("only 5 left") is never read. nashir uses only the real quantity.
If something goes wrong
| What nashir says | What to do |
|---|---|
| EasyOrders did not accept this API key | Copy the key again, in full. If it was deleted or turned off, repeat step 2. |
| The key works, but it is not allowed to read products | Open the key in Settings, Public API, tick Read Products and save. Or repeat step 2. |
| This API key belongs to another EasyOrders store | Write the address of the store the key was created in. |
| We found no EasyOrders store at this address | Do step 1 again. The address ending in .myeasyorders.com always works. |
| EasyOrders limits each API key to 40 requests a minute | Wait a few minutes and try again. If another app uses the same key, create a separate key for nashir. |
| We could not reach your store or EasyOrders | Check that your store opens in the browser, then press Retry import. |
| Your EasyOrders store is not active | Top up your wallet in EasyOrders or pay what is due, so the store is active again. While it is not active, EasyOrders lets nobody read it. |
To stop nashir reading your store, press Disconnect store on the card in nashir. To also cancel the key, open Settings, Public API in your EasyOrders dashboard and delete the key named nashir.
If you create a new key later, press Disconnect store on the card in nashir, then connect again with the new key. Your products come back as they were.
If the sync fails, nothing in your catalog is changed or removed. After 3 failed syncs in a row, the card shows a warning and the team owner gets an email.