sendXml()


Metodo per inviare una fattura al SDI direttamente in formato stringa XML.

{warning} Le fatture inviate tramite API saranno prese in carico dal sistema e saranno inviate successivamente tramite cron giornalieri (ogni 2 ore).

Endpoint

Method URI
POST https://fatture.keliweb.it/api/send-xml

Request Parameters

Parameter Type Description Required
HTTP headers: Authorization string Bearer + the token to access APIs Yes
xml string La stringa in formato XML Yes

Response Parameters

Parameter Type Description
status string risultato dell'operazione (success / errors)
message string dettagli sul risultato dell'operazione
invoiceData array dati relativi alla fattura appena inviata (status, nome file, ID, progressivo, etc.)
sdi array dati specifici del SDI, come IdentificativoSdI e DataOraRicezione

Example Request (BASH Curl)

curl --location --request POST 'https://fatture.keliweb.it/api/send-xml' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY5Nzk4' \
--form 'xml="<?xml version=\"1.0\" encoding=\"utf-8\"?>
<ns3:FatturaElettronica xmlns:ns3=\"http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2\" xmlns:ns2=\"http://www.w3.org/2000/09/xmldsig#\" versione=\"FPR12\">
  <FatturaElettronicaHeader>
  </FatturaElettronicaHeader>
  <FatturaElettronicaBody>
  </FatturaElettronicaBody>
</ns3:FatturaElettronica>"'

Example Request (PHP Curl)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://fatture.keliweb.it/api/send-xml',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('xml' => '<?xml version="1.0" encoding="utf-8"?>
<ns3:FatturaElettronica xmlns:ns3="http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" versione="FPR12">
  <FatturaElettronicaHeader>
  </FatturaElettronicaHeader>
  <FatturaElettronicaBody>
  </FatturaElettronicaBody>
</ns3:FatturaElettronica>'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY5Nzk4YTMzODM'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example Request (jQuery AJAX)

var form = new FormData();
form.append("xml", "<?xml version=\"1.0\" encoding=\"utf-8\"?>
<ns3:FatturaElettronica xmlns:ns3=\"http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2\" xmlns:ns2=\"http://www.w3.org/2000/09/xmldsig#\" versione=\"FPR12\">
  <FatturaElettronicaHeader>
  </FatturaElettronicaHeader>
  <FatturaElettronicaBody>
  </FatturaElettronicaBody>
</ns3:FatturaElettronica>");

var settings = {
  "url": "https://fatture.keliweb.it/api/send-xml",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY5Nzk4YTMzODMw"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Example Request (Python - Requests)

import requests

url = "https://fatture.keliweb.it/api/send-xml"

payload={'xml': '<?xml version="1.0" encoding="utf-8"?>
<ns3:FatturaElettronica xmlns:ns3="http://ivaservizi.agenziaentrate.gov.it/docs/xsd/fatture/v1.2" xmlns:ns2="http://www.w3.org/2000/09/xmldsig#" versione="FPR12">
  <FatturaElettronicaHeader>
  </FatturaElettronicaHeader>
  <FatturaElettronicaBody>
  </FatturaElettronicaBody>
</ns3:FatturaElettronica>'}
files=[

]
headers = {
  'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImY5Nzk4Y'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Example Response (JSON payload)

{
    "status": "success",
    "message": "Fattura presa in carico dal sistema. SarĂ  inviata al prossimo cron giornaliero.",
    "invoiceData": {
        "progressivo": "0000f",
        "invoiceId": 15,
        "filename": "IT03281320782_0000f.xml",
        "path": "invoices/info@keliweb.it/2022/15",
        "version": "FPR12",
        "production": false,
        "numero": "2022X-12345",
        "identificativoSdI": null,
        "dataOraRicezioneSdi": null,
        "status": "PRESA IN CARICO"
    },
    "sdi": null
}