Legalinvoice

Solutions de facturation électronique pour les entreprises, les professionnels et les contribuables

Activez via API et en quelques secondes Legalinvoice, le logiciel de facturation électronique B2B et PA.

Toutes les connaissances dont vous avez besoin

Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.

Conseils utiles pour commencer Legalinvoice

Obtenir le Token dans la section appropriée avant de commencer.

Utilisez l'outil en ligne ou générez-le via l'API. Définissez la date d'expiration, un nom utile et ajoutez maintenant un ensemble d'étendues pour limiter les actions possibles que votre jeton peut effectuer.

Legal Invoice (1.0.0)

Service web permettant d'activer un compte pour la facturation électronique.

Create

Méthodes permettant d'activer un nouveau compte

Enregistrer un nouveau compte "forfettario" pour les factures légales

Cette méthode vous permet d'enregistrer un nouveau compte de factures légales de type "forfettario". 'forfettario' signifie que vous avez 50 factures de départ. Pour les documents, le système appellera à partir de l'adresse IP suivante : 34.76.237.249

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

Porte-pivot cf/piva

denominazione_titolare
required
string

nom du titulaire

comune_titolare
required
string

ville détentrice

indirizzo_titolare
required
string

adresse du titulaire

cap_titolare
required
string

code postal du titulaire

provincia_titolare
required
string

Province du titulaire

email
required
string

courriel du titulaire

nome_richiedente
required
string

nom du client

cognome_richiedente
required
string

nom de famille du client

sesso_richiedente
required
string
Enum: "M" "F"

genre

cf_richiedente
required
string

code fiscal du client

data_nascita_richiedente
string

date de naissance du client (format accepté : jj/mm/aaaa)

telefono
string

téléphone client

cellulare
string

téléphone mobile du client

documento_identita
required
string

Url où le système peut télécharger un document d'identité du client ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

modulo_attivazione
required
string

Url où le système peut télécharger le formulaire d'activation ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

s'il est fixé à true, il permet au système de renouveler le compte automatiquement à l'expiration, en essayant de retirer le crédit du porte-monnaie du propriétaire.

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
}

Enregistrement d'un nouveau compte "start" pour les factures légales

Cette méthode vous permet d'enregistrer un nouveau compte de factures légales de type "start". 'start' signifie que vous avez 200 factures de départ. Pour les documents, le système appellera à partir de l'adresse IP suivante : 34.76.237.249

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

Porte-pivot cf/piva

denominazione_titolare
required
string

nom du titulaire

comune_titolare
required
string

ville détentrice

indirizzo_titolare
required
string

adresse du titulaire

cap_titolare
required
string

code postal du titulaire

provincia_titolare
required
string

Province du titulaire

email
required
string

courriel du titulaire

nome_richiedente
required
string

nom du client

cognome_richiedente
required
string

nom de famille du client

sesso_richiedente
required
string
Enum: "M" "F"

genre

cf_richiedente
required
string

code fiscal du client

data_nascita_richiedente
string

date de naissance du client (format accepté : jj/mm/aaaa)

telefono
string

téléphone client

cellulare
string

téléphone mobile du client

documento_identita
required
string

Url où le système peut télécharger un document d'identité du client ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

modulo_attivazione
required
string

Url où le système peut télécharger le formulaire d'activation ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

s'il est fixé à true, il permet au système de renouveler le compte automatiquement à l'expiration, en essayant de retirer le crédit du porte-monnaie du propriétaire.

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
}

Enregistrement d'un nouveau compte "pro" pour les factures légales

Cette méthode vous permet d'enregistrer un nouveau compte de factures légales de type "pro". pro" signifie que vous disposez de 400 factures de départ et de la possibilité d'ajouter des noms d'entreprise supplémentaires. Pour les documents, le système appellera à partir de l'adresse IP suivante : 34.76.237.249

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

Porte-pivot cf/piva

denominazione_titolare
required
string

nom du titulaire

comune_titolare
required
string

ville détentrice

indirizzo_titolare
required
string

adresse du titulaire

cap_titolare
required
string

code postal du titulaire

provincia_titolare
required
string

Province du titulaire

email
required
string

courriel du titulaire

nome_richiedente
required
string

nom du client

cognome_richiedente
required
string

nom de famille du client

sesso_richiedente
required
string
Enum: "M" "F"

genre

cf_richiedente
required
string

code fiscal du client

data_nascita_richiedente
string

date de naissance du client (format accepté : jj/mm/aaaa)

telefono
string

téléphone client

cellulare
string

téléphone mobile du client

documento_identita
required
string

Url où le système peut télécharger un document d'identité du client ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

modulo_attivazione
required
string

Url où le système peut télécharger le formulaire d'activation ; format accepté : pdf. Le système appellera à partir de l'adresse IP suivante : 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

s'il est fixé à true, il permet au système de renouveler le compte automatiquement à l'expiration, en essayant de retirer le crédit du porte-monnaie du propriétaire.

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
}

Télécharger le formulaire d'activation

Cette méthode vous permet de télécharger directement le formulaire d'activation. Une fois compilé et signé, il sera transmis sous la forme d'une chaîne codée en base 64 à l'aide de la méthode POST, accompagné d'un document d'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

Méthodes permettant de modifier votre compte

Liste des comptes de vos factures légales

Cette méthode permet d'afficher la liste des comptes de factures légales appartenant à votre nom d'utilisateur.

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
}

Compte spécifique de la facture légale

Cette méthode permet d'afficher le compte de la facture légale correspondant à l'identifiant.

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

Identifiant du compte

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
}

Ajouter des factures ou des noms d'entreprises supplémentaires

Cette méthode vous permet d'ajouter des factures ou des noms d'entreprise supplémentaires. Les factures peuvent être ajoutées pour tous les types de comptes, tandis que les noms de sociétés ne peuvent être ajoutés que pour les comptes de type "pro".

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

Identifiant du compte

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

nombre de factures supplémentaires, seuls les multiples de 50 pour forfettario et de 100 pour start/pro sont acceptés

ragioni_sociali_extra
integer [ 1 .. 1000 ]

nombre de noms d'entreprises supplémentaires

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
}

Révocation d'un compte de facturation légale

Cette méthode vous permet de révoquer le compte de facturation légale spécifique lié à l'identifiant

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

Identifiant du compte

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
}

Renouvellement du compte de factures légales

Cette méthode vous permet de renouveler pour une ou plusieurs années le compte de facture légale identifié par l'id

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

Identifiant du compte

query Parameters
anni
integer
Example: anni=2

Nombre d'années pour lesquelles vous souhaitez renouveler le compte. S'il n'est pas renseigné, il est de 1 par défaut

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
}

Compte spécifique de la facture légale

Cette méthode permet d'afficher le ou les comptes de la facture légale liés à l'e-mail.

Authorizations:
bearerAuth
path Parameters
email
required
string

Courriel du compte

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
}