SDK de Node (API)
@openfactura/node llama a la API por ti: cada operación tipada (generada de la misma
especificación que la referencia), sin dependencias. Corre en Node 20+, Bun, Deno,
Cloudflare Workers y el navegador.
npm install @openfactura/nodeimport { OpenFactura, OpenFacturaError } from '@openfactura/node'
const of = new OpenFactura({ apiKey: process.env.OPENFACTURA_API_KEY! })
try { const doc = await of.dte.emitir({ tipoDte: '01', datos }) console.log(doc.estado, doc.selloRecibido)} catch (e) { if (e instanceof OpenFacturaError && e.code === 'dte_rechazado') console.log(e.details)}Idempotencia y reintentos. Cada emisión lleva una clave de idempotencia (pasa la tuya con
{ idempotencyKey: 'venta-10931' }). Ante 429, 5xx o una falla de red el SDK reintenta con la misma
clave, así que nunca emite dos veces. Lo que no es seguro repetir no se reintenta.
Verificar webhooks
Sección titulada «Verificar webhooks»import { verificarWebhook } from '@openfactura/node'
const evento = await verificarWebhook(cuerpoCrudo, firmaDelEncabezado, secreto)Pasa el cuerpo crudo (antes de JSON.parse) y el encabezado OpenFactura-Signature. Lanza
FirmaInvalida si no coincide o si el envío tiene más de 5 minutos.
Plataforma
Sección titulada «Plataforma»Con Plataforma (Open Factura Cloud):
const cliente = await of.plataforma.clientes.crear({ nombre: 'Casa Barista', externalId: 'cb-1' })const { url } = await of.plataforma.clientes.enlace(cliente.id)const { clave } = await of.plataforma.clientes.claves.crear(cliente.id, { nombre: 'POS', modo: 'test', scopes: ['dte:emit', 'dte:read'],})await of.comoCliente(clave).dte.emitir({ tipoDte: '01', datos }) // en SU espacioGuarda la clave de cada cliente en tu base de datos: se muestra una sola vez.
Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.