Ruby

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.
 

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.

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.