getNotifications()


Metodo per ottenere la lista delle notifiche dal SDI relative alle proprie fatture.

Endpoint

Method URI
GET https://fatture.keliweb.it/api/notifications

Request Parameters

Parameter Type Description Required
HTTP headers: Authorization string Bearer + the token to access APIs Yes

Response Parameters

Parameter Type Description
data array lista delle notifiche, in formato JSON

Example Request (BASH Curl)

curl --location --request GET 'https://fatture.keliweb.it/api/notifications' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjJmZTQ2NTMzZWZhMmMxZj'

Example Request (PHP Curl)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://fatture.keliweb.it/api/notifications',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjJmZTQ2NTMzZWZhMmMxZjFkN2JlY2NhYzVm'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Example Request (jQuery AJAX)

var form = new FormData();
var settings = {
    url: "https://fatture.keliweb.it/api/notifications",
    method: "GET",
    timeout: 0,
    headers: {
        Authorization:
            "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjJmZTQ2NTMzZWZhMmMxZjF"
    },
    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/notifications"

payload={}
files={}
headers = {
  'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6ImYxYTAzNzMzYzY5ZD'
}

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

print(response.text)

Example Response (JSON payload)

{
    "data": [
        {
            "id": 5,
            "invoice_id": 1,
            "identificativoSdI": 23041615,
            "nomeFileNotifica": "IT03281320782_00001_NS_001.xml",
            "nomeFileOriginale": "IT03281320782_00001.xml",
            "codiceDestinatario": null,
            "descrizioneDestinatario": null,
            "xml": "invoices/info@keliweb.it/2019/1/notifications/NS/20200709163212/IT03281320782_00001_NS_001.xml",
            "type": "NS",
            "hash": "478f782eb26503e58a0ca860eb1dc806a22a3355ada855c198b3037a1454226b",
            "errors": "[{\"Codice\": \"00200\", \"Descrizione\": \"File non conforme al formato (nella descrizione del messaggio è riportata l’indicazione puntuale della non conformità)  : The value 'abcdef70p20h123y' of element 'CodiceFiscale' is not valid.\nriga: 24 - colonna: 56\", \"Suggerimento\": \"Verificare che il file inviato sia conforme al formato previsto\"}, {\"Codice\": \"00200\", \"Descrizione\": \"File non conforme al formato (nella descrizione del messaggio è riportata l’indicazione puntuale della non conformità)  : The value 'abcdef70p20h123y' of element 'CodiceFiscale' is not valid.\nriga: 41 - colonna: 56\", \"Suggerimento\": \"Verificare che il file inviato sia conforme al formato previsto\"}]",
            "messageId": 44258902,
            "dataOraRicezione": "2020-07-09T16:31:55.000+02:00",
            "dataMessaADisposizione": null,
            "dataOraConsegna": null,
            "descrizione": null,
            "note": null,
            "created_at": "2020-07-09 14:32:12",
            "updated_at": "2020-07-09 14:32:12",
            "numeroFattura": null,
            "annoFattura": null,
            "posizioneFattura": null,
            "esito": null,
            "scarto": null,
            "messageIdCommittente": null,
            "riferimentoArchivio": null,
            "pecMessageId": null,
            "riferimentoFattura": null,
            "esitoCommittente": null,
            "formato": null,
            "tentativiInvio": null,
            "hashFileOriginale": null
        }
    ],
    "version": "v2.0.0",
    "copyright": "2009-2021 - Keliweb Srl",
    "documentation": "https://fatture.keliweb.it/docs",
    "valid_as_of": "21/10/2021 (12:25)"
}