🪪 Estado del CPF

El reporte de Estado CPF valida el número de identificación fiscal nacional de Brasil (Cadastro de Pessoas Físicas) y recupera datos personales asociados de la base de datos oficial de la Receita Federal.

Descripción General

La validación de Estado CPF es la base de la verificación de identidad en Brasil. Este reporte valida el formato del CPF, confirma su existencia en el registro fiscal nacional y recupera información personal asociada para verificación cruzada con otros reportes.

Requisitos de Entrada

Campos Requeridos

Campo	Tipo	Descripción	Ejemplo
document_id	string	Número CPF de 11 dígitos	12345678901
city_locode	string	UN LOCODE de la ciudad	BR SAO

Campos Opcionales

Campo	Tipo	Descripción	Por Defecto
full_name	string	Nombre completo esperado para verificación	null
date_of_birth	string	Fecha de nacimiento esperada (YYYY-MM-DD)	null

Especificación de Formato CPF

El CPF sigue un formato específico de 11 dígitos con dígitos verificadores:

000.000.000-00

Desglose del Formato

Posición	Caracteres	Descripción	Ejemplo
1-9	Números	Dígitos de identificación secuencial	123456789
10	Número	Primer dígito verificador	0
11	Número	Segundo dígito verificador	1

Algoritmo de Dígito Verificador

El CPF usa un algoritmo específico para validar los dos últimos dígitos:

// Cálculo de dígito verificador CPF
function validateCPF(cpf) {
  // Remover formato
  cpf = cpf.replace(/[^\d]/g, '');

  if (cpf.length !== 11) return false;

  // Calcular primer dígito verificador
  let sum = 0;
  for (let i = 0; i < 9; i++) {
    sum += parseInt(cpf[i]) * (10 - i);
  }
  let firstDigit = 11 - (sum % 11);
  if (firstDigit >= 10) firstDigit = 0;

  // Calcular segundo dígito verificador
  sum = 0;
  for (let i = 0; i < 10; i++) {
    sum += parseInt(cpf[i]) * (11 - i);
  }
  let secondDigit = 11 - (sum % 11);
  if (secondDigit >= 10) secondDigit = 0;

  return parseInt(cpf[9]) === firstDigit && parseInt(cpf[10]) === secondDigit;
}

Fuente de Datos

Registro: Receita Federal do Brasil (Servicio Federal de Ingresos de Brasil) Autoridad: Ministério da Fazenda (Ministerio de Hacienda) Cobertura: Todos los ciudadanos brasileños y residentes legales con obligaciones fiscales Frecuencia de Actualización: Tiempo real

Esquemas de Respuesta

Validación Exitosa - CPF Activo

{
  "id": "f170bf78-9309-46d4-8723-3e964ed7844d",
  "reports": {
    "cpf_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T04:48:11.144178",
      "updated_at": "2021-03-30T04:48:24.050517",
      "outcome": "PASSED",
      "details": {
        "cpf": "12345678901",
        "cpf_status": "REGULAR",
        "full_name": "JUAN MIGUEL DOE ROE",
        "date_of_birth": "1985-08-13",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": true
        }
      }
    }
  }
}

Respuesta Persona Fallecida

{
  "id": "f170bf78-9309-46d4-8723-3e964ed7844d",
  "reports": {
    "cpf_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T04:48:11.144178",
      "updated_at": "2021-03-30T04:48:24.050517",
      "outcome": "FAILED",
      "details": {
        "cpf": "12345678901",
        "cpf_status": "TITULAR FALECIDO",
        "full_name": "JUAN MIGUEL DOE ROE",
        "date_of_birth": "1900-01-01",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": true,
          "status_reason": "DECEASED"
        }
      }
    }
  }
}

Respuesta Regularización Pendiente

{
  "id": "f170bf78-9309-46d4-8723-3e964ed7844d",
  "reports": {
    "cpf_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T04:48:11.144178",
      "updated_at": "2021-03-30T04:48:24.050517",
      "outcome": "FAILED",
      "details": {
        "cpf": "12345678901",
        "cpf_status": "PENDENTE DE REGULARIZAÇÃO",
        "full_name": "ELIELSON LINO DE JESUS",
        "date_of_birth": "1975-05-20",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": true,
          "status_reason": "PENDING_REGULARIZATION"
        }
      }
    }
  }
}

Respuesta CPF Inválido

{
  "id": "f170bf78-9309-46d4-8723-3e964ed7844d",
  "reports": {
    "cpf_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T04:48:11.144178",
      "updated_at": "2021-03-30T04:48:24.050517",
      "outcome": "FAILED",
      "details": {
        "cpf": "INVALID12345",
        "validation": {
          "format_valid": false,
          "check_digit_valid": false,
          "registry_found": false,
          "errors": [
            "Formato de CPF inválido",
            "Dígito verificador no coincide",
            "No encontrado en registro de Receita Federal"
          ]
        }
      }
    }
  }
}

Tipos de Estado CPF

Estado Regular (REGULAR)

• Significado: CPF está activo y en buen estado

• Resultado: PASSED

• Uso: Puede ser usado para todas las transacciones y verificaciones

Fallecido (TITULAR FALECIDO)

• Significado: El titular del CPF está fallecido

• Resultado: FAILED

• Uso: El CPF no debe ser usado para nuevas transacciones

Regularización Pendiente (PENDENTE DE REGULARIZAÇÃO)

• Significado: El CPF tiene problemas que requieren resolución con la Receita Federal

• Resultado: FAILED

• Uso: El titular del CPF debe resolver problemas antes del uso normal

Suspendido (SUSPENSO)

• Significado: El CPF está temporalmente suspendido

• Resultado: FAILED

• Uso: Requiere resolución con las autoridades fiscales

Cancelado (CANCELADO)

• Significado: El CPF ha sido cancelado

• Resultado: FAILED

• Uso: No puede ser usado para ninguna transacción

Proceso de Validación

Pasos de Validación de Formato

1. Verificación de Longitud: Debe ser exactamente 11 dígitos
2. Validación de Caracteres: Solo se permiten caracteres numéricos
3. Verificación Secuencial: No puede ser todos los mismos dígitos (ej. 11111111111)
4. Validación de Dígito Verificador: Ambos dígitos verificadores deben ser correctos
5. Patrones Inválidos Conocidos: Rechazar secuencias inválidas conocidas

Validación de Registro

1. Búsqueda en Receita Federal: Verificar existencia en base de datos oficial
2. Verificación de Estado: Confirmar estado actual del CPF
3. Recuperación de Datos: Extraer información personal asociada
4. Referencia Cruzada: Validar contra datos proporcionados si están disponibles

Integración de Reportes Relacionados

El Estado CPF habilita y valida otros reportes de Brasil:

Reporte de Verificación de Nombre

Valida el full_name proporcionado contra datos de la Receita Federal:

{
  "name_check": {
    "outcome": "PASSED",
    "details": {
      "score": 1.0,
      "full_name": "JUAN MIGUEL DOE ROE",
      "name_fragment_check": false,
      "name_score_min": 1.0
    }
  }
}

Reporte de Verificación de Fecha de Nacimiento

Valida la date_of_birth proporcionada contra datos de la Receita Federal:

{
  "dob_check": {
    "outcome": "PASSED",
    "details": {
      "provided_dob": "1985-08-13",
      "registry_dob": "1985-08-13",
      "match": true
    }
  }
}

Configuración de Verificación de Nombre

El reporte name_check puede ser personalizado con configuraciones específicas:

Parámetros de Configuración

name_score_min

• Tipo: Float (0.0 a 1.0)

• Por Defecto: 1.0 (se requiere coincidencia del 100%)

• Descripción: Puntuación mínima de similitud para coincidencia de nombres

• Ejemplo: 0.98 requiere 98% de similitud

name_fragment_check

• Tipo: Boolean

• Por Defecto: false

• Descripción: Habilitar comparación de nombres basada en fragmentos

• Uso: Compara partes individuales del nombre por separado

Ejemplo de Coincidencia de Fragmentos

Nombre de Entrada: “JUAN DOE” Nombre de Registro: “JUAN ANTONIO DOE”

Proceso de Puntuación de Fragmentos:

1. Comparar “JUAN” contra [“JUAN”, “ANTONIO”, “DOE”] → Puntuación: 1.0
2. Comparar “DOE” contra [“JUAN”, “ANTONIO”, “DOE”] → Puntuación: 1.0
3. Puntuación Final: (1.0 + 1.0) / 2 = 1.0

Ejemplos de Integración API

Crear Persona con Validación CPF

curl -X POST "https://api.emptor.io/v3/br/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "12345678901",
    "city_locode": "BR SAO",
    "full_name": "JUAN MIGUEL DOE ROE",
    "date_of_birth": "1985-08-13",
    "pipeline": {
      "name": "standard_id_check"
    }
  }'

Validación CPF con Configuraciones de Nombre Personalizadas

curl -X POST "https://api.emptor.io/v3/br/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "12345678901",
    "city_locode": "BR SAO",
    "full_name": "JUAN DOE",
    "pipeline": {
      "name": "standard_id_check"
    },
    "report_settings": {
      "name_check": {
        "name_score_min": 0.98,
        "name_fragment_check": true
      }
    }
  }'

Obtener Detalles del Reporte CPF

curl -X GET "https://api.emptor.io/v3/br/details/{person_id}/cpf_status" \
  -H "X-Api-Key: YOUR_API_KEY"

Errores Comunes de Validación

Tipo de Error	Descripción	Resolución
INVALID_FORMAT	El CPF no coincide con el patrón de 11 dígitos	Verificar formato CPF (000.000.000-00)
INVALID_CHECK_DIGIT	Falla el cálculo del dígito verificador	Verificar que el CPF se ingresó correctamente
SEQUENTIAL_DIGITS	Todos los dígitos son iguales	Usar un número CPF válido
NOT_FOUND_IN_REGISTRY	CPF no encontrado en Receita Federal	Verificar que el CPF existe y está emitido
REGISTRY_TIMEOUT	Tiempo de espera de base de datos de Receita Federal	Reintentar después de unos minutos
DECEASED_HOLDER	El titular del CPF está fallecido	No se puede usar CPF de persona fallecida
PENDING_REGULARIZATION	El CPF requiere resolución fiscal	Resolver problemas con Receita Federal

Casos de Uso y Aplicaciones

Aplicaciones Principales

• Verificación de Identidad: Verificación de identidad primaria para individuos brasileños
• Cumplimiento Fiscal: Verificar registro y estado fiscal
• Servicios Financieros: Apertura de cuentas y cumplimiento KYC
• Verificación de Empleo: Validar registro fiscal del empleado
• Servicios Gubernamentales: Verificación de servicios ciudadanos

Flujos de Integración

Verificación Básica de Identidad

Estado CPF → Verificación de Nombre → Verificación de Fecha de Nacimiento

Verificación de Antecedentes Estándar

Estado CPF → Verificación de Nombre → Verificación de Fecha de Nacimiento → Antecedentes Penales → Historial Laboral

KYC Financiero

Estado CPF → Verificación de Nombre → Verificación de Fecha de Nacimiento → Verificación de Crédito → Evaluación de Riesgo

Endpoints de API Relacionados

• Crear Persona - Iniciar validación CPF
• Obtener Reportes - Recuperar resultados CPF
• Obtener Detalles del Reporte - Datos detallados CPF
• Actualizar Reportes - Actualizar validación CPF

Documentación Relacionada

• Referencia de Verificación de Nombre - Validación de nombre
• Referencia de Verificación de Fecha de Nacimiento - Validación de fecha de nacimiento
• Guía de País Brasil - Información específica de Brasil
• Glosario Legal - Terminología legal

Base CPF

La validación CPF es la base para todos los otros reportes de Brasil. Siempre asegúrese de que la validación CPF pase antes de proceder con reportes de verificación adicionales.

Cumplimiento de Privacidad

Los datos CPF contienen información personal y fiscal sensible. Asegúrese del cumplimiento con la Lei Geral de Proteção de Dados (LGPD) brasileña al manejar estos datos.

Verificación de Estado

Siempre verifique el campo cpf_status. Los CPF fallecidos, suspendidos o cancelados no deben ser usados para nuevas transacciones o creación de cuentas.