SDKs · Documentación

Próximamente

Los SDKs envuelven la misma API REST con tipos generados del contrato, reintentos e idempotencia automática. Mientras salen, todo lo que hacen se puede hacer con fetch o requests, como en el inicio rápido.

TypeScript y JavaScript#

npm

npm i @firmo/sdk

emitir.ts

import { Firmo } from '@firmo/sdk';

const firmo = new Firmo({ apiKey: process.env.FIRMO_API_KEY! });

const ecf = await firmo.ecf.emitir({
  tipo: 31,
  comprador: { rnc: '131000000', razonSocial: 'Ferretería El Puente SRL' },
  items: [{ descripcion: 'Cemento gris 42.5 kg', cantidad: 20, precioUnitario: 500 }],
});

console.log(ecf.estado, ecf.encf);

La interfaz del SDK puede cambiar antes de la versión 1.0. La API REST es la referencia estable.

Python#

Próximamente

pip

pip install firmo

Mientras tanto, usa la API directamente con requests o httpx.

Otros lenguajes#

En la República Dominicana hay mucho PHP, C#/.NET y Java. Están en la hoja de ruta. Mientras, puedes generar un cliente a partir de openapi.json.