Canale di invio e ricezione
accreditato SdI

Sistema di Interscambi

Telefono
+39 06-40402261

Ruby

Guida pratica

Ruby

Guida pratica

Fattura elettronica

Prova Fattura24

GRATIS

per 30 giorni

CLICCA QUI

Ruby è linguaggio di programmazione nato in oriente e si basa sul principio del OOP (Object Oriented Programming). Pur essendo un linguaggio OOP presenta alcune paradigmi caratteristici come imperativo e funzionale.
 

IMPORTANTE: Questo modulo è stato realizzato da uno sviluppatore indipendente pertanto Fattura24 non può garantirne il corretto funzionamento ne fornire assistenza tecnica. Per qualsiasi chiarimento vi invitiamo a contattare direttamente l’autore: qui il suo account GitHub.

 

 

ruby modulo di fatturazione fattura24

 

Cosa permette di fare Ruby?

Il linguaggio Ruby offre un’integrazione alle API di Fattura24 (https://www.fattura24.com/api-documentazione/) per qualsiasi progetto Rudy in modo più handy and practical per lo sviluppatore.

 

Consulta il Regolamento Integrativo (delle Condizioni di Contratto) per l’UTENTE che utilizza le API di Fattura24, clicca qui.

 

Grazie agli oggetti puri e dinamici è possibile aggiungere o modificare metodi a run-time che si trovano in questi pacchetti.

 

Esempio pratico

Come si evince dall’esempio presente sulla pagina dello sviluppatore, che riportiamo qui di seguito, per usare questo pacchetto bisogna configurare il modulo di Fattura24 aggiungendo la propria chiave API.

 

La libreria tradurrà la struttura del hash in un documento; quindi effettua la chiamata e controlla la risposta:

r = Fattura24::Fuoco.test_key
r = Fattura24::Api.get_template
r = Fattura24::Fuoco.get_pdc
r = Fattura24::Api.get_numerator

mette  r . 

 

Sala cliente

r  =  Fattura24 :: Api . save_customer ( 
  CUSTOMER_NAME : 'John Doe' , 
  customer_address : '100 Yonge Street' , 
  customer_city : 'Toronto' , 
  customer_country : 'CA' , 
  customer_fiscal_code : 'Impostare questo per le persone' , 
  customer_vat_code : 'iva' , 
  customer_email : 'un po' @ mail .com' , 
  fe_customer_pec : 'a@pec.com' 
)

 

Salva documento

r  =  Fattura24 :: Api . save_document ( 
  DOCUMENT_TYPE : Fattura24 :: DocumentType :: ELECTRONIC_INVOICE , 
  customer_name : 'John Doe' , 
  customer_fiscal_code : 'NDASFN89A27L219Y' , 
  customer_address : '100 Yonge Street' , 
  customer_city : 'Toronto' , 
  customer_country : 'CA' , 
  fe_payment_code : Fattura24 :: FePaymentCode :: CREDIT_CARD, 
  pagamenti : [ 
    { 
      data : '2020-04-27' , 
      importo : '100' , 
      pagato : 'vero' 
    } 
  ] , 
  righe : [ 
    { 
      codice : '001' , 
      descrizione : 'Descrizione elemento' , 
      qtà : '1 ' , 
      prezzo : '100' 
    } 
  ] , 
  id_template : '65' , 
  send_email : 'true' , 
  oggetto :'test' , 
  totale : 100 , 
  totale_senza_tasse : 100 , 
  importo_iva : 0 
)

 

Prendi il file

r = Fattura24::Fuoco.prendi il file('1234567')

# true se il contenuto della risposta è in realtà un file 
se  r . PDF? 
  File . write ( 'invoice.pdf' ,  r . to_s ) 
end

 

Ottieni il prodotto

# ottiene tutti i prodotti 
r  =  Fattura24 :: Api . get_product

# filtri per codice 
r  =  Fattura24 :: Api . get_product ( codice : 'qualche_codice' )

# filtri per categoria 
r  =  Fattura24 :: Api . get_product ( categoria : 'qualche_categoria' )

# combina entrambi 
r  =  Fattura24 :: Api . get_product ( { 
  code : 'some_code' , 
  category : 'some_category' 
} )

 

Sviluppo

Dopo aver controllato e verificato il reposity bisogna eseguire il bunndle per l’installazione delle dipendenze.

 

Per l’installazione del modulo Ruby in locale devi eseguir il bundle exec rake install mentre per eseguire il ret e linting basterà eseguire il bundle exec rake.

 

Ricordati che dopo ogni modifica deve include i documenti appropriati ed eseguendo bundle exec rake rdoc li potrai ricostruire.

 

Con il comando $ make build puoi testare la versione per il mobile e di conseguenza verranno create immagini docker che potrai testare con il comando $ make.

 

Quindi, per concludere una volta impostato è possibile richiamare i metodi delle API e ottenere le necessarie risposte.

 

Queste chiamate non richiedono alcun argomento; basta utilizzarle e lavorare le conseguenti risposte.

 

Il modulo per Ruby è a questo link: https://github.com/snada/fattura24.

Fattura elettronica

Prova Fattura24

GRATIS

per 30 giorni

CLICCA QUI