# Import suppliers

With Fairmarkit, you will invite suppliers to respond to your events in Fairmarkit. In addition to the suppliers in the Fairmarkit database, you can sync your list of registered suppliers and contacts to Fairmarkit from your purchasing application.

### Supplier data <a href="#supplierdata" id="supplierdata"></a>

The following table outlines the column headers you will need to create when you import your suppliers into Fairmarkit. The \*required fields are marked, and the remaining fields are optional but recommended. All fields are used to improve your supplier recommendations on events.

Template: Make sure you have the latest version of the flat file template ([view](https://docs.google.com/spreadsheets/d/1INb94RFKXMIBECHJ0DEpPo4EiY7iUvetkmloNSABD8o/edit#gid=0) | [download CSV file](https://docs.google.com/spreadsheets/d/e/2PACX-1vSsskPZC9mulbFftbuowuzDwLg43wu2SiFVbOWLulELeU0Pvr61n9e0LgwQ-jyt7KJEdnaRNtBt8wBq/pub?gid=0\&single=true\&output=csv)).

| [Fairmarkit field](broken://pages/nnmG7CqlApAGFJ5hJpzw) | [Header](broken://pages/nnmG7CqlApAGFJ5hJpzw) | [Description](broken://pages/nnmG7CqlApAGFJ5hJpzw) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------- | --------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \*                                                      | Supplier ID                                   | supplier\_id                                       | <p>Supplier ID in your purchasing application.</p><p>Data type: Text</p><p><em>Example: S1000</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| \*                                                      | Supplier Title                                | supplier\_title                                    | <p>Name or title of the supplier.</p><p>Data type: Text</p><p><em>Example: Catherine's Coffee Shop</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| \*                                                      | Supplier Email                                | supplier\_email                                    | <p>Supplier's email. Fairmarkit does not validate the email.</p><p>Data type: Text</p><p><em>Example: <catherine@example.com></em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|                                                         | Address1                                      | supplier\_address1                                 | <p>Supplier's address - line 1.</p><p>Data type: Text</p><p><em>Example: 1234 Main St</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|                                                         | Address2                                      | supplier\_address2                                 | <p>Supplier's address - line 2.</p><p>Data type: Text</p><p><em>Example: Floor 2</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                                                         | City                                          | supplier\_city                                     | <p>Supplier's city</p><p>Data type: Text</p><p><em>Example: Boston</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|                                                         | State                                         | supplier\_state                                    | <p>Supplier's state.</p><p>Data type: Text</p><p><em>Example: MA</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|                                                         | Zip                                           | supplier\_zip                                      | <p>Supplier's zipcode.</p><p>Data type: Text</p><p><em>Example: 02445</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| \*                                                      | Country                                       | supplier\_country                                  | <p>Supplier's country. This value can be a country name, Alpha-2, Alpha-3.</p><p>Data type: Text</p><p><em>Example: US</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                                                         | Contact First Name                            | supplier\_first\_name                              | <p>Supplier contact's first name.</p><p>Data type: Text</p><p><em>Example: Catherine</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                                                         | Contact Last Name                             | supplier\_last\_name                               | <p>Supplier contact's last name.</p><p>Data type: Text</p><p><em>Example: Jones</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|                                                         | Phone Number                                  | supplier\_phone\_number                            | <p>Supplier contact's phone number.</p><p>Data type: Text</p><p><em>Example: 617-123-4567</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                         | Fax Number                                    | supplier\_fax\_number                              | <p>Supplier contact's fax number.</p><p>Data type: Text</p><p><em>Example: 617-123-7654</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|                                                         | Is Active                                     | supplier\_is\_active                               | <p>Is the supplier active? This value is not case sensitive.</p><p><strong>Default value: True</strong></p><p>Data type: Text</p><p><em>Example value: TRUE</em></p><p>Accepted values:y,yes,t,true,on,1,n,no,f,false,off,0</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|                                                         | Originating ERP System                        | supplier\_erp\_system                              | <p>The purchasing application associated with the supplier.</p><p>Data type: Text</p><p><em>Example: SAP Ariba</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|                                                         | Supplier Tag XXX                              | supplier\_tag\_*XXX*                               | <p>Supplier tag. Replace XXX with your value. For example, add plant for supplier\_tag\_plant. You can add as many supplier tags as needed.</p><p>Data type: Text</p><p><em>Example: P663</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|                                                         | Supplier Meta Tag XXX                         | supplier\_meta\_tag\_XXX                           | <p>Supplier meta tag. Replace XXX with your value. For example, add account for supplier\_meta\_tag\_account. You can add as many supplier meta tags as needed.</p><p>Data type: Text</p><p><em>Example: preferred</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|                                                         | Supplier Category XXX                         | supplier\_category\_XXX                            | <p>Supplier category. Replace XXX with your value. The value does not have to related to a category. For example, supplier\_category\_1, supplier\_category\_2.</p><p>Data type: Text</p><p><em>Example: Coffee</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|                                                         | Supplier Business Classification XXX          | supplier\_business\_ classification\_XXX           | <p>Supplier business classification. Replace XXX with your value. The value does not have to be related to a business calculation. For example, supplier\_business\_classification\_1, supplier\_business\_classification\_2.</p><p>Data type: Text</p><p>Example: sdvet</p><p>Accepted values:</p><ul><li>8a</li><li>Alaskan</li><li>bcorp</li><li>Dbe</li><li>Dobe</li><li>Edwosb</li><li>Fairtrade</li><li>Fsc</li><li>Gsa</li><li>Hbcu</li><li>International\_soc\_automation</li><li>Iso\_9001</li><li>Lbe</li><li>Lgbt</li><li>Minority\_business\_enterprise</li><li>Msc</li><li>Sdb</li><li>Sdvbe</li><li>Sdvet</li><li>small\_business\_certification</li><li>small\_business\_enterprise</li><li>Veteran\_business\_enterprise</li><li>Woman\_owned\_business\_enterprise</li><li>Wosb</li></ul> |
|                                                         | Additional Information                        | additional\_info\_XXX                              | <p>Space for additional information.</p><p>Data type: Text</p><p><em>Example: Boston</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fairmarkit.com/buyers/integrations/flat-file-integration/import-data/import-suppliers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
