Legalinvoice

  1. Home
  2. Libreria API
  3. Legalinvoice
Le soluzioni di Fatturazione Elettronica per Imprese, Professionisti e Forfettari

Attiva via API ed in pochi secondi Legalinvoice, il software di Fatturazione Elettronica B2B e PA

Tutte le informazioni di cui hai bisogno

Qui trovi qualche consiglio da prendere in considerazione per approcciare a questa API. Se preferisci forniamo esempi di codice, documentazione in OAS3, la possibilità di provare l'API dal vivo con la Swagger UI oppure importare l'intera collezione in Postman. Offriamo inoltre un ambiente di Sandbox dove puoi sperimentare tutte le API gratuitamente.

Utili consigli per iniziare con Legalinvoice

Prendi il token nell'apposita sezione prima di cominciare.

Usa lo strumento online o generalo via API. Imposta una data di scadenza e aggiungi una serie di Scopes per limitare le possibli azioni permesse al token.
Approfondisci Oauth Gestisci i tokens
API docs by Redocly

Legal Invoice (1.0.0)

URL: https://openapi.it/en/support License: Apache 2.0 Terms of Service

Servizio web che consente di attivare un account per la fatturazione elettronica.

Prima volta qui? Generare un nuovo token di accesso

Create

Metodi che consentono di attivare un nuovo account

Registrare un nuovo account per la fattura legale "forfettario

Questo metodo consente di registrare un nuovo conto di fattura legale di tipo "forfettario". 'forfettario' significa che si hanno 50 fatture iniziali. Per i documenti il sistema chiamerà dal seguente ip: 34.76.237.249

Authorizations:
bearerAuth
Request Body schema: application/json
cf_piva_titolare
required
string

Supporto per cf/piva

denominazione_titolare
required
string

nome del titolare

comune_titolare
required
string

città titolare

indirizzo_titolare
required
string

indirizzo del titolare

cap_titolare
required
string

codice postale del titolare

provincia_titolare
required
string

provincia titolare

email
required
string

e-mail del titolare

nome_richiedente
required
string

nome del cliente

cognome_richiedente
required
string

cognome del cliente

sesso_richiedente
required
string
Enum: "M" "F"

genere

cf_richiedente
required
string

codice fiscale del cliente

data_nascita_richiedente
string

data di nascita del cliente (formato accettato: gg/mm/aaaa)

telefono
string

telefono cliente

cellulare
string

telefono cellulare del cliente

documento_identita
required
string

Url da cui il sistema può scaricare un documento di identità del cliente; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

modulo_attivazione
required
string

Url da cui il sistema può scaricare il modulo di attivazione; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

se impostato su true, permette al sistema di rinnovare automaticamente l'account alla scadenza, cercando di prelevare il credito dal borsellino del proprietario

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Registrare un nuovo conto fattura legale "iniziale

Questo metodo consente di registrare un nuovo conto di fatture legali di tipo "start". 'start' significa che si hanno 200 fatture iniziali. Per i documenti il sistema chiamerà dal seguente ip: 34.76.237.249

Authorizations:
bearerAuth
Request Body schema: application/json
cf_piva_titolare
required
string

Supporto per cf/piva

denominazione_titolare
required
string

nome del titolare

comune_titolare
required
string

città titolare

indirizzo_titolare
required
string

indirizzo del titolare

cap_titolare
required
string

codice postale del titolare

provincia_titolare
required
string

provincia titolare

email
required
string

e-mail del titolare

nome_richiedente
required
string

nome del cliente

cognome_richiedente
required
string

cognome del cliente

sesso_richiedente
required
string
Enum: "M" "F"

genere

cf_richiedente
required
string

codice fiscale del cliente

data_nascita_richiedente
string

data di nascita del cliente (formato accettato: gg/mm/aaaa)

telefono
string

telefono cliente

cellulare
string

telefono cellulare del cliente

documento_identita
required
string

Url da cui il sistema può scaricare un documento di identità del cliente; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

modulo_attivazione
required
string

Url da cui il sistema può scaricare il modulo di attivazione; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

se impostato su true, permette al sistema di rinnovare automaticamente l'account alla scadenza, cercando di prelevare il credito dal borsellino del proprietario

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Registrare un nuovo account di fattura legale "pro

Questo metodo consente di registrare un nuovo account di fatturazione legale di tipo "pro". 'pro' significa che si hanno 400 fatture iniziali e la possibilità di aggiungere altri nomi di società. Per i documenti il sistema chiamerà dal seguente ip: 34.76.237.249

Authorizations:
bearerAuth
Request Body schema: application/json
cf_piva_titolare
required
string

Supporto per cf/piva

denominazione_titolare
required
string

nome del titolare

comune_titolare
required
string

città titolare

indirizzo_titolare
required
string

indirizzo del titolare

cap_titolare
required
string

codice postale del titolare

provincia_titolare
required
string

provincia titolare

email
required
string

e-mail del titolare

nome_richiedente
required
string

nome del cliente

cognome_richiedente
required
string

cognome del cliente

sesso_richiedente
required
string
Enum: "M" "F"

genere

cf_richiedente
required
string

codice fiscale del cliente

data_nascita_richiedente
string

data di nascita del cliente (formato accettato: gg/mm/aaaa)

telefono
string

telefono cliente

cellulare
string

telefono cellulare del cliente

documento_identita
required
string

Url da cui il sistema può scaricare un documento di identità del cliente; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

modulo_attivazione
required
string

Url da cui il sistema può scaricare il modulo di attivazione; formato accettato: pdf. Il sistema chiamerà dal seguente ip: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

se impostato su true, permette al sistema di rinnovare automaticamente l'account alla scadenza, cercando di prelevare il credito dal borsellino del proprietario

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Scarica il modulo di attivazione

Questo metodo consente di scaricare direttamente il modulo di attivazione. Una volta compilato e firmato, verrà passato sotto forma di stringa codificata in base 64 utilizzando il metodo POST insieme a un documento di identità.

Authorizations:
bearerAuth

Responses

Response Schema: application/pdf
string <binary>

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/modulo_attivazione");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Modify

Metodi che consentono di modificare il proprio account

Elenco dei conti delle fatture legali

Questo metodo mostra l'elenco dei conti delle fatture legali che appartengono al proprio nome utente.

Authorizations:
bearerAuth

Responses

Response Schema: application/json
Array of objects (Accounts)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/account");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "message": "",
  • "error": null
}

Conto specifico della fattura legale

Questo metodo mostra lo specifico conto della fattura legale relativo all'id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 62b19eea2f7b5264ce34ac29

Id del conto

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/account/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Aggiungere fatture o nomi di società supplementari

Questo metodo consente di aggiungere fatture o nomi di società supplementari. Le fatture possono essere aggiunte per tutti i tipi di conti, mentre le ragioni sociali possono essere aggiunte solo per quelli di tipo "pro".

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 62b19eea2f7b5264ce34ac29

Id del conto

Request Body schema: application/json
fatture_extra
integer [ 50 .. 900 ]

numero di fatture extra, accettati solo multipli di 50 per forfettario e 100 per start/pro

ragioni_sociali_extra
integer [ 1 .. 1000 ]

numero di nomi di aziende extra

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples

Content type
application/json
{
  • "fatture_extra": 200
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Revoca di un conto fattura legale

Questo metodo consente di revocare il conto specifico della fattura legale relativa all'id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 62b19eea2f7b5264ce34ac29

Id del conto

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/account/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Rinnovo del conto per le fatture legali

Questo metodo consente di rinnovare per uno o più anni il conto della fattura legale identificato dall'id

Authorizations:
bearerAuth
path Parameters
id
required
string
Example: 62b19eea2f7b5264ce34ac29

Id del conto

query Parameters
anni
integer
Example: anni=2

Numero di anni per i quali si desidera rinnovare l'account. Se non viene passato è 1 per impostazione predefinita

Responses

Response Schema: application/json
object (Account)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/account/%7Bid%7D/rinnovo?anni=2");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}

Conto specifico della fattura legale

Questo metodo mostra il conto o i conti delle fatture legali relativi all'e-mail.

Authorizations:
bearerAuth
path Parameters
email
required
string

Email dell'account

Responses

Response Schema: application/json
Account (object) or Accounts (object)
success
boolean
message
string
error
integer

Request samples 

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://legalinvoice.openapi.it/account/%7Bemail%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "success": true,
  • "message": "",
  • "error": null
}
Web Service Revision: 2.0.0