Skip to main content

E-Invoice management

When you need to deal with an e-invoice, we provide a handful of methods that you can use to fulfill your needs: you can verify the XML of your e-invoice, download it, send it to the SDI and eventually obtain the rejection reason.

🔍  Verify the E-Invoice XML

With the Verify e-invoice XML method, you can verify your e-invoice XML before sending it to the SDI. If your XML contains an error or it is missing some fields, you can patch it by editing the invoice. A list of the most common validation errors can be found here.

Below you can find an example of a failed XML verification:

{
"error": {
"message": "Validation XML",
"validation_result": [
"Nei dati generali del documento, il contenuto \"0000-00-00\" del campo Data non è nel formato valido"
]
}
}

⬇️  Download the E-Invoice XML

With the Get e-invoice XML method you can download your e-invoice XML if you need to.

HTTP/1.1 200 OK
Content-Type: text/xml;charset=UTF-8


<p:FatturaElettronica xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:p="http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" versione="FPR12">
<FatturaElettronicaHeader>
...
</FatturaElettronicaHeader>
<FatturaElettronicaBody>
...
</FatturaElettronicaBody>
</p:FatturaElettronica>

📬  Send the E-Invoice

If your e-invoice XML is valid you can now send it to the SDI using the Send e-invoice method.

After the invoice has been sent, you can check its status by making a Get Issued Document request: the ei_status field will contain the status of your e-invoice.

Check your fieldset!

To show the ei_status field, you need to customize the response, selecting the detailed fieldset or including it in the fields list.

🚨  Get the E-Invoice rejection reason

If your e-invoice gets rejected by the SDI, you can check the rejection reason with the Get rejection reason method. The list of the most common rejection reasons can be found here.

For example, you could get an error like the following one:

{
"data": {
"reason": "Il Codice Fiscale del cliente risulta sbagliato.",
"code": "0036",
"date": "2022-02-22"
}
}