Come preparare il file

Accettiamo CSV, Excel (.xlsx e .xls) e LibreOffice Calc (.ods): carica il file così com'è, leggiamo la prima scheda. La prima riga deve contenere le intestazioni delle colonne (i nomi qui sotto). Le colonne che non ci servono tornano invariate nel risultato.

Da Excel: va bene il formato nativo (.xlsx), non serve "Salva come CSV".
Da LibreOffice: il formato nativo .ods va bene.
Il CSV può avere separatore virgola o punto e virgola: lo riconosciamo da soli (UTF-8 o Latin-1).
Dopo il caricamento ti mostriamo un'anteprima con quante righe abbiamo letto e quanto costa, prima di avviare.

Tre passaggi che ti risparmi

Rinominare le colonne. Le intestazioni le riconosciamo noi nelle forme in cui si scrivono di solito: Tel. e Cellulare sono il telefono, E-Mail e Posta elettronica sono l'email, Comune e Città sono la località, Ragione sociale e Denominazione sono l'intestatario. L'elenco completo è nella tabella delle colonne. Maiuscole, accenti, punti e trattini non contano. Nell'anteprima ti diciamo quali colonne abbiamo riconosciuto e con che ruolo: se ne abbiamo saltata una, te ne accorgi prima di partire.

Ripulire il file dalle colonne che non ci riguardano. Il file torna intero: nel risultato ritrovi tutte le tue colonne, nell'ordine di partenza, e in fondo quelle che aggiungiamo noi — i campi normalizzati, l'esito e il motivo. Non sovrascriviamo niente: il dato di partenza resta lì accanto, così puoi confrontare prima di sostituire.

Togliere le colonne che non ci riguardano. Chi lavora per conto di un committente spesso non ha i dati veri, ma solo il codice con cui quel committente risale al contatto: l'ID del gestionale, il codice cliente — il quinto campo del bollettino — o la codeline del modulo di risposta. Lascialo dov'è, e con lui il nome della campagna, le note interne, qualunque cosa: non serve che sia scritto in un modo particolare né che il nome della colonna ci dica qualcosa. Tutto quello che non elaboriamo torna nel risultato nella stessa posizione e con lo stesso contenuto — noi aggiungiamo le nostre colonne in fondo e non tocchiamo le tue. Così ogni riga si riaggancia al tuo archivio senza doverti fidare dell'ordine. Nell'API vale lo stesso per il campo id: quello che mandi torna tale e quale nella risposta.

Se esporti nel formato classico per lo spedizioniere — campagna, codicecliente, titolo, cognome, nome, aggiunte, edificio, indirizzo, cap, localita, provincia, sesso — caricalo così com'è: le riconosciamo tutte (aggiunte compresa, che è il presso), e campagna e codicecliente tornano intatte.

Le colonne che riconosciamo

Nella prima colonna il nome che usiamo noi, poi gli altri nomi con cui la riconosciamo. Maiuscole, accenti, punti, trattini e spazi non contano: E-Mail, e_mail e EMAIL sono la stessa colonna. Ogni servizio usa solo le colonne che gli servono; le altre tornano invariate.

Colonna	Altri nomi accettati	Note
`indirizzo` Indirizzo	`via`, `address`, `indirizzo postale`, `sede`, `sede legale`, `recapito`, `strada`	Via e numero civico. Va bene anche tutto in una cella («Via Roma 1, 20121 Milano MI»).
`presso` Presso	`c/o`, `co`, `attenzione di`, `alla cortese attenzione`, `aggiunte`	Il c/o e le altre aggiunte sul destinatario.
`edificio` Edificio	`scala`, `interno`, `palazzina`	Scala, interno, palazzina.
`cap` CAP	`zip`, `codice postale`, `C.A.P.`	Cinque cifre. Può mancare.
`localita` Località	`comune`, `città`, `city`, `comune sede`	Il comune. Può mancare se c'è il CAP.
`provincia` Provincia	`prov`, `pv`, `sigla`, `sigla provincia`	La sigla. Può mancare.
`nazione` Nazione (ISO 3166-1)	`paese`, `country`, `stato estero`, `codice paese`, `codice nazione`, `nazione iso2`, `iso2`, `ISO-2`, `country code`	Nome del paese o codice a due lettere. Vuoto vale Italia.
`cognome` Cognome o denominazione	`ragione sociale`, `denominazione`, `ente`, `ente capofila`, `organizzazione`, `azienda`, `società`, `nominativo`, `intestatario`, `destinatario`, `nome ente`, `denominazione ente`	Il cognome della persona, oppure la denominazione dell'ente. Va bene anche «Cognome Nome» in una cella sola.
`nome` Nome	`nome referente`, `nome contatto`	Il nome della persona.
`sesso` Sesso	`genere`, `sex`, `gender`	M o F, anche scritto per esteso («maschio», «donna»). X per un ente, G per una famiglia o una coppia. Può mancare.
`titolo` Titolo	`appellativo`	Dott., Sig.ra, Avv. Può mancare.
`qualifica` Professione	`professione`, `mestiere`, `occupazione`, `attività`, `professione esercitata`, `ruolo`, `incarico`, `carica`	La professione, se ce l'hai.
`titstudio` Titolo di studio	`titolo di studio`, `titolo studio`, `studi`, `titolo accademico`, `livello di istruzione`, `istruzione`	Il titolo di studio, se ce l'hai.
`email` Email	`e-mail`, `mail`, `posta elettronica`, `indirizzo email`, `email referente`, `email contatto`, `pec`	Uno o più indirizzi nella stessa cella, separati da virgola o punto e virgola, oppure in colonne separate («email2», «pec»).
`telefono` Telefono	`tel`, `cellulare`, `cell`, `phone`, `recapito telefonico`, `numero di telefono`, `telefono referente`, `tel referente`, `mobile`	Uno o più numeri nella stessa cella, oppure in colonne separate («telefono2», «cellulare»). Per l'estero col prefisso internazionale.
`codice_fiscale` Codice fiscale	`cf`, `cod. fisc.`, `codfisc`, `C.F.`	Sedici caratteri.
`data_nascita` Data di nascita	`data di nascita`, `nascita`, `DataNasc`, `nato il`	gg/mm/aaaa o aaaa/mm/gg, con barre, trattini o punti; oppure una data di Excel. L'anno con quattro cifre.
`comune_nascita` Comune di nascita	`comune di nascita`, `luogo nascita`, `luogo di nascita`, `nato a`, `NatoA`	Il comune, o lo stato estero.
`sito` Sito web	`sito web`, `url`, `web`, `pagina web`, `homepage`, `sito internet`, `indirizzo web`	Con o senza http://.
`id` Identificativo	`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`	Il tuo identificativo del contatto: torna intatto nel risultato. Più righe con lo stesso id sono lo stesso contatto.

Cosa serve a ogni servizio

Una colonna obbligatoria per servizio; le altre, se le hai, migliorano il risultato. Il file torna com'era, con le nostre colonne in fondo.

Servizio	Obbligatoria	Utili
Verifica contatto	`indirizzo`	`cap`, `localita`, `provincia`, `presso`, `edificio`, `cognome`, `nome`, `titolo`, `sesso`, `codice_fiscale`, `data_nascita`, `comune_nascita`, `nazione`
Deduplica anagrafiche	`cognome`	`nome`, `indirizzo`, `cap`, `localita`, `provincia`, `email`, `telefono`, `nazione`, `id`
Verifica email	`email`	—
Verifica telefono	`telefono`	`nazione`
Verifica sito web	`sito`	—
Codice fiscale	`codice_fiscale`	`cognome`, `nome`, `sesso`, `data_nascita`, `comune_nascita`
Arricchimento nominativo	`cognome`	`nome`, `titolo`, `sesso`, `qualifica`, `titstudio`