Cumplimiento (CAE)

La documentación que cada subcontrata tiene que tener al día para trabajar en una obra (Hacienda, Seguridad Social, seguros, prevención…), con un semáforo y si la empresa le deja entrar a la obra y cobrar.

GET/api/v1/projects/{id}/complianceread:providers

Una entrada por subcontrata con expediente en la obra. Sin paginación.

curl "https://app.buildnexion.com/api/v1/projects/6f1c2a9e-3b7d-4c1e-9a52-1d0e8b7c4a21/compliance" \
  -H "Authorization: Bearer $BUILDNEXION_API_KEY"

Respuesta

{
  "data": [
    {
      "provider_id": "9c4a7e2d-1f8b-4d36-b5e0-3a6c9d2f8e17",
      "provider_name": "Instalaciones Ejemplo SL",
      "status": "ambar",
      "can_access_site": true,
      "can_be_paid": false,
      "documents": [
        {
          "type": "tgss_corriente",
          "label": "Certificado de estar al corriente con la Seguridad Social (TGSS)",
          "status": "validado",
          "expires_at": "2026-12-31",
          "uploaded_at": "2026-09-02T08:10:33.000+00:00"
        },
        {
          "type": "seguro_rc",
          "label": "Seguro de Responsabilidad Civil",
          "status": "pendiente",
          "expires_at": null,
          "uploaded_at": null
        }
      ],
      "pending": [
        "seguro_rc"
      ],
      "expired": [],
      "portal_account": {
        "email": "documentacion@ejemplo.es",
        "active": true
      },
      "updated_at": "2026-09-02T08:10:33.000+00:00"
    }
  ]
}

Campos

Parámetro	Tipo	Descripción
status string	string	Semáforo: pendiente (sin revisar), ambar (revisada, a falta de que la empresa decida), verde (la empresa la da por buena) o rojo (la empresa la rechaza).
can_access_site boolean	boolean	Puede entrar a trabajar en la obra.
can_be_paid boolean	boolean	Se le pueden pagar las certificaciones.
documents array	array	Cada documento exigido: type, label, status (pendiente, subido, validado, rechazado o caducado), expires_at y uploaded_at.
pending string[]	string[]	Tipos de documento pendientes o rechazados.
expired string[]	string[]	Tipos de documento caducados (por estado o por fecha).
portal_account object \| null	object \| null	Su acceso al portal de subcontratas (email y si está activo), o null si no tiene.

Tipos de documento

type	Documento
`aeat_corriente`	Al corriente con Hacienda (AEAT)
`tgss_corriente`	Al corriente con la Seguridad Social (TGSS)
`rea`	Inscripción en el REA
`seguro_rc`	Seguro de responsabilidad civil
`alta_iae`	Alta en el IAE
`modalidad_preventiva`	Modalidad de organización preventiva
`evaluacion_riesgos`	Evaluación de riesgos y planificación preventiva
`plan_seguridad`	Adhesión al plan de seguridad y salud
`info_riesgos`	Información y formación de riesgos
`entrega_epis`	Entrega de EPIs
`rnt_rlc`	RNT y RLC
`alta_trabajadores`	Alta de los trabajadores en la Seguridad Social
`aptitud_medica`	Aptitud médica
`formacion_prl_trabajadores`	Formación PRL de los trabajadores
`justificante_salarios`	Justificante de pago de salarios
`maquinaria_ce`	Documentación de maquinaria (marcado CE)

No todos los tipos se exigen en todas las obras: cada expediente lleva solo los que se han pedido a esa subcontrata.