Skip to main content

Import templates

Both products
The Excel file is in Spanish

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​

RuleDetail
FileCSV, XLS or XLSX, up to 10 MB. In Excel only the first sheet is read; the first row holds the column names.
ExportUp to 10,000 rows, respecting the view, filters and search.
Excel sheetsThe data sheet, the Instructions sheet and a hidden sheet with the dropdown values.
IDFirst column, in gray. Do not edit or delete it. New rows go without an ID.
ActionSecond 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.
DropdownsOnly accept the values in the list. Any other text is ignored (Excel warns with Value not in list).
Gray columnsInformational: editing them changes nothing.
NumbersFormats 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 cellSeparated by commas (;, `

What each Action does:

ActionIf the record existsIf it does not exist
(empty)The wizard's duplicates option applies (Skip, Replace, Create anyway or row by row)It is created
CreateIt is skippedIt is created
UpdateIt is overwrittenIt is created
DeleteSoft delete (recoverable from the Trash)It is skipped
Any other valueError: 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).

#ColumnRequiredValues and rules
1IDNoGray. Internal identifier.
2ActionNoCreate · Update · Delete
3EmailYesMust be valid.
4First nameNoText.
5Last nameNoText.
6PhoneYesNot 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).
7Country codeNoFor example +57.
8CompanyNoBy 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.
9Company tax IDNoThe 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.
10Job titleNoText.
11Contact typeNoIndividual · Company
12IndustryNoValue from the dropdown.
13Company sizeNoJust 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
14CityNoText.
15CountryNoText. If it is missing when creating, it is set to Colombia.
16StatusNoLead · Customer · Lost
17SourceNoManual · File import · Web form · External integration · API · CRM sync · Landing page · Other
18Acquisition channelNoMeta Ads · Google Ads · Organic search · Referral · Email marketing · WhatsApp · Phone call · Event · Website · Organic social · Partner · Other
19MediumNoCPC · Social · Email · Landing page · Form · Direct message · Call · Direct referral · QR · Other
20CampaignNoFree text.
21Sales rep (email)NoEmail 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.
22Customer typeNoFree text (up to 80 characters).
23QualificationNoHot · Warm · Cold. Whatever you write counts as a manual decision: AI classification no longer changes it.
24TagsNoComma-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.
25ListsNoSame as Tags; creating lists requires contacts.createList. BORRAR removes the contact from every list.
26Segments—Gray, read-only. It is calculated from each segment's rules and is not imported.
27NotesNoText.

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.

#ColumnRequiredValues and rules
1IDNoGray.
2ActionNoCreate · Update · Delete
3SKUYesStored in uppercase.
4NameYes*
5BrandNoDropdown 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.).
6PriceYes*Number greater than or equal to 0.
7DescriptionNo
8Wholesale priceNoNumber greater than or equal to 0.
9E-commerce priceNoNumber greater than or equal to 0.
10Stock statusNoAvailable · Out of stock · On request
11Main image (URL)NoPublic http(s) link; it is downloaded to the platform. JPG, PNG, WebP, GIF or AVIF up to 15 MB. BORRAR deletes the image.
12Image gallery (URLs)NoUp to 10 comma-separated links. It replaces the gallery. BORRAR empties it.
13Video gallery (URLs)NoUp 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.
14Technical sheet (URL)—Gray, read-only.
15BarcodeNo
16ModelNo
17Technical nameNo
18Country of originNo
19WebsiteNo
20E-commerce ref.No
21ProviderNoFree text.

*Not required in rows with Delete.

note

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.

#ColumnRequiredValues and rules
1IDNoGray.
2ActionNoCreate · Update · Delete
3NameYes
4DescriptionNo
5PriceNoNumber greater than or equal to 0.
6DurationNoFree text.
7CurrencyNoFree text.
8WarrantyNo
9Image (URL)NoThe link is stored as is.
10Success stories (URLs)—Gray, read-only.

Projects ("Projects" sheet)​

A row is considered the same project if the ID or the Name (exact) matches.

#ColumnRequiredValues and rules
1IDNoGray.
2ActionNoCreate · Update · Delete
3NameYes
4DescriptionNo
5Minimum priceNoNumber greater than or equal to 0.
6Maximum priceNoNumber greater than or equal to 0; it cannot be lower than the minimum.
7CurrencyNoFree text.
8Image (URL)NoThe link is stored as is.
9Image gallery (URLs)—Gray, read-only.
10Video gallery (URLs)—Gray, read-only.
11Features—Gray, read-only.

Distributors ("Distributors" sheet)​

A row is considered the same distributor if the ID or the Name matches (case-insensitive).

#ColumnRequiredValues and rules
1IDNoGray.
2ActionNoCreate · Update · Delete
3NameYesIn the wizard it is called Name or company name.
4Tax ID (NIT)No
5ReferenceNo
6EmailNoValidated if present. In the wizard it is called Email.
7PhoneNo+CC número, with a space after the country code. Without +, it is taken as a Colombian number (+57).
8AddressNo
9CityNo
10DepartmentNo
11WebsiteNo

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.