API – Gestione clienti

Prima di creare un credito è necessario che il cliente verso il quale si vuole emettere fattura sia presente in rubrica, nel caso non lo fosse sarà necessario aggiungerlo.
Ogni volta che si salva un nuovo cliente, il sistema verifica se ne esiste già uno con la stessa P.IVA o C.F.: se lo trova verrà fatto un aggiornamento dei dati diversamente verrà aggiunto in rubrica.

Di seguito le azioni che si possono eseguire sulla propria rubrica utilizzando l’API di Fattura24:

  • lista clienti
  • salvataggio cliente
  • cancellazione cliente

Ottenere la lista dei clienti tramite API

Tramite questo servizio potrai conoscere gli ID delle aliquote che devono essere associate ad un cliente in rubrica o ad un credito.
Per ottenere la lista delle aliquote disponibili sul tuo account dovrai fare la seguente chiamata

Esito positivo
In caso di esito positivo Fattura24 restituirà il parametro ‘return_cod’ diverso da -1 e i dati richiesti dalla chiamata.

Il parametro idTipo identifica se quel contatto è un cliente, un fornitore o entrambi.
Di seguito la transcodifica dei possibili valori:

Esito negativo
In caso di esito negativo Fattura24 restituirà il parametro ‘return_cod’ uguale a -1.

Cancellazione cliente

In Fattura24 la cancellazione dei dati è logica e non fisica, questo garantisce che:

  • i dati rimangano sempre consistenti
  • in caso di cancellazioni accidentali di poter recuperare le informazioni di quel cliente

Raramente emerge l’esigenza di cancellare un cliente tramite API, ma se fosse necessario questa è la chiamata da fare:

Esito positivo
In caso di esito positivo Fattura24 restituirà il parametro ‘return_cod’ diverso da -1 .

Esito negativo
In caso di esito negativo Fattura24 restituirà il parametro ‘return_cod’ uguale a -1.

Salvataggio cliente

Questa funzionalità ti permetterà di aggiungere un nuovo cliente in rubrica o modificare i dati di un cliente già presente.
In quest’ultimo caso il sistema utilizza i parametri ‘ID’, ‘P.IVA’ e ‘C.F.’ per identificare se un cliente è già presente o meno e quindi decidere se aggiungerne uno nuovo o modificarne uno esistente.
Per usare il servizio è necessario effettuare la seguente chiamata:

Il parametro idTipo identifica se il contatto è un cliente, un fornitore o entrambi.
Ricordati che solo i clienti potranno essere utilizzati per creare i crediti e quindi le fatture.
Di seguito la transcodifica dei possibili valori:

Esito positivo
In caso di esito positivo Fattura24 restituirà l’oggetto ‘contatto’ con tutte le informazioni che lo riguardano, compreso l’ID propedeutico alla creazione del credito.

Esito negativo
In caso di esito negativo Fattura24 restituirà il parametro ‘return_cod’ uguale a -1.

Questa funzionalità potrebbe essere utile ad altri? Aiutaci a farla conoscere