Preguntas frecuentes
Respuestas a lo que más preguntan los desarrolladores.
Respuestas breves a las preguntas que más hacen los desarrolladores. Los detalles están en la página enlazada.
Datos
¿De dónde vienen los datos?
De los registros y publicaciones oficiales: el Handelsregister (Registro Mercantil), el Unternehmensregister (registro de empresas) con las cuentas anuales, y los anuncios de insolvencia. Las noticias y los contenidos web vienen de la web. Más en Disponibilidad de datos.
Leemos muchos datos automáticamente de los documentos y anuncios publicados. Para ello usamos la tecnología más actual e invertimos mucho en calidad; aun así, pueden darse errores puntuales.
¿Cómo de actuales son los datos?
Un perfil de empresa viene de nuestra base de datos. Con Tiempo real, la API consulta además el Handelsregister en directo y devuelve las personas inscritas actualmente. Los documentos los obtiene la API del registro cuando los pides.
Si el mismo documento se obtuvo poco antes, puede tener hasta 24 horas.
Las empresas deben publicar sus cuentas anuales a más tardar doce meses después de la fecha de cierre, y muchas agotan el plazo. Por eso las cuentas más recientes suelen ser las del penúltimo año.
¿Por qué falta un valor para una empresa?
Normalmente porque la empresa no está obligada a publicarlo. Lo que es público depende de la forma jurídica y el tamaño: una GmbH pequeña, por ejemplo, no publica cuenta de pérdidas y ganancias, así que normalmente no hay facturación para ella. Los valores vacíos aparecen en la respuesta como null o [].
¿Qué pasa si varias empresas tienen el mismo nombre?
Con un nombre que comparten varias empresas, la API puede devolver una de ellas, no necesariamente la que buscas, o responder con 404. Si necesitas precisión, consulta con tribunal registral y número de registro, por ejemplo “Ansbach HRB 6089”, o con la entity_id. El número de registro solo no basta, porque el mismo número existe en muchos tribunales.
Facturación
¿Cuesta créditos una función que no devuelve datos?
No. Una función solo se cobra cuando devuelve datos. El modo IA, en cambio, se cobra aunque no encuentre ninguna empresa. Solo si la API cancela la solicitud con 408 no se cobra. Tiempo real cuesta créditos por cada consulta en directo correcta, aunque no muestre nada nuevo.
¿Cuánto cuesta una solicitud fallida?
Nada. Una solicitud que termina con un error no se cobra; la única excepción es el recargo del modo IA. Con el estado 402, meta.request_credit_cost indica lo máximo que habría costado la solicitud. Más en Errores.
¿Necesito una suscripción de créditos?
No. Puedes usar perfiles de empresa, Búsqueda y exportación, documentos y Signals con cualquier cuenta; solo pagas los créditos. Una suscripción de créditos desbloquea datos adicionales:
- Plus: el perfil de persona.
- Pro: los KPI financieros ampliados, la función Red de empresas, filtros de búsqueda de propiedad, administración e insolvencia, y el tema de Signals Insolvencias.
- Max: todo lo de Pro, más la función Socios en profundidad, las cuentas por actividad de las empresas energéticas y el tema de Signals Transformaciones y M&A.
Todo sobre precios y planes está en Facturación.
¿Cuánto tiempo son válidos los créditos iniciales y de recarga?
Una cuenta nueva recibe 150 créditos iniciales. Sin suscripción de créditos, los créditos iniciales y de recarga son válidos durante 30 días. Mientras haya una suscripción de créditos activa, no caducan.
Técnica
¿Qué timeout debo configurar?
Para Tiempo real, perfiles de persona y documentos, al menos 120 segundos, porque estas solicitudes tardan más. Si con Tiempo real solo falla la consulta en directo, recibes los datos guardados sin el recargo de Tiempo real. Si la solicitud tarda demasiado, termina con 408, en documentos con 504. Entonces no se cobra nada. Vuelve a intentarlo más tarde.
¿Cuántas solicitudes puedo hacer?
Para perfiles de empresa 60 solicitudes por minuto y cuenta, para documentos 5. Por encima, la API responde con el estado 429 e indica el tiempo de espera en Retry-After. Todos los límites están en Límites.
¿Puedo repetir una solicitud sin pagar dos veces?
Sí, para perfiles de empresa, perfiles de persona, búsqueda y documentos. Envía un valor propio en el header Idempotency-Key. Si repites la solicitud con la misma clave y los mismos parámetros en 24 horas, no cuesta nada.
¿Puedo usar varias claves API?
Sí. En Cuenta › Claves API creas más claves, por ejemplo una por aplicación. Si eliminas una clave, deja de ser válida al instante. Todas las claves comparten el saldo de tu cuenta.