Legalinvoice

Lösungen für die elektronische Rechnungsstellung für Unternehmen, Freiberufler und Steuerzahler

Aktivieren Sie über API und in Sekunden Legalinvoice, die Software für die elektronische Rechnungsstellung für B2B und PA.

All das Wissen, das Sie benötigen

Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.

Nützliche Tipps für den Einstieg Legalinvoice

Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.

Verwenden Sie das Online-Tool oder generieren Sie es über die API. Legen Sie das Ablaufdatum, einen nützlichen Namen fest und fügen Sie jetzt eine Vielzahl von Scopes hinzu, um die möglichen Aktionen Ihres Tokens zu begrenzen.

Legal Invoice (1.0.0)

Webdienst, mit dem ein Konto für die elektronische Rechnungsstellung aktiviert werden kann.

Create

Methoden zur Aktivierung eines neuen Kontos

Registrierung eines neuen Kontos für die gesetzliche "Pauschalrechnung

Mit dieser Methode kann ein neues juristisches Rechnungskonto als 'pauschal' registriert werden. Pauschal" bedeutet, dass Sie 50 Ausgangsrechnungen haben. Für Dokumente ruft das System von der folgenden IP-Adresse aus auf: 34.76.237.249

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

Unterstützung für cf/piva

denominazione_titolare
required
string

Name des Inhabers

comune_titolare
required
string

Titularstadt

indirizzo_titolare
required
string

Adresse des Inhabers

cap_titolare
required
string

Postleitzahl des Inhabers

provincia_titolare
required
string

Titularprovinz

email
required
string

E-Mail des Inhabers

nome_richiedente
required
string

Name des Kunden

cognome_richiedente
required
string

Nachname des Kunden

sesso_richiedente
required
string
Enum: "M" "F"

Genre

cf_richiedente
required
string

Steuernummer des Kunden

data_nascita_richiedente
string

Geburtsdatum des Kunden (akzeptiertes Format: tt/mm/jjjjj)

telefono
string

Kundentelefon

cellulare
string

das Mobiltelefon des Kunden

documento_identita
required
string

Url, von der das System ein Kundenidentitätsdokument herunterladen kann; akzeptiertes Format: pdf. Das System ruft von der folgenden IP-Adresse aus auf: 34.76.237.249

modulo_attivazione
required
string

Url, von der das System das Aktivierungsformular herunterladen kann; akzeptiertes Format: pdf. Das System wird von der folgenden IP-Adresse aus aufgerufen: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

wenn auf true gesetzt, erlaubt es dem System, das Konto automatisch zu erneuern, wenn es abläuft, und versucht, Guthaben aus dem Geldbeutel des Besitzers zu ziehen

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
}

Registrierung eines neuen Kontos für juristische Rechnungen (initial)

Mit dieser Methode können Sie ein neues "Start"-Rechnungskonto registrieren. 'Start' bedeutet, dass Sie 200 erste Rechnungen haben. Für Dokumente wird das System von der folgenden IP-Adresse aus aufrufen: 34.76.237.249

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

Unterstützung für cf/piva

denominazione_titolare
required
string

Name des Inhabers

comune_titolare
required
string

Titularstadt

indirizzo_titolare
required
string

Adresse des Inhabers

cap_titolare
required
string

Postleitzahl des Inhabers

provincia_titolare
required
string

Titularprovinz

email
required
string

E-Mail des Inhabers

nome_richiedente
required
string

Name des Kunden

cognome_richiedente
required
string

Nachname des Kunden

sesso_richiedente
required
string
Enum: "M" "F"

Genre

cf_richiedente
required
string

Steuernummer des Kunden

data_nascita_richiedente
string

Geburtsdatum des Kunden (akzeptiertes Format: tt/mm/jjjjj)

telefono
string

Kundentelefon

cellulare
string

das Mobiltelefon des Kunden

documento_identita
required
string

Url, von der das System ein Kundenidentitätsdokument herunterladen kann; akzeptiertes Format: pdf. Das System ruft von der folgenden IP-Adresse aus auf: 34.76.237.249

modulo_attivazione
required
string

Url, von der das System das Aktivierungsformular herunterladen kann; akzeptiertes Format: pdf. Das System wird von der folgenden IP-Adresse aus aufgerufen: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

wenn auf true gesetzt, erlaubt es dem System, das Konto automatisch zu erneuern, wenn es abläuft, und versucht, Guthaben aus dem Geldbeutel des Besitzers zu ziehen

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
}

Registrierung eines neuen juristischen Rechnungskontos "pro

Mit dieser Methode können Sie ein neues Konto für die juristische Rechnungsstellung "pro" registrieren. Pro" bedeutet, dass Sie zunächst 400 Rechnungen erhalten und die Möglichkeit haben, weitere Firmennamen hinzuzufügen. Für die Dokumente wird das System von der folgenden IP-Adresse aus aufrufen: 34.76.237.249

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

Unterstützung für cf/piva

denominazione_titolare
required
string

Name des Inhabers

comune_titolare
required
string

Titularstadt

indirizzo_titolare
required
string

Adresse des Inhabers

cap_titolare
required
string

Postleitzahl des Inhabers

provincia_titolare
required
string

Titularprovinz

email
required
string

E-Mail des Inhabers

nome_richiedente
required
string

Name des Kunden

cognome_richiedente
required
string

Nachname des Kunden

sesso_richiedente
required
string
Enum: "M" "F"

Genre

cf_richiedente
required
string

Steuernummer des Kunden

data_nascita_richiedente
string

Geburtsdatum des Kunden (akzeptiertes Format: tt/mm/jjjjj)

telefono
string

Kundentelefon

cellulare
string

das Mobiltelefon des Kunden

documento_identita
required
string

Url, von der das System ein Kundenidentitätsdokument herunterladen kann; akzeptiertes Format: pdf. Das System ruft von der folgenden IP-Adresse aus auf: 34.76.237.249

modulo_attivazione
required
string

Url, von der das System das Aktivierungsformular herunterladen kann; akzeptiertes Format: pdf. Das System wird von der folgenden IP-Adresse aus aufgerufen: 34.76.237.249

object (Callback)
autorinnovo
boolean
Default: false

wenn auf true gesetzt, erlaubt es dem System, das Konto automatisch zu erneuern, wenn es abläuft, und versucht, Guthaben aus dem Geldbeutel des Besitzers zu ziehen

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
}

Aktivierungsformular herunterladen

Mit dieser Methode kann das Aktivierungsformular direkt heruntergeladen werden. Sobald es ausgefüllt und signiert ist, wird es in Form einer Base-64-kodierten Zeichenfolge mit der POST-Methode zusammen mit einem Identitätsdokument übermittelt.

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

Methoden zur Änderung des eigenen Kontos

Liste der gesetzlichen Rechnungskonten

Mit dieser Methode wird die Liste der gesetzlichen Rechnungskonten angezeigt, die dem eigenen Benutzernamen gehören.

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
}

Spezifisches Konto für juristische Rechnungen

Diese Methode zeigt das spezifische gesetzliche Rechnungskonto an, das mit der id

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

Kennung des Kontos

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
}

Hinzufügen zusätzlicher Rechnungen oder Firmennamen

Mit dieser Methode können Rechnungen oder zusätzliche Firmennamen hinzugefügt werden. Rechnungen können für alle Arten von Konten hinzugefügt werden, während Firmennamen nur für "Pro"-Konten hinzugefügt werden können.

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

Kennung des Kontos

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

Anzahl der zusätzlichen Rechnungen, nur Vielfache von 50 für Pauschalbeträge und 100 für Start/Pro

ragioni_sociali_extra
integer [ 1 .. 1000 ]

Anzahl der zusätzlichen Firmennamen

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
}

Widerruf eines gesetzlichen Rechnungskontos

Mit dieser Methode können Sie ein bestimmtes legales Rechnungskonto widerrufen, das mit der id

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

Kennung des Kontos

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
}

Erneuerung des Kontos für juristische Rechnungen

Diese Methode ermöglicht es, das legale Rechnungskonto, das durch die id identifiziert wird, für ein oder mehrere Jahre zu verlängern.

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

Kennung des Kontos

query Parameters
anni
integer
Example: anni=2

Anzahl der Jahre, um die Sie das Konto verlängern möchten. Wenn nicht übergeben ist 1 standardmäßig

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
}

Spezifisches Konto für juristische Rechnungen

Diese Methode zeigt das/die legale(n) Rechnungskonto(s) an, die mit der E-Mail verbunden sind.

Authorizations:
bearerAuth
path Parameters
email
required
string

Konto E-Mail

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
}