API REST de consulta RUC y anexos

sunatruc.peru777.com es una API comercial pública de EJJ Consultores SAC (PERU777) para descargar en JSON la ficha de un contribuyente y todos sus establecimientos anexos, más el tipo de cambio. No es un módulo cerrado de un ERP: cualquier desarrollador puede registrarse, obtener un token y consumirla.

Crear cuenta y token Ver planes Ejemplos por lenguaje

Qué descarga la API

Empresa: RUC, razón social, estado, condición, dirección fiscal, ubigeo, departamento, provincia y distrito (v_clientes).
Anexos / sucursales: todas las direcciones del mismo RUC con ubigeo desglosado (v_anexo).
Tipo de cambio: compra y venta por fecha o por mes.
Formato JSON. Autenticación Authorization: Bearer en las consultas con token.

Base URL

https://sunatruc.peru777.com

Proveedor: EJJ Consultores SAC - PERU777. Sitio de registro y documentación abiertos al público.

Endpoints

Uso	Método y URL	Auth
Empresa + anexos (token)	`GET https://sunatruc.peru777.com/api/buscar_empresa.php?query={RUC o nombre}`	Bearer
Tipo de cambio (token)	`GET https://sunatruc.peru777.com/api.php?action=tipo-cambio&fecha=AAAA-MM-DD`	Bearer
Cliente por RUC (compatibilidad FoxPro)	`GET https://sunatruc.peru777.com/api.php?action=cliente&ruc={11 dígitos}`	Opcional

Cabecera: Authorization: Bearer {token}. El token se genera en el panel tras registrarse.

Campos JSON de empresa y anexos

ruc, razon, idestado, idcondicion, estado, condicion,
direc, ubigeo, departamento, provincia, distrito,
anexos[]: ruc, direc, ubigeo, departamento, provincia, distrito

En Soporte hay ejemplos listos para PHP, Visual FoxPro, JavaScript, Python, C#, VB.NET, Java y Rust.

Cómo empezar

Regístrese en registrar.php (alta autogestionable).
Inicie sesión y genere un token de API.
Consulte buscar_empresa.php?query= con el Bearer para bajar empresa y anexos.
Elija un plan en Planes si necesita más consultas o vigencia.