Validar identificacion GET

Valida el formato de una cedula, un RUC o un pasaporte sin consultar al SRI. Comprueba el digito verificador cuando corresponde; un pasaporte es alfanumerico de 5 a 20.

GET /v1/consultas/identificacion/validar/{numero}

No confirma que exista. Responde 200 tambien cuando el numero no es valido: en ese caso, revisa el campo valido.

Parametros#

Parametro	Donde	Regla
`numero`	ruta	Cedula, RUC o pasaporte a validar

curl -s "https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001" \
  -H "X-Api-Key: $ECUAFACT_API_KEY"

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", apiKey);

string json = await http.GetStringAsync(
    "https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001");
Console.WriteLine(json);

import os, requests
r = requests.get(
    "https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001",
    headers={"X-Api-Key": os.environ["ECUAFACT_API_KEY"]}, timeout=30)
print(r.status_code, r.text)

const res = await fetch(
  'https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001',
  { headers: { 'X-Api-Key': process.env.ECUAFACT_API_KEY } });
console.log(res.status, await res.text());

<?php
$ch = curl_init('https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('ECUAFACT_API_KEY')],
]);
$respuesta = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . ' ' . $respuesta;
curl_close($ch);

HttpClient cliente = HttpClient.newHttpClient();
HttpRequest peticion = HttpRequest.newBuilder()
    .uri(URI.create("https://staging-api.mynexusapi.com/v1/consultas/identificacion/validar/1760013210001"))
    .header("X-Api-Key", System.getenv("ECUAFACT_API_KEY"))
    .GET()
    .build();
HttpResponse<String> respuesta = cliente.send(peticion, HttpResponse.BodyHandlers.ofString());
System.out.println(respuesta.statusCode() + " " + respuesta.body());

using Ecuafact.Sdk;
using Ecuafact.Sdk.Contracts;

// client: cliente EcuafactClient - ver SDK .NET
ValidacionIdentificacion resultado = await client.ValidarIdentificacionAsync("1760013210001");
Console.WriteLine(resultado.Valido + " " + resultado.Tipo);

from ecuafact import EcuafactClient

# client: cliente EcuafactClient - ver SDK Python
resultado = client.validar_identificacion("1760013210001")
print(resultado.valido, resultado.tipo)

import { EcuafactClient } from "@ecuafact/sdk";

// client: cliente EcuafactClient - ver SDK Node.js
const resultado = await client.validarIdentificacion("1760013210001");
console.log(resultado.valido, resultado.tipo);

<?php
use Ecuafact\Sdk\EcuafactClient;

// $client: cliente EcuafactClient - ver SDK PHP
$resultado = $client->validarIdentificacion('1760013210001');
echo ($resultado->valido ? 'true' : 'false') . ' ' . $resultado->tipo;

import com.ecuafact.sdk.EcuafactClient;

// client: cliente EcuafactClient - ver SDK Java
ValidacionIdentificacion resultado = client.validarIdentificacion("1760013210001");
System.out.println(resultado.valido() + " " + resultado.tipo());

{
  "entrada": "1760013210001",
  "normalizado": "1760013210001",
  "valido": true,
  "tipo": "RucSociedadPublica",
  "longitud": 13,
  "esSoloDigitos": true,
  "cedulaBaseDelRuc": null,
  "mensaje": "Formato de RUC de sociedad publica aceptado; confirme su registro en el SRI."
}

Respuesta#

Campo	Significado
`entrada`	Numero enviado
`normalizado`	Numero sin separadores
`valido`	Si el formato es valido
`tipo`	Tipo detectado (ver abajo)
`longitud`	Longitud del numero
`esSoloDigitos`	Si el numero es solo digitos
`cedulaBaseDelRuc`	Cedula base (solo en RUC de persona natural)
`mensaje`	Descripcion del resultado

tipo: Desconocido, Cedula, RucPersonaNatural (trae cedulaBaseDelRuc), RucSociedadPrivada, RucSociedadPublica, Pasaporte.

Estados de este endpoint#

Codigo	HTTP	Cuando ocurre	Que hacer
`200`	200	Validacion de formato realizada	Revisa `valido`
`301`	400	Numero mal formado	Corrige el numero
`104`	429	Limite de solicitudes	Espera y reintenta

200 no significa que el numero exista en el SRI: solo valida su formato. El catalogo completo esta en Errores.

Esta consulta no consume cupo de documentos.

Siguientes pasos#

Errores