Passa al contenuto principale

Creare un credito

Con le API di Fattura24 puoi creare anche dei semplici crediti.

Un credito è una prestazione/prodotto che è stata già venduta/consegnata al cliente ma che vuoi fatturare manualmente in un secondo momento, ad esempio a fine mese.

La chiamata che dovrai fare per creare un credito avrà le seguenti caratteristiche.

Chiamata
Endpoint: 

https://www.app.fattura24.com/api/v0.3/SaveItem

Parametri da passare in Post:

apiKey: API KEY associata al proprio account;
xml: una stringa simile alla seguente, contenente i dati del credito da creare.

Esempio XML:

<?xml version="1.0" encoding="UTF-8"?>
<Fattura24>
<Document>
<DocumentType>I</DocumentType>
<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.it</CustomerEmail>
<Object>Oggetto del documento</Object>
<CustomField1></CustomField1>
<CustomField2></CustomField2>
<Rows>
<Row>
<Code>0001</Code>
<Description>PULIZIA NUM. DUE FINESTRE</Description>
<Qty>2</Qty>
<Um></Um>
<Price>200.00</Price>
<Discounts>0</Discounts>
<VatCode>22</VatCode>
<VatDescription>22%</VatDescription>
</Row>
<Row>
<Code>0002</Code>
<Description>PULIZIA NUM. DUE FINESTRONI</Description>
<Qty>2</Qty>
<Um></Um>
<Price>250.00</Price>
<Discounts>0</Discounts>
<VatCode>22</VatCode>
<VatDescription>22%</VatDescription>
</Row>
</Rows>
</Document>
</Fattura24>
IMPORTANTE

Prima di lanciare la chiamata alle nostre API effettua un URL Encoding dell’XML altrimenti la chiamata andrà in errore.

Anche in questo caso, durante la creazione del credito il sistema utilizzerà la partita IVA e/o il C.F. (codice fiscale) del cliente per cercarlo nella tua rubrica. Se la ricerca termina positivamente verrà utilizzato il tuo contatto in rubrica (aggiornato con i dati che avrai inserito nell’XML), in caso negativo verrà creato un nuovo contatto.

Come vedi l’xml è praticamente identico a quello necessario a creare la fattura tranne che per le info specifiche che caratterizzano una fattura.