Visualizzare i dettagli di una fattura

La chiamata che dovrai fare per visualizzare i dettagli di una fattura:

• GET https://endpoint/api/v1/invoices/invoiceId

Parametri url:

• invoiceId: identifica la fattura di cui si vuole visualizzare i dati.

Parametri della richiesta:

• apiKey: API KEY associate alla partita iva del mittente della fattura che si vuole inviare;
• withFile: (valori ammessi: “true”, “false”, default: “true”) se “true” nella risposta sarà presente il campo “invoiceFileBase64” contenente il file fattura firmato codificato in base64;
• withFileXml: (valori ammessi: “true”, “false”, default: “true”) se “true” nella risposta sarà presente il campo invoiceFileXmlBase64” contenente il file fattura xml non firmato codificato in base64;
• withFilePdf: (valori ammessi: “true”, “false”, default: “false”) se “true” nella risposta sarà presente il campo invoiceFilePdfBase64” contenente il file fattura in formato PDF codificato in base64;

Formato risposta valida :

{
"data": {
    "invoiceId": 14, 
    "invoiceKind": "ricavo", 
    "invoiceType": "FPR12", 
    "invoiceStatus": 8,
    "invoiceStatusName": "Consegnata", 
    "invoiceFileName": "IT01234567890_00000.xml.p7m",
    "sender": {
         "description": "MARIO ROSSI",
         "countryCode": "IT",
         "vatCode": "01234567890",
         "fiscalCode": "01234567890"
   },
   "receiver": {
        "description": "LUIGI VERDI", 
        "countryCode": "IT", 
        "vatCode": "98765432109",
        "fiscalCode": null
   },
  "invoiceBody": { 
       "documentType": "TD04", 
       "date": "2019-02-05",
       "number": "1"
  },
  "invoiceSdiTransmissionDateTime": "2019-02-05T12:42:22.000000Z",
  "timestamp": "2019-02-05T13:24:59.000000Z",
  "invoiceFileBase64": "MIAGCSqGSIb3DQEHAq...AA==",
  "invoiceFileXmlBase64": "PD94bWwgdmVyc2lbj0...YT4=",
  "invoiceMetadataFileName": null, 
  "invoiceMetadataFileBase64": null, 
  "notifications": [
        {
        "notificationId": "456def", 
        "notificationKind": "RicevutaConsegna", 
        "invoiceId": "584agd",
        "timestamp": "2018-01-01 13:10:00"
        }
     ]
  }
}

Dove :

• invoiceKind: assume il valore “costo” per le fatture ricevute, “ricavo” per le fatture inviate;
• invoiceStatus: indica lo stato della fattura;
• invoiceFileBase64: contenuto del file xml della fattura firmato come trasmesso/ricevuto all’SdI
• invoiceFileXmlBase64: contenuto del file xml della fattura privo di firma in base 64;
• invoiceFileName: è il nome del file xml come trasmesso all’SdI;
• metadatiFileBase64: (solo per fatture di tipo costo) contenuto del file metadati come ricevuto dall’SdI in base 64
• invoiceFileName: è il nome del file xml come trasmesso/ricevuto all’SdI;
• invoiceSdiTransmissionDateTime: (solo per fatture di tipo ricavo) se presente, indicata la data di trasmissione del file al SdI.

Possibili errori:

Si noti che l’invio della fattura al Sistema di Interscambio dopo essere stata trasmessa tramite le API potrebbe non essere immediato. Durante questa fase di “elaborazione” i campi invoiceFileName e invoiceFileBase64 assumeranno valore null.

In sandbox