Domande frequenti

Dai registri e dalle pubblicazioni ufficiali: l’Handelsregister (registro delle imprese), l’Unternehmensregister (registro delle società) con i bilanci d’esercizio e le pubblicazioni sulle insolvenze. Notizie e contenuti dei siti web vengono dal web. Maggiori dettagli in Disponibilità dei dati.

Molti dettagli li leggiamo automaticamente dai documenti e dalle pubblicazioni. Usiamo la tecnologia più recente e investiamo molto nella qualità; singoli errori restano comunque possibili.

Un profilo aziendale viene dal nostro database. Con Tempo reale l’API interroga anche l’Handelsregister in diretta e restituisce le persone attualmente iscritte. I documenti l’API li recupera dal registro quando li richiedi.

Se lo stesso documento è stato recuperato poco prima, può avere fino a 24 ore.

Le aziende devono pubblicare i bilanci d’esercizio al più tardi dodici mesi dopo la data di chiusura del bilancio, e molte sfruttano tutto il periodo. L’ultimo bilancio riguarda quindi spesso l’anno precedente a quello scorso.

Di solito perché l’azienda non è tenuta a pubblicarlo. Cosa è pubblico dipende da forma giuridica e dimensione: una piccola GmbH, ad esempio, non pubblica il conto economico, quindi di solito non c’è un fatturato. I valori vuoti compaiono nella risposta come null o [].

Per un nome condiviso da più aziende, l’API può restituirne una, non necessariamente quella che intendi, oppure rispondere con 404. Se ti serve precisione, interroga con tribunale del registro e numero di registro, ad esempio “Ansbach HRB 6089”, oppure con l’entity_id. Il numero di registro da solo non basta, perché lo stesso numero esiste presso molti tribunali.

No. Una feature viene addebitata solo se restituisce dati. La Modalità AI invece viene addebitata anche se non trova alcuna azienda; non viene addebitata solo se l’API interrompe la richiesta con 408. Tempo reale costa crediti per ogni recupero in diretta riuscito, anche se non mostra nulla di nuovo.

Niente. Una richiesta che termina con un errore non viene addebitata; l’unica eccezione è il supplemento per la Modalità AI. Con lo stato 402, meta.request_credit_cost indica il massimo che la richiesta sarebbe costata. Maggiori dettagli in Errori.

No. Profili aziendali, Ricerca & Export, documenti e Signals li puoi usare con qualsiasi account; paghi solo i crediti. Un abbonamento a crediti sblocca dati aggiuntivi:

• Plus: il profilo persona.
• Pro: i KPI finanziari estesi, la feature Rete aziendale, i filtri di ricerca per proprietà, direzione e insolvenza, e il tema Signals Insolvenze.
• Max: tutto ciò che c’è in Pro, più la feature Soci approfonditi, i bilanci di attività dei fornitori di energia e il tema Signals Trasformazioni & M&A.

Tutto su prezzi e piani è in Fatturazione.

Un nuovo account riceve 150 crediti iniziali. Senza abbonamento a crediti, i crediti iniziali e i crediti di ricarica valgono 30 giorni. Finché un abbonamento a crediti è attivo, non scadono.

Per Tempo reale, profili persona e documenti almeno 120 secondi, perché queste richieste durano di più. Se con Tempo reale fallisce solo il recupero in diretta, ricevi i dati salvati senza il supplemento Tempo reale. Se la richiesta dura troppo, termina con 408, per i documenti con 504. In quel caso non viene addebitato nulla. Riprova più tardi.

Per i profili aziendali 60 richieste al minuto per account, per i documenti 5. Oltre, l’API risponde con lo stato 429 e indica il tempo di attesa in Retry-After. Tutti i limiti sono in Limiti.

Sì, per profili aziendali, profili persona, ricerca e documenti. Invia un tuo valore nell’header Idempotency-Key. Se ripeti la richiesta con la stessa chiave e gli stessi parametri entro 24 ore, non costa nulla.

Sì. In Account › Chiavi API crei altre chiavi, ad esempio una per applicazione. Se elimini una chiave, non è più valida da subito. Tutte le chiavi condividono il saldo del tuo account.