SDK de JavaScript y TypeScript para facturación electrónica en Ecuador

Si tu aplicación está en JavaScript o TypeScript, el SDK oficial de AZUR te permite integrar la facturación electrónica del SRI con tipos completos y sin dependencias.

Instalación

npm install @azur.com.ec/sdk

Funciona en Node.js 18 o superior, Bun, Deno y entornos edge.

Primeros pasos

import { Azur } from '@azur.com.ec/sdk';

const azur = new Azur({ apiKey: process.env.AZUR_API_KEY });

const ctx = await azur.contexto();
const clientes = await azur.clientes.buscar({ buscar: 'Ferretería' });

Crea tu credencial en AZUR en menú de usuario → Credenciales API y usa una azur_test_ mientras desarrollas.

Qué incluye

• Tipos completos generados desde el OpenAPI: autocompletado en tu editor.
• Reintentos automáticos ante límites por minuto y fallos de red.
• Idempotency-Key automática en escrituras: sin facturas duplicadas.
• Errores tipados: credencial inválida, sin permiso, validación, límite excedido…
• Sincronización con iteradores asíncronos para recorrer todo lo nuevo.
• Verificación de webhooks con verificarWebhook().
• API clásica de emisión con EmisionClasica, incluida la retención 2.0 (retencion20).

Ejemplos incluidos

El paquete trae ejemplos para Express y Next.js, incluido cómo recibir webhooks leyendo el cuerpo crudo para verificar la firma.

Buenas prácticas

• Nunca expongas la credencial en el navegador: úsala solo en el servidor.
• Una credencial por aplicación, con permisos mínimos.
• Verifica siempre la firma de los webhooks.

Consulta la referencia completa de la API y la guía de inicio.

Empieza a programar: crea tu cuenta gratis.