Refrendia · v0.0.1

Facturación electrónica DIAN
para FourG Solutions.

Emitimos, firmamos con XAdES-EPES y refrendamos cada venta ante la DIAN desde una plataforma propia, sin intermediarios. Dominio, UBL 2.1, firma digital e integración SOAP viven en capas separadas y auditables — construido para facturar hoy y cubrir notas, documento soporte, nómina y RADIAN en fases posteriores.

12Packagestypecheck verde
31Tests unit+integrationtodos pasan
08Tablas PostgresRLS forzada · 0 lints
09Skills Claude.claude/skills/

Roadmap

3/7 completos
  1. 00

    Scaffold

    completo

    Monorepo pnpm + Turborepo. Tres apps (api, web, jobs), nueve packages (domain, catalogs, ubl, signing, dian-client, pdf, storage, shared, test-kit).

  2. 01

    Dominio y persistencia

    completo

    Entidades Invoice, InvoiceLine, Customer, Product, Issuer, NumberRange. Value objects Money (BigInt), Nit (con DV), TaxRate. Prisma 5.22 contra Supabase dev + Postgres prod en VPS Hostinger. RLS forzada con 0 lints de seguridad.

  3. 02

    UBL 2.1 + firma XAdES

    completo

    InvoiceBuilder UBL con 5 sub-mappers (party, tax, line, monetary, money). CUFE SHA-384 y CUDE. Lector P12 con node-forge. XAdES signer + verify end-to-end. 31 tests verdes.

  4. 03

    Cliente DIAN habilitación

    en curso

    SendBillSync + parser ApplicationResponse. Workers BullMQ firma → envío → polling de estado. Estados canónicos (accepted, rejected, accepted_with_errors, timeout).

  5. 04

    Set de pruebas DIAN

    pendiente

    Orquestador reproducible, evidencias por caso, 100% aprobado antes de producción.

  6. 05

    Representación gráfica + panel

    pendiente

    PDF con QR y CUFE, bandeja de documentos, estados, reenvío manual.

  7. 06

    Hardening

    pendiente

    Alertas, métricas, runbooks completos, rotación de certificado, retención DIAN 5 años.

Stack

Cumplimiento DIAN

Factura · Nota crédito · Nota débito

El MVP cubre los tres documentos electrónicos de venta. Documento soporte, nómina electrónica y eventos RADIAN quedan para fases posteriores con ADR y set de pruebas dedicados.

Anexo técnico vigente

UBL 2.1 + XAdES-EPES con SHA-256, canonicalización C14N exclusiva, CUFE/CUDE determinísticos con vectores oficiales, envío SOAP a habilitación antes de producción.

Infraestructura

Frontend

Next.js 14 en Vercel, edge CDN global. Preview por branch automático.

API · workers · BD

NestJS + BullMQ + Postgres 17 + Redis 7 en VPS Hostinger Ubuntu 24.04, Docker Swarm con Traefik compartido.

Coexistencia

Integrado al stack Easypanel existente junto a n8n para flujos automatizados sobre eventos de dominio.