The file as it is,
columns kept in place.
We accept CSV, Excel (.xlsx and .xls) and LibreOffice Calc (.ods): upload the file as it is, we read the first sheet. The first row must hold the column headers (the names below). The columns we don't need come back unchanged in the result.
- From Excel: the native format (.xlsx) is fine, no need to "Save as CSV".
- From LibreOffice: the native .ods format is fine.
- The CSV can use a comma or a semicolon as separator: we detect it (UTF-8 or Latin-1).
- After the upload we show you a preview with how many rows we read and what it uses, before starting.
Three steps you skip
Renaming the columns. We recognise the headers in the forms they are usually written: Tel. and Cellulare are the phone, E-Mail and Posta elettronica the email, Comune and Città the city, Ragione sociale and Denominazione the account holder. The full list is in the column table. Capitals, accents, dots and dashes don't matter. In the preview we tell you which columns we recognised and with which role: if we skipped one, you notice before starting.
Cleaning the file of the columns that don't concern us. The file comes back whole: in the result you find all your columns, in their original order, and at the end the ones we add — the normalised fields, the outcome and the reason. We overwrite nothing: the original data stays right there, so you can compare before replacing.
Removing the columns that don't concern us. Whoever works on behalf of a client often doesn't have the real data, only the code with which that client traces the contact: the ID of their system, the customer code or the codeline of the reply form. Leave it where it is, and with it the campaign name, internal notes, anything: it doesn't need to be written in a particular way, nor does the column name need to mean anything to us. Everything we don't process comes back in the result in the same position and with the same content — we add our columns at the end and don't touch yours. So every row hooks back into your database without having to trust the order. In the API the same goes for the id field: what you send comes back as it is in the response.
If you export in the classic mailing-house format — campagna, codicecliente, titolo, cognome, nome, aggiunte, edificio, indirizzo, cap, localita, provincia, sesso — upload it as it is: we recognise them all (aggiunte included, which is the c/o), and campagna and codicecliente come back untouched.
The columns we recognise
In the first column the name we use, then the other names we recognise it by. Capitals, accents, dots, dashes and spaces don't matter: E-Mail, e_mail and EMAIL are the same column. Header names are the Italian ones listed here. Each service uses only the columns it needs; the others come back unchanged.
| Column | Other accepted names | Notes |
|---|---|---|
indirizzoAddress |
via, address, indirizzo postale, sede, sede legale, recapito, strada, street address, address line, address 1, address1, street, straße, strasse, str, anschrift, adresse, postanschrift, straße und hausnummer, rue, voie, adresse postale, dirección, direccion, domicilio, calle, vía, via publica, adres, straat, straatnaam, adresregel, straat en huisnummer, morada, endereço, endereco, rua, arruamento, adress, gatuadress, gata, besöksadress, postadress, gateadresse, gate, veiadresse, besøksadresse, osoite, katuosoite, lähiosoite, postiosoite, vejnavn, gadenavn, heimilisfang, gata, götuheiti, διεύθυνση, οδός, ταχυδρομική διεύθυνση |
Street and house number. Everything in one cell is fine too (“Via Roma 1, 20121 Milano MI”). |
pressoc/o |
c/o, co, attenzione di, alla cortese attenzione, aggiunte, care of, attention, attn, zu händen, z hd, z h, à l attention de, a l attention de, a la atención de, a la atencion de, t a v, ter attentie van, ao cuidado de, a c, att, v b, c/o, υπόψη |
The c/o and the other additions about the recipient. |
edificioBuilding |
scala, interno, palazzina, building, apartment, apt, floor, suite, unit, gebäude, gebaude, stockwerk, etage, wohnung, bâtiment, batiment, appartement, étage, piso, planta, escalera, portal, gebouw, verdieping, andar, prédio, predio, våning, lägenhet, etasje, leilighet, kerros, rappu, huoneisto, sal, lejlighed, bygning, hæð, íbúð, όροφος, κτίριο, διαμέρισμα |
Staircase, flat, block. |
capPostcode |
zip, codice postale, C.A.P., postcode, post code, postal code, zip code, zipcode, plz, postleitzahl, code postal, cp, código postal, codigo postal, postcode, postnummer, postnr, postinumero, cód postal, cod postal, póstnúmer, ταχυδρομικός κώδικας, τκ, τ κ |
Five digits. Can be missing. |
localitaCity |
comune, città, city, comune sede, town, locality, municipality, ort, stadt, wohnort, gemeinde, ville, commune, localité, localite, ciudad, población, poblacion, localidad, municipio, plaats, woonplaats, gemeente, stad, cidade, localidade, concelho, freguesia, postort, kommun, poststed, sted, by, kommune, postitoimipaikka, kaupunki, kunta, paikkakunta, bynavn, sveitarfélag, staður, bær, borg, πόλη, δήμος, περιοχή |
The municipality. Can be missing if the postcode is there. |
provinciaProvince |
prov, pv, sigla, sigla provincia, province, county, state, region, bundesland, kreis, landkreis, département, departement, région, region, comunidad, comunidad autónoma, comunidad autonoma, provincie, distrito, län, lan, fylke, maakunta, lääni, landsdel, landshluti, νομός, περιφέρεια |
The two-letter code. Can be missing. |
nazioneCountry (ISO 3166-1) |
paese, country, stato estero, codice paese, codice nazione, nazione iso2, iso2, ISO-2, country code, country name, nation, iso code, land, staat, pays, país, pais, landcode, ländercode, landercode, code pays, código de país, codigo de pais, landnaam, landkode, maa, maakoodi, landekode, þjóðland, χώρα, κωδικός χώρας |
Country name or two-letter code. Empty means Italy. |
cognomeSurname or company name |
ragione sociale, denominazione, ente, ente capofila, organizzazione, azienda, società, nominativo, intestatario, destinatario, nome ente, denominazione ente, surname, last name, lastname, family name, name, full name, contact name, company, company name, organisation, organization, business name, account name, nachname, name, familienname, firma, firmenname, unternehmen, organisation, nom, nom de famille, société, societe, entreprise, raison sociale, organisme, apellido, apellidos, empresa, razón social, razon social, organización, organizacion, achternaam, naam, bedrijf, bedrijfsnaam, organisatie, apelido, sobrenome, nome da empresa, razão social, razao social, organização, organizacao, efternamn, namn, företag, foretag, företagsnamn, foretagsnamn, etternavn, navn, firmanavn, selskap, sukunimi, nimi, yritys, yrityksen nimi, organisaatio, efternavn, firmanavn, virksomhed, eftirnafn, kenninafn, nafn, fyrirtæki, επώνυμο, επωνυμία, εταιρεία, οργανισμός |
The surname of the person, or the name of the organisation. “Surname First name” in a single cell is fine too. |
nomeFirst name |
nome referente, nome contatto, first name, firstname, given name, forename, vorname, prénom, prenom, nombre, voornaam, nome próprio, nome proprio, primeiro nome, förnamn, fornamn, fornavn, etunimi, eiginnafn, skírnarnafn, όνομα |
The first name of the person. |
sessoSex |
genere, sex, gender, geschlecht, sexe, genre, sexo, género, genero, geslacht, kön, kon, kjønn, kjonn, sukupuoli, køn, kyn, φύλο |
M or F, also written out (“maschio”, “donna”). X for an organisation, G for a family or a couple. Can be missing. |
titoloTitle |
appellativo, title, salutation, prefix, honorific, anrede, titel, civilité, civilite, titre, tratamiento, título, titulo, aanhef, tratamento, tilltal, tiltale, puhuttelu, titel, titill, τίτλος, προσφώνηση |
Dott., Sig.ra, Avv. Can be missing. |
qualificaProfession |
professione, mestiere, occupazione, attività, professione esercitata, ruolo, incarico, carica, profession, job title, occupation, role, position, beruf, position, funktion, profession, fonction, profesión, profesion, cargo, beroep, functie, profissão, profissao, função, funcao, yrke, befattning, stilling, ammatti, tehtävä, tehtava, erhverv, starf, staða, επάγγελμα, ιδιότητα |
The profession, if you have it. |
titstudioQualification |
titolo di studio, titolo studio, studi, titolo accademico, livello di istruzione, istruzione, education, degree |
The qualification, if you have it. |
email |
e-mail, mail, posta elettronica, indirizzo email, email referente, email contatto, pec, email address, e mail address, mail address, contact email, e mail adresse, emailadresse, courriel, adresse e mail, adresse email, mél, mel, correo, correo electrónico, correo electronico, e mailadres, emailadres, e mail address, e post, epost, e postadress, e postadresse, sähköposti, sahkoposti, sähköpostiosoite, sahkopostiosoite, e mailadresse, netfang, tölvupóstur, ηλεκτρονικό ταχυδρομείο, ηλ ταχυδρομείο |
One or more addresses in the same cell, separated by comma or semicolon, or in separate columns (“email2”, “pec”). |
telefonoPhone |
tel, cellulare, cell, phone, recapito telefonico, numero di telefono, telefono referente, tel referente, mobile, phone number, telephone, telephone number, tel no, mobile phone, mobile number, cell phone, cellphone, landline, telefon, telefonnummer, handy, mobil, mobilnummer, téléphone, telephone, portable, teléfono, móvil, movil, celular, telefoon, telefoonnummer, mobiel, telefone, telemóvel, telemovel, telemóvel, mobiltelefon, telefonnr, puhelin, puhelinnumero, matkapuhelin, gsm, sími, símanúmer, farsími, τηλέφωνο, κινητό, σταθερό |
One or more numbers in the same cell, or in separate columns (“telefono2”, “cellulare”). For foreign numbers, with the international prefix. |
codice_fiscaleItalian tax code |
cf, cod. fisc., codfisc, C.F., tax code, fiscal code, tax id, tax number, tin |
Sixteen characters. |
data_nascitaDate of birth |
data di nascita, nascita, DataNasc, nato il, date of birth, birth date, birthdate, dob, born, geburtsdatum, date de naissance, fecha de nacimiento, geboortedatum, data de nascimento, födelsedatum, fodelsedatum, fødselsdato, fodselsdato, syntymäaika, syntymaaika, fæðingardagur, ημερομηνία γέννησης |
dd/mm/yyyy or yyyy/mm/dd, with slashes, dashes or dots; or an Excel date. Four-digit year. |
comune_nascitaPlace of birth |
comune di nascita, luogo nascita, luogo di nascita, nato a, NatoA, place of birth, birth place, birthplace, town of birth, geburtsort, lieu de naissance, lugar de nacimiento, geboorteplaats, naturalidade, local de nascimento, födelseort, fodelseort, fødested, fodested, syntymäpaikka, syntymapaikka, fæðingarstaður, τόπος γέννησης |
The municipality, or the foreign country. |
sitoWebsite |
sito web, url, web, pagina web, homepage, sito internet, indirizzo web, website, web site, site, domain, web address, webseite, internetseite, site web, site internet, sitio web, página web, pagina web, webpagina, sítio web, sitio web, webbplats, hemsida, nettside, nettsted, verkkosivu, kotisivu, www, hjemmeside, websted, vefsíða, heimasíða, ιστοσελίδα, ιστότοπος |
With or without http://. |
idIdentifier |
codice, id cliente, IdCliente, IdSocio, id socio, codice socio, IdAnagrafica, id anagrafica, IdContatto, progressivo, CodiceCliente, codice cliente, quinto campo, V campo, codice spedizione, codeline, code line, codice contatto, id contatto, riferimento, rif, chiave, matricola, customer id, contact id, record id, reference, ref, ref no, key, member id, client id, external id, identifier, kundennummer, kunden nr, kundenid, referenz, identifiant, référence, reference, numéro client, numero client, referencia, identificador, número de cliente, numero de cliente, klantnummer, klant id, referentie, referência, número de cliente, kundnummer, kund id, kundenummer, kunde id, asiakasnumero, tunniste, viite, viðskiptavinanúmer, auðkenni, tilvísun, αριθμός πελάτη, κωδικός πελάτη, αναγνωριστικό |
Your identifier of the contact: it comes back untouched in the result. Several rows with the same id are the same contact. |
What each service needs
One required column per service; the others, if you have them, improve the result. The file comes back as it was, with our columns at the end.
| Service | Required | Useful |
|---|---|---|
| Contact verification | indirizzo |
cap, localita, provincia, presso, edificio, cognome, nome, titolo, sesso, codice_fiscale, data_nascita, comune_nascita, nazione |
| Deduplication | cognome |
nome, indirizzo, cap, localita, provincia, email, telefono, nazione, id |
| Email verification | email |
— |
| Phone verification | telefono |
nazione |
| Website verification | sito |
— |
| Italian tax code | codice_fiscale |
cognome, nome, sesso, data_nascita, comune_nascita |
| Name enrichment | cognome |
nome, titolo, sesso, qualifica, titstudio |