DOCUMENTACIÓN API

Integra los servicios E&M

API REST con respuestas JSON. Envía la clave en el encabezado y conserva el token en tu servidor.

Primeros pasos

Autenticación

Activa una suscripción, copia tu API key desde Mis servicios y envíala en cada consulta. Usa siempre HTTPS.

Authorization: Bearer TU_API_KEY
X-RUC: 20100113610

La API key identifica el RUC de tu cuenta. Cada producto habilita un servicio y una cuota mensual propios; no necesitas instalar un módulo Odoo para consumir estas rutas.

Respuestas habituales: 401 clave o RUC incorrectos, 403 suscripción vencida, 429 cuota mensual agotada. Se devuelven X-RateLimit-Limit y X-RateLimit-Remaining.

La cuota corresponde a tu periodo pagado. Se cuenta cada documento con resultado válido, también desde caché o sin resultados; los fallos técnicos no consumen cuota.

GET · JSON

Consulta RUC y DNI

Consulta datos disponibles de empresas y personas. RUC y DNI comparten la cuota de este servicio.

GET https://eymperu.net/api/v2/ruc/20100113610
Authorization: Bearer TU_API_KEY
X-RUC: 20100113610

GET https://eymperu.net/api/v2/dni/12345678
Authorization: Bearer TU_API_KEY
X-RUC: 20100113610

La respuesta es JSON con los datos encontrados. El RUC enviado en X-RUC identifica la suscripción; el RUC de la ruta es el contribuyente consultado.

GET · JSON

Tipo de cambio

Obtén la compra y venta del tipo de cambio del día.

GET https://eymperu.net/api/v2/exchange-rate/today
Authorization: Bearer TU_API_KEY
X-RUC: 20100113610

Ejemplo ilustrativo; consulta el endpoint para obtener el valor vigente.

{
  "fecha": "20261012",
  "moneda": "USD",
  "compra": 3.40,
  "venta": 3.42,
  "Message": "OK"
                    }

POST · JSON

Validación de comprobantes SUNAT

El RUC del comprobante debe coincidir con el RUC asociado a tu suscripción.

POST https://eymperu.net/api/v2/cpe/status
Content-Type: application/json
Authorization: Bearer TU_API_KEY
X-RUC: 20100113610

{
  "vat": "20100113610",
  "documentType": "01",
  "documentSeries": "F001",
  "documentNumber": "123",
  "documentDate": "2026-10-01",
  "documentTotal": "118.00"
}

La respuesta JSON contiene el resultado devuelto por SUNAT.

API Odoo · GET / POST

Buzón SUNAT

Este servicio se ejecuta en Odoo; su API key y vigencia son independientes. Usa RUC y Authorization: Bearer en todas las rutas.

GET  /api/v1/sunat/mailbox/folders
POST /api/v1/sunat/mailbox/messages
POST /api/v1/sunat/mailbox/messages/file
GET  /api/v1/sunat/mailbox/messages/
GET  /api/v1/sunat/mailbox/messages//html

Las rutas POST de mensajes aceptan JSON-RPC: {"jsonrpc":"2.0","method":"call","params":{...}}. Para lista y archivos, conserva los parámetros messageCodes, includeAttachments, messageCodesFilter, messageId y fileId que envía el cliente.

API · JSON-RPC compatible

SIRE

Las rutas actuales de propuestas, tickets y periodos se ejecutan en Odoo y conservan su contrato de integración. La suscripción habilita el servicio SIRE para el RUC de la cuenta.

POST /api/sire/consultar-periodos
POST /api/sire/consultar-periodos-habilitados
POST /api/sire/solicitar-propuesta
POST /api/sire/reemplazar-propuesta
POST /api/sire/eliminar-preliminar
POST /api/sire/consultar-ticket
POST /api/sire/consultar-fase
POST /api/sire/verificar-propuesta
POST /api/sire/verificar-ticket-anterior
POST /api/sire/consultar-resumen

Envía Authorization: Bearer TU_API_KEY y RUC: 20100113610. El cuerpo conserva el contrato JSON-RPC; cada método recibe sus parámetros dentro de params.