Vai al contenuto

Strumenti da riga di comando

Puoi interagire con Invoicetronic API dalla riga di comando. Questo è conveniente perché non hai bisogno di essere un programmatore e puoi automatizzare le attività tramite cronjobs o altri mezzi. Questa pagina ti presenta due strumenti comodi per raggiungere questo obiettivo.

  1. invoice. Scambia facilmente file di fatture dalla riga di comando.
  2. curl. Lo standard de facto nel trasferimento dati da riga di comando.

invoice

Non hai bisogno di imparare l'API o alcun linguaggio di programmazione per inviare e ricevere fatture. Il comando invoice ti permette di scambiare rapidamente e intuitivamente file di fatture dalla riga di comando.

A colpo d'occhio

Inviare una fattura può essere semplice come eseguire questo comando:

invoice send file1.xml
Diciamo che hai molti file da caricare, puoi usare i wildcard:

invoice send *.xml --delete
invoice send file1.xml file2.xml file3.xml

Nella prima riga sopra, stiamo anche eliminando i file dal disco una volta caricati con successo.

Ricevere file è anche super semplice:

invoice receive --unread

Il comando sopra scaricherà tutte le nuove fatture e le memorizzerà nella directory corrente.

Quickstart

Come usare invoice con Invoicetronic API

Funzionalità

Il comando invoice è progettato per la semplicità e ha un solo obiettivo chiaro: scambiare file di fatture dalla riga di comando. Ci sono pochissimi comandi specifici, ognuno orientato verso un compito semplice.

Upload

Il comando send invia file di fatture allo SDI.

  • File di fattura semplice (.xml)
  • File di fattura firmato (.xml.p7m)
  • File di fattura codificato in Base64
  • Caricamento in blocco (bulk)
  • Validazione preventiva della fattura (opzione)
  • Elimina i file locali una volta caricati con successo (opzione)
  • Applica una firma digitale ai file non firmati (opzione)

Download

I comandi receive e get scaricano fatture dallo SDI.

  • Singola fattura
  • Download in blocco
  • Salva in una destinazione specifica (opzione)
  • Solo fatture non lette (opzione)
  • Come JSON, per collegare l'output ad altri strumenti (opzione)
  • Elimina la fattura remota una volta scaricata con successo (opzione)

Configurazione

Il comando config ci permette di persistere alcune impostazioni così non dobbiamo ripeterci:

  • Modalità verbosa on/off
  • Persistenza della chiave API
  • Indirizzo dell'host remoto
  • Usa un file di configurazione alternativo

Guida alla installazione

L'applicazione da riga di comando invoice è disponibile per Windows, macOS e Linux.

Windows

  1. Vai alla pagina Releases

  2. Scarica il file appropriato per la tua CPU:

    Download Architettura
    invoice-[version]-windows-x64.zip 64-bit Intel/AMD
    invoice-[version]-windows-x86.zip 32-bit Intel/AMD
    invoice-[version]-windows-arm64.zip Dispositivi ARM

  3. Apri il Prompt dei comandi o PowerShell e naviga nella posizione di download: 

    cd C:\path\to\downloads

  4. Estrai il file ZIP: 

    tar -xf invoice-[version]-windows-[architecture].zip
    Se tar non esiste sul tuo sistema, dovrai decomprimerlo con Expand-Archive (PowerShell) o manualmente, con Windows Explorer.

  5. Esegui l'applicazione: 

    invoice --help

Opzionale: Aggiungi al PATH per l'accesso a livello di sistema:

  1. Copia invoice.exe in una posizione permanente
  2. Aggiungi quella posizione alla tua variabile d'ambiente PATH
  3. Riavvia Prompt dei comandi/PowerShell

macOS

  1. Vai alla pagina Releases

  2. Scarica il file appropriato per la tua CPU:

    Download Architettura
    invoice-[version]-macos-amd64.tar.gz 64-bit Intel/AMD
    invoice-[version]-macos-arm64.tar.gz Mac M1/M2/M3

  3. Apri il Terminale e naviga nella posizione di download: 

    cd ~/Downloads

  4. Estrai l'archivio: 
    tar -xf invoice-[version]-macos-[architecture].tar.gz
  5. Esegui l'applicazione: 
    ./invoice --help

Opzionale: Sposta nel PATH di sistema:

sudo mv invoice /usr/local/bin/

Linux

  1. Vai alla pagina Releases

  2. Scarica il file appropriato per la tua CPU:

    Download Architettura
    application-[version]-linux-amd64.tar.gz 64-bit Intel/AMD
    application-[version]-linux-i386.tar.gz 32-bit Intel/AMD
    application-[version]-linux-arm64.tar.gz Dispositivi ARM

  3. Apri il terminale e naviga nella posizione di download: 

    cd ~/Downloads

  4. Estrai l'archivio: 
    tar -xf invoice-[version]-linux-[architecture].tar.gz
  5. Esegui l'applicazione: 
    ./invoice --help

Opzionale: Sposta nel PATH di sistema:

sudo mv invoice /usr/local/bin/

curl

curl è lo standard de facto nel trasferimento dati da riga di comando. È onnipresente e utilizzato quotidianamente da virtualmente ogni essere umano che usa Internet, anche se probabilmente a loro insaputa.

Come invoice, non hai bisogno di scrivere un programma per lavorare con Invoicetronic API, ma è più complesso e ha una curva di apprendimento più ripida. Ti permette di interagire con tutti gli endpoint dell'API e di eseguire molte attività, non solo inviare e ricevere fatture.

Quickstart

Come usare curl con Invoicetronic API