Creare un contatto cliente
La chiamata che dovrai fare per creare un contatto cliente nella rubrica di Fattura24 avrà le seguenti caratteristiche.
Endpoint:
https://www.app.fattura24.com/api/v0.3/SaveCustomer
Parametri da passare in Post:
apiKey: API KEY associata al proprio account;
xml: una stringa simile alla seguente, contenente i dati del contatto da creare.
Esempio XML:
<?xml version="1.0" encoding="UTF-8"?>
<Fattura24>
<Document>
<CustomerName>MARIO ROSSI</CustomerName>
<CustomerAddress>Via Alberti 8</CustomerAddress>
<CustomerPostcode>06122</CustomerPostcode>
<CustomerCity>Perugia</CustomerCity>
<CustomerProvince>PG</CustomerProvince>
<CustomerCountry></CustomerCountry>
<CustomerFiscalCode>MARROS66C44G217W</CustomerFiscalCode>
<CustomerVatCode>03912377542</CustomerVatCode>
<CustomerCellPhone>335123456789</CustomerCellPhone>
<CustomerEmail>info@rossi.i</CustomerEmail>
<FeCustomerPec>test@pec.it</FeCustomerPec>
<FeDestinationCode>0000000</FeDestinationCode>
</Document>
</Fattura24>
Le chiavi che permettono a Fattura24 di sapere se quel contatto è già presente in rubrica sono: P.IVA, codice fiscale e ragione sociale.
Alla prima chiave trovata, il sistema ignorerà le successive. In altre parole se viene trovato un contatto con la stessa P.IVA ricevuta in input, Fattura24 non verificherà le successive chiavi: codice fiscale e ragione sociale.
Quando si salva un contatto cliente già presente nella propria rubrica, il sistema procederà ad aggiornare i suoi dati con quelli appena ricevuti.
Se la lunghezza della stringa contenuta in <FeDestinationCode> è di 6 caratteri, il sistema creerà un contatto di tipo PA (Pubblica Amministrazione).