Servicios / APIs
Una sola integración para todas tus consultas oficiales.
Una sola integración para todas tus consultas a fuentes oficiales peruanas. Nosotros mantenemos la conexión con cada entidad; tú recibes JSON estable.
X-API-Key: tu_token
GET /api/sunat/consulta-ruc/20123456789 200 OK {
"numero": "20123456789",
"nombre_o_razon_social": "EMPRESA DE EJEMPLO S.A.C.",
"tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
"nombre_comercial": "EJEMPLO",
…
} - SUNAT RUC, estado del contribuyente y tipo de cambio
- MTC registro de transportistas, constancias y placas
- MINEM REINFO, formalización minera
- Y la que necesites integramos fuentes nuevas a pedido
¿Por qué una plataforma?
El problema no es consultar una vez. Es que siga funcionando.
Las entidades públicas no ofrecen APIs estables: cambian sus portales sin avisar. Mantener esas conexiones es un trabajo continuo, y es el que hacemos nosotros.
-
Una integración, todas las fuentes
La misma autenticación y el mismo formato de respuesta para cada consulta. Integras una vez y añades fuentes sin tocar tu código.
-
Nosotros lidiamos con el Estado
Las entidades no publican APIs: hay que leer sus portales. Cuando cambian el HTML, lo arreglamos nosotros y tu integración sigue funcionando.
-
No pagas dos veces por el mismo dato
Las consultas cuyos datos no cambian a diario se sirven desde caché. Repetir una consulta reciente no descuenta de tu plan.
-
Control de consumo y auditoría
Tokens por aplicación, cuota por plan y registro de cada consulta: qué se pidió, cuándo y con qué resultado.
-
¿Falta la que necesitas?
Integramos fuentes nuevas a pedido. Si tu proceso depende de un portal público, podemos convertirlo en un endpoint.
-
Lo usamos nosotros
Nuestro propio ERP consume esta plataforma para validar RUC, placas y registros. No es un producto que vendemos sin usar.
Cómo se integra
Una cabecera y una petición HTTP.
Sin SDK ni dependencias. Todas las consultas se piden igual, así que añadir una nueva no cambia tu código.
- Pide tu token. Te damos acceso al panel para generarlo.
- Añade la cabecera. Cualquiera de las dos sirve. El token se genera desde el panel de cliente.
- Consulta. Esta petición ya funciona.
X-API-Key: tu_tokenAuthorization: Bearer tu_token
curl -X GET "https://api.perusoftware.dev/api/sunat/consulta-ruc/20123456789" \
-H "X-API-Key: tu_token" Disponibles hoy
10 consultas en producción.
El catálogo crece. Todos los planes incluyen todas, así que añadir una consulta no cambia lo que pagas.
Consulta de RUC
Ficha completa del contribuyente: razón social, estado, condición, domicilio fiscal, actividades económicas y padrones.
Para qué sirve: Rellenar los datos de un cliente nuevo a partir de su RUC, sin que los escriba a mano.
Documentación y probadorVista rápida
Petición
curl -X GET "https://api.perusoftware.dev/api/sunat/consulta-ruc/20123456789" \
-H "X-API-Key: tu_token" -
rucRUC de 11 dígitos · en la ruta
Respuesta
{
"numero": "20123456789",
"nombre_o_razon_social": "EMPRESA DE EJEMPLO S.A.C.",
"tipo_contribuyente": "SOCIEDAD ANONIMA CERRADA",
"nombre_comercial": "EJEMPLO",
"estado": "ACTIVO",
"condicion": "HABIDO",
"fecha_inscripcion": "12/03/2015",
"direccion": "AV. EJEMPLO NRO 123 URB. MODELO",
"departamento": "LIMA",
"provincia": "LIMA",
"distrito": "MIRAFLORES",
"actividades_economicas": {
"principal": "6201 - PROGRAMACION INFORMATICA",
"secundarias": []
},
"es_buen_contribuyente": false,
"es_agente_de_retencion": false
} Los valores son de ejemplo; los nombres de campo son los reales.
Tipo de cambio
Tipo de cambio oficial de SUNAT, con compra y venta por día. Se consulta por mes completo, no por fecha suelta.
Para qué sirve: Convertir importes en dólares a soles con el tipo de cambio oficial del día de la operación.
Documentación y probadorVista rápida
Petición
curl -X POST "https://api.perusoftware.dev/api/sunat/tipo-cambio" \
-H "X-API-Key: tu_token"
-H "Content-Type: application/json" \
-d '{ "anio": "2026", "mes": "8" }' -
anioAño a consultar · en el cuerpo -
mesMes, de 1 a 12 · en el cuerpo
Respuesta
{
"resultado": [
{ "fecha": "01-08-2026", "compra": 3.752, "venta": 3.759 },
{ "fecha": "02-08-2026", "compra": 3.748, "venta": 3.755 }
]
} Los valores son de ejemplo; los nombres de campo son los reales.
Registro MTC
Códigos de registro habilitados en el Ministerio de Transportes para un RUC.
Para qué sirve: Verificar que un transportista tiene registro vigente antes de contratarlo.
Documentación y probadorVista rápida
Petición
curl -X POST "https://api.perusoftware.dev/api/mtc/registro" \
-H "X-API-Key: tu_token"
-H "Content-Type: application/json" \
-d '{ "ruc": "20123456789" }' -
rucRUC de la empresa · en el cuerpo
Respuesta
{
"registros_habilitados": ["0000123", "0000456"]
} Los valores son de ejemplo; los nombres de campo son los reales.
Constancia MTC
Detalle de la constancia de transporte asociada a una placa concreta.
Para qué sirve: Comprobar los datos técnicos de un vehículo antes de asignarle una carga.
Documentación y probadorVista rápida
Petición
curl -X POST "https://api.perusoftware.dev/api/mtc/constancia" \
-H "X-API-Key: tu_token"
-H "Content-Type: application/json" \
-d '{ "ruc": "20123456789", "registro": "0001234", "placa": "ABC-123" }' -
rucRUC de la empresa · en el cuerpo -
registroCódigo de registro MTC · en el cuerpo -
placaPlaca del vehículo · en el cuerpo
Respuesta
{
"item": "1",
"placa": "ABC-123",
"nro_constancia": "0001234-2026",
"categoria": "N3",
"serie_chasis": "9BWZZZ00ZTT000000",
"fabricacion": "2019",
"nro_ejes": "3",
"carga_util": "18000",
"peso_seco": "9000"
} Los valores son de ejemplo; los nombres de campo son los reales.
REINFO
Registro Integral de Formalización Minera del MINEM. Devuelve los derechos mineros asociados a un RUC con su estado.
Para qué sirve: Comprobar si un proveedor minero está inscrito y en qué estado se encuentra su formalización.
Documentación y probadorVista rápida
Petición
curl -X GET "https://api.perusoftware.dev/api/reinfo/20123456789" \
-H "X-API-Key: tu_token" -
rucRUC del titular · en la ruta
Respuesta
{
"registros": [
{
"sec": "1",
"ruc": "20123456789",
"nombre": "MINERA DE EJEMPLO S.A.C.",
"codigo_unico": "010012345",
"derecho": "CONCESION DE EJEMPLO 1",
"departamento": "AREQUIPA",
"provincia": "CAYLLOMA",
"distrito": "CAYLLOMA",
"estado": "VIGENTE"
}
]
} Los valores son de ejemplo; los nombres de campo son los reales.
También disponibles
Funcionan igual que las anteriores y se piden con el mismo token. Su documentación detallada llega en la próxima entrega.
- SUNAT GET Representantes legales Representantes legales inscritos de un contribuyente.
- SUNAT GET Deuda coactiva Deuda en cobranza coactiva registrada para un RUC.
- SUNAT POST Ficha RUC imprimible La misma ficha, devuelta como HTML listo para imprimir o adjuntar.
- SUNAT POST Deuda coactiva imprimible La consulta de deuda coactiva como HTML listo para imprimir.
- REINFO POST REINFO imprimible La consulta de REINFO como HTML listo para imprimir.
¿Necesitas una que no está? Si tu proceso depende de consultar un portal público, podemos convertirlo en un endpoint más de tu misma integración. Cuéntanos cuál.
Planes
Pagas por volumen, no por API.
Todos los planes incluyen todas las consultas, las de hoy y las que se añadan. La única diferencia es cuántas puedes hacer.
Gratuito
Gratis
300 consultas · 30 días
Para integrar sin prisa y ver si encaja.
- Todas las fuentes, sin recortes
- Historial de consultas
- Soporte por correo
Emprende
S/ 19.00/mes
S/ 190.00 al año −17% de ahorro
12,000 consultas · 30 días
S/ 0.0016 por consulta
Estudios contables y equipos que validan clientes a diario.
- Todas las fuentes, sin recortes
- MTC y REINFO incluidos
- Fichas en HTML para imprimir
- Historial de consultas
- Soporte por WhatsApp
Negocio
S/ 35.00/mes
S/ 350.00 al año −17% de ahorro
40,000 consultas · 30 días
S/ 0.0009 por consulta
Validación en formularios, altas de clientes y consultas MTC o REINFO recurrentes.
- Todas las fuentes, sin recortes
- MTC y REINFO incluidos
- Fichas en HTML para imprimir
- Historial de consultas
- Soporte por WhatsApp
Corporativo
S/ 65.00/mes
S/ 650.00 al año −17% de ahorro
120,000 consultas · 30 días
S/ 0.0005 por consulta
Alto volumen, procesos por lotes y saneamiento de cartera.
- Todas las fuentes, sin recortes
- MTC y REINFO incluidos
- Fichas en HTML para imprimir
- Historial de consultas
- Soporte por WhatsApp
Los precios no incluyen IGV.
Al agotar el cupo, el servicio responde 429 y las consultas se detienen hasta renovar. Todavía no hay cobro por consulta adicional.
¿Prefieres que lo integremos nosotros?
Los planes son acceso al API: alguien de tu lado programa la integración. Si no tienes a quien, la hacemos nosotros y la dejamos funcionando dentro de tu sistema —tu ERP, tu web o el software que ya uses—.
Cotización a medida, según el sistema y las consultas que haya que conectar.
Pedir cotizaciónPago
Págalo desde tu celular y activamos tu token.
Sin pasarela de por medio y sin recargo por el medio de pago: pagas por Yape, Plin o transferencia, nos envías la constancia y te dejamos el token activo.
1. Qué vas a pagar
Elige el plan y cada cuánto lo renuevas. El total ya lleva el IGV.
2. Cómo lo pagas
El monto no se rellena solo: escríbelo exacto y el pago cuadra a la primera.
Estás pagando
Concepto
Escríbelo en el mensaje del pago: es lo que nos permite reconocerlo sin preguntarte.
Elige arriba el plan y el periodo para saber el monto exacto.
Yape / Plin
Sin comisiónVer los datos
- Número
- +51 929 766 373
- A nombre de
- Carlos Daniel De La Cruz Galvan
El QR es de Yape. Desde Plin —BBVA, Interbank, Scotiabank y cajas— búscanos por el número. Comprueba el nombre antes de confirmar.
BCP
Sin comisión desde el BCPVer los datos
- Cuenta en soles
- 25595400323098
- CCI
- 00225519540032309881
- Titular
- Carlos Daniel De La Cruz Galvan
Desde otro banco, usa el CCI: la transferencia entra igual y suele llegar el mismo día.
Interbank
Sin comisión desde InterbankVer los datos
- Cuenta Simple en soles
- 8983216258748
- CCI
- 00389801321625874840
- Titular
- Carlos Daniel De La Cruz Galvan
Desde otro banco, usa el CCI: la transferencia entra igual y suele llegar el mismo día.
3. Avísanos
La activación no es automática: revisamos el pago y habilitamos el token a mano, dentro del horario de atención.
o escríbenos a contacto@perusoftware.pe
Lunes a viernes, 10:00 – 17:00 (GMT-5)
Nunca te pediremos claves, códigos de verificación ni datos de tarjeta. El pago sale de tu app hacia la cuenta de la empresa; esta página no lo intermedia.
Emitimos factura electrónica por cada pago.
Referencia
Qué te puede responder.
Los mismos códigos para todas las consultas. Conviene contemplarlos desde el principio, no cuando aparezcan en producción.
- 200 OK Consulta resuelta. Descuenta una petición del plan.
- 401 Token inválido o vencido Falta la cabecera de autenticación o el token no es válido.
- 403 Sin acceso El plan no cubre este servicio o la suscripción no está activa.
- 404 No encontrado La consulta se ejecutó pero no hubo resultados. También descuenta.
- 429 Límite alcanzado Se agotaron las consultas del período.
- 500 Error del servicio Fallo al consultar la fuente oficial. No se guarda en caché.
¿Lo probamos con tu caso?
Cuéntanos qué necesitas consultar. Te damos acceso de prueba para validar la integración antes de contratar.
Escribir por WhatsApp