API de Boletín Claro · Errores · BC-3001

BC-3001No encontrado

La ruta existe y lo que pediste no. Hoy solo lo emite /v1/empresas/{nif}: no tenemos ningún registro de dinero público para ese NIF. No es un error de la petición.

Código

BC-3001

Estado HTTP

404 Not Found

Reintentable

No

type

https://boletinclaro.es/v1/errores/BC-3001

Qué respuesta recibes

HTTP/1.1 404 Not Found
Content-Type: application/problem+json

{
  "type": "https://boletinclaro.es/v1/errores/BC-3001",
  "codigo": "BC-3001",
  "title": "No encontrado",
  "status": 404,
  "detail": "No tenemos registros de dinero público para el NIF B12345678."
}

El campo estable es codigo, y es el final de type. El title y el detail están para leerlos: podemos reescribirlos sin avisar.

Por qué ocurre BC-3001

• Ese NIF no aparece ni en la BDNS ni en la PLACSP: la empresa existe, pero no ha recibido subvenciones ni ganado contratos públicos que hayamos ingerido.
• El NIF tiene una errata. Se comprueba la forma, no que exista.
• Preguntaste por una filial o un centro de trabajo, y el dinero está a nombre de la matriz.

Cómo se arregla

1. Resuelve el NIF por nombre con /v1/empresas?consulta=… antes de pedir la ficha.
2. Trátalo como «sin datos», no como un fallo: para la mayoría de las empresas españolas esta es la respuesta correcta.

¿Merece la pena reintentar?

No de inmediato: el dato no está. Puede aparecer más adelante si la empresa recibe una subvención o gana un contrato, así que tiene sentido volver a consultarlo cada cierto tiempo, no en bucle.

No lo confundas con

• BC-3002 · Ruta no encontrada 404

Los 11 errores de la API

El catálogo completo, con el código y el estado de cada uno, está en https://boletinclaro.es/v1/errores. Responde también en JSON con Accept: application/json. La referencia de la API está en https://boletinclaro.es/v1.