APIs y Servicios Conectados en Tiempo Real
Potencia tu software existente conectándolo con RENIEC y SUNAT. Consultas instantáneas de DNI, RUC, Tipo de Cambio y Facturación Electrónica con más del 99.9% de disponibilidad.
Consulta RUC y DNI
Obtención automática de nombres completos, razón social, dirección y condición fiscal desde RENIEC y SUNAT.
Tipo de Cambio SUNAT & SBS
Sincronización diaria oficial de compra y venta del dólar y euro enviada en JSON a las 08:30 am.
Facturación Electrónica (OSE/PSE)
Emisión de comprobantes XML UBL 2.1, generación de CDR firmado y envío directo a SUNAT en 2 segundos.
Mailing & WhatsApp Corporate
Infraestructura SMTP transaccional y bot de WhatsApp para envío de comprobantes, recibos y alertas.
Credenciales de Acceso PersonID API v1
REST APIPlayground Live (DNI & RUC)
API LiveHaz clic en Consultar para ver los datos formateados.
Ejemplos de Integración en Código (SDKs)
Consume la API PersonID v1 directamente desde tu backend o frontend.
curl -X GET "https://smartappsperu.com/persona/api/v1/dni.php?dni=12345678" \
-H "X-Api-Key: tu_api_key" \
-H "X-Secret-Key: tu_secret_key"<?php
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://smartappsperu.com/persona/api/v1/dni.php?dni=12345678",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"X-Api-Key: tu_api_key",
"X-Secret-Key: tu_secret_key"
]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;fetch("https://smartappsperu.com/persona/api/v1/dni.php?dni=12345678", {
headers: {
"X-Api-Key": "tu_api_key",
"X-Secret-Key": "tu_secret_key"
}
})
.then(res => res.json())
.then(data => console.log(data));import requests
url = "https://smartappsperu.com/persona/api/v1/dni.php?dni=12345678"
headers = {
"X-Api-Key": "tu_api_key",
"X-Secret-Key": "tu_secret_key"
}
response = requests.get(url, headers=headers)
print(response.json())Estructura Completa de Datos DNI y RUC
Revisa todos los parámetros de entrada, respuesta JSON estructurada y posibles códigos HTTP de error.
¿Cómo probar en Postman?
- Crea una nueva petición de tipo GET en Postman.
- Ingresa la URL del endpoint (ej:
https://smartappsperu.com/persona/api/v1/dni.php?dni=12345678). - Ve a la pestaña Headers y agrega las llaves:
X-Api-Key: tu_api_keyX-Secret-Key: tu_secret_key
- Haz clic en Send para recibir la respuesta oficial en formato JSON.
Parámetro Query String
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| dni | String | Sí | Número de DNI peruano de 8 dígitos numéricos. |
Campos Retornados en JSON (200 OK)
| Campo JSON | Tipo | Ejemplo | Descripción |
|---|---|---|---|
| id | String | "12345678" | Número de documento |
| nombres | String | "JUAN PEREZ" | Nombres del ciudadano |
| apellido_paterno | String | "GARCIA" | Primer apellido |
| apellido_materno | String | "RODRIGUEZ" | Segundo apellido |
| nombre_completo | String | "JUAN PEREZ GARCIA RODRIGUEZ" | Nombre completo unificado |
| genero | String | "MASCULINO" | Género oficial RENIEC |
| fecha_nacimiento | String | "1990-01-01" | Fecha en formato YYYY-MM-DD |
| codigo_verificacion | String | "5" | Dígito verificador del DNI |
Parámetro Query String
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| ruc | String | Sí | Número de RUC de 11 dígitos numéricos. |
Campos Retornados en JSON (200 OK)
| Campo JSON | Tipo | Ejemplo | Descripción |
|---|---|---|---|
| id | String | "20123456789" | Número de RUC |
| razon_social | String | "SMARTAPPS PERU S.A.C." | Razón social registrada en SUNAT |
| condicion | String | "HABIDO" | Condición fiscal del domicilio (HABIDO / NO HABIDO) |
| nombre_comercial | String | "SMARTAPPS" | Nombre comercial de la empresa |
| tipo | String | "SOCIEDAD ANONIMA CERRADA" | Tipo de persona jurídica o natural |
| estado | String | "ACTIVO" | Estado operativo en SUNAT |
| direccion | String | "CALLE MONTEROSA 256 SURCO" | Dirección fiscal declarada |
| departamento / provincia / distrito | String | "LIMA / LIMA / SANTIAGO DE SURCO" | Ubicación geográfica fiscal |
| actividades_economicas | Array | ["DESARROLLO DE SOFTWARE"] | Códigos de actividad CIIU |
| comprobante_pago | Array | ["FACTURA", "BOLETA"] | Comprobantes autorizados |
| representantes_legales | Array | ["JHERSON EGUSQUIZA (GERENTE GENERAL)"] | Representantes y gerentes registrados |
¿Por qué elegir las APIs de Smart Apps Perú?
Servicios de alta velocidad respaldados con más de 99.9% de uptime y soporte técnico continuo.
¿Cuál es la API de consulta DNI y RUC más rápida en Perú?
Las APIs de Smart Apps Perú responden en menos de 200 ms con datos validados de RENIEC y el padrón reducido de SUNAT, garantizando alta disponibilidad sin caídas.
¿Cómo funciona la API de Facturación Electrónica SUNAT 2.1?
Nuestra API convierte JSON a XML UBL 2.1, firma digitalmente los comprobantes (Boletas, Facturas, Notas) y genera el archivo CDR firmado por SUNAT/OSE en tiempo real.
¿Tienen API de Tipo de Cambio SUNAT y SBS?
Sí, ofrecemos un microservicio diario que sincroniza la tasa oficial de compra y venta emitida por SUNAT y la SBS todos los días a primera hora (08:30 am).
¿Requieren API Key para integración empresarial?
Sí, entregamos API Keys seguras con limitación de peticiones por segundo adaptadas a las necesidades de tu sistema o plataforma de software.
