downloadOriginalSDI()

Fatture ricevute (XML/P7M): metodo per effettuare una ricerca in base all'ID fattura o identificativo SdI e scaricare i file originali prevenuti dal SDI, se presenti (file fattura e notifica).

{info} Nel payload JSON, l'XML viene codificato in base64. È un sistema di codifica che consente la traduzione di dati binari in stringhe di testo ASCII, rappresentando i dati sulla base di 64 caratteri ASCII diversi.

Endpoint

Method URI
POST https://fatture.keliweb.it/api/download-original-sdi

Request Parameters

Parameter Type Description Required
HTTP headers: Authorization string Bearer + the token to access APIs Yes
invoiceId integer ID univoco della fattura (relativo al DB locale) optional
identificativoSdI integer ID univoco della fattura dato dal SDI optional

Response Parameters

Parameter Type Description
data['filename'] string nome del file dato al pacchetto ZIP
data['mime_type'] string Natura e formato del documento (application/zip)
data['content'] string contenuto del pacchetto zip da scaricare, codificato in base64

Example Request (BASH Curl)

curl --location --request POST 'https://fatture.keliweb.it/api/download-original-sdi' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImYxYTAzNzMzYzY5ZDQ3' \
--form 'invoiceId="1"'

Example Request (PHP Curl)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://fatture.keliweb.it/api/download-original-sdi',
  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('invoiceId' => '1'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImYxYTAzNzMzYzY5ZDQ3ZDUxZDFiNTA2M'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example Request (jQuery AJAX)

var form = new FormData();
form.append("invoiceId", "1");

var settings = {
    url: "https://fatture.keliweb.it/api/download-original-sdi",
    method: "POST",
    timeout: 0,
    headers: {
        Authorization:
            "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImYxYTAzNzMzYzY5ZDQ3ZD"
    },
    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/download-original-sdi"

payload={'invoiceId': '1'}
files=[

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

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

print(response.text)

Example Response (JSON payload)

{
    "data": {
        "filename": "IT35258760517_0001f.zip",
        "mime_type": "application/zip",
        "content": "UEsDBBQAAgAIAKN8XFTBI5dW0hQAAASyAAAbAAAASVQwNjY1NTk3MTAwN19XOXNUaC54bWwucDdt7Z19e"
    },
    "version": "v2.6.11",
    "copyright": "2009-2022 - Keliweb Srl",
    "documentation": "https://fatture.keliweb.it/docs",
    "valid_as_of": "01/03/2022 (08:57)"
}