API – Gestione crediti

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.
Per maggiori informazioni fare riferimento a questa pagina: http://www.fattura24.com/api-gestione-clienti/

Le API di Fattura24 ti permettono di creare dei crediti da fatturare manualmente in un secondo momento.
Abbiamo deciso di non offrire, almeno per ora, il servizio di creazione diretta delle fatture per il seguente motivo:

  • i crediti sono un valido strumento per generare velocemente la fattura senza correre il rischio di creare per errore fatture automatiche che poi richiederebbero una nota di credito.
  • usare i crediti ti permette di emettere un’unica fattura relativa a prodotti/servizi acquistati dallo stesso cliente in momenti differenti

Di seguito le azioni che si possono eseguire sui tuoi crediti

  • lista crediti
  • salvataggio credito
  • cancellazione credito

Ottenere la lista crediti 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.

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

Cancellazione credito

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

  • i dati rimangano sempre consistenti
  • in caso di cancellazione accidentale sarà possibile recuperare le informazioni di quel credito

Raramente emerge l’esigenza di cancellare un credito 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 credito

Questa funzionalità ti permetterà di aggiungere un nuovo credito da fatturare in un secondo momento accedendo al tuo profilo di fatturazione in Fattura24.
Per usare il servizio è necessario effettuare la seguente chiamata:

Descrizione dei campi obbligatori

  • idCredito identifica il credito da modificare, se si desidera creare un nuovo credito questo parametro non va passato.
  • idCliente identifica il cliente al quale va associato il credito
  • idIva identifica l’ID dell’aliquota IVA da associare al credito
  • importoUnitario decimale che quantifica il costo unitario del prodotto/servizio acquistato
  • quantita decimale che rappresenta il numero di prodotti/servizi acquistati
  • sconto decimale che rappresenta lo sconto applicato all’acquisto
  • tipoImporto ‘imponibile’ o ‘nonImponibile’
  • nota descrizione del prodotto/servizio che verrà utilizzato per l’emissione della fattura

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