Factura al SRI desde Node.js y Next.js con el SDK de AZUR

Si tu producto está construido con Node.js o Next.js, puedes facturar al SRI desde tu propio backend con el SDK de AZUR.

1. Instala y configura

npm install @azur.com.ec/sdk

Guarda la credencial en una variable de entorno del servidor (AZUR_API_KEY). En Next.js, no le pongas el prefijo NEXT_PUBLIC_: la credencial nunca debe llegar al navegador.

2. Crea un módulo del servidor

// lib/azur.ts
import { Azur } from '@azur.com.ec/sdk';
export const azur = new Azur({ apiKey: process.env.AZUR_API_KEY });

3. Factura desde una ruta del servidor

Desde un Route Handler o una Server Action, usa el recurso de facturas del SDK para guardar el comprobante (primero como borrador) y luego enviarlo al SRI. Los nombres exactos de los métodos y los campos de la factura están en el README del paquete y en la referencia de la API.

El SDK agrega una Idempotency-Key automática: si tu función se reintenta, no se duplica la factura.

4. Recibe los webhooks

Crea una ruta que reciba los avisos de AZUR y verifique la firma con el cuerpo crudo:

// app/api/webhooks/azur/route.ts
import { verificarWebhook } from '@azur.com.ec/sdk';

export async function POST(req: Request) {
  const cuerpo = await req.text();
  const evento = await verificarWebhook(cuerpo, req.headers, process.env.AZUR_WEBHOOK_SECRET!);
  // evento.evento: comprobante.autorizado, comprobante.rechazado…
  return new Response('ok');
}

Responde rápido con un 2xx y procesa en segundo plano. Si tu servidor falla, AZUR reintenta.

5. Errores

El SDK lanza errores tipados (credencial inválida, sin permiso, validación con motivos). Captúralos para mostrar mensajes útiles a tus usuarios.

Checklist

• Credencial solo en el servidor.
• Permisos mínimos y, si puedes, IP autorizadas.
• Webhook con firma verificada.
• Pruebas completas con azur_test_.

Construye tu integración: crea tu cuenta gratis y revisa la guía de la API.