Import templates
The template file is generated in Spanish: its sheets, column headers and
dropdown values are the Spanish ones (for example Crear, Actualizar,
Eliminar). This page shows their English meaning; keep the Spanish values
in the file.
Summary
There are five templates: contacts, products, services, projects and distributors. Each one is the same Excel file that the Export button on its screen downloads. This is the column-by-column detail; the wizard's step-by-step is in Imports.
Common rules
| Rule | Detail |
|---|---|
| File | CSV, XLS or XLSX, up to 10 MB. In Excel only the first sheet is read; the first row holds the column names. |
| Export | Up to 10,000 rows, respecting the view, filters and search. |
| Excel sheets | The data sheet, the Instructions sheet and a hidden sheet with the dropdown values. |
| ID | First column, in gray. Do not edit or delete it. New rows go without an ID. |
| Action | Second column: Create, Update or Delete (empty = whatever you choose in the wizard). It is empty when you export. |
| Empty cell | "Do not touch this value". It never deletes. |
| Dropdowns | Only accept the values in the list. Any other text is ignored (Excel warns with Value not in list). |
| Gray columns | Informational: editing them changes nothing. |
| Numbers | Formats such as 1.234,56, 189.900 or 1,234.56 are accepted; currency symbols are ignored. Negative numbers are not accepted. |
| Lists inside a cell | Separated by commas (;, ` |
What each Action does:
| Action | If the record exists | If it does not exist |
|---|---|---|
| (empty) | The wizard's duplicates option applies (Skip, Replace, Create anyway or row by row) | It is created |
| Create | It is skipped | It is created |
| Update | It is overwritten | It is created |
| Delete | Soft delete (recoverable from the Trash) | It is skipped |
| Any other value | Error: Unrecognized action. Use the dropdown: Create, Update or Delete. | — |
Reference table
Contacts ("Contacts" sheet)
A row is considered the same contact if the ID, the email or the phone matches (in that order).
| # | Column | Required | Values and rules |
|---|---|---|---|
| 1 | ID | No | Gray. Internal identifier. |
| 2 | Action | No | Create · Update · Delete |
| 3 | Yes | Must be valid. | |
| 4 | First name | No | Text. |
| 5 | Last name | No | Text. |
| 6 | Phone | Yes | Not required in rows with Delete. The country code comes from the number itself (+CC), from Country code or from the workspace's default country (if there is none, +57). |
| 7 | Country code | No | For example +57. |
| 8 | Company | No | By name, ignoring case and accents. If it does not exist, it is created only with permission to create companies and the Companies module on; otherwise it stays as text with a warning. BORRAR unlinks it. |
| 9 | Company tax ID | No | The lookup is by tax ID (NIT) first. A tax ID without a name that does not match leaves the contact without a company, with a warning. |
| 10 | Job title | No | Text. |
| 11 | Contact type | No | Individual · Company |
| 12 | Industry | No | Value from the dropdown. |
| 13 | Company size | No | Just me (1 person) · 2 – 5 employees · 6 – 10 employees · 11 – 25 employees · 26 – 50 employees · 51 – 100 employees · 101 – 200 employees · 201 – 500 employees · More than 500 employees |
| 14 | City | No | Text. |
| 15 | Country | No | Text. If it is missing when creating, it is set to Colombia. |
| 16 | Status | No | Lead · Customer · Lost |
| 17 | Source | No | Manual · File import · Web form · External integration · API · CRM sync · Landing page · Other |
| 18 | Acquisition channel | No | Meta Ads · Google Ads · Organic search · Referral · Email marketing · WhatsApp · Phone call · Event · Website · Organic social · Partner · Other |
| 19 | Medium | No | CPC · Social · Email · Landing page · Form · Direct message · Call · Direct referral · QR · Other |
| 20 | Campaign | No | Free text. |
| 21 | Sales rep (email) | No | Email of an active team member (dropdown). If it is not one, the sales rep does not change and a warning is left. BORRAR leaves it without a sales rep. |
| 22 | Customer type | No | Free text (up to 80 characters). |
| 23 | Qualification | No | Hot · Warm · Cold. Whatever you write counts as a manual decision: AI classification no longer changes it. |
| 24 | Tags | No | Comma-separated, up to 50. They replace the contact's tags. Tags that do not exist are created only with permission (tag.create); otherwise they are skipped with a warning. BORRAR removes them all. |
| 25 | Lists | No | Same as Tags; creating lists requires contacts.createList. BORRAR removes the contact from every list. |
| 26 | Segments | — | Gray, read-only. It is calculated from each segment's rules and is not imported. |
| 27 | Notes | No | Text. |
BORRAR is recognized regardless of case; eliminar, quitar, ninguna,
ninguno and - also work.
Products ("Products" sheet)
A row is considered the same product if the ID or the SKU matches.
| # | Column | Required | Values and rules |
|---|---|---|---|
| 1 | ID | No | Gray. |
| 2 | Action | No | Create · Update · Delete |
| 3 | SKU | Yes | Stored in uppercase. |
| 4 | Name | Yes* | |
| 5 | Brand | No | Dropdown with the workspace's brands. It must exist: otherwise the row fails (That brand doesn't exist. Create it in the catalog first, then import again.). |
| 6 | Price | Yes* | Number greater than or equal to 0. |
| 7 | Description | No | |
| 8 | Wholesale price | No | Number greater than or equal to 0. |
| 9 | E-commerce price | No | Number greater than or equal to 0. |
| 10 | Stock status | No | Available · Out of stock · On request |
| 11 | Main image (URL) | No | Public http(s) link; it is downloaded to the platform. JPG, PNG, WebP, GIF or AVIF up to 15 MB. BORRAR deletes the image. |
| 12 | Image gallery (URLs) | No | Up to 10 comma-separated links. It replaces the gallery. BORRAR empties it. |
| 13 | Video gallery (URLs) | No | Up to 5 links, up to 100 MB each, MP4, WebM or MOV. YouTube and Vimeo do not work. It replaces the videos. BORRAR empties them. |
| 14 | Technical sheet (URL) | — | Gray, read-only. |
| 15 | Barcode | No | |
| 16 | Model | No | |
| 17 | Technical name | No | |
| 18 | Country of origin | No | |
| 19 | Website | No | |
| 20 | E-commerce ref. | No | |
| 21 | Provider | No | Free text. |
*Not required in rows with Delete.
Categories, subcategories, families and sales channels are not in the template: they are assigned from the catalog.
Google Drive links work if the file is shared as "Anyone with the link". Images and videos are processed after the import; if any fails, a warning is left in the report.
Services ("Services" sheet)
A row is considered the same service if the ID or the Name (exact) matches.
| # | Column | Required | Values and rules |
|---|---|---|---|
| 1 | ID | No | Gray. |
| 2 | Action | No | Create · Update · Delete |
| 3 | Name | Yes | |
| 4 | Description | No | |
| 5 | Price | No | Number greater than or equal to 0. |
| 6 | Duration | No | Free text. |
| 7 | Currency | No | Free text. |
| 8 | Warranty | No | |
| 9 | Image (URL) | No | The link is stored as is. |
| 10 | Success stories (URLs) | — | Gray, read-only. |
Projects ("Projects" sheet)
A row is considered the same project if the ID or the Name (exact) matches.
| # | Column | Required | Values and rules |
|---|---|---|---|
| 1 | ID | No | Gray. |
| 2 | Action | No | Create · Update · Delete |
| 3 | Name | Yes | |
| 4 | Description | No | |
| 5 | Minimum price | No | Number greater than or equal to 0. |
| 6 | Maximum price | No | Number greater than or equal to 0; it cannot be lower than the minimum. |
| 7 | Currency | No | Free text. |
| 8 | Image (URL) | No | The link is stored as is. |
| 9 | Image gallery (URLs) | — | Gray, read-only. |
| 10 | Video gallery (URLs) | — | Gray, read-only. |
| 11 | Features | — | Gray, read-only. |
Distributors ("Distributors" sheet)
A row is considered the same distributor if the ID or the Name matches (case-insensitive).
| # | Column | Required | Values and rules |
|---|---|---|---|
| 1 | ID | No | Gray. |
| 2 | Action | No | Create · Update · Delete |
| 3 | Name | Yes | In the wizard it is called Name or company name. |
| 4 | Tax ID (NIT) | No | |
| 5 | Reference | No | |
| 6 | No | Validated if present. In the wizard it is called Email. | |
| 7 | Phone | No | +CC número, with a space after the country code. Without +, it is taken as a Colombian number (+57). |
| 8 | Address | No | |
| 9 | City | No | |
| 10 | Department | No | |
| 11 | Website | No |
Notes
- Permissions: exporting requires the view permission (
<módulo>.read); importing, including rows with Delete, requires the create permission (<módulo>.create). - The import report keeps at most 1,000 errors and 1,000 warnings.
- A large import keeps running in the background even if you close the window.