API FATTURAZIONE

L’API è privata e quindi per poterne usufruire è necessario possedere il Token per l’accesso che può essere richiesto a Nomos S.r.l. Per effettuare l’interrogazione è sufficiente inviare all’Url sotto indicato una richiesta di tipo GET indicando obbligatoriamente il proprio Token. La risorsa risponde con un formato JSON contenente i seguenti campi:

  • errors: array contenente eventuali errori che sono stati riscontrati nella richiesta
  • token: se inserito correttamente nella richiesta in questa variabile viene memorizzato il vostro token, altrimenti non sarà presente la variabile nella risposta JSON
  • code: questa variabile ritorna il codice 200 se la richiesta è corretta e non ci sono errori, 403 se il Token non è corretto e 404 se ci sono altri errori nella richiesta
  • fatture: array contenente i dettagli delle singole fatture:
    • data: data della fattura
    • numero_fattura: numero univoco della fattura
    • cliente: cliente della fattura
    • causale: causale della fattura
    • importo_netto: importo della fattura iva esclusa
    • importo_iva: conteggio iva della fattura
    • importo_totale: importo della fattura iva inclusa
    • stato: fattura pagata o non pagata
  • generato_il: questa variabile contiene la data di generazione della risposta

Url: [NOME ATENEO]-specializzazionemedica.it/API/fatture.php?t=[TOKEN ACCESSO]

Inoltre, è possibile utilizzare ulteriori parametri facoltativi da inserire in GET come il Token:

  • [da] Se questo parametro viene usato senza l’uso del parametro [a] allora mostra le fatture che sono state fatte nel giorno indicato, altrimenti (se usato con il parametro [a] indica la data di inizio del periodo che si vuole selezionare). Formato richiesto [gg-mm-aaaa].
  • [a] Se questo parametro viene usato senza l’uso del parametro [da] allora mostra le fatture che sono state fatte nel giorno indicato, altrimenti (se usato con il parametro [a] indica la data di fine del periodo che si vuole selezionare). Formato richiesto [gg-mm-aaaa].
  • [pagato] Ritorna solo le fatture con lo stato di pagamento indicato. Accetta [S] per pagato e [N] per non pagato
  • [cliente] Seleziona le fatture con il cliente inserito (può essere inserito anche parte del nominativo del cliente)

Esempi: