Perguntas frequentes

Dos registros e publicações oficiais: o Handelsregister (registro comercial), o Unternehmensregister (registro de empresas) com as demonstrações financeiras anuais e os avisos de insolvência. Notícias e conteúdo de sites vêm da web. Mais em Disponibilidade de dados.

Lemos muitos detalhes automaticamente dos documentos e publicações. Usamos a tecnologia mais recente para isso e investimos muito em qualidade; ainda assim, erros pontuais são possíveis.

Um perfil de empresa vem do nosso banco de dados. Com Tempo real, a API também consulta o Handelsregister ao vivo e retorna as pessoas registradas no momento. A API busca documentos no registro quando você os solicita.

Se o mesmo documento foi buscado pouco antes, ele pode ter até 24 horas.

As empresas devem publicar as demonstrações financeiras anuais no máximo doze meses após a data do balanço, e muitas usam o prazo inteiro. Por isso, a demonstração mais recente muitas vezes cobre o ano retrasado.

Geralmente porque a empresa não é obrigada a publicá-lo. O que é público depende da forma jurídica e do porte: uma GmbH pequena, por exemplo, não publica DRE, então em geral não há faturamento para ela. Valores vazios aparecem como null ou [] na resposta.

Para um nome que várias empresas compartilham, a API pode retornar uma delas, não necessariamente a que você quer, ou responder com 404. Se precisar de exatidão, consulte com tribunal de registro e número de registro, por exemplo “Ansbach HRB 6089”, ou com o entity_id. Só o número de registro não basta, porque o mesmo número existe em muitos tribunais.

Não. Um recurso só é cobrado quando retorna dados. Já o Modo IA é cobrado mesmo que não encontre empresa nenhuma. Só não é cobrado se a API cancelar a requisição com 408. O Tempo real custa créditos a cada consulta ao vivo bem-sucedida, mesmo que não mostre nada novo.

Nada. Uma requisição que termina com erro não é cobrada; a única exceção é o acréscimo do Modo IA. Com status 402, meta.request_credit_cost informa o máximo que a requisição teria custado. Mais em Erros.

Não. Você pode usar perfis de empresas, Busca & Exportação, documentos e Signals com qualquer conta; você só paga os créditos. Uma assinatura de créditos libera dados adicionais:

• Plus: o perfil de pessoa.
• Pro: os KPIs financeiros ampliados, o recurso Rede da empresa, filtros de busca por propriedade, administração e insolvência, e o tema de Signals Insolvências.
• Max: tudo do Pro, mais o recurso Sócios em profundidade, os relatórios de atividade de empresas de energia e o tema de Signals Transformações & M&A.

Tudo sobre preços e planos está em Cobrança.

Uma conta nova recebe 150 créditos iniciais. Sem assinatura de créditos, os créditos iniciais e de recarga valem por 30 dias. Enquanto uma assinatura de créditos estiver ativa, eles não expiram.

Para Tempo real, perfis de pessoas e documentos, pelo menos 120 segundos, porque essas requisições demoram mais. Se com Tempo real só a consulta ao vivo falhar, você recebe os dados armazenados sem o acréscimo de Tempo real. Se a requisição demorar demais, ela termina com 408, para documentos com 504. Nada é cobrado nesse caso. Tente de novo mais tarde.

Para perfis de empresas, 60 requisições por minuto e por conta; para documentos, 5. Acima disso, a API responde com status 429 e informa o tempo de espera em Retry-After. Todos os limites estão em Limites.

Sim, para perfis de empresas, perfis de pessoas, busca e documentos. Envie um valor próprio no header Idempotency-Key. Se você repetir a requisição com a mesma chave e os mesmos parâmetros em até 24 horas, ela não custa nada.

Sim. Em Conta › Chaves de API você cria mais chaves, por exemplo uma por aplicação. Se você excluir uma chave, ela fica inválida na hora. Todas as chaves compartilham o saldo da sua conta.