SDKs

Node.js

@fiscal-web/node — cliente oficial para Node 18+ con tipado completo y retries inteligentes.

Instalación

npm
npm install @fiscal-web/node

El paquete trae tipos TypeScript embebidos — no necesitas un @types/* aparte.

Uso

Emitir una factura
import { FiscalWeb } from "@fiscal-web/node";

const fw = new FiscalWeb({ apiKey: process.env.FW_KEY });

const doc = await fw.documents.create({
  kind: "invoice",
  series: "F001",
  receiver: {
    idKind: "ruc",
    idValue: "20512333797",
    name: "ACME SAC",
  },
  items: [
    { description: "Servicio profesional", quantity: "1", unitPrice: "100.00" },
  ],
});

console.log(doc.id, doc.state);

Features

  • Retries automáticos con backoff exponencial en 5xx y rate_limited.
  • Idempotency-Key generado automáticamente (UUID v4) en POSTs si no le pasas uno.
  • Verificación de webhooks: fw.webhooks.verify(payload, signature).
  • Tipos discriminados sobre kind — el TS te avisa si tu schema de factura no calza.
  • Sin runtime deps pesadas — usa node:crypto y fetch nativos.

El repo, issues y CHANGELOG viven en github.com/fiscal-web/node-sdk.