Salta ai contenuti

Per conformarsi a TicketBAI, il sistema di fatturazione o POS deve essere dotato di un software che generi un file XML per ogni transazione, lo firmi con un certificato elettronico e lo invii all’autorità fiscale competente.

La firma dei file TicketBAI viene eseguita nel componente di firma dell’API SIGN ES.

Ogni fattura sarà concatenata alla precedente e la firma digitale garantisce che le informazioni non vengano manomesse.

L’API SIGN ES utilizza un certificato elettronico gestito da fiskaly per firmare e inviare tutti i file XML TicketBAI per conto del contribuente.

In fiskaly, abbiamo deciso di utilizzare il nostro certificato elettronico grazie ai suoi molteplici vantaggi:

  • È gestito completamente da fiskaly, quindi non devi preoccuparti delle date di scadenza o del rinnovo.
  • Il contribuente non deve fornire il proprio certificato privato.
  • La firma e l’invio dei file TicketBAI possono essere effettuati con lo stesso certificato, poiché fiskaly è un collaboratore sociale delle autorità fiscali di tutti e tre i territori dei Paesi Baschi: Álava, Bizkaia e Gipuzkoa.

Accordo di collaborazione sociale tra fiskaly e il contribuente

Sezione intitolata “Accordo di collaborazione sociale tra fiskaly e il contribuente”

Come parte del processo di integrazione, è necessario implementare gli endpoint corrispondenti alla generazione e al caricamento dell’accordo di collaborazione sociale tra fiskaly e il contribuente.

Tramite l’endpoint Genera accordo, fornirai tutte le informazioni necessarie a fiskaly per generare l’accordo. Le informazioni richieste variano a seconda che il contribuente sia un’AZIENDA o un INDIVIDUO.

  • Per un INDIVIDUO (ad es. lavoratore autonomo), tutte le informazioni vengono fornite tramite l’endpoint Crea contribuente, dove sono necessari legal_name, tax_number e address dell’emittente. Non vengono utilizzate informazioni aggiuntive dall’endpoint Genera accordo.
  • Per un’AZIENDA, è necessario fornire:
    • legal_name, tax_number e address dall’endpoint Crea contribuente
    • Informazioni sul rappresentante dell’azienda (full_name, tax_number e address) come richiesto nell’endpoint Genera accordo.

Come risposta positiva, otterrai il PDF, che deve essere firmato dal contribuente.

Una volta che il documento è firmato digitalmente, SIGN ES richiede che venga fornito come documento PDF codificato in Base-64 tramite l’endpoint Carica accordo firmato.