Using Excel to access Octopart Supply Data

The Nexar Supply Excel Add-in enables you to access pricing and availability data from right within Microsoft Excel. You can populate part information for your BOM all at once without leaving your spreadsheet.

This Add-in is supported on the Windows platform only and the versions supported are Excel for Microsoft 365 and Excel 2016. Specifically, the versions tested were Excel for Microsoft 365 MSO (16.0.14228.20216) 64-bit and Microsoft Excel 2016 MSO (16.0.14228.20216) 32-bit.

Step 1: Register at nexar.com

If you haven't done so already, you will need to register at nexar.com.

1. Sign up for a new account for free and complete the simple registration process.
2. Create your Organization. 
3. Create an Application ensuring you have the "Supply" scope switch enabled.
4. Go to your Dashboard and then Manage Applications and choose Show Details to see the Client Id and Secret credentials. 
5. NB: The Client Secret is confidential and should only be used to authenticate your Application and make requests on its behalf.

Step 2: Installation

Download the Nexar Supply Add-in binary for your system.

• Nexar Supply Excel Add-in 64-bit
• Nexar Supply Excel Add-in 32-bit

In Excel, choose 'File -> Options -> Add-ins', then press 'Go...' to manage the 'Excel Add-ins'.

Browse for the Nexar Supply Add-in, make sure it's selected, and press 'OK'.

To use the worksheet functions, simply type '=NEXAR_' and the list of functions will appear. Refer to the Excel Functions for documentation on how to use these functions.

Ribbon

A new ribbon will be added to your toolbar to make use of the new functionality.

The following table summarizes the actions of these commands.

Note the "Force Rerun All" command causes all =NEXAR_... functions to run again even if the information is up to date. This results in re-executing Nexar supply API queries again with returned parts counting against your monthly part allowance.

Excel Functions

The following functions are available through the Add-in. You can also access the guide to each argument by clicking the Function Wizard (fx) after you've selected any function. Keep in mind that across most functions, the "MPN or SKU" field is required; most other fields are optional.

The first function that you'll need to call in order to use the Add-in is:

=NEXAR_SUPPLY_LOGIN("ClientId", "ClientSecret")  

ClientId  refers to your unique Nexar Supply application Client Id key as provided by Nexar. ClientSecret  refers to your unique Nexar Supply application Client Secret key as provided by Nexar. 

• Top Tip: There are two additional, optional arguments to login and if you are a self-server customer on a subscription which doesn't include the Datasheets or Lead Time features, you'll need to pass in TRUE to one or both arguments. If you are an enterprise customer or using the free plan, no change needed.
• =NEXAR_SUPPLY_LOGIN("ClientId", "ClientSecret", "ExcludeDatasheets", "ExcludeLeadTime") 

ExcludeDatasheets  optional, defaults to FALSE , should be set to TRUE if the client is unauthorized to access datasheet data

ExcludeLeadTime  optional, defaults to FALSE , should be set to TRUE if the client is unauthorized to access lead time data.

Once you've entered these correctly, the result will read "The Nexar Supply Add-in is ready!". This login to the Nexar servers will mean your usage of supply queries from within the Add-in can be tracked and offset against your monthly quota.

Top tips for connecting:

• If you see "Please provide your Nexar application Client Id and Secret" this means the login function has not been correctly passed your Client Id or Client Secret.
• If you see "Unable to login to Nexar application, check Client Id and Secret" there may be an error in your Client Id or Secret, your application may be deleted, or there may be some other problem logging in, Check your Client Id and Secret are correct and then try "Refresh login". 
• If you see "The access token has expired, please refresh login" this is a result of a stale session. For security reasons, sessions timeout after a period of time (usually 24 hours). In this case, click the "Refresh Login" button to refresh the session. 

For accessing your Nexar supply Client Id and Client Secret, visit Nexar which you can do easily with the "Launch nexar.com" button. 

From here on, the world is your oyster:

=NEXAR_SUPPLY_AVERAGE_PRICE(...)

=NEXAR_SUPPLY_DATASHEET_URL(...)

=NEXAR_SUPPLY_DETAIL_URL(...)

=NEXAR_SUPPLY_SHORT_DESCRIPTION(...)

=NEXAR_SUPPLY_DISTRIBUTOR_LEAD_TIME(...)

=NEXAR_SUPPLY_DISTRIBUTOR_MOQ(...)

=NEXAR_SUPPLY_DISTRIBUTOR_ORDER_MUTIPLE(...)

=NEXAR_SUPPLY_DISTRIBUTOR_PACKAGING(...)

=NEXAR_SUPPLY_DISTRIBUTOR_PRICE(...)

=NEXAR_SUPPLY_DISTRIBUTOR_SKU(...)

=NEXAR_SUPPLY_DISTRIBUTOR_STOCK(...)

=NEXAR_SUPPLY_DISTRIBUTOR_URL(...)

=NEXAR_SUPPLY_LOGIN(...)

=NEXAR_SUPPLY_VERSION(...)

For results that come in a URL format (e.g., for =NEXAR_SUPPLY_DATASHEET_URL , =NEXAR_SUPPLY_DETAIL_URL or =NEXAR_SUPPLY_DISTRIBUTOR_URL , click the "Update Hyperlinks" button to activate the links.

Sample Spreadsheet

A sample spreadsheet, including examples of functions as well as a small (and unrealistic) Bill-of-Materials (BOM), is provided. 

• Sample Excel

Building the Excel Add-in (windows)

If you are wanting to build a local copy of the add-in, you can follow this guide.

• Building the Excel add-in