Το αρχείο όπως είναι,
οι στήλες στη θέση τους.
Δεχόμαστε CSV, Excel (.xlsx και .xls) και LibreOffice Calc (.ods): ανεβάστε το αρχείο όπως είναι, διαβάζουμε το πρώτο φύλλο. Η πρώτη γραμμή πρέπει να περιέχει τις επικεφαλίδες των στηλών (τα ονόματα παρακάτω). Οι στήλες που δεν μας χρειάζονται επιστρέφουν αμετάβλητες στο αποτέλεσμα.
- Από το Excel: η εγγενής μορφή (.xlsx) είναι μια χαρά, δεν χρειάζεται «Αποθήκευση ως CSV».
- Από το LibreOffice: η εγγενής μορφή .ods είναι μια χαρά.
- Το CSV μπορεί να έχει διαχωριστικό κόμμα ή ερωτηματικό: το αναγνωρίζουμε μόνοι μας (UTF-8 ή Latin-1).
- Μετά το ανέβασμα σας δείχνουμε μια προεπισκόπηση με το πόσες γραμμές διαβάσαμε και τι καταναλώνει, πριν ξεκινήσετε.
Τρία βήματα που γλιτώνετε
Μετονομασία των στηλών. Τις επικεφαλίδες τις αναγνωρίζουμε εμείς στις μορφές που γράφονται συνήθως: Tel. και Cellulare είναι το τηλέφωνο, E-Mail και Posta elettronica το email, Comune και Città η πόλη, Ragione sociale και Denominazione ο δικαιούχος. Ο πλήρης κατάλογος βρίσκεται στον πίνακα των στηλών. Κεφαλαία, τόνοι, τελείες και παύλες δεν μετράνε. Στην προεπισκόπηση σας λέμε ποιες στήλες αναγνωρίσαμε και με ποιον ρόλο: αν παραλείψαμε κάποια, το βλέπετε πριν ξεκινήσετε.
Καθάρισμα του αρχείου από τις στήλες που δεν μας αφορούν. Το αρχείο επιστρέφει ολόκληρο: στο αποτέλεσμα βρίσκετε όλες τις στήλες σας, με την αρχική τους σειρά, και στο τέλος αυτές που προσθέτουμε εμείς — τα κανονικοποιημένα πεδία, το αποτέλεσμα και την αιτία. Δεν αντικαθιστούμε τίποτα: το αρχικό δεδομένο μένει εκεί δίπλα, ώστε να μπορείτε να συγκρίνετε πριν αντικαταστήσετε.
Αφαίρεση των στηλών που δεν μας αφορούν. Όποιος εργάζεται για λογαριασμό ενός πελάτη συχνά δεν έχει τα πραγματικά δεδομένα, μόνο τον κωδικό με τον οποίο ο πελάτης αυτός εντοπίζει την επαφή: το ID του συστήματός του, τον κωδικό πελάτη ή την codeline της φόρμας απάντησης. Αφήστε τον εκεί που είναι, και μαζί του το όνομα της καμπάνιας, τις εσωτερικές σημειώσεις, οτιδήποτε: δεν χρειάζεται να είναι γραμμένος με συγκεκριμένο τρόπο, ούτε το όνομα της στήλης να μας λέει κάτι. Ό,τι δεν επεξεργαζόμαστε επιστρέφει στο αποτέλεσμα στην ίδια θέση και με το ίδιο περιεχόμενο — εμείς προσθέτουμε τις στήλες μας στο τέλος και δεν αγγίζουμε τις δικές σας. Έτσι κάθε γραμμή ξανακουμπώνει στη βάση σας χωρίς να χρειάζεται να εμπιστευτείτε τη σειρά. Στο API το ίδιο ισχύει για το πεδίο id: ό,τι στέλνετε επιστρέφει όπως είναι στην απάντηση.
Αν εξάγετε στην κλασική μορφή για την εταιρεία αποστολών — campagna, codicecliente, titolo, cognome, nome, aggiunte, edificio, indirizzo, cap, localita, provincia, sesso — ανεβάστε το όπως είναι: τις αναγνωρίζουμε όλες (μαζί με το aggiunte, που είναι το c/o), και τα campagna και codicecliente επιστρέφουν ανέπαφα.
Οι στήλες που αναγνωρίζουμε
Στην πρώτη στήλη το όνομα που χρησιμοποιούμε εμείς, μετά τα άλλα ονόματα με τα οποία την αναγνωρίζουμε. Κεφαλαία, τόνοι, τελείες, παύλες και κενά δεν μετράνε: E-Mail, e_mail και EMAIL είναι η ίδια στήλη. Τα ονόματα των επικεφαλίδων είναι τα ιταλικά που αναγράφονται εδώ. Κάθε υπηρεσία χρησιμοποιεί μόνο τις στήλες που της χρειάζονται· οι άλλες επιστρέφουν αμετάβλητες.
| Στήλη | Άλλα αποδεκτά ονόματα | Σημειώσεις |
|---|---|---|
indirizzoΔιεύθυνση |
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, διεύθυνση, οδός, ταχυδρομική διεύθυνση |
Οδός και αριθμός. Είναι μια χαρά και όλα σε ένα κελί («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, υπόψη |
Το c/o και οι άλλες προσθήκες για τον παραλήπτη. |
edificioΚτίριο |
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úð, όροφος, κτίριο, διαμέρισμα |
Κλιμακοστάσιο, διαμέρισμα, κτίριο. |
capΤαχυδρομικός κώδικας |
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, ταχυδρομικός κώδικας, τκ, τ κ |
Πέντε ψηφία. Μπορεί να λείπει. |
localitaΠόλη |
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, πόλη, δήμος, περιοχή |
Ο δήμος. Μπορεί να λείπει αν υπάρχει ο ταχυδρομικός κώδικας. |
provinciaΕπαρχία |
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, νομός, περιφέρεια |
Ο διγράμματος κωδικός. Μπορεί να λείπει. |
nazioneΧώρα (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, χώρα, κωδικός χώρας |
Όνομα χώρας ή διγράμματος κωδικός. Κενό σημαίνει Ιταλία. |
cognomeΕπώνυμο ή επωνυμία |
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, επώνυμο, επωνυμία, εταιρεία, οργανισμός |
Το επώνυμο του προσώπου, ή η επωνυμία του φορέα. Είναι μια χαρά και «Επώνυμο Όνομα» σε ένα μόνο κελί. |
nomeΌνομα |
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, όνομα |
Το όνομα του προσώπου. |
sessoΦύλο |
genere, sex, gender, geschlecht, sexe, genre, sexo, género, genero, geslacht, kön, kon, kjønn, kjonn, sukupuoli, køn, kyn, φύλο |
M ή F, και γραμμένο ολογράφως («maschio», «donna»). X για φορέα, G για οικογένεια ή ζευγάρι. Μπορεί να λείπει. |
titoloΤίτλος |
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. Μπορεί να λείπει. |
qualificaΕπάγγελμα |
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, επάγγελμα, ιδιότητα |
Το επάγγελμα, αν το έχετε. |
titstudioΤίτλος σπουδών |
titolo di studio, titolo studio, studi, titolo accademico, livello di istruzione, istruzione, education, degree |
Ο τίτλος σπουδών, αν τον έχετε. |
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, ηλεκτρονικό ταχυδρομείο, ηλ ταχυδρομείο |
Μία ή περισσότερες διευθύνσεις στο ίδιο κελί, χωρισμένες με κόμμα ή ερωτηματικό, ή σε χωριστές στήλες («email2», «pec»). |
telefonoΤηλέφωνο |
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, τηλέφωνο, κινητό, σταθερό |
Ένας ή περισσότεροι αριθμοί στο ίδιο κελί, ή σε χωριστές στήλες («telefono2», «cellulare»). Για τους ξένους αριθμούς, με το διεθνές πρόθεμα. |
codice_fiscaleΙταλικός φορολογικός κωδικός (codice fiscale) |
cf, cod. fisc., codfisc, C.F., tax code, fiscal code, tax id, tax number, tin |
Δεκαέξι χαρακτήρες. |
data_nascitaΗμερομηνία γέννησης |
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, ημερομηνία γέννησης |
ηη/μμ/εεεε ή εεεε/μμ/ηη, με καθέτους, παύλες ή τελείες· ή μια ημερομηνία του Excel. Έτος με τέσσερα ψηφία. |
comune_nascitaΤόπος γέννησης |
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, τόπος γέννησης |
Ο δήμος, ή η ξένη χώρα. |
sitoΙστότοπος |
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, ιστοσελίδα, ιστότοπος |
Με ή χωρίς http://. |
idΑναγνωριστικό |
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, αριθμός πελάτη, κωδικός πελάτη, αναγνωριστικό |
Το δικό σας αναγνωριστικό της επαφής: επιστρέφει ανέπαφο στο αποτέλεσμα. Περισσότερες γραμμές με το ίδιο id είναι η ίδια επαφή. |
Τι χρειάζεται κάθε υπηρεσία
Μία υποχρεωτική στήλη ανά υπηρεσία· οι άλλες, αν τις έχετε, βελτιώνουν το αποτέλεσμα. Το αρχείο επιστρέφει όπως ήταν, με τις στήλες μας στο τέλος.
| Υπηρεσία | Υποχρεωτική | Χρήσιμες |
|---|---|---|
| Επαλήθευση επαφής | indirizzo |
cap, localita, provincia, presso, edificio, cognome, nome, titolo, sesso, codice_fiscale, data_nascita, comune_nascita, nazione |
| Αφαίρεση διπλοεγγραφών | cognome |
nome, indirizzo, cap, localita, provincia, email, telefono, nazione, id |
| Επαλήθευση email | email |
— |
| Επαλήθευση τηλεφώνου | telefono |
nazione |
| Επαλήθευση ιστότοπου | sito |
— |
| Ιταλικός φορολογικός κωδικός (codice fiscale) | codice_fiscale |
cognome, nome, sesso, data_nascita, comune_nascita |
| Εμπλουτισμός ονοματεπωνύμου | cognome |
nome, titolo, sesso, qualifica, titstudio |