Die API wurde durch die neuen, in Company verfügbaren Endpunkte ersetzt
Um Zugang zu allen Stammdaten, Tätigkeitsinformationen, Aktionären und wirtschaftlichen Daten eines italienischen Unternehmens zu erhalten, entdecken Sie die neuen Dienste Company
Deprecated starting from 2025-12-31
Es gibt keine Begrenzung für den als Parameter angegebenen Radius, aber bitte beachten Sie, dass die maximale Anzahl von Ergebnissen pro einzelner Anfrage 100 beträgt.
In der Get Advance-Antwort ist der eingetragene Sitz des Unternehmens angegeben.
Der Parameter hängt von dem Endpunkt ab, für den die Anfrage gestellt werden soll.
Für Get /base, /advance, /closed, /gruppoiva, /pec, /soci ist einer der folgenden Parameter zu verwenden:
- Umsatzsteuernummer
- Steuerkennzeichen
- id (nur für base und advance)
Für den Endpunkt GET Advance können einer oder mehrere der folgenden Parameter übergeben werden:
- Name oder Teil (in diesem Fall muss der Name immer eine ganze Zahl sein) des Firmennamens
- Provinz
- ATECO-Code
- CCIAA
- REA
- Mindest- und/oder Höchstumsatz
- Mindest- und/oder Höchstzahl der Beschäftigten
Für den Endpunkt GET /Autocomplete kann der Parameter eine Zeichenkette (auch mit Platzhalter '*') und optional Breitengrad, Längengrad und Radius sein.
Für den GET-Endpunkt /forma_giuridica/ wird kein Parameter benötigt, für Get /forma_giuridica/ ist es der Legal Nature Code.
Für den GET-Endpunkt /updates/ sind die Parameter, die alle optional sind, Breitengrad, Längengrad und Radius.
Für den Endpunkt /updates/{timestamp} muss der obligatorische Parameter zu den vorherigen Endpunkten hinzugefügt werden: timestamp (d.h. das Datum, ab dem die Suche beginnen soll).
Die Aktualisierung hängt von der Art der Daten und dem Endpoint.
Die Daten in den endpoint Cessate (=Eingestellt) und SdI werden täglich aktualisiert. Neue und stillgelegte Unternehmen werden innerhalb von 24 Stunden aktualisiert. Daten wie Umsatz, Gewinn und PEC (=turnover, profit and PEC) werden im Durchschnitt wöchentlich aktualisiert und können eine maximale Verzögerung von einem Monat aufweisen. Die Dipendenti (=Mitarbeiterdaten) werden vierteljährlich aktualisiert.
Es handelt sich um zwei verschiedene Informationen, die aus unterschiedlichen offiziellen Quellen stammen.
Das Feld Stato Attività (=Aktivitätsstatus) gibt den Status des Unternehmens gemäß der italienischen Handelskammer an. Folgende Werte können in der Antwort vorkommen:
- Attiva (=Aktiv)
- Registrata (=Eingetragen)
- Inattiva (=Inaktiv)
- Sospesa (=Suspendiert)
- In Iscrizione (=Eingeschrieben)
- Cessata (=Erloschen)
Das Feld Cessata (=Eingestellt) gibt stattdessen den Status des Unternehmens bei der Steuerbehörde an. In diesem Fall sind die verfügbaren Werte:
- True
- False
Die Verpflichtung zur Identifizierung mittels des Identitätsdokuments der Person oder Firma, die den Service beantragt, besteht nur für einige Dienste, die dem TULPS und der entsprechenden Lizenz unterliegen (Artikel 6 der TULPS-Lizenz).
Für einige Dienste schreibt die TULPS-Verordnung die Identifizierung des Dienstnutzers vor. Im Falle von Unternehmen ist es daher erforderlich, ein Identitätsdokument (Führerschein, Reisepass, Personalausweis) hochzuladen, das entweder dem gesetzlichen Vertreter oder einer Person mit Zeichnungsbefugnissen oder einem Delegierten für die Bereitstellung und Nutzung des spezifischen Dienstes gehört (z. B. IT-Manager oder Verwaltungsbüro).
Die Antwort wird für alle Endpunkte in Echtzeit zurückgegeben.
Informationen zur Mitgliedschaft sind über den speziellen Endppoint "Get /soci" oder auch im Antwortdatensatz für den Endpunkt "Get Advance/{piva_or_cf}" verfügbar.
Die Antwort wird in Echtzeit zurückgegeben und enthält Name oder Bezeichnung, Steuernummer und prozentualen Anteil.
Die Aktionäre in der Liste sind diejenigen, die einen Anteil von 10 % oder mehr haben (die gleichen Informationen können auch aus der hinterlegten Bilanz entnommen werden, wenn diese in den letzten 4 Jahren hinterlegt wurde).
Für aktuellere und umfangreichere Daten können Sie auch den Endpoint GET /soci der Unternehmens-API verwenden, über den Sie weitere Informationen über die Unternehmensrollen, die Aktionäre und das Unternehmen im Allgemeinen erhalten.
Die Parameter für eine Anfrage an die beiden Endpunkte sind die gleichen:
- MwSt.-Nummer
- Steuernummer
- id
Der Unterschied liegt in den Daten, die in der Antwort enthalten sind.
Die Antwort GET Base enthält die folgenden Daten:
- Steuerkennzeichen
- Name
- MwSt.-Nummer
- Ortsname
- Straße
- Hausnummer
- vollständige Adresse
- Gemeinde
- Weiler
- Provinz
- Status der Tätigkeit
- Datum der Aktualisierung
- Postleitzahl
- Code des Empfängers
- Firmenkennung
- Längengrad
- Breitengrad
- Datum der Registrierung bei der Handelskammer
In der GET Advance-Antwort sind zusätzlich zu allen Daten in der Basis folgende Daten enthalten
- REA
- PEC
- Code der Rechtsform
- ATECO Code und Beschreibung
- Aktivität Startdatum
- Abschlussdatum Bilanz, Umsatz, Gewinn (mit Historie bis zu 5 Jahren)
- Mitarbeiter
- Aktienkapital
- MwSt.-Gruppe
- Status des Unternehmens bei der Steuerbehörde
- Aktionäre (Name / Name, Steuernummer / prozentualer Anteil)
Nein, für die Enterprise-API gibt es keine täglichen Ratenbeschränkungen.
Unternehmen und Company bieten beide Informationen über italienische Unternehmen.
Unternehmen ermöglicht eine schnelle Überprüfung eines Unternehmens und bietet den wesentlichen Datensatz für eine problemlose Rechnungsstellung. Es bietet Informationen wie den Tätigkeitsstatus (CCIAA), den Status bei der Steuerbehörde, den Umsatz, den Gewinn, die Beschäftigten, usw. Es bietet auch eine Reihe von Endpunkten, um spezifische Daten zu erhalten, wie z.B. Empfängercode, PEC, MwSt.-Gruppe (=codice destinatario, PEC, gruppo IVA).
Mit Company hingegen haben Sie Zugriff auf einen viel größeren Datensatz, bis zu 400 Datenpunkte, um eine detaillierte Analyse des Unternehmens und seiner Stakeholder durchzuführen und auf alle Kontakte und Informationen zuzugreifen, um Marketingaktivitäten zu planen.
Mit dem Endpunkt "Get /advance" können Sie Unternehmen anhand von Parametern wie Umsatzzahl, Mitarbeiter, ATECO-Code, Koordinaten und Radius finden.
Je nach den in der Anfrage verwendeten Parametern können ein oder mehrere Unternehmen in die Antwort aufgenommen werden. Für jedes einzelne Unternehmen sind die folgenden Daten verfügbar
- Steuernummer
- Name
- Umsatzsteuer-Identifikationsnummer
- Ortsname
- Straße
- Hausnummer
- vollständige Adresse
- Gemeinde
- Weiler
- Provinz
- Status der Tätigkeit
- Datum der Aktualisierung
- Postleitzahl
- Betriebsnummer
- Längengrad
- Breitengrad
- Code Rechtsnatur
- Datum der Eintragung bei der Handelskammer
Get /advance{piva_cf_or_id} erfordert stattdessen einen der folgenden Werte als Parameter
- Umsatzsteuer-Identifikationsnummer
- Steuernummer
- Unternehmens-ID
Die Antwort betrifft nur ein Unternehmen und gibt folgende Daten zurück:
- Steuernummer
- Firmenname
- MwSt.-Nummer
- Ortsname
- Straße
- Hausnummer
- vollständige Adresse
- Gemeinde
- Weiler
- Provinz
- Status der Tätigkeit
- Datum der Aktualisierung
- Postleitzahl
- Code des Empfängers
- Firmenkennung
- Längengrad
- Breitengrad
- Datum der Registrierung bei der Handelskammer
- REA
- PEC
- Code der Rechtsnatur
- ATECO Code und Beschreibung
- Datum der Gründung
- Abschlussdatum Bilanz, Umsatz, Gewinn (mit Historie bis zu 5 Jahren)
- Mitarbeiter
- Aktienkapital
- MwSt.-Gruppe
- Status des Unternehmens bei der Steuerbehörde
- Aktionäre (Name / Name, Steuernummer / prozentualer Anteil)
Ja, weitere Informationen können über die Company-API abgerufen werden, wo über 400 individuelle Unternehmens-, Mitarbeiter- und Marketingdaten verfügbar sind.
Alle Daten in den Antworten der Unternehmen-API stammen aus offiziellen und zertifizierten Quellen und öffentlichen Datenbanken mit TULPS-Lizenz, z. B. Handelskammer, INPS (Nationale Sozialversicherungsanstalt), Finanzamt.
Mit GET Advance können Sie eine Liste von Unternehmen mit einer Reihe von Informationen erhalten. Für jede einzelne Anfrage ist standardmäßig eine Höchstgrenze von 100 Ergebnissen festgelegt.
Wenn mehr als 100 Ergebnisse verfügbar sind, können Sie mit dem SKIP-Parameter die Anzahl der Datensätze festlegen, die Sie aus der Ergebnismenge auslassen möchten.
Die API Unternehmen bietet Informationen über alle Arten von italienischen Unternehmen. Der in der Antwort verfügbare Datensatz kann davon abhängen, ob das Unternehmen bei der Handelskammer eingetragen ist oder nicht. Für Freiberufler, die nicht bei der Handelskammer registriert sind, empfehlen wir die Verwendung des Risiko-Endpunkts anagrafica, um Informationen wie Standort, Name, Ateco-Code und Beschreibung, Steuerdomizil und persönliche Informationen zu erhalten.
Im Bereich "Usage" können Sie Ihre kostenlosen und abonnierten oder aufladbaren Anfragen überwachen. Sie sind sowohl in grafischer Form (Zeitraum Monat und Jahr) als auch in Form einer textlichen Zusammenfassung verfügbar.
Trockenlauf, Skip und Limit sind optionale Parameter, die in eine Anfrage an GET Advance eingefügt werden können.
Mit Dry Run können Sie eine Anfrage simulieren, indem Sie nur die Anzahl der gefundenen Datensätze und den Preis zurückgeben. In der Praxis zeigt es an, wie viele Unternehmen mit den in der Anfrage verwendeten Parametern kompatibel sind.
Mit Skip hingegen können Sie die Anzahl der Datensätze festlegen, die Sie aus der Ergebnismenge auslassen möchten.
Limit gibt die maximale Anzahl der Ergebnisse an, die Sie in der Antwort erhalten möchten. Bitte beachten Sie, dass die Antwort standardmäßig maximal 100 Ergebnisse enthält.
Die Kosten für einzelne Anfragen hängen vom Endpunkt ab und reichen von 0,001 € bis zu 0,10 €. Alle Preise für einzelne Anfragen (Grundpreise) finden Sie im Abschnitt "Pricing", wo auch angegeben ist, ob Abonnements verfügbar sind und wie hoch die prozentuale Ersparnis ist.
Sie können Ihr Abonnement im Abschnitt "Subscription" aktivieren, indem Sie die Abonnementdauer (Monat/Jahr) angeben, die Anzahl der Anfragen und das Startdatum auswählen. Sobald die Zahlung abgeschlossen ist, sind die Anfragen sofort verfügbar (Sie können auch entscheiden, das Abonnement zu einem späteren Zeitpunkt zu starten). Bei Zahlung per Banküberweisung sind die Abrufe verfügbar, sobald der Betrag gutgeschrieben wurde.
In der Get Advance-Antwort ist der eingetragene Sitz des Unternehmens angegeben.
Ja, es gibt 30 Anfragen pro Monat für Get pec, base, closed und soci endpoints. Weitere Informationen finden Sie im Abschnitt "Pricing".