Connect any system to DGII electronic invoicing.

// Types you define in your integration from the API reference.
import type {
  ConsumerInvoiceRequest,
  ConsumerInvoiceResponse,
} from "./types/factura";

export async function issueConsumerInvoice(
  apiKey: string,
  body: ConsumerInvoiceRequest,
): Promise<ConsumerInvoiceResponse> {
  const res = await fetch(
    "https://tuempresa.factura.com.do/api/v1/consumer-invoices",
    {
      method: "POST",
      headers: {
        "X-Api-Key": apiKey,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    },
  );

  if (!res.ok) {
    throw new Error(`factura.com.do: ${res.status} ${await res.text()}`);
  }
  return res.json() as Promise<ConsumerInvoiceResponse>;
}

import type { Request, Response } from "express";

const SHARED_SECRET = process.env.FACTURA_WEBHOOK_SECRET!;

export function handleWebhook(req: Request, res: Response) {
  // BYO-auth validation: the secret travels in a header
  // you configure when registering the webhook.
  if (req.header("X-Webhook-Secret") !== SHARED_SECRET) {
    return res.status(401).end();
  }

  const { Event, Timestamp, data } = req.body;

  switch (Event) {
    case "dgii.aprobado":
      // mark the receipt as accepted in your ERP
      break;
    case "dgii.rechazado":
      // trigger manual review or credit note
      break;
    case "dgii.aceptado_condicional":
      // accept with observations, log in audit trail
      break;
    case "dgii.en_proceso":
      // keep as "pending DGII" until next event
      break;
  }

  res.status(200).end();
}