Validacion CPF

Valida un numero de CPF verificando el formato y los digitos verificadores mediante el algoritmo Modulo 11.

Endpoint

POST /api/external/cpf/validate

Headers

Header	Tipo	Obligatorio	Descripcion
Authorization	String	Si	ApiKey {client_id}:{client_secret}
Content-Type	String	Si	application/json

Request Body

Campo	Tipo	Obligatorio	Descripcion	Ejemplo
document_number	String	Si	Numero del CPF (con o sin formato)	"12345678909" o "123.456.789-09"

Ejemplo

curl -X POST https://api.owem.com.br/api/external/cpf/validate \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"document_number":"12345678909"}'

Respuesta Exitosa -- CPF Valido (200)

{
  "worked": true,
  "valid": true,
  "formatted": "123.456.789-09"
}

Respuesta Exitosa -- CPF Invalido (200)

{
  "worked": true,
  "valid": false,
  "formatted": null
}

Campo	Tipo	Descripcion
worked	Boolean	true indica que la solicitud fue procesada
valid	Boolean	true si el CPF es valido, false en caso contrario
formatted	String	CPF formateado (XXX.XXX.XXX-XX) si es valido, null si es invalido

Validaciones Realizadas

1. Verifica que el CPF tenga exactamente 11 digitos
2. Rechaza CPFs con todos los digitos iguales (ej: 111.111.111-11)
3. Calcula y verifica los 2 digitos verificadores mediante el algoritmo Modulo 11

Respuesta de Error (400)

{
  "worked": false,
  "detail": "O campo document_number e obrigatorio"
}

Respuesta de Error (401)

{
  "error": {
    "status": 401,
    "message": "Missing API key credentials. Use Authorization: ApiKey <client_id>:<client_secret>"
  }
}

Uso

Este endpoint realiza unicamente la validacion matematica del CPF (Modulo 11). No consulta a la Receita Federal ni verifica la situacion registral del documento.