PeruAPI

Fuente oficial, sin intermediarios

Consulta el Perú.
Factura a SUNAT.

Una sola API para consultar RUC, DNI y ubigeos, y para emitir facturas, boletas y guías de remisión. Padrón propio, sin depender del portal de SUNAT: cuando SUNAT se cae, tu consulta sigue respondiendo.

POST /api/v1/facturacion/emitir
{
  "tipo": "01", "serie": "F001", "numero": "128",
  "cliente": { "numero_documento": "20131312955" },
  "items": [ { "descripcion": "Servicio", "cantidad": 1,
               "valor_unitario": 100.00 } ]
}

→ "La Factura numero F001-128, ha sido aceptada"
  código 0 · CDR recibido · 0.4s

18 378 024

contribuyentes

9 651 294

emisores electrónicos

770 886

locales anexos

24 h

actualización

Todo lo que resuelve

Dos frentes que normalmente exigen dos proveedores distintos.

Consulta

Padrón propio en PostgreSQL. No dependemos de que el portal de SUNAT responda.

  • RUC Razón social, estado, condición, dirección y distrito
  • DNI Resuelto desde el RUC de persona natural
  • CPE Desde cuándo el RUC emite factura electrónica
  • SED Locales anexos: sucursales y almacenes por RUC
  • GEO Ubigeos, establecimientos de salud, CIE-10
  • OECE Contrataciones del Estado: procesos y adjudicaciones por RUC

Emisión a SUNAT

UBL 2.1 firmado, enviado y con CDR. Tu certificado viaja cifrado.

  • 01 Factura electrónica
  • 03 Boleta de venta
  • 07 Nota de crédito
  • 08 Nota de débito
  • 09 Guía de remisión (GRE 2022, vía REST)
  • PDF Representación impresa con QR escaneable

Después de emitir

Emitir es la mitad del trabajo. La otra mitad es corregir.

  • RA Baja de facturas ya aceptadas
  • RC Resumen diario de boletas
  • CDR Consulta del estado real en SUNAT
  • TKT Resolución de tickets asíncronos

Los PDF y XML no se archivan: se generan al momento y viajan en la respuesta. Puedes volver a pedirlos cuando quieras con los mismos datos.

Nuevo · WhatsApp

Ahora también envías por WhatsApp

Vincula tu número escaneando un QR, como WhatsApp Web, y envía mensajes desde tu propia API. Sin aprobación de Meta, sin plantillas preaprobadas, sin pagar por conversación. Misma key, mismo plan.

# vincula una vez
curl -X POST https://peru.hik.pe/api/v1/whatsapp/sesiones \
  -H "X-API-Key: pk_tu_clave" -d '{"nombre":"ventas"}'
# → {"qr_url":"..."}, escanea y listo

# envía cuando quieras
curl -X POST .../whatsapp/sesiones/1/enviar \
  -H "X-API-Key: pk_tu_clave" \
  -d '{"destino":"987654321","mensaje":"Su pedido #1234 salió"}'

Pruébalo ahora

Un documento, el servicio que elijas. Sin registro.

Endpoints

  • GET /api/v1/ruc/{ruc}
  • GET /api/v1/ruc/{ruc}/anexos
  • GET /api/v1/dni/{dni}
  • GET /api/v1/validar/ruc | /dni | /ce
  • GET /api/v1/buscar?razon_social= | ?ubigeo=
  • GET /api/v1/ubigeo/{codigo}
  • GET /api/v1/salud?ubigeo= | ?nombre= | ?lat=&lng=
  • GET /api/v1/cie10/{codigo} | ?q=
  • GET /api/v1/tipo-cambio?fecha=
  • GET /api/v1/contrataciones/{ruc}
  • GET /api/v1/contrataciones/proceso/{ocid}
  • POST /api/v1/ruc/batch
  • POST /api/v1/facturacion/emitir
  • POST /api/v1/facturacion/guia
  • POST /api/v1/facturacion/pdf
  • POST /api/v1/facturacion/xml
  • GET  /api/v1/facturacion/validar
  • POST /api/v1/facturacion/anular
  • POST /api/v1/facturacion/resumen
  • GET  /api/v1/facturacion/ticket

Autenticación

curl https://peru.hik.pe/api/v1/ruc/20131312955 \
  -H "X-API-Key: pk_tu_clave"

Una consulta = una unidad de tu plan. Si falla, no se cobra.

Precios

Soles al mes, sin IGV.

gratis

Gratis

1,000

consultas / mes

micro

S/5

5,000

consultas / mes

basico

S/15

60,000

consultas / mes

plus

S/25

120,000

consultas / mes

premium

S/45

300,000

consultas / mes

¿Y si en vez de conectarla, ya viniera puesta?

Esta API es el motor de nuestro ERP: inventario, ventas, caja, kardex y comisiones, con la emisión a SUNAT integrada y sin configurar nada. Si estás construyendo la facturación desde cero, quizá te ahorres el trabajo entero.

Conocer el ERP