H24
volver a Writing

18 de septiembre de 2026 / 6 min de lectura

NCF, RNC e ITBIS: facturar en RD sin inventar una API

Rangos NCF, padrón local de la DGII e ITBIS configurable. Notas reales desde HavadaDesktop, un ERP de escritorio para negocios pequeños.

#Facturación#RD

Facturar en República Dominicana tiene tres piezas que se parecen poco a un sistema de facturación genérico: el NCF, la validación del RNC y el ITBIS. En HavadaDesktop las resolví con datos locales y reglas explícitas, no con magia fiscal.

El NCF es un rango, no un texto libre

El administrador crea rangos por tipo, prefijo, desde, hasta y vencimiento. El sistema consume el siguiente número —prefijo más ocho dígitos— solo cuando una factura lo necesita. Eso evita quemar comprobantes al equivocarse en un formulario.

El NCF es opcional por factura: si la factura no tiene un rango asignado, no se le inventa uno. La disciplina está en el dato, no en el disclaimer.

El RNC vive en un padrón local

La DGII no ofrece una API pública en tiempo real para esto, así que HavadaDesktop descarga el ZIP oficial del padrón, lo parsea con codificación `latin1`, lo carga en un `Map` en memoria y lo guarda en un archivo separado. La búsqueda es rápida y funciona sin internet; la actualización es un paso consciente.

El ITBIS no debe ser una constante

  • Tasa configurable; el valor por defecto es 18%, pero el negocio decide.
  • El descuento se aplica antes de calcular el impuesto, sobre la base gravable.
  • El envío queda registrado: SMTP para el correo, historial de envíos y un portal de cliente con token aleatorio.
Esto no es facturación electrónica ni envío a la DGII. Es un ERP local que respeta las reglas que sí puede cumplir.

La lección es general: cuando la autoridad no da una API, construye sobre los datos que sí existen y haz visible el límite. Un sistema honesto con sus fronteras es más útil que uno que promete integraciones inexistentes.