import { Aside, Code } from "@astrojs/starlight/components";
import models from "../../../../public/models/typescript/ecf.ts?raw";
Interfaces sin dependencias: funcionan en Node, Bun o el navegador. Copia el archivo a tu proyecto e impórtalo donde construyas o leas comprobantes.
## Descargar
{/* prettier-ignore */}
- ecf.ts: emisión de e-CF, con sus tipos anidados.
- novafe-models-typescript.zip: todas las áreas de la API.
- documento OpenAPI: el contrato completo, para generar tus propios modelos.
## Ejemplo: emitir un comprobante
```ts title="emitir.ts"
import type { EcfDto, IssueEcfCommand } from "./ecf";
const payload: IssueEcfCommand = {
type: 31,
incomeType: "01",
internalNumber: "FAC-2026-00042",
buyer: { rnc: "131880681", name: "Mi Cliente SRL" },
payment: {
condition: "credit",
dueDate: "15-03-2026",
methods: [{ type: "check_transfer", amount: 2360 }],
},
lines: [
{
name: "Servicio de consultoría",
kind: "service",
quantity: 1,
unitOfMeasure: "43",
unitPrice: 2000,
itbisRate: 1,
},
],
};
const response = await fetch("https://api.novafe.example/api/v1/ecf", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": process.env.NOVAFE_API_KEY!,
"Idempotency-Key": crypto.randomUUID(),
},
body: JSON.stringify(payload),
});
const ecf: EcfDto = await response.json();
console.log(ecf.encf, ecf.status);
```
## Modelos de emisión
Todo el contenido de `ecf.ts`, listo para copiar. Incluye `IssueEcfCommand` (el cuerpo de `POST /ecf`), `EcfDto` (la respuesta) y sus tipos anidados.