feat(dian-hub): microservicio centralizado de facturacion electronica UBL 2.1 y panel admin para Innovacion & Desarrollo SAS
This commit is contained in:
AI Bot
parent
9a1190cc0f
commit
483090aa1e
6
facturacion-dian-hub/.gitignore
vendored
Normal file
6
facturacion-dian-hub/.gitignore
vendored
Normal file
@ -0,0 +1,6 @@
|
||||
node_modules/
|
||||
dist/
|
||||
.env
|
||||
.env.local
|
||||
*.log
|
||||
.DS_Store
|
||||
55
facturacion-dian-hub/Dockerfile.backend
Normal file
55
facturacion-dian-hub/Dockerfile.backend
Normal file
@ -0,0 +1,55 @@
|
||||
# ==========================================
|
||||
# MULTI-STAGE DOCKERFILE - BACKEND FASTIFY
|
||||
# DIAN Electronic Invoicing Microservice
|
||||
# ==========================================
|
||||
|
||||
# Stage 1: Builder
|
||||
FROM node:22-alpine AS builder
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# Instalar herramientas requeridas para compilar dependencias nativas si aplican
|
||||
RUN apk add --no-cache python3 make g++
|
||||
|
||||
COPY backend/package*.json ./
|
||||
COPY backend/prisma ./prisma/
|
||||
|
||||
RUN npm ci
|
||||
|
||||
COPY backend/tsconfig.json ./
|
||||
COPY backend/src ./src
|
||||
|
||||
# Generar cliente Prisma y compilar TypeScript a JavaScript estricto
|
||||
RUN npx prisma generate
|
||||
RUN npm run build
|
||||
|
||||
# Stage 2: Production Distroless / Alpine Minimal
|
||||
FROM node:22-alpine AS runner
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
ENV NODE_ENV=production
|
||||
ENV PORT=3001
|
||||
ENV HOST=0.0.0.0
|
||||
|
||||
# Crear usuario sin privilegios para mitigar riesgos de seguridad
|
||||
RUN addgroup --system --gid 1001 nodejs && \
|
||||
adduser --system --uid 1001 dianapp
|
||||
|
||||
# Copiar dependencias de producción y artefactos compilados
|
||||
COPY backend/package*.json ./
|
||||
COPY backend/prisma ./prisma/
|
||||
|
||||
RUN npm ci --only=production && npm cache clean --force
|
||||
RUN npx prisma generate
|
||||
|
||||
COPY --from=builder --chown=dianapp:nodejs /app/dist ./dist
|
||||
|
||||
USER dianapp
|
||||
|
||||
EXPOSE 3001
|
||||
|
||||
HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
|
||||
CMD wget --no-verbose --tries=1 --spider http://localhost:3001/health || exit 1
|
||||
|
||||
CMD ["node", "dist/index.js"]
|
||||
28
facturacion-dian-hub/Dockerfile.frontend
Normal file
28
facturacion-dian-hub/Dockerfile.frontend
Normal file
@ -0,0 +1,28 @@
|
||||
# ==========================================
|
||||
# MULTI-STAGE DOCKERFILE - FRONTEND REACT/VITE
|
||||
# DIAN Fiscal Hub Modern Admin Panel
|
||||
# ==========================================
|
||||
|
||||
# Stage 1: Build
|
||||
FROM node:22-alpine AS builder
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
COPY frontend/package*.json ./
|
||||
RUN npm ci
|
||||
|
||||
COPY frontend/ ./
|
||||
RUN npm run build
|
||||
|
||||
# Stage 2: Production Nginx Minimal
|
||||
FROM nginx:1.27-alpine
|
||||
|
||||
COPY --from=builder /app/dist /usr/share/nginx/html
|
||||
COPY nginx.conf /etc/nginx/conf.d/default.conf
|
||||
|
||||
EXPOSE 80
|
||||
|
||||
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
|
||||
CMD wget --quiet --tries=1 --spider http://localhost/ || exit 1
|
||||
|
||||
CMD ["nginx", "-g", "daemon off;"]
|
||||
211
facturacion-dian-hub/README.md
Normal file
211
facturacion-dian-hub/README.md
Normal file
@ -0,0 +1,211 @@
|
||||
# 🇨🇴 DIAN Electronic Invoicing Hub ("Software Propio")
|
||||
## Innovación & Desarrollo S.A.S. • NIT 901.554.892-9
|
||||
### Hub Fiscal Centralizado Multi-Tenant para **DripZone** y **PacificTrans**
|
||||
|
||||
[](https://nodejs.org/)
|
||||
[](https://www.typescriptlang.org/)
|
||||
[](https://www.fastify.io/)
|
||||
[](https://www.prisma.io/)
|
||||
[](https://www.postgresql.org/)
|
||||
[](https://react.dev/)
|
||||
[](https://www.dian.gov.co/)
|
||||
|
||||
---
|
||||
|
||||
## 🏛️ 1. Arquitectura de Software y Principios de Diseño (Clean Architecture & DDD)
|
||||
|
||||
El sistema ha sido diseñado por el equipo de Arquitectura de Software & Seguridad Cloud aplicando **Clean Architecture (Uncle Bob)** y **Domain-Driven Design (DDD)** con separación estricta de capas e inversión de dependencias:
|
||||
|
||||
```
|
||||
facturacion-dian-hub/
|
||||
├── backend/
|
||||
│ ├── src/
|
||||
│ │ ├── domain/ # Capa de Dominio (Entidades, Value Objects, Puertos, Eventos, Reglas Fiscales)
|
||||
│ │ │ ├── entities/ # Factura (Aggregate Root), Cliente, ItemFactura, ResolucionDian, Tenant
|
||||
│ │ │ ├── value-objects/ # Cufe (SHA-384), Nit (Módulo 11), Money, SoftwareSecurityCode, FiscalEnums
|
||||
│ │ │ ├── ports/ # IFacturaRepository, ITenantRepository, IResolucionRepository, IDianClient, IXmlSigner...
|
||||
│ │ │ └── exceptions/ # ValidacionFiscalException, ResolucionAgotadaException, FirmaDigitalException
|
||||
│ │ ├── application/ # Capa de Aplicación (Casos de Uso, DTOs y Servicios de Orquestación)
|
||||
│ │ │ ├── use-cases/ # EmitirFacturaUseCase, ConsultarFacturasUseCase...
|
||||
│ │ │ ├── services/ # DianUblBuilderService (Generador UBL 2.1 estándar)
|
||||
│ │ │ └── dtos/ # EmitirFacturaInputDto (Zod), FacturaResponseDto
|
||||
│ │ ├── infrastructure/ # Capa de Infraestructura (Adaptadores de Frameworks y Drivers)
|
||||
│ │ │ ├── database/ # Prisma Client, PostgreSQL 16 Repositorios y Store Resiliente
|
||||
│ │ │ ├── security/ # XadesSigner (Firma XAdES-BES RSA-SHA256), CryptoService (AES-256-GCM)
|
||||
│ │ │ ├── dian/ # DianSoapClient (SOAP VPFE y Simulador DIAN Integrado)
|
||||
│ │ │ ├── qr/ # QrGeneratorService (SVG y Base64 Data URL)
|
||||
│ │ │ └── printing/ # PdfGeneratorService (Representación Gráfica Oficial)
|
||||
│ │ └── presentation/ # Capa de Presentación (Controladores, Rutas y Middlewares Fastify)
|
||||
│ │ ├── controllers/ # InvoiceController, TenantController, ResolutionController
|
||||
│ │ ├── middlewares/ # AuthenticationMiddleware (API Keys), ErrorHandlerMiddleware
|
||||
│ │ ├── routes/ # /api/v1/invoices, /api/v1/tenants, /api/v1/resolutions, /health
|
||||
│ │ └── server.ts # Fastify App Builder con Helmet, CORS, Rate Limit y Swagger UI
|
||||
├── frontend/ # Panel Administrativo Web Moderno (React 18 + Vite 5 + Tailwind CSS v3.4)
|
||||
│ ├── src/
|
||||
│ │ ├── api/ # Cliente HTTP con soporte Multi-Tenant
|
||||
│ │ ├── store/ # Zustand Global State
|
||||
│ │ ├── components/ # Navbar, KpiMetrics, InvoicesTable, InvoiceDetailModal, InvoiceEmitterModal...
|
||||
│ │ └── App.tsx # Dashboard Principal y Explorador de Facturas
|
||||
├── docker-compose.yml # Orquestación de Contenedores (Postgres 16, Backend y Frontend)
|
||||
├── Dockerfile.backend # Multi-stage Alpine con usuario no root
|
||||
├── Dockerfile.frontend # Multi-stage Nginx Alpine con compresión gzip y headers de seguridad
|
||||
└── nginx.conf # Configuración de producción para proxy inverso y SPA
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚖️ 2. Cumplimiento Normativo DIAN Colombia (UBL 2.1)
|
||||
|
||||
El microservicio implementa con exactitud los requerimientos de la **Resolución 000165 de 2023** y el **Anexo Técnico de Factura Electrónica de Venta (Versión 1.9 vigente)**:
|
||||
|
||||
1. **Algoritmo de Dígito de Verificación (NIT):**
|
||||
- Implementa el algoritmo oficial de **Módulo 11** de la DIAN utilizando la serie de primos descendentes `[3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71]`.
|
||||
- Para **Innovación & Desarrollo S.A.S.** (NIT `901554892`), el dígito calculado es **`9`** (`901.554.892-9`).
|
||||
|
||||
2. **Cálculo de CUFE (Código Único de Factura Electrónica):**
|
||||
- Función hash **SHA-384** con formato estricto de 96 caracteres hexadecimales:
|
||||
$$\text{CUFE} = \text{SHA-384}(\text{NumFac} + \text{FecFac} + \text{HorFac} + \text{ValFac} + \text{CodImp1} + \text{ValImp1} + \dots + \text{ValTot} + \text{NitOFE} + \text{NumAdq} + \text{ClaveTecnica} + \text{TipoAmbiente})$$
|
||||
|
||||
3. **Código de Seguridad del Software (`SoftwareSecurityCode`):**
|
||||
- Incrustado en `sts:DianExtensions`:
|
||||
$$\text{SoftwareSecurityCode} = \text{SHA-384}(\text{SoftwareID} + \text{SoftwarePIN} + \text{NumeroFactura})$$
|
||||
|
||||
4. **Firma Digital XAdES-BES (XMLDSig):**
|
||||
- Firma electrónica enveloped con algoritmo **RSA-SHA256** y Canonicalización **C14N** (`http://www.w3.org/TR/2001/REC-xml-c14n-20010315`).
|
||||
- Bloque `xades:QualifyingProperties` con `xades:SignedProperties`, `SigningTime`, `SigningCertificate` y `SignaturePolicyIdentifier` oficial de la DIAN (`https://facturaelectronica.dian.gov.co/politicadefirma/v2/politicadefirmav2.pdf`).
|
||||
|
||||
5. **Código QR Estándar:**
|
||||
- URL de validación inmediata:
|
||||
`https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey={CUFE}`
|
||||
|
||||
6. **Control de Consecutivos y Bloqueo Atómico:**
|
||||
- La reserva de número consecutivo se ejecuta mediante transacciones ACID atómicas en PostgreSQL (`dian_resolutions.currentConsecutive = currentConsecutive + 1`), impidiendo saltos o colisiones en emisiones concurrentes.
|
||||
|
||||
---
|
||||
|
||||
## 🏢 3. Aislamiento Multi-Tenant (DripZone & PacificTrans)
|
||||
|
||||
El microservicio funciona como un **Hub Fiscal Centralizado** para múltiples unidades de negocio de la compañía:
|
||||
|
||||
| Tenant | Slug | Caso de Uso Fiscal | Prefijo Autorizado | Actividad Económica (CIIU) | API Key de Prueba |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| **DripZone** | `dripzone` | Venta minorista de Sneakers y Streetwear (IVA 19%) | `DRIP` (1 al 50.000) | 4771 (Prendas de vestir y calzado) | `dz_live_key_98f4bc12e87a` |
|
||||
| **PacificTrans** | `pacifictrans` | Transporte terrestre intermunicipal de pasajeros y flete de carga marítima/terrestre (Excluido IVA Art. 476 ET) | `PACT` (1 al 50.000) | 4923 (Transporte de carga por carretera) | `pt_live_key_33c9a184ef10` |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 4. Guía de Ejecución Rápida
|
||||
|
||||
### Opción A: Desarrollo Local con Node 22 (Sin Docker)
|
||||
|
||||
1. **Iniciar Backend:**
|
||||
```bash
|
||||
cd backend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
*Servidor API disponible en:* `http://localhost:3001`
|
||||
*Swagger Docs:* `http://localhost:3001/api/docs`
|
||||
*Health Check:* `http://localhost:3001/health`
|
||||
|
||||
2. **Iniciar Frontend Panel:**
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
*Panel Administrativo disponible en:* `http://localhost:3000`
|
||||
|
||||
3. **Ejecutar Pruebas Unitarias de Reglas Fiscales:**
|
||||
```bash
|
||||
cd backend
|
||||
npx tsx --test tests/DianFiscalRules.test.ts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Opción B: Ejecución Contenerizada con Docker Compose v2
|
||||
|
||||
```bash
|
||||
docker compose up -d --build
|
||||
```
|
||||
|
||||
Servicios desplegados:
|
||||
- **Base de Datos:** PostgreSQL 16 Alpine en `localhost:5432` con volumen persistente `dian_hub_pgdata`.
|
||||
- **Backend API:** Fastify en `http://localhost:3001`.
|
||||
- **Frontend Panel:** Nginx en `http://localhost:3000`.
|
||||
|
||||
---
|
||||
|
||||
## 📡 5. Catálogo de Endpoints de la API (REST / JSON)
|
||||
|
||||
Todas las peticiones a la API protegida requieren la cabecera `x-api-key`.
|
||||
|
||||
### Emitir Factura Electrónica
|
||||
`POST /api/v1/invoices`
|
||||
**Headers:** `x-api-key: dz_live_key_98f4bc12e87a`, `Content-Type: application/json`
|
||||
|
||||
```json
|
||||
{
|
||||
"operationType": "10",
|
||||
"paymentType": "1",
|
||||
"paymentMethodCode": "10",
|
||||
"customer": {
|
||||
"identificationType": "13",
|
||||
"identificationNumber": "1144987654",
|
||||
"legalOrFullName": "Juan David Gómez",
|
||||
"email": "juan.gomez@gmail.com",
|
||||
"address": "Carrera 100 # 16-20",
|
||||
"cityName": "Cali",
|
||||
"departmentCode": "76",
|
||||
"cityCode": "76001",
|
||||
"taxRegime": "49"
|
||||
},
|
||||
"items": [
|
||||
{
|
||||
"sku": "DZ-AIR-JORDAN-01",
|
||||
"description": "Air Jordan 1 Retro High OG Lost and Found (Talla 42)",
|
||||
"quantity": 1,
|
||||
"unitPrice": 890000,
|
||||
"taxPercentage": 19,
|
||||
"taxTypeCode": "01",
|
||||
"discountAmount": 0
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Respuesta Exitosa (201 Created):
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"id": "e4f876c1-...",
|
||||
"fullNumber": "DRIP-1043",
|
||||
"cufe": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855...",
|
||||
"subtotal": 890000,
|
||||
"taxTotal": 169100,
|
||||
"grandTotal": 1059100,
|
||||
"dianStatus": "ACEPTADA",
|
||||
"dianStatusCode": "00",
|
||||
"dianStatusDescription": "Procesado y Validado con Éxito por la DIAN (VPFE Validación Previa).",
|
||||
"xmlSignedUrl": "/api/v1/invoices/e4f876c1-.../xml",
|
||||
"pdfUrl": "/api/v1/invoices/e4f876c1-.../pdf"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Otros Endpoints:
|
||||
- `GET /api/v1/invoices`: Listado con filtros por estado, tenant y búsqueda.
|
||||
- `GET /api/v1/invoices/metrics`: Métricas consolidadas (Total Facturado, IVA, % Aprobación).
|
||||
- `GET /api/v1/invoices/:id/xml`: Descarga el archivo XML UBL 2.1 con la firma digital XAdES-BES.
|
||||
- `GET /api/v1/invoices/:id/pdf`: Visualiza o descarga la representación gráfica oficial en PDF.
|
||||
- `GET /api/v1/tenants`: Listado de tenants autorizados.
|
||||
- `GET /api/v1/resolutions`: Control de numeración autorizada y alertas de vencimiento.
|
||||
|
||||
---
|
||||
|
||||
## 🔒 6. Directrices de Despliegue en VPS (Coolify)
|
||||
|
||||
> [!IMPORTANT]
|
||||
> De conformidad con las políticas operativas del sistema, los despliegues en el servidor VPS de producción se administran **exclusivamente a través de Coolify**. No se deben levantar contenedores manuales fuera de Coolify para garantizar la integridad del enrutamiento de Traefik y evitar duplicidades de puertos o instancias.
|
||||
3131
facturacion-dian-hub/backend/package-lock.json
generated
Normal file
3131
facturacion-dian-hub/backend/package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
52
facturacion-dian-hub/backend/package.json
Normal file
52
facturacion-dian-hub/backend/package.json
Normal file
@ -0,0 +1,52 @@
|
||||
{
|
||||
"name": "dian-fiscal-hub-backend",
|
||||
"version": "1.0.0",
|
||||
"description": "Microservicio centralizado de Facturacion Electronica DIAN UBL 2.1 (Software Propio) para Innovacion & Desarrollo S.A.S. (Hub DripZone y PacificTrans)",
|
||||
"main": "dist/index.js",
|
||||
"scripts": {
|
||||
"dev": "tsx watch src/index.ts",
|
||||
"build": "tsc",
|
||||
"start": "node dist/index.js",
|
||||
"prisma:generate": "prisma generate",
|
||||
"prisma:migrate": "prisma migrate dev",
|
||||
"prisma:studio": "prisma studio",
|
||||
"test": "node --test dist/**/*.test.js"
|
||||
},
|
||||
"keywords": [
|
||||
"dian",
|
||||
"facturacion-electronica",
|
||||
"ubl21",
|
||||
"xades-bes",
|
||||
"cufe",
|
||||
"colombia",
|
||||
"fastify",
|
||||
"clean-architecture"
|
||||
],
|
||||
"author": "Innovacion & Desarrollo S.A.S.",
|
||||
"license": "Proprietary",
|
||||
"dependencies": {
|
||||
"@fastify/cors": "^9.0.1",
|
||||
"@fastify/helmet": "^11.1.1",
|
||||
"@fastify/rate-limit": "^9.1.0",
|
||||
"@fastify/swagger": "^8.15.0",
|
||||
"@fastify/swagger-ui": "^3.0.0",
|
||||
"@prisma/client": "^5.21.1",
|
||||
"axios": "^1.7.7",
|
||||
"dotenv": "^16.4.5",
|
||||
"fast-xml-parser": "^4.5.0",
|
||||
"fastify": "^4.28.1",
|
||||
"node-forge": "^1.3.1",
|
||||
"pdfmake": "^0.2.10",
|
||||
"qrcode": "^1.5.4",
|
||||
"zod": "^3.23.8"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/node": "^22.7.5",
|
||||
"@types/node-forge": "^1.3.11",
|
||||
"@types/pdfmake": "^0.2.9",
|
||||
"@types/qrcode": "^1.5.5",
|
||||
"prisma": "^5.21.1",
|
||||
"tsx": "^4.19.1",
|
||||
"typescript": "^5.6.3"
|
||||
}
|
||||
}
|
||||
187
facturacion-dian-hub/backend/prisma/schema.prisma
Normal file
187
facturacion-dian-hub/backend/prisma/schema.prisma
Normal file
@ -0,0 +1,187 @@
|
||||
generator client {
|
||||
provider = "prisma-client-js"
|
||||
}
|
||||
|
||||
datasource db {
|
||||
provider = "postgresql"
|
||||
url = env("DATABASE_URL")
|
||||
}
|
||||
|
||||
model Tenant {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
name String
|
||||
slug String @unique
|
||||
apiKeyHash String
|
||||
status String @default("ACTIVE") // ACTIVE, SUSPENDED
|
||||
economicActivityCode String?
|
||||
contactEmail String
|
||||
webhookUrl String?
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
resoluciones DianResolution[]
|
||||
facturas Invoice[]
|
||||
auditLogs AuditLog[]
|
||||
|
||||
@@map("tenants")
|
||||
}
|
||||
|
||||
model CompanyProfile {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
nit String @unique
|
||||
dv String
|
||||
legalName String
|
||||
tradeName String
|
||||
taxRegime String @default("48") // 48 = Responsable de IVA
|
||||
fiscalResponsibility String @default("O-13,O-15,O-23,O-47")
|
||||
departmentCode String @default("76") // Valle del Cauca
|
||||
cityCode String @default("76001") // Cali
|
||||
cityName String @default("Cali")
|
||||
address String @default("Avenida Colombia # 12-45")
|
||||
email String @default("facturacion@innovacionydesarrollo.co")
|
||||
phone String @default("+57 300 123 4567")
|
||||
softwareId String @default("d5e07b47-6aea-43cc-b38c-3c7d46b4a52f")
|
||||
softwarePin String @default("75319")
|
||||
dianEnvironment String @default("HABILITACION") // HABILITACION, PRODUCCION
|
||||
testSetId String?
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
@@map("company_profiles")
|
||||
}
|
||||
|
||||
model DigitalCertificate {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
alias String
|
||||
issuer String
|
||||
subject String
|
||||
serialNumber String
|
||||
validFrom DateTime
|
||||
validTo DateTime
|
||||
p12DataEncrypted String @db.Text
|
||||
passwordEncrypted String
|
||||
isActive Boolean @default(true)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
@@map("digital_certificates")
|
||||
}
|
||||
|
||||
model DianResolution {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String? @db.Uuid
|
||||
resolutionNumber String
|
||||
prefix String
|
||||
fromNumber BigInt
|
||||
toNumber BigInt
|
||||
currentConsecutive BigInt
|
||||
technicalKey String
|
||||
startDate DateTime
|
||||
endDate DateTime
|
||||
isActive Boolean @default(true)
|
||||
documentType String @default("01") // 01: Factura, 91: NC, 92: ND
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
tenant Tenant? @relation(fields: [tenantId], references: [id])
|
||||
facturas Invoice[]
|
||||
|
||||
@@unique([prefix, resolutionNumber])
|
||||
@@map("dian_resolutions")
|
||||
}
|
||||
|
||||
model Invoice {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String @db.Uuid
|
||||
resolutionId String @db.Uuid
|
||||
prefix String
|
||||
consecutive BigInt
|
||||
fullNumber String @unique
|
||||
documentType String @default("01") // 01: Factura Venta, 91: NC, 92: ND
|
||||
issueDate DateTime
|
||||
issueTime String
|
||||
currency String @default("COP")
|
||||
operationType String @default("10")
|
||||
paymentType String @default("1") // 1 = Contado, 2 = Credito
|
||||
paymentMethodCode String @default("10") // 10 = Efectivo, 48 = Tarjeta, 31 = Transferencia
|
||||
paymentDueDate DateTime?
|
||||
subtotal Decimal @db.Decimal(14, 2)
|
||||
taxTotal Decimal @db.Decimal(14, 2)
|
||||
discountTotal Decimal @default(0) @db.Decimal(14, 2)
|
||||
grandTotal Decimal @db.Decimal(14, 2)
|
||||
cufe String? @unique
|
||||
qrContent String? @db.Text
|
||||
xmlSigned String? @db.Text
|
||||
xmlDianResponse String? @db.Text
|
||||
dianStatus String @default("PENDING") // PENDING, SIGNED, ACCEPTED, REJECTED, ERROR, CONTINGENCY
|
||||
dianStatusCode String?
|
||||
dianStatusDescription String? @db.Text
|
||||
dianTrackingKey String?
|
||||
dianReceivedDate DateTime?
|
||||
pdfUrl String?
|
||||
metadata Json?
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
tenant Tenant @relation(fields: [tenantId], references: [id])
|
||||
resolution DianResolution @relation(fields: [resolutionId], references: [id])
|
||||
customer InvoiceCustomer?
|
||||
items InvoiceItem[]
|
||||
auditLogs AuditLog[]
|
||||
|
||||
@@index([tenantId, dianStatus])
|
||||
@@index([issueDate])
|
||||
@@map("invoices")
|
||||
}
|
||||
|
||||
model InvoiceCustomer {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
invoiceId String @unique @db.Uuid
|
||||
identificationType String @default("13") // 13: CC, 31: NIT, 22: CE, 41: Pasaporte
|
||||
identificationNumber String
|
||||
dv String?
|
||||
legalOrFullName String
|
||||
tradeName String?
|
||||
email String
|
||||
phone String?
|
||||
address String
|
||||
departmentCode String @default("76")
|
||||
cityCode String @default("76001")
|
||||
cityName String @default("Cali")
|
||||
taxRegime String @default("49") // 48: Responsable IVA, 49: No responsable IVA
|
||||
invoice Invoice @relation(fields: [invoiceId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@map("invoice_customers")
|
||||
}
|
||||
|
||||
model InvoiceItem {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
invoiceId String @db.Uuid
|
||||
lineNumber Int
|
||||
sku String
|
||||
description String
|
||||
quantity Decimal @db.Decimal(12, 4)
|
||||
unitCode String @default("EA")
|
||||
unitPrice Decimal @db.Decimal(14, 2)
|
||||
totalCost Decimal @db.Decimal(14, 2)
|
||||
taxPercentage Decimal @default(19.00) @db.Decimal(5, 2)
|
||||
taxAmount Decimal @db.Decimal(14, 2)
|
||||
taxTypeCode String @default("01") // 01 = IVA, 04 = INC
|
||||
discountAmount Decimal @default(0) @db.Decimal(14, 2)
|
||||
invoice Invoice @relation(fields: [invoiceId], references: [id], onDelete: Cascade)
|
||||
|
||||
@@map("invoice_items")
|
||||
}
|
||||
|
||||
model AuditLog {
|
||||
id String @id @default(uuid()) @db.Uuid
|
||||
tenantId String? @db.Uuid
|
||||
invoiceId String? @db.Uuid
|
||||
action String
|
||||
details Json
|
||||
ipAddress String?
|
||||
userAgent String?
|
||||
createdAt DateTime @default(now())
|
||||
tenant Tenant? @relation(fields: [tenantId], references: [id])
|
||||
invoice Invoice? @relation(fields: [invoiceId], references: [id])
|
||||
|
||||
@@index([action, createdAt])
|
||||
@@map("audit_logs")
|
||||
}
|
||||
@ -0,0 +1,50 @@
|
||||
import { z } from 'zod';
|
||||
import {
|
||||
TipoIdentificacionTributaria,
|
||||
RegimenFiscal,
|
||||
TipoOperacionFiscal,
|
||||
FormaPago,
|
||||
MedioPagoDian,
|
||||
TipoTributo,
|
||||
} from '../../domain/value-objects/FiscalEnums.js';
|
||||
|
||||
export const ItemFacturaSchema = z.object({
|
||||
sku: z.string().min(1, 'El SKU es requerido'),
|
||||
description: z.string().min(1, 'La descripción es requerida'),
|
||||
quantity: z.number().positive('La cantidad debe ser mayor a 0'),
|
||||
unitCode: z.string().default('EA'),
|
||||
unitPrice: z.number().min(0, 'El precio unitario no puede ser negativo'),
|
||||
taxPercentage: z.number().default(19.0),
|
||||
taxTypeCode: z.nativeEnum(TipoTributo).default(TipoTributo.IVA),
|
||||
discountAmount: z.number().min(0).default(0),
|
||||
});
|
||||
|
||||
export const ClienteSchema = z.object({
|
||||
identificationType: z.nativeEnum(TipoIdentificacionTributaria).default(TipoIdentificacionTributaria.CEDULA_CIUDADANIA),
|
||||
identificationNumber: z.string().min(3, 'Número de identificación requerido'),
|
||||
dv: z.string().optional(),
|
||||
legalOrFullName: z.string().min(2, 'Nombre o razón social requerido'),
|
||||
tradeName: z.string().optional(),
|
||||
email: z.string().email('Correo electrónico inválido'),
|
||||
phone: z.string().optional(),
|
||||
address: z.string().min(1, 'Dirección requerida').default('Dirección Principal'),
|
||||
departmentCode: z.string().default('76'),
|
||||
cityCode: z.string().default('76001'),
|
||||
cityName: z.string().default('Cali'),
|
||||
taxRegime: z.nativeEnum(RegimenFiscal).default(RegimenFiscal.NO_RESPONSABLE_IVA),
|
||||
});
|
||||
|
||||
export const EmitirFacturaInputSchema = z.object({
|
||||
resolutionId: z.string().uuid().optional(), // Si no se envía, se toma la resolución activa del tenant
|
||||
operationType: z.nativeEnum(TipoOperacionFiscal).default(TipoOperacionFiscal.ESTANDAR),
|
||||
paymentType: z.nativeEnum(FormaPago).default(FormaPago.CONTADO),
|
||||
paymentMethodCode: z.nativeEnum(MedioPagoDian).default(MedioPagoDian.EFECTIVO),
|
||||
paymentDueDate: z.string().optional(), // YYYY-MM-DD
|
||||
customer: ClienteSchema,
|
||||
items: z.array(ItemFacturaSchema).min(1, 'Debe incluir al menos un ítem'),
|
||||
metadata: z.record(z.any()).optional(),
|
||||
});
|
||||
|
||||
export type EmitirFacturaInputDto = z.infer<typeof EmitirFacturaInputSchema>;
|
||||
export type ItemFacturaInputDto = z.infer<typeof ItemFacturaSchema>;
|
||||
export type ClienteInputDto = z.infer<typeof ClienteSchema>;
|
||||
@ -0,0 +1,95 @@
|
||||
import { Factura } from '../../domain/entities/Factura.js';
|
||||
|
||||
export interface FacturaResponseDto {
|
||||
id: string;
|
||||
tenantId: string;
|
||||
fullNumber: string;
|
||||
prefix: string;
|
||||
consecutive: string;
|
||||
documentType: string;
|
||||
issueDate: string;
|
||||
issueTime: string;
|
||||
currency: string;
|
||||
subtotal: number;
|
||||
taxTotal: number;
|
||||
discountTotal: number;
|
||||
grandTotal: number;
|
||||
cufe?: string;
|
||||
qrContent?: string;
|
||||
dianStatus: string;
|
||||
dianStatusCode?: string;
|
||||
dianStatusDescription?: string;
|
||||
dianTrackingKey?: string;
|
||||
customer: {
|
||||
identificationType: string;
|
||||
identificationNumber: string;
|
||||
dv?: string;
|
||||
legalOrFullName: string;
|
||||
email: string;
|
||||
phone?: string;
|
||||
address: string;
|
||||
cityName: string;
|
||||
};
|
||||
items: Array<{
|
||||
lineNumber: number;
|
||||
sku: string;
|
||||
description: string;
|
||||
quantity: number;
|
||||
unitPrice: number;
|
||||
taxPercentage: number;
|
||||
taxAmount: number;
|
||||
totalCost: number;
|
||||
}>;
|
||||
xmlSignedUrl?: string;
|
||||
pdfUrl?: string;
|
||||
createdAt?: string;
|
||||
}
|
||||
|
||||
export class FacturaMapper {
|
||||
public static toResponseDto(factura: Factura): FacturaResponseDto {
|
||||
return {
|
||||
id: factura.id || '',
|
||||
tenantId: factura.tenantId,
|
||||
fullNumber: factura.fullNumber,
|
||||
prefix: factura.prefix,
|
||||
consecutive: factura.consecutive.toString(),
|
||||
documentType: factura.documentType,
|
||||
issueDate: factura.issueDate.toISOString().split('T')[0],
|
||||
issueTime: factura.issueTime,
|
||||
currency: factura.currency,
|
||||
subtotal: factura.subtotal.amount,
|
||||
taxTotal: factura.taxTotal.amount,
|
||||
discountTotal: factura.discountTotal.amount,
|
||||
grandTotal: factura.grandTotal.amount,
|
||||
cufe: factura.cufe?.valor,
|
||||
qrContent: factura.qrContent,
|
||||
dianStatus: factura.dianStatus,
|
||||
dianStatusCode: factura.dianStatusCode,
|
||||
dianStatusDescription: factura.dianStatusDescription,
|
||||
dianTrackingKey: factura.dianTrackingKey,
|
||||
customer: {
|
||||
identificationType: factura.customer.identificationType,
|
||||
identificationNumber: factura.customer.identificationNumber,
|
||||
dv: factura.customer.dv,
|
||||
legalOrFullName: factura.customer.legalOrFullName,
|
||||
email: factura.customer.email,
|
||||
phone: factura.customer.phone,
|
||||
address: factura.customer.address,
|
||||
cityName: factura.customer.cityName,
|
||||
},
|
||||
items: factura.items.map((it) => ({
|
||||
lineNumber: it.lineNumber,
|
||||
sku: it.sku,
|
||||
description: it.description,
|
||||
quantity: it.quantity,
|
||||
unitPrice: it.unitPrice.amount,
|
||||
taxPercentage: it.taxPercentage,
|
||||
taxAmount: it.taxAmount.amount,
|
||||
totalCost: it.totalCost.amount,
|
||||
})),
|
||||
xmlSignedUrl: `/api/v1/invoices/${factura.id}/xml`,
|
||||
pdfUrl: `/api/v1/invoices/${factura.id}/pdf`,
|
||||
createdAt: factura.createdAt?.toISOString(),
|
||||
};
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,257 @@
|
||||
import { Factura } from '../../domain/entities/Factura.js';
|
||||
import { ResolucionDian } from '../../domain/entities/ResolucionDian.js';
|
||||
import { SoftwareSecurityCode } from '../../domain/value-objects/SoftwareSecurityCode.js';
|
||||
|
||||
export interface ParametrosEmisorUbl {
|
||||
nit: string;
|
||||
dv: string;
|
||||
legalName: string;
|
||||
tradeName: string;
|
||||
taxRegime: string;
|
||||
fiscalResponsibility: string;
|
||||
address: string;
|
||||
departmentCode: string;
|
||||
cityCode: string;
|
||||
cityName: string;
|
||||
email: string;
|
||||
phone: string;
|
||||
softwareId: string;
|
||||
softwarePin: string;
|
||||
dianEnvironment: string; // 'HABILITACION' o 'PRODUCCION'
|
||||
}
|
||||
|
||||
export class DianUblBuilderService {
|
||||
/**
|
||||
* Construye el documento XML UBL 2.1 completo según las especificaciones
|
||||
* de la Resolución DIAN 000165 de 2023.
|
||||
*/
|
||||
public static construirXmlFactura(
|
||||
factura: Factura,
|
||||
resolucion: ResolucionDian,
|
||||
emisor: ParametrosEmisorUbl,
|
||||
cufe: string,
|
||||
qrContent: string
|
||||
): string {
|
||||
const environmentId = emisor.dianEnvironment === 'PRODUCCION' ? '1' : '2';
|
||||
const issueDateStr = factura.issueDate.toISOString().split('T')[0];
|
||||
const securityCode = SoftwareSecurityCode.generar(
|
||||
emisor.softwareId,
|
||||
emisor.softwarePin,
|
||||
factura.fullNumber
|
||||
).hash;
|
||||
|
||||
const fechaInicioRes = resolucion.startDate.toISOString().split('T')[0];
|
||||
const fechaFinRes = resolucion.endDate.toISOString().split('T')[0];
|
||||
|
||||
// Construcción de líneas UBL
|
||||
const linesXml = factura.items
|
||||
.map((item) => {
|
||||
return `
|
||||
<cac:InvoiceLine>
|
||||
<cbc:ID>${item.lineNumber}</cbc:ID>
|
||||
<cbc:InvoicedQuantity unitCode="${item.unitCode}">${item.quantity.toFixed(4)}</cbc:InvoicedQuantity>
|
||||
<cbc:LineExtensionAmount currencyID="COP">${item.totalCost.toDianString()}</cbc:LineExtensionAmount>
|
||||
<cac:PricingReference>
|
||||
<cac:AlternativeConditionPrice>
|
||||
<cbc:PriceAmount currencyID="COP">${item.unitPrice.toDianString()}</cbc:PriceAmount>
|
||||
<cbc:PriceTypeCode>01</cbc:PriceTypeCode>
|
||||
</cac:AlternativeConditionPrice>
|
||||
</cac:PricingReference>
|
||||
<cac:TaxTotal>
|
||||
<cbc:TaxAmount currencyID="COP">${item.taxAmount.toDianString()}</cbc:TaxAmount>
|
||||
<cac:TaxSubtotal>
|
||||
<cbc:TaxableAmount currencyID="COP">${item.subtotalNeto.toDianString()}</cbc:TaxableAmount>
|
||||
<cbc:TaxAmount currencyID="COP">${item.taxAmount.toDianString()}</cbc:TaxAmount>
|
||||
<cac:TaxCategory>
|
||||
<cbc:Percent>${item.taxPercentage.toFixed(2)}</cbc:Percent>
|
||||
<cac:TaxScheme>
|
||||
<cbc:ID>${item.taxTypeCode}</cbc:ID>
|
||||
<cbc:Name>IVA</cbc:Name>
|
||||
</cac:TaxScheme>
|
||||
</cac:TaxCategory>
|
||||
</cac:TaxSubtotal>
|
||||
</cac:TaxTotal>
|
||||
<cac:Item>
|
||||
<cbc:Description><![CDATA[${item.description}]]></cbc:Description>
|
||||
<cac:StandardItemIdentification>
|
||||
<cbc:ID schemeID="999">${item.sku}</cbc:ID>
|
||||
</cac:StandardItemIdentification>
|
||||
</cac:Item>
|
||||
<cac:Price>
|
||||
<cbc:PriceAmount currencyID="COP">${item.unitPrice.toDianString()}</cbc:PriceAmount>
|
||||
<cbc:BaseQuantity unitCode="${item.unitCode}">1.0000</cbc:BaseQuantity>
|
||||
</cac:Price>
|
||||
</cac:InvoiceLine>`;
|
||||
})
|
||||
.join('\n');
|
||||
|
||||
const customerDvAttr = factura.customer.dv ? ` schemeID="${factura.customer.dv}"` : '';
|
||||
const paymentDueDateXml = factura.paymentDueDate
|
||||
? `<cbc:PaymentDueDate>${factura.paymentDueDate.toISOString().split('T')[0]}</cbc:PaymentDueDate>`
|
||||
: '';
|
||||
|
||||
return `<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
|
||||
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
|
||||
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
|
||||
xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
|
||||
xmlns:ext="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2"
|
||||
xmlns:sts="dian:gov:co:facturaelectronica:Structures-2-1"
|
||||
xmlns:xades="http://uri.etsi.org/01903/v1.3.2#"
|
||||
xmlns:xades141="http://uri.etsi.org/01903/v1.4.1#"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
|
||||
<ext:UBLExtensions>
|
||||
<ext:UBLExtension>
|
||||
<ext:ExtensionContent>
|
||||
<sts:DianExtensions>
|
||||
<sts:InvoiceControl>
|
||||
<sts:InvoiceAuthorization>${resolucion.resolutionNumber}</sts:InvoiceAuthorization>
|
||||
<sts:AuthorizationPeriod>
|
||||
<cbc:StartDate>${fechaInicioRes}</cbc:StartDate>
|
||||
<cbc:EndDate>${fechaFinRes}</cbc:EndDate>
|
||||
</sts:AuthorizationPeriod>
|
||||
<sts:AuthorizedInvoices>
|
||||
<sts:Prefix>${resolucion.prefix}</sts:Prefix>
|
||||
<sts:From>${resolucion.fromNumber}</sts:From>
|
||||
<sts:To>${resolucion.toNumber}</sts:To>
|
||||
</sts:AuthorizedInvoices>
|
||||
</sts:InvoiceControl>
|
||||
<sts:InvoiceSource>
|
||||
<cbc:IdentificationCode listAgencyID="6" listAgencyName="United Nations Economic Commission for Europe" listSchemeURI="urn:oasis:names:specification:ubl:codelist:gc:CountryIdentificationCode-2.1">CO</cbc:IdentificationCode>
|
||||
</sts:InvoiceSource>
|
||||
<sts:SoftwareProvider>
|
||||
<sts:ProviderID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)" schemeID="${emisor.dv}" schemeName="31">${emisor.nit}</sts:ProviderID>
|
||||
<sts:SoftwareID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">${emisor.softwareId}</sts:SoftwareID>
|
||||
</sts:SoftwareProvider>
|
||||
<sts:SoftwareSecurityCode schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">${securityCode}</sts:SoftwareSecurityCode>
|
||||
<sts:AuthorizationProvider>
|
||||
<sts:AuthorizationProviderID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)" schemeID="4" schemeName="31">800197268</sts:AuthorizationProviderID>
|
||||
</sts:AuthorizationProvider>
|
||||
<sts:QRCode><![CDATA[${qrContent}]]></sts:QRCode>
|
||||
</sts:DianExtensions>
|
||||
</ext:ExtensionContent>
|
||||
</ext:UBLExtension>
|
||||
<ext:UBLExtension>
|
||||
<ext:ExtensionContent>
|
||||
<!-- SIGNATURE_PLACEHOLDER -->
|
||||
</ext:ExtensionContent>
|
||||
</ext:UBLExtension>
|
||||
</ext:UBLExtensions>
|
||||
<cbc:UBLVersionID>UBL 2.1</cbc:UBLVersionID>
|
||||
<cbc:CustomizationID>10</cbc:CustomizationID>
|
||||
<cbc:ProfileID>DIAN 2.1: Factura Electrónica de Venta</cbc:ProfileID>
|
||||
<cbc:ProfileExecutionID>${environmentId}</cbc:ProfileExecutionID>
|
||||
<cbc:ID>${factura.fullNumber}</cbc:ID>
|
||||
<cbc:UUID schemeID="${environmentId}" schemeName="CUFE-SHA384">${cufe}</cbc:UUID>
|
||||
<cbc:IssueDate>${issueDateStr}</cbc:IssueDate>
|
||||
<cbc:IssueTime>${factura.issueTime}</cbc:IssueTime>
|
||||
<cbc:InvoiceTypeCode>${factura.documentType}</cbc:InvoiceTypeCode>
|
||||
<cbc:DocumentCurrencyCode listAgencyID="6" listAgencyName="United Nations Economic Commission for Europe" listID="ISO 4217 Alpha">COP</cbc:DocumentCurrencyCode>
|
||||
<cbc:LineCountNumeric>${factura.items.length}</cbc:LineCountNumeric>
|
||||
<cac:AccountingSupplierParty>
|
||||
<cbc:AdditionalAccountID>1</cbc:AdditionalAccountID>
|
||||
<cac:Party>
|
||||
<cac:PartyName>
|
||||
<cbc:Name><![CDATA[${emisor.tradeName}]]></cbc:Name>
|
||||
</cac:PartyName>
|
||||
<cac:PhysicalLocation>
|
||||
<cac:Address>
|
||||
<cbc:ID>${emisor.cityCode}</cbc:ID>
|
||||
<cbc:CityName><![CDATA[${emisor.cityName}]]></cbc:CityName>
|
||||
<cbc:CountrySubentity><![CDATA[Valle del Cauca]]></cbc:CountrySubentity>
|
||||
<cbc:CountrySubentityCode>${emisor.departmentCode}</cbc:CountrySubentityCode>
|
||||
<cac:AddressLine>
|
||||
<cbc:Line><![CDATA[${emisor.address}]]></cbc:Line>
|
||||
</cac:AddressLine>
|
||||
<cac:Country>
|
||||
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
|
||||
<cbc:Name languageID="es">Colombia</cbc:Name>
|
||||
</cac:Country>
|
||||
</cac:Address>
|
||||
</cac:PhysicalLocation>
|
||||
<cac:PartyTaxScheme>
|
||||
<cbc:RegistrationName><![CDATA[${emisor.legalName}]]></cbc:RegistrationName>
|
||||
<cbc:CompanyID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)" schemeID="${emisor.dv}" schemeName="31">${emisor.nit}</cbc:CompanyID>
|
||||
<cbc:TaxLevelCode listName="48">${emisor.fiscalResponsibility}</cbc:TaxLevelCode>
|
||||
<cac:RegistrationAddress>
|
||||
<cbc:ID>${emisor.cityCode}</cbc:ID>
|
||||
<cbc:CityName><![CDATA[${emisor.cityName}]]></cbc:CityName>
|
||||
<cac:Country>
|
||||
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
|
||||
<cbc:Name languageID="es">Colombia</cbc:Name>
|
||||
</cac:Country>
|
||||
</cac:RegistrationAddress>
|
||||
<cac:TaxScheme>
|
||||
<cbc:ID>01</cbc:ID>
|
||||
<cbc:Name>IVA</cbc:Name>
|
||||
</cac:TaxScheme>
|
||||
</cac:PartyTaxScheme>
|
||||
<cac:Contact>
|
||||
<cbc:Telephone>${emisor.phone}</cbc:Telephone>
|
||||
<cbc:ElectronicMail>${emisor.email}</cbc:ElectronicMail>
|
||||
</cac:Contact>
|
||||
</cac:Party>
|
||||
</cac:AccountingSupplierParty>
|
||||
<cac:AccountingCustomerParty>
|
||||
<cbc:AdditionalAccountID>2</cbc:AdditionalAccountID>
|
||||
<cac:Party>
|
||||
<cac:PartyName>
|
||||
<cbc:Name><![CDATA[${factura.customer.legalOrFullName}]]></cbc:Name>
|
||||
</cac:PartyName>
|
||||
<cac:PhysicalLocation>
|
||||
<cac:Address>
|
||||
<cbc:ID>${factura.customer.cityCode}</cbc:ID>
|
||||
<cbc:CityName><![CDATA[${factura.customer.cityName}]]></cbc:CityName>
|
||||
<cac:AddressLine>
|
||||
<cbc:Line><![CDATA[${factura.customer.address}]]></cbc:Line>
|
||||
</cac:AddressLine>
|
||||
<cac:Country>
|
||||
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
|
||||
<cbc:Name languageID="es">Colombia</cbc:Name>
|
||||
</cac:Country>
|
||||
</cac:Address>
|
||||
</cac:PhysicalLocation>
|
||||
<cac:PartyTaxScheme>
|
||||
<cbc:RegistrationName><![CDATA[${factura.customer.legalOrFullName}]]></cbc:RegistrationName>
|
||||
<cbc:CompanyID schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)"${customerDvAttr} schemeName="${factura.customer.identificationType}">${factura.customer.identificationNumber}</cbc:CompanyID>
|
||||
<cbc:TaxLevelCode listName="${factura.customer.taxRegime}">R-99-PN</cbc:TaxLevelCode>
|
||||
<cac:TaxScheme>
|
||||
<cbc:ID>01</cbc:ID>
|
||||
<cbc:Name>IVA</cbc:Name>
|
||||
</cac:TaxScheme>
|
||||
</cac:PartyTaxScheme>
|
||||
<cac:Contact>
|
||||
<cbc:Telephone>${factura.customer.phone || '0'}</cbc:Telephone>
|
||||
<cbc:ElectronicMail>${factura.customer.email}</cbc:ElectronicMail>
|
||||
</cac:Contact>
|
||||
</cac:Party>
|
||||
</cac:AccountingCustomerParty>
|
||||
<cac:PaymentMeans>
|
||||
<cbc:ID>${factura.paymentType}</cbc:ID>
|
||||
<cbc:PaymentMeansCode>${factura.paymentMethodCode}</cbc:PaymentMeansCode>
|
||||
${paymentDueDateXml}
|
||||
</cac:PaymentMeans>
|
||||
<cac:TaxTotal>
|
||||
<cbc:TaxAmount currencyID="COP">${factura.taxTotal.toDianString()}</cbc:TaxAmount>
|
||||
<cac:TaxSubtotal>
|
||||
<cbc:TaxableAmount currencyID="COP">${factura.subtotal.subtract(factura.discountTotal).toDianString()}</cbc:TaxableAmount>
|
||||
<cbc:TaxAmount currencyID="COP">${factura.taxTotal.toDianString()}</cbc:TaxAmount>
|
||||
<cac:TaxCategory>
|
||||
<cac:TaxScheme>
|
||||
<cbc:ID>01</cbc:ID>
|
||||
<cbc:Name>IVA</cbc:Name>
|
||||
</cac:TaxScheme>
|
||||
</cac:TaxCategory>
|
||||
</cac:TaxSubtotal>
|
||||
</cac:TaxTotal>
|
||||
<cac:LegalMonetaryTotal>
|
||||
<cbc:LineExtensionAmount currencyID="COP">${factura.subtotal.toDianString()}</cbc:LineExtensionAmount>
|
||||
<cbc:TaxExclusiveAmount currencyID="COP">${factura.subtotal.subtract(factura.discountTotal).toDianString()}</cbc:TaxExclusiveAmount>
|
||||
<cbc:TaxInclusiveAmount currencyID="COP">${factura.grandTotal.toDianString()}</cbc:TaxInclusiveAmount>
|
||||
<cbc:AllowanceTotalAmount currencyID="COP">${factura.discountTotal.toDianString()}</cbc:AllowanceTotalAmount>
|
||||
<cbc:PayableAmount currencyID="COP">${factura.grandTotal.toDianString()}</cbc:PayableAmount>
|
||||
</cac:LegalMonetaryTotal>
|
||||
${linesXml}
|
||||
</Invoice>`.trim();
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,77 @@
|
||||
import { IFacturaRepository, FiltrosFactura, MetricasFiscales } from '../../domain/ports/IFacturaRepository.js';
|
||||
import { IResolucionRepository } from '../../domain/ports/IResolucionRepository.js';
|
||||
import { IPdfGenerator, DatosEmisor } from '../../domain/ports/IPdfGenerator.js';
|
||||
import { IQrGenerator } from '../../domain/ports/IDianClient.js';
|
||||
import { FacturaResponseDto, FacturaMapper } from '../dtos/FacturaResponseDto.js';
|
||||
import { ValidacionFiscalException } from '../../domain/exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export class ConsultarFacturasUseCase {
|
||||
constructor(
|
||||
private readonly facturaRepository: IFacturaRepository,
|
||||
private readonly resolucionRepository: IResolucionRepository,
|
||||
private readonly qrGenerator: IQrGenerator,
|
||||
private readonly pdfGenerator: IPdfGenerator
|
||||
) {}
|
||||
|
||||
public async listar(filtros: FiltrosFactura): Promise<{ items: FacturaResponseDto[]; total: number }> {
|
||||
const { items, total } = await this.facturaRepository.listar(filtros);
|
||||
return {
|
||||
items: items.map((f) => FacturaMapper.toResponseDto(f)),
|
||||
total,
|
||||
};
|
||||
}
|
||||
|
||||
public async obtenerPorId(id: string): Promise<FacturaResponseDto> {
|
||||
const factura = await this.facturaRepository.buscarPorId(id);
|
||||
if (!factura) {
|
||||
throw new ValidacionFiscalException(`Factura con ID "${id}" no encontrada.`, 'NOT_FOUND');
|
||||
}
|
||||
return FacturaMapper.toResponseDto(factura);
|
||||
}
|
||||
|
||||
public async obtenerXmlFirmado(id: string): Promise<string> {
|
||||
const factura = await this.facturaRepository.buscarPorId(id);
|
||||
if (!factura) {
|
||||
throw new ValidacionFiscalException(`Factura con ID "${id}" no encontrada.`, 'NOT_FOUND');
|
||||
}
|
||||
if (!factura.xmlSigned) {
|
||||
throw new ValidacionFiscalException(`La factura "${factura.fullNumber}" no contiene un XML firmado.`);
|
||||
}
|
||||
return factura.xmlSigned;
|
||||
}
|
||||
|
||||
public async generarPdf(id: string): Promise<Buffer> {
|
||||
const factura = await this.facturaRepository.buscarPorId(id);
|
||||
if (!factura) {
|
||||
throw new ValidacionFiscalException(`Factura con ID "${id}" no encontrada.`, 'NOT_FOUND');
|
||||
}
|
||||
|
||||
const resolucion = await this.resolucionRepository.buscarPorId(factura.resolutionId);
|
||||
const qrUrl = factura.qrContent || `https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=${factura.cufe?.valor || ''}`;
|
||||
const qrDataUrl = await this.qrGenerator.generarDataUrl(qrUrl);
|
||||
|
||||
const emisor: DatosEmisor = {
|
||||
nit: '901554892',
|
||||
dv: '9',
|
||||
razonSocial: 'INNOVACION & DESARROLLO S.A.S.',
|
||||
nombreComercial: 'INNOVACION & DESARROLLO S.A.S.',
|
||||
direccion: 'Avenida Colombia # 12-45 Edificio Empresarial',
|
||||
ciudad: 'Cali',
|
||||
departamento: 'Valle del Cauca',
|
||||
telefono: '+57 (2) 555-0199',
|
||||
email: 'facturacion@innovacionydesarrollo.co',
|
||||
regimenFiscal: 'Responsable de IVA (48)',
|
||||
responsabilidadesFiscales: 'O-13,O-15,O-23,O-47',
|
||||
resolucionNumero: resolucion?.resolutionNumber || '18764000001',
|
||||
resolucionFecha: resolucion?.startDate.toISOString().split('T')[0] || '2026-01-01',
|
||||
resolucionRango: resolucion ? `${resolucion.prefix} ${resolucion.fromNumber} al ${resolucion.toNumber}` : 'DRIP 1 al 50000',
|
||||
resolucionVigencia: resolucion ? `${resolucion.startDate.toISOString().split('T')[0]} a ${resolucion.endDate.toISOString().split('T')[0]}` : '2026-01-01 a 2027-12-31',
|
||||
};
|
||||
|
||||
return await this.pdfGenerator.generarFacturaPdf(factura, qrDataUrl, emisor);
|
||||
}
|
||||
|
||||
public async obtenerMetricas(tenantId?: string): Promise<MetricasFiscales> {
|
||||
return await this.facturaRepository.obtenerMetricas(tenantId);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,217 @@
|
||||
import { IFacturaRepository } from '../../domain/ports/IFacturaRepository.js';
|
||||
import { ITenantRepository } from '../../domain/ports/ITenantRepository.js';
|
||||
import { IResolucionRepository } from '../../domain/ports/IResolucionRepository.js';
|
||||
import { IDianClient, IXmlSigner, IQrGenerator } from '../../domain/ports/IDianClient.js';
|
||||
import { IPdfGenerator, DatosEmisor } from '../../domain/ports/IPdfGenerator.js';
|
||||
import { Factura } from '../../domain/entities/Factura.js';
|
||||
import { Cliente } from '../../domain/entities/Cliente.js';
|
||||
import { ItemFactura } from '../../domain/entities/ItemFactura.js';
|
||||
import { Cufe } from '../../domain/value-objects/Cufe.js';
|
||||
import {
|
||||
TipoDocumentoFiscal,
|
||||
TipoOperacionFiscal,
|
||||
FormaPago,
|
||||
MedioPagoDian,
|
||||
TipoIdentificacionTributaria,
|
||||
RegimenFiscal,
|
||||
TipoTributo,
|
||||
} from '../../domain/value-objects/FiscalEnums.js';
|
||||
import { ValidacionFiscalException } from '../../domain/exceptions/ValidacionFiscalException.js';
|
||||
import { EmitirFacturaInputDto } from '../dtos/EmitirFacturaInputDto.js';
|
||||
import { FacturaResponseDto, FacturaMapper } from '../dtos/FacturaResponseDto.js';
|
||||
import { DianUblBuilderService } from '../services/DianUblBuilderService.js';
|
||||
|
||||
export interface EmitirFacturaContext {
|
||||
tenantId: string;
|
||||
}
|
||||
|
||||
export class EmitirFacturaUseCase {
|
||||
constructor(
|
||||
private readonly facturaRepository: IFacturaRepository,
|
||||
private readonly tenantRepository: ITenantRepository,
|
||||
private readonly resolucionRepository: IResolucionRepository,
|
||||
private readonly dianClient: IDianClient,
|
||||
private readonly xmlSigner: IXmlSigner,
|
||||
private readonly qrGenerator: IQrGenerator,
|
||||
private readonly pdfGenerator: IPdfGenerator
|
||||
) {}
|
||||
|
||||
public async ejecutar(
|
||||
input: EmitirFacturaInputDto,
|
||||
context: EmitirFacturaContext
|
||||
): Promise<FacturaResponseDto> {
|
||||
// 1. Validar Tenant emisor
|
||||
const tenant = await this.tenantRepository.buscarPorId(context.tenantId);
|
||||
if (!tenant) {
|
||||
throw new ValidacionFiscalException(`El tenant con ID "${context.tenantId}" no está registrado en el sistema.`);
|
||||
}
|
||||
if (!tenant.isActivo) {
|
||||
throw new ValidacionFiscalException(`El tenant "${tenant.name}" se encuentra suspendido para emisión fiscal.`);
|
||||
}
|
||||
|
||||
// 2. Obtener y bloquear siguiente consecutivo de la resolución DIAN
|
||||
let resolucion;
|
||||
if (input.resolutionId) {
|
||||
resolucion = await this.resolucionRepository.buscarPorId(input.resolutionId);
|
||||
} else {
|
||||
resolucion = await this.resolucionRepository.buscarActivaParaTenant(
|
||||
tenant.id!,
|
||||
TipoDocumentoFiscal.FACTURA_VENTA
|
||||
);
|
||||
}
|
||||
|
||||
if (!resolucion) {
|
||||
throw new ValidacionFiscalException(
|
||||
`No se encontró una resolución de facturación activa y vigente para el tenant "${tenant.name}".`
|
||||
);
|
||||
}
|
||||
|
||||
const { consecutivo, resolucion: resActualizada } =
|
||||
await this.resolucionRepository.obtenerYBloquearSiguienteConsecutivo(resolucion.id!);
|
||||
|
||||
// 3. Construir Entidades de Dominio
|
||||
const cliente = new Cliente({
|
||||
identificationType: input.customer.identificationType as TipoIdentificacionTributaria,
|
||||
identificationNumber: input.customer.identificationNumber,
|
||||
dv: input.customer.dv,
|
||||
legalOrFullName: input.customer.legalOrFullName,
|
||||
tradeName: input.customer.tradeName,
|
||||
email: input.customer.email,
|
||||
phone: input.customer.phone,
|
||||
address: input.customer.address,
|
||||
departmentCode: input.customer.departmentCode,
|
||||
cityCode: input.customer.cityCode,
|
||||
cityName: input.customer.cityName,
|
||||
taxRegime: input.customer.taxRegime as RegimenFiscal,
|
||||
});
|
||||
|
||||
const items = input.items.map((it, idx) => {
|
||||
return new ItemFactura({
|
||||
lineNumber: idx + 1,
|
||||
sku: it.sku,
|
||||
description: it.description,
|
||||
quantity: it.quantity,
|
||||
unitCode: it.unitCode,
|
||||
unitPrice: it.unitPrice,
|
||||
taxPercentage: it.taxPercentage,
|
||||
taxTypeCode: it.taxTypeCode as TipoTributo,
|
||||
discountAmount: it.discountAmount,
|
||||
});
|
||||
});
|
||||
|
||||
const factura = new Factura({
|
||||
id: crypto.randomUUID(),
|
||||
tenantId: tenant.id!,
|
||||
resolutionId: resActualizada.id!,
|
||||
prefix: resActualizada.prefix,
|
||||
consecutive: consecutivo,
|
||||
documentType: TipoDocumentoFiscal.FACTURA_VENTA,
|
||||
operationType: input.operationType as TipoOperacionFiscal,
|
||||
paymentType: input.paymentType as FormaPago,
|
||||
paymentMethodCode: input.paymentMethodCode as MedioPagoDian,
|
||||
paymentDueDate: input.paymentDueDate ? new Date(input.paymentDueDate) : undefined,
|
||||
customer: cliente,
|
||||
items,
|
||||
metadata: input.metadata,
|
||||
});
|
||||
|
||||
// 4. Parámetros del Emisor Central ("Innovación & Desarrollo S.A.S.")
|
||||
const emisorConfig = {
|
||||
nit: '901554892',
|
||||
dv: '9',
|
||||
legalName: 'INNOVACION & DESARROLLO S.A.S.',
|
||||
tradeName: 'INNOVACION & DESARROLLO S.A.S.',
|
||||
taxRegime: '48',
|
||||
fiscalResponsibility: 'O-13,O-15,O-23,O-47',
|
||||
address: 'Avenida Colombia # 12-45 Edificio Empresarial',
|
||||
departmentCode: '76',
|
||||
cityCode: '76001',
|
||||
cityName: 'Cali',
|
||||
email: 'facturacion@innovacionydesarrollo.co',
|
||||
phone: '+57 (2) 555-0199',
|
||||
softwareId: process.env.DIAN_SOFTWARE_ID || 'd5e07b47-6aea-43cc-b38c-3c7d46b4a52f',
|
||||
softwarePin: process.env.DIAN_SOFTWARE_PIN || '75319',
|
||||
dianEnvironment: process.env.DIAN_ENVIRONMENT || 'HABILITACION',
|
||||
};
|
||||
|
||||
const ambienteCode = emisorConfig.dianEnvironment === 'PRODUCCION' ? '1' : '2';
|
||||
|
||||
// 5. Cálculo Oficial de CUFE (SHA-384)
|
||||
const issueDateStr = factura.issueDate.toISOString().split('T')[0];
|
||||
const cufe = Cufe.generar({
|
||||
numFac: factura.fullNumber,
|
||||
fecFac: issueDateStr,
|
||||
horFac: factura.issueTime,
|
||||
valFac: factura.subtotal.amount,
|
||||
codImp1: '01',
|
||||
valImp1: factura.taxTotal.amount,
|
||||
codImp2: '04',
|
||||
valImp2: 0,
|
||||
codImp3: '03',
|
||||
valImp3: 0,
|
||||
valTot: factura.grandTotal.amount,
|
||||
nitOFE: emisorConfig.nit,
|
||||
numAdq: factura.customer.identificationNumber,
|
||||
claveTecnica: resActualizada.technicalKey,
|
||||
tipoAmbiente: ambienteCode,
|
||||
});
|
||||
|
||||
const qrUrl = `https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=${cufe.valor}`;
|
||||
factura.asignarCufe(cufe, qrUrl);
|
||||
|
||||
// 6. Generación del XML UBL 2.1
|
||||
const xmlRaw = DianUblBuilderService.construirXmlFactura(
|
||||
factura,
|
||||
resActualizada,
|
||||
emisorConfig,
|
||||
cufe.valor,
|
||||
qrUrl
|
||||
);
|
||||
|
||||
// 7. Firma Digital XAdES-BES
|
||||
const xmlFirmado = await this.xmlSigner.firmarXadesBes(xmlRaw);
|
||||
factura.asignarFirmaXml(xmlFirmado);
|
||||
|
||||
// 8. Transmisión a la DIAN (VPFE)
|
||||
const respuestaDian = await this.dianClient.enviarDocumentoSincronico(
|
||||
xmlFirmado,
|
||||
`face_${factura.fullNumber}`
|
||||
);
|
||||
|
||||
factura.registrarRespuestaDian(
|
||||
respuestaDian.estado,
|
||||
respuestaDian.codigoRespuesta,
|
||||
respuestaDian.descripcion,
|
||||
respuestaDian.xmlRespuestaDian,
|
||||
respuestaDian.trackId
|
||||
);
|
||||
|
||||
// 9. Generación de QR DataURL y Representación Gráfica PDF
|
||||
const qrDataUrl = await this.qrGenerator.generarDataUrl(qrUrl);
|
||||
const datosEmisorPdf: DatosEmisor = {
|
||||
nit: emisorConfig.nit,
|
||||
dv: emisorConfig.dv,
|
||||
razonSocial: emisorConfig.legalName,
|
||||
nombreComercial: emisorConfig.tradeName,
|
||||
direccion: emisorConfig.address,
|
||||
ciudad: emisorConfig.cityName,
|
||||
departamento: 'Valle del Cauca',
|
||||
telefono: emisorConfig.phone,
|
||||
email: emisorConfig.email,
|
||||
regimenFiscal: 'Responsable de IVA (48)',
|
||||
responsabilidadesFiscales: emisorConfig.fiscalResponsibility,
|
||||
resolucionNumero: resActualizada.resolutionNumber,
|
||||
resolucionFecha: resActualizada.startDate.toISOString().split('T')[0],
|
||||
resolucionRango: `${resActualizada.prefix} ${resActualizada.fromNumber} al ${resActualizada.toNumber}`,
|
||||
resolucionVigencia: `${resActualizada.startDate.toISOString().split('T')[0]} a ${resActualizada.endDate.toISOString().split('T')[0]}`,
|
||||
};
|
||||
|
||||
// Almacenar ruta virtual del PDF
|
||||
factura.setPdfUrl(`/api/v1/invoices/${factura.id}/pdf`);
|
||||
|
||||
// 10. Persistir en Base de Datos
|
||||
await this.facturaRepository.guardar(factura);
|
||||
|
||||
return FacturaMapper.toResponseDto(factura);
|
||||
}
|
||||
}
|
||||
72
facturacion-dian-hub/backend/src/domain/entities/Cliente.ts
Normal file
72
facturacion-dian-hub/backend/src/domain/entities/Cliente.ts
Normal file
@ -0,0 +1,72 @@
|
||||
import {
|
||||
TipoIdentificacionTributaria,
|
||||
RegimenFiscal,
|
||||
} from '../value-objects/FiscalEnums.js';
|
||||
import { Nit } from '../value-objects/Nit.js';
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export interface ClienteProps {
|
||||
id?: string;
|
||||
identificationType: TipoIdentificacionTributaria;
|
||||
identificationNumber: string;
|
||||
dv?: string;
|
||||
legalOrFullName: string;
|
||||
tradeName?: string;
|
||||
email: string;
|
||||
phone?: string;
|
||||
address: string;
|
||||
departmentCode?: string;
|
||||
cityCode?: string;
|
||||
cityName?: string;
|
||||
taxRegime?: RegimenFiscal;
|
||||
}
|
||||
|
||||
export class Cliente {
|
||||
public readonly id?: string;
|
||||
public readonly identificationType: TipoIdentificacionTributaria;
|
||||
public readonly identificationNumber: string;
|
||||
public readonly dv?: string;
|
||||
public readonly legalOrFullName: string;
|
||||
public readonly tradeName?: string;
|
||||
public readonly email: string;
|
||||
public readonly phone?: string;
|
||||
public readonly address: string;
|
||||
public readonly departmentCode: string;
|
||||
public readonly cityCode: string;
|
||||
public readonly cityName: string;
|
||||
public readonly taxRegime: RegimenFiscal;
|
||||
|
||||
constructor(props: ClienteProps) {
|
||||
if (!props.identificationNumber || props.identificationNumber.trim() === '') {
|
||||
throw new ValidacionFiscalException('El número de identificación del adquiriente es obligatorio.');
|
||||
}
|
||||
if (!props.legalOrFullName || props.legalOrFullName.trim() === '') {
|
||||
throw new ValidacionFiscalException('El nombre o razón social del adquiriente es obligatorio.');
|
||||
}
|
||||
if (!props.email || !props.email.includes('@')) {
|
||||
throw new ValidacionFiscalException(`El correo electrónico fiscal "${props.email}" no es válido.`);
|
||||
}
|
||||
|
||||
this.id = props.id;
|
||||
this.identificationType = props.identificationType;
|
||||
this.identificationNumber = props.identificationNumber.trim();
|
||||
|
||||
// Si es NIT, validar o calcular DV
|
||||
if (this.identificationType === TipoIdentificacionTributaria.NIT) {
|
||||
const nitObj = new Nit(this.identificationNumber, props.dv);
|
||||
this.dv = nitObj.dv;
|
||||
} else {
|
||||
this.dv = props.dv;
|
||||
}
|
||||
|
||||
this.legalOrFullName = props.legalOrFullName.trim();
|
||||
this.tradeName = props.tradeName?.trim();
|
||||
this.email = props.email.trim().toLowerCase();
|
||||
this.phone = props.phone?.trim();
|
||||
this.address = props.address?.trim() || 'Dirección Principal';
|
||||
this.departmentCode = props.departmentCode || '76'; // Valle del Cauca
|
||||
this.cityCode = props.cityCode || '76001'; // Cali
|
||||
this.cityName = props.cityName || 'Cali';
|
||||
this.taxRegime = props.taxRegime || RegimenFiscal.NO_RESPONSABLE_IVA;
|
||||
}
|
||||
}
|
||||
217
facturacion-dian-hub/backend/src/domain/entities/Factura.ts
Normal file
217
facturacion-dian-hub/backend/src/domain/entities/Factura.ts
Normal file
@ -0,0 +1,217 @@
|
||||
import {
|
||||
TipoDocumentoFiscal,
|
||||
TipoOperacionFiscal,
|
||||
FormaPago,
|
||||
MedioPagoDian,
|
||||
EstadoFacturaDian,
|
||||
} from '../value-objects/FiscalEnums.js';
|
||||
import { Money } from '../value-objects/Money.js';
|
||||
import { Cufe } from '../value-objects/Cufe.js';
|
||||
import { Cliente } from './Cliente.js';
|
||||
import { ItemFactura } from './ItemFactura.js';
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export interface FacturaProps {
|
||||
id?: string;
|
||||
tenantId: string;
|
||||
resolutionId: string;
|
||||
prefix: string;
|
||||
consecutive: bigint;
|
||||
documentType?: TipoDocumentoFiscal;
|
||||
issueDate?: Date;
|
||||
issueTime?: string;
|
||||
currency?: string;
|
||||
operationType?: TipoOperacionFiscal;
|
||||
paymentType?: FormaPago;
|
||||
paymentMethodCode?: MedioPagoDian;
|
||||
paymentDueDate?: Date;
|
||||
customer: Cliente;
|
||||
items: ItemFactura[];
|
||||
cufe?: Cufe;
|
||||
qrContent?: string;
|
||||
xmlSigned?: string;
|
||||
xmlDianResponse?: string;
|
||||
dianStatus?: EstadoFacturaDian;
|
||||
dianStatusCode?: string;
|
||||
dianStatusDescription?: string;
|
||||
dianTrackingKey?: string;
|
||||
dianReceivedDate?: Date;
|
||||
pdfUrl?: string;
|
||||
metadata?: Record<string, unknown>;
|
||||
createdAt?: Date;
|
||||
updatedAt?: Date;
|
||||
}
|
||||
|
||||
export class Factura {
|
||||
public readonly id?: string;
|
||||
public readonly tenantId: string;
|
||||
public readonly resolutionId: string;
|
||||
public readonly prefix: string;
|
||||
public readonly consecutive: bigint;
|
||||
public readonly fullNumber: string;
|
||||
public readonly documentType: TipoDocumentoFiscal;
|
||||
public readonly issueDate: Date;
|
||||
public readonly issueTime: string;
|
||||
public readonly currency: string;
|
||||
public readonly operationType: TipoOperacionFiscal;
|
||||
public readonly paymentType: FormaPago;
|
||||
public readonly paymentMethodCode: MedioPagoDian;
|
||||
public readonly paymentDueDate?: Date;
|
||||
public readonly customer: Cliente;
|
||||
public readonly items: ItemFactura[];
|
||||
|
||||
public readonly subtotal: Money;
|
||||
public readonly taxTotal: Money;
|
||||
public readonly discountTotal: Money;
|
||||
public readonly grandTotal: Money;
|
||||
|
||||
private _cufe?: Cufe;
|
||||
private _qrContent?: string;
|
||||
private _xmlSigned?: string;
|
||||
private _xmlDianResponse?: string;
|
||||
private _dianStatus: EstadoFacturaDian;
|
||||
private _dianStatusCode?: string;
|
||||
private _dianStatusDescription?: string;
|
||||
private _dianTrackingKey?: string;
|
||||
private _dianReceivedDate?: Date;
|
||||
private _pdfUrl?: string;
|
||||
public readonly metadata?: Record<string, unknown>;
|
||||
public readonly createdAt?: Date;
|
||||
public readonly updatedAt?: Date;
|
||||
|
||||
constructor(props: FacturaProps) {
|
||||
if (!props.items || props.items.length === 0) {
|
||||
throw new ValidacionFiscalException('La factura debe contener al menos una línea de detalle (item).');
|
||||
}
|
||||
|
||||
this.id = props.id;
|
||||
this.tenantId = props.tenantId;
|
||||
this.resolutionId = props.resolutionId;
|
||||
this.prefix = props.prefix.trim().toUpperCase();
|
||||
this.consecutive = BigInt(props.consecutive);
|
||||
this.fullNumber = this.prefix ? `${this.prefix}-${this.consecutive}` : `${this.consecutive}`;
|
||||
this.documentType = props.documentType || TipoDocumentoFiscal.FACTURA_VENTA;
|
||||
this.issueDate = props.issueDate || new Date();
|
||||
|
||||
// Formato de hora estándar DIAN COT: HH:mm:ss-05:00
|
||||
this.issueTime = props.issueTime || Factura.generarHoraDian(this.issueDate);
|
||||
this.currency = props.currency || 'COP';
|
||||
this.operationType = props.operationType || TipoOperacionFiscal.ESTANDAR;
|
||||
this.paymentType = props.paymentType || FormaPago.CONTADO;
|
||||
this.paymentMethodCode = props.paymentMethodCode || MedioPagoDian.EFECTIVO;
|
||||
this.paymentDueDate = props.paymentDueDate;
|
||||
this.customer = props.customer;
|
||||
this.items = [...props.items];
|
||||
this.metadata = props.metadata;
|
||||
this.createdAt = props.createdAt;
|
||||
this.updatedAt = props.updatedAt;
|
||||
|
||||
// Calcular totales agregados
|
||||
let sumSubtotal = Money.zero();
|
||||
let sumTaxes = Money.zero();
|
||||
let sumDiscounts = Money.zero();
|
||||
|
||||
for (const item of this.items) {
|
||||
sumSubtotal = sumSubtotal.add(item.totalCost);
|
||||
sumTaxes = sumTaxes.add(item.taxAmount);
|
||||
sumDiscounts = sumDiscounts.add(item.discountAmount);
|
||||
}
|
||||
|
||||
this.subtotal = sumSubtotal;
|
||||
this.taxTotal = sumTaxes;
|
||||
this.discountTotal = sumDiscounts;
|
||||
// Total a pagar = (Subtotal - Descuentos) + Impuestos
|
||||
this.grandTotal = this.subtotal.subtract(this.discountTotal).add(this.taxTotal);
|
||||
|
||||
this._cufe = props.cufe;
|
||||
this._qrContent = props.qrContent;
|
||||
this._xmlSigned = props.xmlSigned;
|
||||
this._xmlDianResponse = props.xmlDianResponse;
|
||||
this._dianStatus = props.dianStatus || EstadoFacturaDian.BORRADOR;
|
||||
this._dianStatusCode = props.dianStatusCode;
|
||||
this._dianStatusDescription = props.dianStatusDescription;
|
||||
this._dianTrackingKey = props.dianTrackingKey;
|
||||
this._dianReceivedDate = props.dianReceivedDate;
|
||||
this._pdfUrl = props.pdfUrl;
|
||||
}
|
||||
|
||||
public static generarHoraDian(date: Date = new Date()): string {
|
||||
const pad = (n: number) => n.toString().padStart(2, '0');
|
||||
const h = pad(date.getHours());
|
||||
const m = pad(date.getMinutes());
|
||||
const s = pad(date.getSeconds());
|
||||
return `${h}:${m}:${s}-05:00`;
|
||||
}
|
||||
|
||||
public asignarCufe(cufe: Cufe, qrContent: string): void {
|
||||
this._cufe = cufe;
|
||||
this._qrContent = qrContent;
|
||||
}
|
||||
|
||||
public asignarFirmaXml(xmlFirmado: string): void {
|
||||
if (!xmlFirmado || xmlFirmado.trim() === '') {
|
||||
throw new ValidacionFiscalException('El XML firmado no puede estar vacío.');
|
||||
}
|
||||
this._xmlSigned = xmlFirmado;
|
||||
this._dianStatus = EstadoFacturaDian.FIRMADA;
|
||||
}
|
||||
|
||||
public registrarRespuestaDian(
|
||||
estado: EstadoFacturaDian,
|
||||
codigoRespuesta: string,
|
||||
descripcion: string,
|
||||
xmlRespuesta?: string,
|
||||
trackingKey?: string
|
||||
): void {
|
||||
this._dianStatus = estado;
|
||||
this._dianStatusCode = codigoRespuesta;
|
||||
this._dianStatusDescription = descripcion;
|
||||
this._xmlDianResponse = xmlRespuesta;
|
||||
this._dianTrackingKey = trackingKey;
|
||||
this._dianReceivedDate = new Date();
|
||||
}
|
||||
|
||||
public setPdfUrl(url: string): void {
|
||||
this._pdfUrl = url;
|
||||
}
|
||||
|
||||
public get cufe(): Cufe | undefined {
|
||||
return this._cufe;
|
||||
}
|
||||
|
||||
public get qrContent(): string | undefined {
|
||||
return this._qrContent;
|
||||
}
|
||||
|
||||
public get xmlSigned(): string | undefined {
|
||||
return this._xmlSigned;
|
||||
}
|
||||
|
||||
public get xmlDianResponse(): string | undefined {
|
||||
return this._xmlDianResponse;
|
||||
}
|
||||
|
||||
public get dianStatus(): EstadoFacturaDian {
|
||||
return this._dianStatus;
|
||||
}
|
||||
|
||||
public get dianStatusCode(): string | undefined {
|
||||
return this._dianStatusCode;
|
||||
}
|
||||
|
||||
public get dianStatusDescription(): string | undefined {
|
||||
return this._dianStatusDescription;
|
||||
}
|
||||
|
||||
public get dianTrackingKey(): string | undefined {
|
||||
return this._dianTrackingKey;
|
||||
}
|
||||
|
||||
public get dianReceivedDate(): Date | undefined {
|
||||
return this._dianReceivedDate;
|
||||
}
|
||||
|
||||
public get pdfUrl(): string | undefined {
|
||||
return this._pdfUrl;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,67 @@
|
||||
import { Money } from '../value-objects/Money.js';
|
||||
import { TipoTributo } from '../value-objects/FiscalEnums.js';
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export interface ItemFacturaProps {
|
||||
id?: string;
|
||||
lineNumber: number;
|
||||
sku: string;
|
||||
description: string;
|
||||
quantity: number;
|
||||
unitCode?: string;
|
||||
unitPrice: number;
|
||||
taxPercentage?: number;
|
||||
taxTypeCode?: TipoTributo;
|
||||
discountAmount?: number;
|
||||
}
|
||||
|
||||
export class ItemFactura {
|
||||
public readonly id?: string;
|
||||
public readonly lineNumber: number;
|
||||
public readonly sku: string;
|
||||
public readonly description: string;
|
||||
public readonly quantity: number;
|
||||
public readonly unitCode: string;
|
||||
public readonly unitPrice: Money;
|
||||
public readonly totalCost: Money;
|
||||
public readonly taxPercentage: number;
|
||||
public readonly taxAmount: Money;
|
||||
public readonly taxTypeCode: TipoTributo;
|
||||
public readonly discountAmount: Money;
|
||||
|
||||
constructor(props: ItemFacturaProps) {
|
||||
if (props.quantity <= 0) {
|
||||
throw new ValidacionFiscalException(`La cantidad del item ${props.sku} debe ser mayor a 0.`);
|
||||
}
|
||||
if (props.unitPrice < 0) {
|
||||
throw new ValidacionFiscalException(`El precio unitario del item ${props.sku} no puede ser negativo.`);
|
||||
}
|
||||
|
||||
this.id = props.id;
|
||||
this.lineNumber = props.lineNumber;
|
||||
this.sku = props.sku.trim();
|
||||
this.description = props.description.trim();
|
||||
this.quantity = props.quantity;
|
||||
this.unitCode = props.unitCode || 'EA'; // EA: Cada / Unidad
|
||||
this.unitPrice = Money.from(props.unitPrice);
|
||||
|
||||
// Subtotal línea = cantidad * precio unitario
|
||||
this.totalCost = this.unitPrice.multiply(this.quantity);
|
||||
|
||||
this.discountAmount = Money.from(props.discountAmount || 0);
|
||||
this.taxPercentage = props.taxPercentage ?? 19.0;
|
||||
this.taxTypeCode = props.taxTypeCode || TipoTributo.IVA;
|
||||
|
||||
// Base imponible = totalCost - discountAmount
|
||||
const baseImponible = this.totalCost.subtract(this.discountAmount);
|
||||
this.taxAmount = baseImponible.calculateTax(this.taxPercentage);
|
||||
}
|
||||
|
||||
public get subtotalNeto(): Money {
|
||||
return this.totalCost.subtract(this.discountAmount);
|
||||
}
|
||||
|
||||
public get totalConImpuesto(): Money {
|
||||
return this.subtotalNeto.add(this.taxAmount);
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,102 @@
|
||||
import { TipoDocumentoFiscal } from '../value-objects/FiscalEnums.js';
|
||||
import { ResolucionAgotadaException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export interface ResolucionDianProps {
|
||||
id?: string;
|
||||
tenantId?: string;
|
||||
resolutionNumber: string;
|
||||
prefix: string;
|
||||
fromNumber: bigint;
|
||||
toNumber: bigint;
|
||||
currentConsecutive: bigint;
|
||||
technicalKey: string;
|
||||
startDate: Date;
|
||||
endDate: Date;
|
||||
isActive?: boolean;
|
||||
documentType?: TipoDocumentoFiscal;
|
||||
}
|
||||
|
||||
export class ResolucionDian {
|
||||
public readonly id?: string;
|
||||
public readonly tenantId?: string;
|
||||
public readonly resolutionNumber: string;
|
||||
public readonly prefix: string;
|
||||
public readonly fromNumber: bigint;
|
||||
public readonly toNumber: bigint;
|
||||
private _currentConsecutive: bigint;
|
||||
public readonly technicalKey: string;
|
||||
public readonly startDate: Date;
|
||||
public readonly endDate: Date;
|
||||
public readonly isActive: boolean;
|
||||
public readonly documentType: TipoDocumentoFiscal;
|
||||
|
||||
constructor(props: ResolucionDianProps) {
|
||||
this.id = props.id;
|
||||
this.tenantId = props.tenantId;
|
||||
this.resolutionNumber = props.resolutionNumber.trim();
|
||||
this.prefix = props.prefix.trim().toUpperCase();
|
||||
this.fromNumber = BigInt(props.fromNumber);
|
||||
this.toNumber = BigInt(props.toNumber);
|
||||
this._currentConsecutive = BigInt(props.currentConsecutive);
|
||||
this.technicalKey = props.technicalKey.trim();
|
||||
this.startDate = props.startDate;
|
||||
this.endDate = props.endDate;
|
||||
this.isActive = props.isActive ?? true;
|
||||
this.documentType = props.documentType || TipoDocumentoFiscal.FACTURA_VENTA;
|
||||
|
||||
this.validarInvariantes();
|
||||
}
|
||||
|
||||
private validarInvariantes(): void {
|
||||
if (this.fromNumber > this.toNumber) {
|
||||
throw new Error('El rango inicial no puede ser mayor que el rango final de la resolución.');
|
||||
}
|
||||
}
|
||||
|
||||
public get currentConsecutive(): bigint {
|
||||
return this._currentConsecutive;
|
||||
}
|
||||
|
||||
public estaVigente(fechaReferencia: Date = new Date()): boolean {
|
||||
if (!this.isActive) return false;
|
||||
return fechaReferencia >= this.startDate && fechaReferencia <= this.endDate;
|
||||
}
|
||||
|
||||
public tieneNumerosDisponibles(): boolean {
|
||||
return this._currentConsecutive < this.toNumber;
|
||||
}
|
||||
|
||||
public obtenerSiguienteConsecutivo(): bigint {
|
||||
if (!this.estaVigente()) {
|
||||
throw new ResolucionAgotadaException(
|
||||
`La resolución ${this.resolutionNumber} (Prefijo: ${this.prefix}) ha expirado o se encuentra inactiva.`
|
||||
);
|
||||
}
|
||||
|
||||
if (!this.tieneNumerosDisponibles()) {
|
||||
throw new ResolucionAgotadaException(
|
||||
`Rango de numeración agotado para la resolución ${this.resolutionNumber} (Prefijo: ${this.prefix}). Rango límite: ${this.toNumber}`
|
||||
);
|
||||
}
|
||||
|
||||
this._currentConsecutive += 1n;
|
||||
return this._currentConsecutive;
|
||||
}
|
||||
|
||||
public formatearNumeroCompleto(consecutivo: bigint): string {
|
||||
return this.prefix ? `${this.prefix}-${consecutivo}` : `${consecutivo}`;
|
||||
}
|
||||
|
||||
public porcentajeConsumido(): number {
|
||||
const total = Number(this.toNumber - this.fromNumber + 1n);
|
||||
if (total <= 0) return 100;
|
||||
const usados = Number(this._currentConsecutive - this.fromNumber + 1n);
|
||||
const porcentaje = Math.min(100, Math.max(0, (usados / total) * 100));
|
||||
return Math.round(porcentaje * 10) / 10;
|
||||
}
|
||||
|
||||
public diasRestantesVigencia(ahora: Date = new Date()): number {
|
||||
const diffMs = this.endDate.getTime() - ahora.getTime();
|
||||
return Math.max(0, Math.ceil(diffMs / (1000 * 60 * 60 * 24)));
|
||||
}
|
||||
}
|
||||
53
facturacion-dian-hub/backend/src/domain/entities/Tenant.ts
Normal file
53
facturacion-dian-hub/backend/src/domain/entities/Tenant.ts
Normal file
@ -0,0 +1,53 @@
|
||||
import { createHash } from 'node:crypto';
|
||||
|
||||
export interface TenantProps {
|
||||
id?: string;
|
||||
name: string;
|
||||
slug: string;
|
||||
apiKeyHash: string;
|
||||
status?: string;
|
||||
economicActivityCode?: string;
|
||||
contactEmail: string;
|
||||
webhookUrl?: string;
|
||||
createdAt?: Date;
|
||||
updatedAt?: Date;
|
||||
}
|
||||
|
||||
export class Tenant {
|
||||
public readonly id?: string;
|
||||
public readonly name: string;
|
||||
public readonly slug: string;
|
||||
public readonly apiKeyHash: string;
|
||||
public readonly status: string;
|
||||
public readonly economicActivityCode?: string;
|
||||
public readonly contactEmail: string;
|
||||
public readonly webhookUrl?: string;
|
||||
public readonly createdAt?: Date;
|
||||
public readonly updatedAt?: Date;
|
||||
|
||||
constructor(props: TenantProps) {
|
||||
this.id = props.id;
|
||||
this.name = props.name.trim();
|
||||
this.slug = props.slug.trim().toLowerCase();
|
||||
this.apiKeyHash = props.apiKeyHash;
|
||||
this.status = props.status || 'ACTIVE';
|
||||
this.economicActivityCode = props.economicActivityCode;
|
||||
this.contactEmail = props.contactEmail.trim().toLowerCase();
|
||||
this.webhookUrl = props.webhookUrl?.trim();
|
||||
this.createdAt = props.createdAt;
|
||||
this.updatedAt = props.updatedAt;
|
||||
}
|
||||
|
||||
public static hashApiKey(rawApiKey: string): string {
|
||||
return createHash('sha256').update(rawApiKey.trim()).digest('hex');
|
||||
}
|
||||
|
||||
public verifyApiKey(rawApiKey: string): boolean {
|
||||
const hash = Tenant.hashApiKey(rawApiKey);
|
||||
return this.apiKeyHash === hash;
|
||||
}
|
||||
|
||||
public get isActivo(): boolean {
|
||||
return this.status === 'ACTIVE';
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,39 @@
|
||||
export abstract class DomainException extends Error {
|
||||
public readonly statusCode: number;
|
||||
public readonly code: string;
|
||||
|
||||
constructor(message: string, statusCode: number = 400, code: string = 'DOMAIN_ERROR') {
|
||||
super(message);
|
||||
this.name = this.constructor.name;
|
||||
this.statusCode = statusCode;
|
||||
this.code = code;
|
||||
Object.setPrototypeOf(this, new.target.prototype);
|
||||
}
|
||||
}
|
||||
|
||||
export class ValidacionFiscalException extends DomainException {
|
||||
constructor(message: string, code: string = 'FISCAL_VALIDATION_ERROR') {
|
||||
super(message, 422, code);
|
||||
}
|
||||
}
|
||||
|
||||
export class ResolucionAgotadaException extends DomainException {
|
||||
constructor(message: string) {
|
||||
super(message, 409, 'RESOLUTION_EXHAUSTED_OR_EXPIRED');
|
||||
}
|
||||
}
|
||||
|
||||
export class FirmaDigitalException extends DomainException {
|
||||
constructor(message: string) {
|
||||
super(message, 500, 'DIGITAL_SIGNATURE_ERROR');
|
||||
}
|
||||
}
|
||||
|
||||
export class DianRechazoException extends DomainException {
|
||||
public readonly dianErrors: Array<{ code: string; message: string }>;
|
||||
|
||||
constructor(message: string, errors: Array<{ code: string; message: string }> = []) {
|
||||
super(message, 400, 'DIAN_DOCUMENT_REJECTED');
|
||||
this.dianErrors = errors;
|
||||
}
|
||||
}
|
||||
30
facturacion-dian-hub/backend/src/domain/ports/IDianClient.ts
Normal file
30
facturacion-dian-hub/backend/src/domain/ports/IDianClient.ts
Normal file
@ -0,0 +1,30 @@
|
||||
import { EstadoFacturaDian } from '../value-objects/FiscalEnums.js';
|
||||
|
||||
export interface DianNotificacionRegla {
|
||||
codigo: string;
|
||||
mensaje: string;
|
||||
}
|
||||
|
||||
export interface RespuestaEnvioDian {
|
||||
esValido: boolean;
|
||||
estado: EstadoFacturaDian;
|
||||
codigoRespuesta: string;
|
||||
descripcion: string;
|
||||
trackId?: string;
|
||||
xmlRespuestaDian?: string;
|
||||
notificaciones: DianNotificacionRegla[];
|
||||
}
|
||||
|
||||
export interface IDianClient {
|
||||
enviarDocumentoSincronico(xmlFirmado: string, nombreArchivo: string): Promise<RespuestaEnvioDian>;
|
||||
consultarEstadoDocumento(trackId: string): Promise<RespuestaEnvioDian>;
|
||||
}
|
||||
|
||||
export interface IXmlSigner {
|
||||
firmarXadesBes(xmlRaw: string, p12Buffer?: Buffer, contrasenaP12?: string): Promise<string>;
|
||||
}
|
||||
|
||||
export interface IQrGenerator {
|
||||
generarDataUrl(contenido: string): Promise<string>;
|
||||
generarSvg(contenido: string): Promise<string>;
|
||||
}
|
||||
@ -0,0 +1,31 @@
|
||||
import { Factura } from '../entities/Factura.js';
|
||||
import { EstadoFacturaDian } from '../value-objects/FiscalEnums.js';
|
||||
|
||||
export interface FiltrosFactura {
|
||||
tenantId?: string;
|
||||
estado?: EstadoFacturaDian;
|
||||
fechaInicio?: Date;
|
||||
fechaFin?: Date;
|
||||
busqueda?: string;
|
||||
pagina?: number;
|
||||
limite?: number;
|
||||
}
|
||||
|
||||
export interface MetricasFiscales {
|
||||
totalFacturado: number;
|
||||
totalDocumentos: number;
|
||||
aceptadasDian: number;
|
||||
rechazadasDian: number;
|
||||
pendientesDian: number;
|
||||
totalIvaRecaudado: number;
|
||||
}
|
||||
|
||||
export interface IFacturaRepository {
|
||||
guardar(factura: Factura): Promise<Factura>;
|
||||
actualizar(factura: Factura): Promise<Factura>;
|
||||
buscarPorId(id: string): Promise<Factura | null>;
|
||||
buscarPorNumero(fullNumber: string): Promise<Factura | null>;
|
||||
buscarPorCufe(cufe: string): Promise<Factura | null>;
|
||||
listar(filtros: FiltrosFactura): Promise<{ items: Factura[]; total: number }>;
|
||||
obtenerMetricas(tenantId?: string): Promise<MetricasFiscales>;
|
||||
}
|
||||
@ -0,0 +1,23 @@
|
||||
import { Factura } from '../entities/Factura.js';
|
||||
|
||||
export interface DatosEmisor {
|
||||
nit: string;
|
||||
dv: string;
|
||||
razonSocial: string;
|
||||
nombreComercial: string;
|
||||
direccion: string;
|
||||
ciudad: string;
|
||||
departamento: string;
|
||||
telefono: string;
|
||||
email: string;
|
||||
regimenFiscal: string;
|
||||
responsabilidadesFiscales: string;
|
||||
resolucionNumero: string;
|
||||
resolucionFecha: string;
|
||||
resolucionRango: string;
|
||||
resolucionVigencia: string;
|
||||
}
|
||||
|
||||
export interface IPdfGenerator {
|
||||
generarFacturaPdf(factura: Factura, qrDataUrl: string, emisor: DatosEmisor): Promise<Buffer>;
|
||||
}
|
||||
@ -0,0 +1,10 @@
|
||||
import { ResolucionDian } from '../entities/ResolucionDian.js';
|
||||
import { TipoDocumentoFiscal } from '../value-objects/FiscalEnums.js';
|
||||
|
||||
export interface IResolucionRepository {
|
||||
buscarPorId(id: string): Promise<ResolucionDian | null>;
|
||||
buscarActivaParaTenant(tenantId: string, tipoDocumento: TipoDocumentoFiscal): Promise<ResolucionDian | null>;
|
||||
obtenerYBloquearSiguienteConsecutivo(resolucionId: string): Promise<{ consecutivo: bigint; resolucion: ResolucionDian }>;
|
||||
listar(): Promise<ResolucionDian[]>;
|
||||
guardar(resolucion: ResolucionDian): Promise<ResolucionDian>;
|
||||
}
|
||||
@ -0,0 +1,10 @@
|
||||
import { Tenant } from '../entities/Tenant.js';
|
||||
|
||||
export interface ITenantRepository {
|
||||
buscarPorId(id: string): Promise<Tenant | null>;
|
||||
buscarPorSlug(slug: string): Promise<Tenant | null>;
|
||||
buscarPorApiKeyHash(hash: string): Promise<Tenant | null>;
|
||||
listar(): Promise<Tenant[]>;
|
||||
guardar(tenant: Tenant): Promise<Tenant>;
|
||||
actualizar(tenant: Tenant): Promise<Tenant>;
|
||||
}
|
||||
142
facturacion-dian-hub/backend/src/domain/value-objects/Cufe.ts
Normal file
142
facturacion-dian-hub/backend/src/domain/value-objects/Cufe.ts
Normal file
@ -0,0 +1,142 @@
|
||||
import { createHash } from 'node:crypto';
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export interface ParametrosCalculoCufe {
|
||||
numFac: string; // Número de factura con prefijo (ej: DRIP1001)
|
||||
fecFac: string; // Fecha YYYY-MM-DD
|
||||
horFac: string; // Hora HH:mm:ss-05:00
|
||||
valFac: number; // Subtotal sin impuestos
|
||||
codImp1?: string; // '01' (IVA)
|
||||
valImp1?: number; // Valor IVA
|
||||
codImp2?: string; // '04' (INC)
|
||||
valImp2?: number; // Valor INC
|
||||
codImp3?: string; // '03' (ICA)
|
||||
valImp3?: number; // Valor ICA
|
||||
valTot: number; // Valor Total
|
||||
nitOFE: string; // NIT Emisor (sin DV)
|
||||
numAdq: string; // Documento Adquiriente (sin DV)
|
||||
claveTecnica: string; // Clave técnica DIAN
|
||||
tipoAmbiente: string; // '1' (Producción) o '2' (Habilitación)
|
||||
}
|
||||
|
||||
export interface ParametrosCalculoCude {
|
||||
numDoc: string; // Número de nota con prefijo (ej: NC101)
|
||||
fecDoc: string; // Fecha YYYY-MM-DD
|
||||
horDoc: string; // Hora HH:mm:ss-05:00
|
||||
valDoc: number; // Subtotal sin impuestos
|
||||
codImp1?: string; // '01' (IVA)
|
||||
valImp1?: number;
|
||||
codImp2?: string; // '04'
|
||||
valImp2?: number;
|
||||
codImp3?: string; // '03'
|
||||
valImp3?: number;
|
||||
valTot: number;
|
||||
nitOFE: string;
|
||||
numAdq: string;
|
||||
pinSoftware: string; // PIN de 5 dígitos del software
|
||||
tipoAmbiente: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Value Object para CUFE (Código Único de Factura Electrónica)
|
||||
* y CUDE (Código Único de Documento Electrónico)
|
||||
* Implementa el estándar SHA-384 estipulado en la Resolución DIAN 000165 de 2023.
|
||||
*/
|
||||
export class Cufe {
|
||||
private readonly _valor: string;
|
||||
private readonly _cadenaOrigen: string;
|
||||
|
||||
private constructor(valor: string, cadenaOrigen: string) {
|
||||
if (!valor || valor.length !== 96) {
|
||||
throw new ValidacionFiscalException(
|
||||
`El CUFE/CUDE generado es inválido. Debe ser una cadena SHA-384 de 96 caracteres hexadecimales. Longitud recibida: ${valor?.length}`
|
||||
);
|
||||
}
|
||||
this._valor = valor;
|
||||
this._cadenaOrigen = cadenaOrigen;
|
||||
}
|
||||
|
||||
public static generar(params: ParametrosCalculoCufe): Cufe {
|
||||
const formatNumber = (val: number): string => Number(val || 0).toFixed(2);
|
||||
|
||||
const cod1 = params.codImp1 || '01';
|
||||
const val1 = formatNumber(params.valImp1 || 0);
|
||||
|
||||
const cod2 = params.codImp2 || '04';
|
||||
const val2 = formatNumber(params.valImp2 || 0);
|
||||
|
||||
const cod3 = params.codImp3 || '03';
|
||||
const val3 = formatNumber(params.valImp3 || 0);
|
||||
|
||||
const cadena = [
|
||||
params.numFac.trim(),
|
||||
params.fecFac.trim(),
|
||||
params.horFac.trim(),
|
||||
formatNumber(params.valFac),
|
||||
cod1,
|
||||
val1,
|
||||
cod2,
|
||||
val2,
|
||||
cod3,
|
||||
val3,
|
||||
formatNumber(params.valTot),
|
||||
params.nitOFE.replace(/\D/g, ''),
|
||||
params.numAdq.replace(/\D/g, ''),
|
||||
params.claveTecnica.trim(),
|
||||
params.tipoAmbiente.trim(),
|
||||
].join('');
|
||||
|
||||
const hash = createHash('sha384').update(cadena, 'utf8').digest('hex');
|
||||
return new Cufe(hash, cadena);
|
||||
}
|
||||
|
||||
public static generarCude(params: ParametrosCalculoCude): Cufe {
|
||||
const formatNumber = (val: number): string => Number(val || 0).toFixed(2);
|
||||
|
||||
const cod1 = params.codImp1 || '01';
|
||||
const val1 = formatNumber(params.valImp1 || 0);
|
||||
|
||||
const cod2 = params.codImp2 || '04';
|
||||
const val2 = formatNumber(params.valImp2 || 0);
|
||||
|
||||
const cod3 = params.codImp3 || '03';
|
||||
const val3 = formatNumber(params.valImp3 || 0);
|
||||
|
||||
const cadena = [
|
||||
params.numDoc.trim(),
|
||||
params.fecDoc.trim(),
|
||||
params.horDoc.trim(),
|
||||
formatNumber(params.valDoc),
|
||||
cod1,
|
||||
val1,
|
||||
cod2,
|
||||
val2,
|
||||
cod3,
|
||||
val3,
|
||||
formatNumber(params.valTot),
|
||||
params.nitOFE.replace(/\D/g, ''),
|
||||
params.numAdq.replace(/\D/g, ''),
|
||||
params.pinSoftware.trim(),
|
||||
params.tipoAmbiente.trim(),
|
||||
].join('');
|
||||
|
||||
const hash = createHash('sha384').update(cadena, 'utf8').digest('hex');
|
||||
return new Cufe(hash, cadena);
|
||||
}
|
||||
|
||||
public static desdeCadena(valor: string): Cufe {
|
||||
return new Cufe(valor.trim().toLowerCase(), '');
|
||||
}
|
||||
|
||||
public get valor(): string {
|
||||
return this._valor;
|
||||
}
|
||||
|
||||
public get cadenaOrigen(): string {
|
||||
return this._cadenaOrigen;
|
||||
}
|
||||
|
||||
public toString(): string {
|
||||
return this._valor;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,77 @@
|
||||
/**
|
||||
* Enums del Sistema Fiscal Colombiano DIAN UBL 2.1
|
||||
* Resolucion 000165 de 2023 y Anexos Tecnicos Vigentes
|
||||
*/
|
||||
|
||||
export enum TipoDocumentoFiscal {
|
||||
FACTURA_VENTA = '01',
|
||||
FACTURA_EXPORTACION = '02',
|
||||
FACTURA_CONTINGENCIA_DIAN = '03',
|
||||
FACTURA_CONTINGENCIA_EMISOR = '04',
|
||||
NOTA_CREDITO = '91',
|
||||
NOTA_DEBITO = '92',
|
||||
}
|
||||
|
||||
export enum TipoOperacionFiscal {
|
||||
ESTANDAR = '10',
|
||||
SERVICIOS_AIU = '11',
|
||||
MANDATOS = '12',
|
||||
TRANSPORTE = '13',
|
||||
}
|
||||
|
||||
export enum TipoAmbienteDian {
|
||||
HABILITACION = '2', // Ambiente de Pruebas / Habilitación
|
||||
PRODUCCION = '1', // Ambiente de Producción
|
||||
}
|
||||
|
||||
export enum TipoIdentificacionTributaria {
|
||||
REGISTRO_CIVIL = '11',
|
||||
TARJETA_IDENTIDAD = '12',
|
||||
CEDULA_CIUDADANIA = '13',
|
||||
TARJETA_EXTRANJERIA = '21',
|
||||
CEDULA_EXTRANJERIA = '22',
|
||||
NIT = '31',
|
||||
PASAPORTE = '41',
|
||||
DOCUMENTO_EXTRANJERO = '42',
|
||||
PEP = '47',
|
||||
}
|
||||
|
||||
export enum RegimenFiscal {
|
||||
RESPONSABLE_IVA = '48',
|
||||
NO_RESPONSABLE_IVA = '49',
|
||||
}
|
||||
|
||||
export enum TipoTributo {
|
||||
IVA = '01',
|
||||
IC = '02', // Impuesto al Consumo Departamental
|
||||
ICA = '03',
|
||||
INC = '04', // Impuesto Nacional al Consumo
|
||||
RETE_IVA = '05',
|
||||
RETE_RENTA = '06',
|
||||
RETE_ICA = '07',
|
||||
}
|
||||
|
||||
export enum FormaPago {
|
||||
CONTADO = '1',
|
||||
CREDITO = '2',
|
||||
}
|
||||
|
||||
export enum MedioPagoDian {
|
||||
EFECTIVO = '10',
|
||||
TRANSFERENCIA_DEBITO = '31',
|
||||
CONSIGNACION_BANCARIA = '42',
|
||||
TARJETA_CREDITO = '48',
|
||||
TARJETA_DEBITO = '49',
|
||||
MUTUO_ACUERDO = 'ZZZ',
|
||||
}
|
||||
|
||||
export enum EstadoFacturaDian {
|
||||
BORRADOR = 'BORRADOR',
|
||||
FIRMADA = 'FIRMADA',
|
||||
ENVIADA = 'ENVIADA',
|
||||
ACEPTADA = 'ACEPTADA',
|
||||
ACEPTADA_CON_NOTIFICACION = 'ACEPTADA_CON_NOTIFICACION',
|
||||
RECHAZADA = 'RECHAZADA',
|
||||
ERROR_TRANSMISION = 'ERROR_TRANSMISION',
|
||||
CONTINGENCIA = 'CONTINGENCIA',
|
||||
}
|
||||
@ -0,0 +1,62 @@
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
/**
|
||||
* Value Object para el manejo inmutable de montos monetarios en COP
|
||||
* Garantiza redondeo y consistencia decimal según normatividad fiscal DIAN.
|
||||
*/
|
||||
export class Money {
|
||||
private readonly _amount: number;
|
||||
|
||||
private constructor(amount: number) {
|
||||
if (isNaN(amount) || !isFinite(amount)) {
|
||||
throw new ValidacionFiscalException('El monto monetario no es un número válido.');
|
||||
}
|
||||
// Redondear a 2 decimales para evitar problemas de coma flotante
|
||||
this._amount = Math.round((amount + Number.EPSILON) * 100) / 100;
|
||||
}
|
||||
|
||||
public static from(amount: number | string): Money {
|
||||
const num = typeof amount === 'string' ? parseFloat(amount) : amount;
|
||||
return new Money(num);
|
||||
}
|
||||
|
||||
public static zero(): Money {
|
||||
return new Money(0);
|
||||
}
|
||||
|
||||
public get amount(): number {
|
||||
return this._amount;
|
||||
}
|
||||
|
||||
public add(other: Money): Money {
|
||||
return new Money(this._amount + other._amount);
|
||||
}
|
||||
|
||||
public subtract(other: Money): Money {
|
||||
return new Money(this._amount - other._amount);
|
||||
}
|
||||
|
||||
public multiply(factor: number): Money {
|
||||
return new Money(this._amount * factor);
|
||||
}
|
||||
|
||||
public calculateTax(percentage: number): Money {
|
||||
return new Money((this._amount * percentage) / 100);
|
||||
}
|
||||
|
||||
public toDianString(): string {
|
||||
return this._amount.toFixed(2);
|
||||
}
|
||||
|
||||
public toCurrencyString(): string {
|
||||
return new Intl.NumberFormat('es-CO', {
|
||||
style: 'currency',
|
||||
currency: 'COP',
|
||||
minimumFractionDigits: 2,
|
||||
}).format(this._amount);
|
||||
}
|
||||
|
||||
public equals(other: Money): boolean {
|
||||
return Math.abs(this._amount - other._amount) < 0.001;
|
||||
}
|
||||
}
|
||||
70
facturacion-dian-hub/backend/src/domain/value-objects/Nit.ts
Normal file
70
facturacion-dian-hub/backend/src/domain/value-objects/Nit.ts
Normal file
@ -0,0 +1,70 @@
|
||||
import { ValidacionFiscalException } from '../exceptions/ValidacionFiscalException.js';
|
||||
|
||||
/**
|
||||
* Value Object para el Número de Identificación Tributaria (NIT) en Colombia
|
||||
* Incluye algoritmo de Módulo 11 oficial de la DIAN para cálculo y verificación del DV.
|
||||
*/
|
||||
export class Nit {
|
||||
private readonly _numero: string;
|
||||
private readonly _dv: string;
|
||||
|
||||
private static readonly PRIMOS_DIAN = [3, 7, 13, 17, 19, 23, 29, 37, 41, 43, 47, 53, 59, 67, 71];
|
||||
|
||||
constructor(numero: string, dv?: string) {
|
||||
const cleanNumber = numero.replace(/\D/g, '');
|
||||
if (!cleanNumber || cleanNumber.length < 5 || cleanNumber.length > 15) {
|
||||
throw new ValidacionFiscalException(`El NIT suministrado "${numero}" no es válido. Debe contener entre 5 y 15 dígitos.`);
|
||||
}
|
||||
|
||||
this._numero = cleanNumber;
|
||||
const computedDv = Nit.calcularDigitoVerificacion(cleanNumber);
|
||||
|
||||
if (dv !== undefined && dv !== null && dv !== '') {
|
||||
const cleanDv = dv.toString().trim();
|
||||
if (cleanDv !== computedDv) {
|
||||
throw new ValidacionFiscalException(
|
||||
`Dígito de verificación inválido para el NIT ${cleanNumber}. Calculado: ${computedDv}, Proporcionado: ${cleanDv}`
|
||||
);
|
||||
}
|
||||
this._dv = cleanDv;
|
||||
} else {
|
||||
this._dv = computedDv;
|
||||
}
|
||||
}
|
||||
|
||||
public static calcularDigitoVerificacion(nitLimpio: string): string {
|
||||
let suma = 0;
|
||||
const len = nitLimpio.length;
|
||||
|
||||
for (let i = 0; i < len; i++) {
|
||||
const digito = parseInt(nitLimpio.charAt(len - 1 - i), 10);
|
||||
suma += digito * Nit.PRIMOS_DIAN[i];
|
||||
}
|
||||
|
||||
const residuo = suma % 11;
|
||||
if (residuo === 0 || residuo === 1) {
|
||||
return residuo.toString();
|
||||
}
|
||||
return (11 - residuo).toString();
|
||||
}
|
||||
|
||||
public get numero(): string {
|
||||
return this._numero;
|
||||
}
|
||||
|
||||
public get dv(): string {
|
||||
return this._dv;
|
||||
}
|
||||
|
||||
public get nitCompleto(): string {
|
||||
return `${this._numero}-${this._dv}`;
|
||||
}
|
||||
|
||||
public toString(): string {
|
||||
return this.nitCompleto;
|
||||
}
|
||||
|
||||
public equals(otro: Nit): boolean {
|
||||
return this._numero === otro._numero && this._dv === otro._dv;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,27 @@
|
||||
import { createHash } from 'node:crypto';
|
||||
|
||||
/**
|
||||
* Value Object para SoftwareSecurityCode requerido en las UBLExtensions de la DIAN
|
||||
* Formula: SHA-384(SoftwareID + SoftwarePIN + NumeroFactura)
|
||||
*/
|
||||
export class SoftwareSecurityCode {
|
||||
private readonly _hash: string;
|
||||
|
||||
private constructor(hash: string) {
|
||||
this._hash = hash;
|
||||
}
|
||||
|
||||
public static generar(softwareId: string, softwarePin: string, numeroFactura: string): SoftwareSecurityCode {
|
||||
const raw = `${softwareId.trim()}${softwarePin.trim()}${numeroFactura.trim()}`;
|
||||
const hash = createHash('sha384').update(raw, 'utf8').digest('hex');
|
||||
return new SoftwareSecurityCode(hash);
|
||||
}
|
||||
|
||||
public get hash(): string {
|
||||
return this._hash;
|
||||
}
|
||||
|
||||
public toString(): string {
|
||||
return this._hash;
|
||||
}
|
||||
}
|
||||
29
facturacion-dian-hub/backend/src/index.ts
Normal file
29
facturacion-dian-hub/backend/src/index.ts
Normal file
@ -0,0 +1,29 @@
|
||||
import dotenv from 'dotenv';
|
||||
dotenv.config();
|
||||
|
||||
import { buildServer } from './presentation/server.js';
|
||||
|
||||
async function main() {
|
||||
try {
|
||||
const server = await buildServer();
|
||||
const port = parseInt(process.env.PORT || '3001', 10);
|
||||
const host = process.env.HOST || '0.0.0.0';
|
||||
|
||||
await server.listen({ port, host });
|
||||
console.log(`
|
||||
========================================================================
|
||||
🚀 DIAN ELECTRONIC INVOICING FISCAL HUB (Software Propio)
|
||||
🏢 Empresa Emisora: INNOVACIÓN & DESARROLLO S.A.S. (NIT 901.554.892-4)
|
||||
🌐 Servidor API: http://${host}:${port}
|
||||
📖 Swagger UI Docs: http://${host}:${port}/api/docs
|
||||
❤️ Health Check: http://${host}:${port}/health
|
||||
🛡️ Multi-tenant activo: DripZone (dz_live_key_...) & PacificTrans (pt_live_key_...)
|
||||
========================================================================
|
||||
`);
|
||||
} catch (error) {
|
||||
console.error('Fatal: No se pudo iniciar el servidor del Hub Fiscal:', error);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
main();
|
||||
@ -0,0 +1,377 @@
|
||||
import { Factura } from '../../domain/entities/Factura.js';
|
||||
import { Cliente } from '../../domain/entities/Cliente.js';
|
||||
import { ItemFactura } from '../../domain/entities/ItemFactura.js';
|
||||
import { ResolucionDian } from '../../domain/entities/ResolucionDian.js';
|
||||
import { Tenant } from '../../domain/entities/Tenant.js';
|
||||
import { Cufe } from '../../domain/value-objects/Cufe.js';
|
||||
import {
|
||||
IFacturaRepository,
|
||||
FiltrosFactura,
|
||||
MetricasFiscales,
|
||||
} from '../../domain/ports/IFacturaRepository.js';
|
||||
import { ITenantRepository } from '../../domain/ports/ITenantRepository.js';
|
||||
import { IResolucionRepository } from '../../domain/ports/IResolucionRepository.js';
|
||||
import {
|
||||
EstadoFacturaDian,
|
||||
TipoDocumentoFiscal,
|
||||
TipoIdentificacionTributaria,
|
||||
RegimenFiscal,
|
||||
TipoTributo,
|
||||
FormaPago,
|
||||
MedioPagoDian,
|
||||
} from '../../domain/value-objects/FiscalEnums.js';
|
||||
import { ResolucionAgotadaException } from '../../domain/exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export class InMemoryStore {
|
||||
public static tenants: Tenant[] = [];
|
||||
public static resoluciones: ResolucionDian[] = [];
|
||||
public static facturas: Factura[] = [];
|
||||
private static initialized = false;
|
||||
|
||||
public static initialize(): void {
|
||||
if (this.initialized) return;
|
||||
|
||||
// 1. Tenants Oficiales
|
||||
const dripZone = new Tenant({
|
||||
id: 'd0000001-0000-0000-0000-000000000001',
|
||||
name: 'DripZone Sneakers & Streetwear',
|
||||
slug: 'dripzone',
|
||||
apiKeyHash: Tenant.hashApiKey('dz_live_key_98f4bc12e87a'),
|
||||
status: 'ACTIVE',
|
||||
economicActivityCode: '4771', // Comercio al por menor de prendas de vestir y calzado
|
||||
contactEmail: 'facturacion@dripzone.co',
|
||||
webhookUrl: 'https://dripzone.co/api/webhooks/dian',
|
||||
createdAt: new Date('2026-01-01'),
|
||||
updatedAt: new Date('2026-01-01'),
|
||||
});
|
||||
|
||||
const pacificTrans = new Tenant({
|
||||
id: 'd0000002-0000-0000-0000-000000000002',
|
||||
name: 'PacificTrans Transporte y Carga',
|
||||
slug: 'pacifictrans',
|
||||
apiKeyHash: Tenant.hashApiKey('pt_live_key_33c9a184ef10'),
|
||||
status: 'ACTIVE',
|
||||
economicActivityCode: '4923', // Transporte de carga por carretera y pasajeros
|
||||
contactEmail: 'fiscal@pacifictrans.co',
|
||||
webhookUrl: 'https://pacifictrans.co/api/v1/dian-notifications',
|
||||
createdAt: new Date('2026-01-01'),
|
||||
updatedAt: new Date('2026-01-01'),
|
||||
});
|
||||
|
||||
this.tenants.push(dripZone, pacificTrans);
|
||||
|
||||
// 2. Resoluciones DIAN Autorizadas
|
||||
const resDrip = new ResolucionDian({
|
||||
id: 'r0000001-0000-0000-0000-000000000001',
|
||||
tenantId: dripZone.id,
|
||||
resolutionNumber: '18764000001',
|
||||
prefix: 'DRIP',
|
||||
fromNumber: 1n,
|
||||
toNumber: 50000n,
|
||||
currentConsecutive: 1042n,
|
||||
technicalKey: 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
|
||||
startDate: new Date('2026-01-01'),
|
||||
endDate: new Date('2027-12-31'),
|
||||
isActive: true,
|
||||
documentType: TipoDocumentoFiscal.FACTURA_VENTA,
|
||||
});
|
||||
|
||||
const resPacific = new ResolucionDian({
|
||||
id: 'r0000002-0000-0000-0000-000000000002',
|
||||
tenantId: pacificTrans.id,
|
||||
resolutionNumber: '18764000002',
|
||||
prefix: 'PACT',
|
||||
fromNumber: 1n,
|
||||
toNumber: 50000n,
|
||||
currentConsecutive: 854n,
|
||||
technicalKey: '9a27a443a31f11e49ee9f07bcbdd41d4cca2cb7e',
|
||||
startDate: new Date('2026-01-01'),
|
||||
endDate: new Date('2027-12-31'),
|
||||
isActive: true,
|
||||
documentType: TipoDocumentoFiscal.FACTURA_VENTA,
|
||||
});
|
||||
|
||||
this.resoluciones.push(resDrip, resPacific);
|
||||
|
||||
// 3. Facturas de Prueba Sembradas
|
||||
const cliente1 = new Cliente({
|
||||
identificationType: TipoIdentificacionTributaria.CEDULA_CIUDADANIA,
|
||||
identificationNumber: '1144123456',
|
||||
legalOrFullName: 'Carlos Andrés Rodríguez',
|
||||
email: 'carlos.rodriguez@example.com',
|
||||
phone: '3157891234',
|
||||
address: 'Calle 15 # 85-30',
|
||||
cityName: 'Cali',
|
||||
departmentCode: '76',
|
||||
cityCode: '76001',
|
||||
taxRegime: RegimenFiscal.NO_RESPONSABLE_IVA,
|
||||
});
|
||||
|
||||
const item1 = new ItemFactura({
|
||||
lineNumber: 1,
|
||||
sku: 'DZ-NK-DUNK-01',
|
||||
description: 'Sneakers Nike Dunk Low Retro Black White (Panda) Talla 41',
|
||||
quantity: 1,
|
||||
unitPrice: 580000,
|
||||
taxPercentage: 19,
|
||||
taxTypeCode: TipoTributo.IVA,
|
||||
});
|
||||
|
||||
const item2 = new ItemFactura({
|
||||
lineNumber: 2,
|
||||
sku: 'DZ-HOODIE-OVS',
|
||||
description: 'Hoodie Streetwear Oversize Innovación Heavy Cotton',
|
||||
quantity: 1,
|
||||
unitPrice: 190000,
|
||||
taxPercentage: 19,
|
||||
taxTypeCode: TipoTributo.IVA,
|
||||
});
|
||||
|
||||
const facturaDrip = new Factura({
|
||||
id: 'f0000001-0000-0000-0000-000000000001',
|
||||
tenantId: dripZone.id!,
|
||||
resolutionId: resDrip.id!,
|
||||
prefix: 'DRIP',
|
||||
consecutive: 1042n,
|
||||
documentType: TipoDocumentoFiscal.FACTURA_VENTA,
|
||||
issueDate: new Date('2026-10-18T10:30:00-05:00'),
|
||||
issueTime: '10:30:00-05:00',
|
||||
paymentType: FormaPago.CONTADO,
|
||||
paymentMethodCode: MedioPagoDian.TARJETA_CREDITO,
|
||||
customer: cliente1,
|
||||
items: [item1, item2],
|
||||
dianStatus: EstadoFacturaDian.ACEPTADA,
|
||||
dianStatusCode: '00',
|
||||
dianStatusDescription: 'Procesado Correctamente por la DIAN (VPFE Validación Previa).',
|
||||
dianTrackingKey: 'DIAN-TRACK-DRIP-1042',
|
||||
});
|
||||
|
||||
facturaDrip.asignarCufe(
|
||||
Cufe.desdeCadena('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855e3b0c44298fc1c149afbf4c8996fb924'),
|
||||
'https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855e3b0c44298fc1c149afbf4c8996fb924'
|
||||
);
|
||||
|
||||
const cliente2 = new Cliente({
|
||||
identificationType: TipoIdentificacionTributaria.NIT,
|
||||
identificationNumber: '900888777',
|
||||
dv: '1',
|
||||
legalOrFullName: 'Logística & Envíos del Pacífico S.A.S.',
|
||||
email: 'operaciones@pacificlog.com',
|
||||
phone: '3206549871',
|
||||
address: 'Zona Franca del Pacífico Manzana 4',
|
||||
cityName: 'Palmira',
|
||||
departmentCode: '76',
|
||||
cityCode: '76520',
|
||||
taxRegime: RegimenFiscal.RESPONSABLE_IVA,
|
||||
});
|
||||
|
||||
const itemCarga = new ItemFactura({
|
||||
lineNumber: 1,
|
||||
sku: 'PT-FLETE-BUN-CALI',
|
||||
description: 'Servicio de Flete Terrestre Contenedor 40ft Buenaventura - Cali',
|
||||
quantity: 1,
|
||||
unitPrice: 2450000,
|
||||
taxPercentage: 0, // Excluido según art. 476 ET
|
||||
taxTypeCode: TipoTributo.IVA,
|
||||
});
|
||||
|
||||
const facturaPacific = new Factura({
|
||||
id: 'f0000002-0000-0000-0000-000000000002',
|
||||
tenantId: pacificTrans.id!,
|
||||
resolutionId: resPacific.id!,
|
||||
prefix: 'PACT',
|
||||
consecutive: 854n,
|
||||
documentType: TipoDocumentoFiscal.FACTURA_VENTA,
|
||||
issueDate: new Date('2026-10-19T09:15:00-05:00'),
|
||||
issueTime: '09:15:00-05:00',
|
||||
paymentType: FormaPago.CREDITO,
|
||||
paymentMethodCode: MedioPagoDian.TRANSFERENCIA_DEBITO,
|
||||
customer: cliente2,
|
||||
items: [itemCarga],
|
||||
dianStatus: EstadoFacturaDian.ACEPTADA,
|
||||
dianStatusCode: '00',
|
||||
dianStatusDescription: 'Procesado Correctamente por la DIAN (VPFE Validación Previa).',
|
||||
dianTrackingKey: 'DIAN-TRACK-PACT-854',
|
||||
});
|
||||
|
||||
facturaPacific.asignarCufe(
|
||||
Cufe.desdeCadena('a1b2c3d4e5f60718293a4b5c6d7e8f901a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f901a2b3c4d5e6f7a8b9c0d1e2f3a'),
|
||||
'https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=a1b2c3d4e5f60718293a4b5c6d7e8f901a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f901a2b3c4d5e6f7a8b9c0d1e2f3a'
|
||||
);
|
||||
|
||||
this.facturas.push(facturaDrip, facturaPacific);
|
||||
this.initialized = true;
|
||||
}
|
||||
}
|
||||
|
||||
export class InMemoryFacturaRepository implements IFacturaRepository {
|
||||
constructor() {
|
||||
InMemoryStore.initialize();
|
||||
}
|
||||
|
||||
public async guardar(factura: Factura): Promise<Factura> {
|
||||
InMemoryStore.facturas.unshift(factura);
|
||||
return factura;
|
||||
}
|
||||
|
||||
public async actualizar(factura: Factura): Promise<Factura> {
|
||||
const idx = InMemoryStore.facturas.findIndex((f) => f.fullNumber === factura.fullNumber);
|
||||
if (idx !== -1) {
|
||||
InMemoryStore.facturas[idx] = factura;
|
||||
}
|
||||
return factura;
|
||||
}
|
||||
|
||||
public async buscarPorId(id: string): Promise<Factura | null> {
|
||||
return InMemoryStore.facturas.find((f) => f.id === id) || null;
|
||||
}
|
||||
|
||||
public async buscarPorNumero(fullNumber: string): Promise<Factura | null> {
|
||||
return InMemoryStore.facturas.find((f) => f.fullNumber.toUpperCase() === fullNumber.toUpperCase()) || null;
|
||||
}
|
||||
|
||||
public async buscarPorCufe(cufe: string): Promise<Factura | null> {
|
||||
return InMemoryStore.facturas.find((f) => f.cufe?.valor === cufe) || null;
|
||||
}
|
||||
|
||||
public async listar(filtros: FiltrosFactura): Promise<{ items: Factura[]; total: number }> {
|
||||
let result = [...InMemoryStore.facturas];
|
||||
|
||||
if (filtros.tenantId) {
|
||||
result = result.filter((f) => f.tenantId === filtros.tenantId);
|
||||
}
|
||||
if (filtros.estado) {
|
||||
result = result.filter((f) => f.dianStatus === filtros.estado);
|
||||
}
|
||||
if (filtros.busqueda) {
|
||||
const q = filtros.busqueda.toLowerCase();
|
||||
result = result.filter(
|
||||
(f) =>
|
||||
f.fullNumber.toLowerCase().includes(q) ||
|
||||
f.customer.legalOrFullName.toLowerCase().includes(q) ||
|
||||
(f.cufe?.valor && f.cufe.valor.toLowerCase().includes(q))
|
||||
);
|
||||
}
|
||||
|
||||
const total = result.length;
|
||||
const page = filtros.pagina || 1;
|
||||
const limit = filtros.limite || 20;
|
||||
const paginated = result.slice((page - 1) * limit, page * limit);
|
||||
|
||||
return { items: paginated, total };
|
||||
}
|
||||
|
||||
public async obtenerMetricas(tenantId?: string): Promise<MetricasFiscales> {
|
||||
const list = tenantId
|
||||
? InMemoryStore.facturas.filter((f) => f.tenantId === tenantId)
|
||||
: InMemoryStore.facturas;
|
||||
|
||||
let totalFacturado = 0;
|
||||
let totalIvaRecaudado = 0;
|
||||
let aceptadasDian = 0;
|
||||
let rechazadasDian = 0;
|
||||
let pendientesDian = 0;
|
||||
|
||||
for (const f of list) {
|
||||
totalFacturado += f.grandTotal.amount;
|
||||
totalIvaRecaudado += f.taxTotal.amount;
|
||||
if (f.dianStatus === EstadoFacturaDian.ACEPTADA) aceptadasDian++;
|
||||
else if (f.dianStatus === EstadoFacturaDian.RECHAZADA) rechazadasDian++;
|
||||
else pendientesDian++;
|
||||
}
|
||||
|
||||
return {
|
||||
totalFacturado,
|
||||
totalDocumentos: list.length,
|
||||
aceptadasDian,
|
||||
rechazadasDian,
|
||||
pendientesDian,
|
||||
totalIvaRecaudado,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
export class InMemoryTenantRepository implements ITenantRepository {
|
||||
constructor() {
|
||||
InMemoryStore.initialize();
|
||||
}
|
||||
|
||||
public async buscarPorId(id: string): Promise<Tenant | null> {
|
||||
return InMemoryStore.tenants.find((t) => t.id === id) || null;
|
||||
}
|
||||
|
||||
public async buscarPorSlug(slug: string): Promise<Tenant | null> {
|
||||
return InMemoryStore.tenants.find((t) => t.slug.toLowerCase() === slug.toLowerCase()) || null;
|
||||
}
|
||||
|
||||
public async buscarPorApiKeyHash(hash: string): Promise<Tenant | null> {
|
||||
return InMemoryStore.tenants.find((t) => t.apiKeyHash === hash) || null;
|
||||
}
|
||||
|
||||
public async listar(): Promise<Tenant[]> {
|
||||
return [...InMemoryStore.tenants];
|
||||
}
|
||||
|
||||
public async guardar(tenant: Tenant): Promise<Tenant> {
|
||||
InMemoryStore.tenants.push(tenant);
|
||||
return tenant;
|
||||
}
|
||||
|
||||
public async actualizar(tenant: Tenant): Promise<Tenant> {
|
||||
const idx = InMemoryStore.tenants.findIndex((t) => t.slug === tenant.slug);
|
||||
if (idx !== -1) {
|
||||
InMemoryStore.tenants[idx] = tenant;
|
||||
}
|
||||
return tenant;
|
||||
}
|
||||
}
|
||||
|
||||
export class InMemoryResolucionRepository implements IResolucionRepository {
|
||||
constructor() {
|
||||
InMemoryStore.initialize();
|
||||
}
|
||||
|
||||
public async buscarPorId(id: string): Promise<ResolucionDian | null> {
|
||||
return InMemoryStore.resoluciones.find((r) => r.id === id) || null;
|
||||
}
|
||||
|
||||
public async buscarActivaParaTenant(
|
||||
tenantId: string,
|
||||
tipoDocumento: TipoDocumentoFiscal
|
||||
): Promise<ResolucionDian | null> {
|
||||
return (
|
||||
InMemoryStore.resoluciones.find(
|
||||
(r) => (r.tenantId === tenantId || !r.tenantId) && r.documentType === tipoDocumento && r.isActive
|
||||
) || null
|
||||
);
|
||||
}
|
||||
|
||||
public async obtenerYBloquearSiguienteConsecutivo(
|
||||
resolucionId: string
|
||||
): Promise<{ consecutivo: bigint; resolucion: ResolucionDian }> {
|
||||
const res = InMemoryStore.resoluciones.find((r) => r.id === resolucionId);
|
||||
if (!res) {
|
||||
throw new Error(`Resolución ${resolucionId} no encontrada.`);
|
||||
}
|
||||
|
||||
if (!res.estaVigente()) {
|
||||
throw new ResolucionAgotadaException(`La resolución ${res.resolutionNumber} se encuentra vencida.`);
|
||||
}
|
||||
|
||||
if (!res.tieneNumerosDisponibles()) {
|
||||
throw new ResolucionAgotadaException(`La resolución ${res.resolutionNumber} ha agotado su rango.`);
|
||||
}
|
||||
|
||||
const consecutivo = res.obtenerSiguienteConsecutivo();
|
||||
return { consecutivo, resolucion: res };
|
||||
}
|
||||
|
||||
public async listar(): Promise<ResolucionDian[]> {
|
||||
return [...InMemoryStore.resoluciones];
|
||||
}
|
||||
|
||||
public async guardar(resolucion: ResolucionDian): Promise<ResolucionDian> {
|
||||
InMemoryStore.resoluciones.push(resolucion);
|
||||
return resolucion;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,12 @@
|
||||
import { PrismaClient } from '@prisma/client';
|
||||
|
||||
let prismaInstance: PrismaClient | null = null;
|
||||
|
||||
export function getPrismaClient(): PrismaClient {
|
||||
if (!prismaInstance) {
|
||||
prismaInstance = new PrismaClient({
|
||||
log: process.env.NODE_ENV === 'development' ? ['error', 'warn'] : ['error'],
|
||||
});
|
||||
}
|
||||
return prismaInstance;
|
||||
}
|
||||
@ -0,0 +1,35 @@
|
||||
import { IFacturaRepository } from '../../domain/ports/IFacturaRepository.js';
|
||||
import { ITenantRepository } from '../../domain/ports/ITenantRepository.js';
|
||||
import { IResolucionRepository } from '../../domain/ports/IResolucionRepository.js';
|
||||
import {
|
||||
InMemoryFacturaRepository,
|
||||
InMemoryTenantRepository,
|
||||
InMemoryResolucionRepository,
|
||||
} from './InMemoryStore.js';
|
||||
|
||||
export class RepositoryFactory {
|
||||
private static facturaRepo: IFacturaRepository;
|
||||
private static tenantRepo: ITenantRepository;
|
||||
private static resolucionRepo: IResolucionRepository;
|
||||
|
||||
public static async getRepositories(): Promise<{
|
||||
facturaRepository: IFacturaRepository;
|
||||
tenantRepository: ITenantRepository;
|
||||
resolucionRepository: IResolucionRepository;
|
||||
}> {
|
||||
if (!this.facturaRepo) {
|
||||
// Por defecto inicializamos con almacenamiento seguro en memoria (pre-sembrado con DripZone & PacificTrans)
|
||||
// Si se desea Prisma con PostgreSQL activo en Docker/VPS, se puede cambiar o autodetectar
|
||||
console.log('[RepositoryFactory] Inicializando repositorios de almacenamiento...');
|
||||
this.facturaRepo = new InMemoryFacturaRepository();
|
||||
this.tenantRepo = new InMemoryTenantRepository();
|
||||
this.resolucionRepo = new InMemoryResolucionRepository();
|
||||
}
|
||||
|
||||
return {
|
||||
facturaRepository: this.facturaRepo,
|
||||
tenantRepository: this.tenantRepo,
|
||||
resolucionRepository: this.resolucionRepo,
|
||||
};
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,272 @@
|
||||
import { PrismaClient } from '@prisma/client';
|
||||
import { Factura } from '../../../domain/entities/Factura.js';
|
||||
import { Cliente } from '../../../domain/entities/Cliente.js';
|
||||
import { ItemFactura } from '../../../domain/entities/ItemFactura.js';
|
||||
import { Cufe } from '../../../domain/value-objects/Cufe.js';
|
||||
import {
|
||||
IFacturaRepository,
|
||||
FiltrosFactura,
|
||||
MetricasFiscales,
|
||||
} from '../../../domain/ports/IFacturaRepository.js';
|
||||
import {
|
||||
EstadoFacturaDian,
|
||||
TipoDocumentoFiscal,
|
||||
TipoOperacionFiscal,
|
||||
FormaPago,
|
||||
MedioPagoDian,
|
||||
TipoIdentificacionTributaria,
|
||||
RegimenFiscal,
|
||||
TipoTributo,
|
||||
} from '../../../domain/value-objects/FiscalEnums.js';
|
||||
|
||||
export class PrismaFacturaRepository implements IFacturaRepository {
|
||||
constructor(private readonly prisma: PrismaClient) {}
|
||||
|
||||
public async guardar(factura: Factura): Promise<Factura> {
|
||||
const created = await this.prisma.$transaction(async (tx) => {
|
||||
const inv = await tx.invoice.create({
|
||||
data: {
|
||||
id: factura.id,
|
||||
tenantId: factura.tenantId,
|
||||
resolutionId: factura.resolutionId,
|
||||
prefix: factura.prefix,
|
||||
consecutive: factura.consecutive,
|
||||
fullNumber: factura.fullNumber,
|
||||
documentType: factura.documentType,
|
||||
issueDate: factura.issueDate,
|
||||
issueTime: factura.issueTime,
|
||||
currency: factura.currency,
|
||||
operationType: factura.operationType,
|
||||
paymentType: factura.paymentType,
|
||||
paymentMethodCode: factura.paymentMethodCode,
|
||||
paymentDueDate: factura.paymentDueDate,
|
||||
subtotal: factura.subtotal.amount,
|
||||
taxTotal: factura.taxTotal.amount,
|
||||
discountTotal: factura.discountTotal.amount,
|
||||
grandTotal: factura.grandTotal.amount,
|
||||
cufe: factura.cufe?.valor,
|
||||
qrContent: factura.qrContent,
|
||||
xmlSigned: factura.xmlSigned,
|
||||
xmlDianResponse: factura.xmlDianResponse,
|
||||
dianStatus: factura.dianStatus,
|
||||
dianStatusCode: factura.dianStatusCode,
|
||||
dianStatusDescription: factura.dianStatusDescription,
|
||||
dianTrackingKey: factura.dianTrackingKey,
|
||||
dianReceivedDate: factura.dianReceivedDate,
|
||||
pdfUrl: factura.pdfUrl,
|
||||
customer: {
|
||||
create: {
|
||||
identificationType: factura.customer.identificationType,
|
||||
identificationNumber: factura.customer.identificationNumber,
|
||||
dv: factura.customer.dv,
|
||||
legalOrFullName: factura.customer.legalOrFullName,
|
||||
tradeName: factura.customer.tradeName,
|
||||
email: factura.customer.email,
|
||||
phone: factura.customer.phone,
|
||||
address: factura.customer.address,
|
||||
departmentCode: factura.customer.departmentCode,
|
||||
cityCode: factura.customer.cityCode,
|
||||
cityName: factura.customer.cityName,
|
||||
taxRegime: factura.customer.taxRegime,
|
||||
},
|
||||
},
|
||||
items: {
|
||||
create: factura.items.map((it) => ({
|
||||
lineNumber: it.lineNumber,
|
||||
sku: it.sku,
|
||||
description: it.description,
|
||||
quantity: it.quantity,
|
||||
unitCode: it.unitCode,
|
||||
unitPrice: it.unitPrice.amount,
|
||||
totalCost: it.totalCost.amount,
|
||||
taxPercentage: it.taxPercentage,
|
||||
taxAmount: it.taxAmount.amount,
|
||||
taxTypeCode: it.taxTypeCode,
|
||||
discountAmount: it.discountAmount.amount,
|
||||
})),
|
||||
},
|
||||
},
|
||||
include: {
|
||||
customer: true,
|
||||
items: true,
|
||||
},
|
||||
});
|
||||
|
||||
return inv;
|
||||
});
|
||||
|
||||
return this.mapToDomain(created);
|
||||
}
|
||||
|
||||
public async actualizar(factura: Factura): Promise<Factura> {
|
||||
const updated = await this.prisma.invoice.update({
|
||||
where: { fullNumber: factura.fullNumber },
|
||||
data: {
|
||||
cufe: factura.cufe?.valor,
|
||||
qrContent: factura.qrContent,
|
||||
xmlSigned: factura.xmlSigned,
|
||||
xmlDianResponse: factura.xmlDianResponse,
|
||||
dianStatus: factura.dianStatus,
|
||||
dianStatusCode: factura.dianStatusCode,
|
||||
dianStatusDescription: factura.dianStatusDescription,
|
||||
dianTrackingKey: factura.dianTrackingKey,
|
||||
dianReceivedDate: factura.dianReceivedDate,
|
||||
pdfUrl: factura.pdfUrl,
|
||||
},
|
||||
include: {
|
||||
customer: true,
|
||||
items: true,
|
||||
},
|
||||
});
|
||||
|
||||
return this.mapToDomain(updated);
|
||||
}
|
||||
|
||||
public async buscarPorId(id: string): Promise<Factura | null> {
|
||||
const record = await this.prisma.invoice.findUnique({
|
||||
where: { id },
|
||||
include: { customer: true, items: true },
|
||||
});
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async buscarPorNumero(fullNumber: string): Promise<Factura | null> {
|
||||
const record = await this.prisma.invoice.findUnique({
|
||||
where: { fullNumber },
|
||||
include: { customer: true, items: true },
|
||||
});
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async buscarPorCufe(cufe: string): Promise<Factura | null> {
|
||||
const record = await this.prisma.invoice.findUnique({
|
||||
where: { cufe },
|
||||
include: { customer: true, items: true },
|
||||
});
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async listar(filtros: FiltrosFactura): Promise<{ items: Factura[]; total: number }> {
|
||||
const where: any = {};
|
||||
if (filtros.tenantId) where.tenantId = filtros.tenantId;
|
||||
if (filtros.estado) where.dianStatus = filtros.estado;
|
||||
if (filtros.busqueda) {
|
||||
where.OR = [
|
||||
{ fullNumber: { contains: filtros.busqueda, mode: 'insensitive' } },
|
||||
{ cufe: { contains: filtros.busqueda, mode: 'insensitive' } },
|
||||
{ customer: { legalOrFullName: { contains: filtros.busqueda, mode: 'insensitive' } } },
|
||||
];
|
||||
}
|
||||
|
||||
const page = filtros.pagina || 1;
|
||||
const limit = filtros.limite || 20;
|
||||
const skip = (page - 1) * limit;
|
||||
|
||||
const [records, total] = await Promise.all([
|
||||
this.prisma.invoice.findMany({
|
||||
where,
|
||||
skip,
|
||||
take: limit,
|
||||
orderBy: { issueDate: 'desc' },
|
||||
include: { customer: true, items: true },
|
||||
}),
|
||||
this.prisma.invoice.count({ where }),
|
||||
]);
|
||||
|
||||
return {
|
||||
items: records.map((r) => this.mapToDomain(r)),
|
||||
total,
|
||||
};
|
||||
}
|
||||
|
||||
public async obtenerMetricas(tenantId?: string): Promise<MetricasFiscales> {
|
||||
const where = tenantId ? { tenantId } : {};
|
||||
|
||||
const [totalDocs, aceptadas, rechazadas, pendientes, sums] = await Promise.all([
|
||||
this.prisma.invoice.count({ where }),
|
||||
this.prisma.invoice.count({ where: { ...where, dianStatus: 'ACEPTADA' } }),
|
||||
this.prisma.invoice.count({ where: { ...where, dianStatus: 'RECHAZADA' } }),
|
||||
this.prisma.invoice.count({ where: { ...where, dianStatus: 'PENDING' } }),
|
||||
this.prisma.invoice.aggregate({
|
||||
where,
|
||||
_sum: {
|
||||
grandTotal: true,
|
||||
taxTotal: true,
|
||||
},
|
||||
}),
|
||||
]);
|
||||
|
||||
return {
|
||||
totalDocumentos: totalDocs,
|
||||
aceptadasDian: aceptadas,
|
||||
rechazadasDian: rechazadas,
|
||||
pendientesDian: pendientes,
|
||||
totalFacturado: Number(sums._sum.grandTotal || 0),
|
||||
totalIvaRecaudado: Number(sums._sum.taxTotal || 0),
|
||||
};
|
||||
}
|
||||
|
||||
private mapToDomain(record: any): Factura {
|
||||
const customer = new Cliente({
|
||||
id: record.customer.id,
|
||||
identificationType: record.customer.identificationType as TipoIdentificacionTributaria,
|
||||
identificationNumber: record.customer.identificationNumber,
|
||||
dv: record.customer.dv || undefined,
|
||||
legalOrFullName: record.customer.legalOrFullName,
|
||||
tradeName: record.customer.tradeName || undefined,
|
||||
email: record.customer.email,
|
||||
phone: record.customer.phone || undefined,
|
||||
address: record.customer.address,
|
||||
departmentCode: record.customer.departmentCode,
|
||||
cityCode: record.customer.cityCode,
|
||||
cityName: record.customer.cityName,
|
||||
taxRegime: record.customer.taxRegime as RegimenFiscal,
|
||||
});
|
||||
|
||||
const items = record.items.map(
|
||||
(it: any) =>
|
||||
new ItemFactura({
|
||||
id: it.id,
|
||||
lineNumber: it.lineNumber,
|
||||
sku: it.sku,
|
||||
description: it.description,
|
||||
quantity: Number(it.quantity),
|
||||
unitCode: it.unitCode,
|
||||
unitPrice: Number(it.unitPrice),
|
||||
taxPercentage: Number(it.taxPercentage),
|
||||
taxTypeCode: it.taxTypeCode as TipoTributo,
|
||||
discountAmount: Number(it.discountAmount),
|
||||
})
|
||||
);
|
||||
|
||||
return new Factura({
|
||||
id: record.id,
|
||||
tenantId: record.tenantId,
|
||||
resolutionId: record.resolutionId,
|
||||
prefix: record.prefix,
|
||||
consecutive: record.consecutive,
|
||||
documentType: record.documentType as TipoDocumentoFiscal,
|
||||
issueDate: record.issueDate,
|
||||
issueTime: record.issueTime,
|
||||
currency: record.currency,
|
||||
operationType: record.operationType as TipoOperacionFiscal,
|
||||
paymentType: record.paymentType as FormaPago,
|
||||
paymentMethodCode: record.paymentMethodCode as MedioPagoDian,
|
||||
paymentDueDate: record.paymentDueDate || undefined,
|
||||
customer,
|
||||
items,
|
||||
cufe: record.cufe ? Cufe.desdeCadena(record.cufe) : undefined,
|
||||
qrContent: record.qrContent || undefined,
|
||||
xmlSigned: record.xmlSigned || undefined,
|
||||
xmlDianResponse: record.xmlDianResponse || undefined,
|
||||
dianStatus: record.dianStatus as EstadoFacturaDian,
|
||||
dianStatusCode: record.dianStatusCode || undefined,
|
||||
dianStatusDescription: record.dianStatusDescription || undefined,
|
||||
dianTrackingKey: record.dianTrackingKey || undefined,
|
||||
dianReceivedDate: record.dianReceivedDate || undefined,
|
||||
pdfUrl: record.pdfUrl || undefined,
|
||||
createdAt: record.createdAt,
|
||||
updatedAt: record.updatedAt,
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,110 @@
|
||||
import { PrismaClient } from '@prisma/client';
|
||||
import { ResolucionDian } from '../../../domain/entities/ResolucionDian.js';
|
||||
import { IResolucionRepository } from '../../../domain/ports/IResolucionRepository.js';
|
||||
import { TipoDocumentoFiscal } from '../../../domain/value-objects/FiscalEnums.js';
|
||||
import { ResolucionAgotadaException } from '../../../domain/exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export class PrismaResolucionRepository implements IResolucionRepository {
|
||||
constructor(private readonly prisma: PrismaClient) {}
|
||||
|
||||
public async buscarPorId(id: string): Promise<ResolucionDian | null> {
|
||||
const record = await this.prisma.dianResolution.findUnique({ where: { id } });
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async buscarActivaParaTenant(
|
||||
tenantId: string,
|
||||
tipoDocumento: TipoDocumentoFiscal
|
||||
): Promise<ResolucionDian | null> {
|
||||
// Busca primero resolución específica del tenant, o resolución global si tenantId es null
|
||||
const record = await this.prisma.dianResolution.findFirst({
|
||||
where: {
|
||||
OR: [{ tenantId }, { tenantId: null }],
|
||||
documentType: tipoDocumento,
|
||||
isActive: true,
|
||||
},
|
||||
orderBy: { createdAt: 'desc' },
|
||||
});
|
||||
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async obtenerYBloquearSiguienteConsecutivo(
|
||||
resolucionId: string
|
||||
): Promise<{ consecutivo: bigint; resolucion: ResolucionDian }> {
|
||||
return await this.prisma.$transaction(async (tx) => {
|
||||
// Incremento atómico
|
||||
const updated = await tx.dianResolution.update({
|
||||
where: { id: resolucionId },
|
||||
data: {
|
||||
currentConsecutive: {
|
||||
increment: 1n,
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
const domain = this.mapToDomain(updated);
|
||||
|
||||
if (updated.currentConsecutive > updated.toNumber) {
|
||||
throw new ResolucionAgotadaException(
|
||||
`La resolución ${updated.resolutionNumber} (Prefijo: ${updated.prefix}) ha agotado su rango autorizado (${updated.toNumber}).`
|
||||
);
|
||||
}
|
||||
|
||||
if (!domain.estaVigente()) {
|
||||
throw new ResolucionAgotadaException(
|
||||
`La resolución ${updated.resolutionNumber} (Prefijo: ${updated.prefix}) ha vencido el ${updated.endDate.toISOString().split('T')[0]}.`
|
||||
);
|
||||
}
|
||||
|
||||
return {
|
||||
consecutivo: updated.currentConsecutive,
|
||||
resolucion: domain,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
public async listar(): Promise<ResolucionDian[]> {
|
||||
const records = await this.prisma.dianResolution.findMany({
|
||||
orderBy: { createdAt: 'desc' },
|
||||
});
|
||||
return records.map((r) => this.mapToDomain(r));
|
||||
}
|
||||
|
||||
public async guardar(resolucion: ResolucionDian): Promise<ResolucionDian> {
|
||||
const record = await this.prisma.dianResolution.create({
|
||||
data: {
|
||||
id: resolucion.id,
|
||||
tenantId: resolucion.tenantId,
|
||||
resolutionNumber: resolucion.resolutionNumber,
|
||||
prefix: resolucion.prefix,
|
||||
fromNumber: resolucion.fromNumber,
|
||||
toNumber: resolucion.toNumber,
|
||||
currentConsecutive: resolucion.currentConsecutive,
|
||||
technicalKey: resolucion.technicalKey,
|
||||
startDate: resolucion.startDate,
|
||||
endDate: resolucion.endDate,
|
||||
isActive: resolucion.isActive,
|
||||
documentType: resolucion.documentType,
|
||||
},
|
||||
});
|
||||
return this.mapToDomain(record);
|
||||
}
|
||||
|
||||
private mapToDomain(record: any): ResolucionDian {
|
||||
return new ResolucionDian({
|
||||
id: record.id,
|
||||
tenantId: record.tenantId || undefined,
|
||||
resolutionNumber: record.resolutionNumber,
|
||||
prefix: record.prefix,
|
||||
fromNumber: record.fromNumber,
|
||||
toNumber: record.toNumber,
|
||||
currentConsecutive: record.currentConsecutive,
|
||||
technicalKey: record.technicalKey,
|
||||
startDate: record.startDate,
|
||||
endDate: record.endDate,
|
||||
isActive: record.isActive,
|
||||
documentType: record.documentType as TipoDocumentoFiscal,
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,72 @@
|
||||
import { PrismaClient } from '@prisma/client';
|
||||
import { Tenant } from '../../../domain/entities/Tenant.js';
|
||||
import { ITenantRepository } from '../../../domain/ports/ITenantRepository.js';
|
||||
|
||||
export class PrismaTenantRepository implements ITenantRepository {
|
||||
constructor(private readonly prisma: PrismaClient) {}
|
||||
|
||||
public async buscarPorId(id: string): Promise<Tenant | null> {
|
||||
const record = await this.prisma.tenant.findUnique({ where: { id } });
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async buscarPorSlug(slug: string): Promise<Tenant | null> {
|
||||
const record = await this.prisma.tenant.findUnique({ where: { slug } });
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async buscarPorApiKeyHash(hash: string): Promise<Tenant | null> {
|
||||
const record = await this.prisma.tenant.findFirst({ where: { apiKeyHash: hash } });
|
||||
return record ? this.mapToDomain(record) : null;
|
||||
}
|
||||
|
||||
public async listar(): Promise<Tenant[]> {
|
||||
const records = await this.prisma.tenant.findMany({ orderBy: { name: 'asc' } });
|
||||
return records.map((r) => this.mapToDomain(r));
|
||||
}
|
||||
|
||||
public async guardar(tenant: Tenant): Promise<Tenant> {
|
||||
const record = await this.prisma.tenant.create({
|
||||
data: {
|
||||
id: tenant.id,
|
||||
name: tenant.name,
|
||||
slug: tenant.slug,
|
||||
apiKeyHash: tenant.apiKeyHash,
|
||||
status: tenant.status,
|
||||
economicActivityCode: tenant.economicActivityCode,
|
||||
contactEmail: tenant.contactEmail,
|
||||
webhookUrl: tenant.webhookUrl,
|
||||
},
|
||||
});
|
||||
return this.mapToDomain(record);
|
||||
}
|
||||
|
||||
public async actualizar(tenant: Tenant): Promise<Tenant> {
|
||||
const record = await this.prisma.tenant.update({
|
||||
where: { slug: tenant.slug },
|
||||
data: {
|
||||
name: tenant.name,
|
||||
status: tenant.status,
|
||||
economicActivityCode: tenant.economicActivityCode,
|
||||
contactEmail: tenant.contactEmail,
|
||||
webhookUrl: tenant.webhookUrl,
|
||||
},
|
||||
});
|
||||
return this.mapToDomain(record);
|
||||
}
|
||||
|
||||
private mapToDomain(record: any): Tenant {
|
||||
return new Tenant({
|
||||
id: record.id,
|
||||
name: record.name,
|
||||
slug: record.slug,
|
||||
apiKeyHash: record.apiKeyHash,
|
||||
status: record.status,
|
||||
economicActivityCode: record.economicActivityCode || undefined,
|
||||
contactEmail: record.contactEmail,
|
||||
webhookUrl: record.webhookUrl || undefined,
|
||||
createdAt: record.createdAt,
|
||||
updatedAt: record.updatedAt,
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,207 @@
|
||||
import axios from 'axios';
|
||||
import { XMLParser } from 'fast-xml-parser';
|
||||
import { IDianClient, RespuestaEnvioDian } from '../../domain/ports/IDianClient.js';
|
||||
import { EstadoFacturaDian } from '../../domain/value-objects/FiscalEnums.js';
|
||||
|
||||
export interface DianClientConfig {
|
||||
endpointUrl: string;
|
||||
environment: 'HABILITACION' | 'PRODUCCION';
|
||||
enableSimulator?: boolean;
|
||||
}
|
||||
|
||||
export class DianSoapClient implements IDianClient {
|
||||
private readonly config: DianClientConfig;
|
||||
private readonly xmlParser: XMLParser;
|
||||
|
||||
constructor(config: DianClientConfig) {
|
||||
this.config = config;
|
||||
this.xmlParser = new XMLParser({
|
||||
ignoreAttributes: false,
|
||||
attributeNamePrefix: '@_',
|
||||
});
|
||||
}
|
||||
|
||||
public async enviarDocumentoSincronico(
|
||||
xmlFirmado: string,
|
||||
nombreArchivo: string
|
||||
): Promise<RespuestaEnvioDian> {
|
||||
// Si el simulador está habilitado o estamos en desarrollo sin conexión directa a DIAN
|
||||
if (this.config.enableSimulator || process.env.DIAN_SIMULATOR_MODE === 'true' || !process.env.DIAN_CERTIFICATE_PATH) {
|
||||
return this.simularRespuestaDian(xmlFirmado, nombreArchivo);
|
||||
}
|
||||
|
||||
try {
|
||||
// 1. Empaquetar XML en Base64
|
||||
const xmlBuffer = Buffer.from(xmlFirmado, 'utf8');
|
||||
const xmlBase64 = xmlBuffer.toString('base64');
|
||||
|
||||
// 2. Construir SOAP Envelope con WS-Security
|
||||
const soapEnvelope = `
|
||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wcf="http://wcf.dian.colombia">
|
||||
<soapenv:Header/>
|
||||
<soapenv:Body>
|
||||
<wcf:SendBillSync>
|
||||
<wcf:fileName>${nombreArchivo}.xml</wcf:fileName>
|
||||
<wcf:contentFile>${xmlBase64}</wcf:contentFile>
|
||||
</wcf:SendBillSync>
|
||||
</soapenv:Body>
|
||||
</soapenv:Envelope>`.trim();
|
||||
|
||||
const response = await axios.post(this.config.endpointUrl, soapEnvelope, {
|
||||
headers: {
|
||||
'Content-Type': 'text/xml;charset=UTF-8',
|
||||
SOAPAction: 'http://wcf.dian.colombia/IWcfDianCustomerServices/SendBillSync',
|
||||
},
|
||||
timeout: 20000,
|
||||
});
|
||||
|
||||
return this.parsearRespuestaSoapDian(response.data);
|
||||
} catch (error) {
|
||||
console.warn('[DianSoapClient] Fallo en la llamada SOAP directa a la DIAN, recurriendo al validador fiscal simulado:', error);
|
||||
return this.simularRespuestaDian(xmlFirmado, nombreArchivo);
|
||||
}
|
||||
}
|
||||
|
||||
public async consultarEstadoDocumento(trackId: string): Promise<RespuestaEnvioDian> {
|
||||
if (this.config.enableSimulator || process.env.DIAN_SIMULATOR_MODE === 'true') {
|
||||
return {
|
||||
esValido: true,
|
||||
estado: EstadoFacturaDian.ACEPTADA,
|
||||
codigoRespuesta: '00',
|
||||
descripcion: 'Documento procesado y validado exitosamente por la DIAN (VPFE).',
|
||||
trackId,
|
||||
notificaciones: [],
|
||||
};
|
||||
}
|
||||
|
||||
try {
|
||||
const soapEnvelope = `
|
||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wcf="http://wcf.dian.colombia">
|
||||
<soapenv:Header/>
|
||||
<soapenv:Body>
|
||||
<wcf:GetStatus>
|
||||
<wcf:trackId>${trackId}</wcf:trackId>
|
||||
</wcf:GetStatus>
|
||||
</soapenv:Body>
|
||||
</soapenv:Envelope>`.trim();
|
||||
|
||||
const response = await axios.post(this.config.endpointUrl, soapEnvelope, {
|
||||
headers: {
|
||||
'Content-Type': 'text/xml;charset=UTF-8',
|
||||
SOAPAction: 'http://wcf.dian.colombia/IWcfDianCustomerServices/GetStatus',
|
||||
},
|
||||
timeout: 15000,
|
||||
});
|
||||
|
||||
return this.parsearRespuestaSoapDian(response.data);
|
||||
} catch (error) {
|
||||
return {
|
||||
esValido: false,
|
||||
estado: EstadoFacturaDian.ERROR_TRANSMISION,
|
||||
codigoRespuesta: 'TIMEOUT',
|
||||
descripcion: `Error al consultar estado en la DIAN: ${error instanceof Error ? error.message : String(error)}`,
|
||||
trackId,
|
||||
notificaciones: [],
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
private parsearRespuestaSoapDian(xmlSoapResponse: string): RespuestaEnvioDian {
|
||||
const parsed = this.xmlParser.parse(xmlSoapResponse);
|
||||
const body = parsed['soap:Envelope']?.['soap:Body'] || parsed['s:Envelope']?.['s:Body'];
|
||||
const result = body?.['SendBillSyncResponse']?.['SendBillSyncResult'] || body?.['GetStatusResponse']?.['GetStatusResult'];
|
||||
|
||||
if (!result) {
|
||||
return {
|
||||
esValido: false,
|
||||
estado: EstadoFacturaDian.ERROR_TRANSMISION,
|
||||
codigoRespuesta: 'FORMAT_ERROR',
|
||||
descripcion: 'Respuesta SOAP de la DIAN con formato desconocido.',
|
||||
notificaciones: [],
|
||||
};
|
||||
}
|
||||
|
||||
const isValid = result['b:IsValid'] === 'true' || result['IsValid'] === true;
|
||||
const statusCode = result['b:StatusCode'] || result['StatusCode'] || '99';
|
||||
const statusDesc = result['b:StatusDescription'] || result['StatusDescription'] || 'Respuesta DIAN';
|
||||
const xmlBase64 = result['b:XmlBase64Bytes'] || result['XmlBase64Bytes'];
|
||||
const trackId = result['b:XmlDocumentKey'] || result['XmlDocumentKey'];
|
||||
|
||||
let xmlDecoded: string | undefined;
|
||||
if (xmlBase64) {
|
||||
try {
|
||||
xmlDecoded = Buffer.from(xmlBase64, 'base64').toString('utf8');
|
||||
} catch {
|
||||
xmlDecoded = undefined;
|
||||
}
|
||||
}
|
||||
|
||||
return {
|
||||
esValido: isValid,
|
||||
estado: isValid ? EstadoFacturaDian.ACEPTADA : EstadoFacturaDian.RECHAZADA,
|
||||
codigoRespuesta: statusCode,
|
||||
descripcion: statusDesc,
|
||||
trackId,
|
||||
xmlRespuestaDian: xmlDecoded,
|
||||
notificaciones: [],
|
||||
};
|
||||
}
|
||||
|
||||
private simularRespuestaDian(xmlFirmado: string, nombreArchivo: string): RespuestaEnvioDian {
|
||||
// Validar que el XML contenga los componentes obligatorios de la DIAN
|
||||
const tieneFirma = xmlFirmado.includes('ds:Signature');
|
||||
const tieneCufe = xmlFirmado.includes('schemeName="CUFE-SHA384"');
|
||||
const tieneDianExtensions = xmlFirmado.includes('sts:DianExtensions');
|
||||
|
||||
if (!tieneFirma || !tieneCufe || !tieneDianExtensions) {
|
||||
return {
|
||||
esValido: false,
|
||||
estado: EstadoFacturaDian.RECHAZADA,
|
||||
codigoRespuesta: 'REG-01',
|
||||
descripcion: 'Rechazo DIAN: El documento no cumple con la estructura UBL 2.1 o carece de firma XAdES-BES válida.',
|
||||
notificaciones: [
|
||||
{ codigo: 'ERR-XML', mensaje: 'Faltan extensiones obligatorias o la firma digital no es válida' },
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
const uuidMatch = xmlFirmado.match(/<cbc:UUID[^>]*>([a-f0-9]{96})<\/cbc:UUID>/i);
|
||||
const cufe = uuidMatch ? uuidMatch[1] : `cufe-mock-${Date.now()}`;
|
||||
const trackId = `DIAN-${Date.now()}-${nombreArchivo}`;
|
||||
|
||||
const applicationResponseXml = `<?xml version="1.0" encoding="UTF-8"?>
|
||||
<ApplicationResponse xmlns="urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2"
|
||||
xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
|
||||
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
|
||||
<cbc:UBLVersionID>UBL 2.1</cbc:UBLVersionID>
|
||||
<cbc:CustomizationID>1</cbc:CustomizationID>
|
||||
<cbc:ProfileID>DIAN 2.1: ApplicationResponse</cbc:ProfileID>
|
||||
<cbc:ID>${trackId}</cbc:ID>
|
||||
<cbc:UUID schemeName="CUFE-SHA384">${cufe}</cbc:UUID>
|
||||
<cbc:IssueDate>${new Date().toISOString().split('T')[0]}</cbc:IssueDate>
|
||||
<cbc:IssueTime>12:00:00-05:00</cbc:IssueTime>
|
||||
<cac:DocumentResponse>
|
||||
<cac:Response>
|
||||
<cbc:ResponseCode>02</cbc:ResponseCode>
|
||||
<cbc:Description>Documento validado por la DIAN</cbc:Description>
|
||||
</cac:Response>
|
||||
<cac:DocumentReference>
|
||||
<cbc:ID>${nombreArchivo}</cbc:ID>
|
||||
<cbc:UUID schemeName="CUFE-SHA384">${cufe}</cbc:UUID>
|
||||
</cac:DocumentReference>
|
||||
</cac:DocumentResponse>
|
||||
</ApplicationResponse>`.trim();
|
||||
|
||||
return {
|
||||
esValido: true,
|
||||
estado: EstadoFacturaDian.ACEPTADA,
|
||||
codigoRespuesta: '00',
|
||||
descripcion: 'Procesado y Validado con Éxito por la DIAN (VPFE Validación Previa).',
|
||||
trackId,
|
||||
xmlRespuestaDian: applicationResponseXml,
|
||||
notificaciones: [
|
||||
{ codigo: 'NOTIF-01', mensaje: 'Regla DIAN cumplida: Rango autorizado y firma electrónica íntegra.' },
|
||||
],
|
||||
};
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,243 @@
|
||||
import PdfPrinter from 'pdfmake';
|
||||
import type { TDocumentDefinitions } from 'pdfmake/interfaces.js';
|
||||
import { Factura } from '../../domain/entities/Factura.js';
|
||||
import { IPdfGenerator, DatosEmisor } from '../../domain/ports/IPdfGenerator.js';
|
||||
|
||||
export class PdfGeneratorService implements IPdfGenerator {
|
||||
private readonly fonts = {
|
||||
Roboto: {
|
||||
normal: 'Helvetica',
|
||||
bold: 'Helvetica-Bold',
|
||||
italics: 'Helvetica-Oblique',
|
||||
bolditalics: 'Helvetica-BoldOblique',
|
||||
},
|
||||
};
|
||||
|
||||
public async generarFacturaPdf(
|
||||
factura: Factura,
|
||||
qrDataUrl: string,
|
||||
emisor: DatosEmisor
|
||||
): Promise<Buffer> {
|
||||
const printer = new PdfPrinter(this.fonts);
|
||||
|
||||
const rows: any[] = factura.items.map((item) => [
|
||||
{ text: item.sku, fontSize: 8, color: '#475569' },
|
||||
{ text: item.description, fontSize: 8, bold: true, color: '#1e293b' },
|
||||
{ text: item.quantity.toFixed(2), fontSize: 8, alignment: 'right' },
|
||||
{ text: item.unitPrice.toCurrencyString(), fontSize: 8, alignment: 'right' },
|
||||
{ text: `${item.taxPercentage}%`, fontSize: 8, alignment: 'center' },
|
||||
{ text: item.totalCost.toCurrencyString(), fontSize: 8, alignment: 'right', bold: true },
|
||||
]);
|
||||
|
||||
const docDefinition: any = {
|
||||
pageSize: 'LETTER',
|
||||
pageMargins: [35, 35, 35, 35],
|
||||
defaultStyle: {
|
||||
font: 'Roboto',
|
||||
},
|
||||
content: [
|
||||
// Encabezado principal: Emisor y Recuadro Factura
|
||||
{
|
||||
columns: [
|
||||
{
|
||||
width: '*',
|
||||
stack: [
|
||||
{ text: emisor.razonSocial, fontSize: 13, bold: true, color: '#0f172a' },
|
||||
{ text: `NIT: ${emisor.nit}-${emisor.dv}`, fontSize: 9, bold: true, color: '#2563eb', margin: [0, 2, 0, 0] },
|
||||
{ text: `Régimen: ${emisor.regimenFiscal} | Responsabilidades: ${emisor.responsabilidadesFiscales}`, fontSize: 7, color: '#64748b' },
|
||||
{ text: `${emisor.direccion} - ${emisor.ciudad}, ${emisor.departamento}`, fontSize: 7.5, color: '#475569', margin: [0, 2, 0, 0] },
|
||||
{ text: `Tel: ${emisor.telefono} | Email: ${emisor.email}`, fontSize: 7.5, color: '#475569' },
|
||||
],
|
||||
},
|
||||
{
|
||||
width: 190,
|
||||
stack: [
|
||||
{
|
||||
table: {
|
||||
widths: ['*'],
|
||||
body: [
|
||||
[
|
||||
{
|
||||
fillColor: '#0f172a',
|
||||
stack: [
|
||||
{ text: 'FACTURA ELECTRÓNICA DE VENTA', color: '#ffffff', fontSize: 8, bold: true, alignment: 'center' },
|
||||
{ text: factura.fullNumber, color: '#38bdf8', fontSize: 13, bold: true, alignment: 'center', margin: [0, 3, 0, 0] },
|
||||
],
|
||||
margin: [4, 6, 4, 6],
|
||||
},
|
||||
],
|
||||
[
|
||||
{
|
||||
fillColor: '#f8fafc',
|
||||
stack: [
|
||||
{ text: `Fecha Emisión: ${factura.issueDate.toISOString().split('T')[0]} ${factura.issueTime}`, fontSize: 7.5 },
|
||||
{ text: `Forma de Pago: ${factura.paymentType === '1' ? 'Contado' : 'Crédito'}`, fontSize: 7.5, bold: true },
|
||||
{ text: `Medio de Pago: Código DIAN ${factura.paymentMethodCode}`, fontSize: 7.5 },
|
||||
],
|
||||
margin: [4, 4, 4, 4],
|
||||
},
|
||||
],
|
||||
],
|
||||
},
|
||||
layout: 'noBorders',
|
||||
},
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
|
||||
// Bloque Resolución DIAN
|
||||
{
|
||||
margin: [0, 10, 0, 8],
|
||||
table: {
|
||||
widths: ['*'],
|
||||
body: [
|
||||
[
|
||||
{
|
||||
fillColor: '#f1f5f9',
|
||||
text: `Autorización DIAN Resolución No. ${emisor.resolucionNumero} | Rango: ${emisor.resolucionRango} | Vigencia: ${emisor.resolucionVigencia}`,
|
||||
fontSize: 7,
|
||||
color: '#334155',
|
||||
alignment: 'center',
|
||||
},
|
||||
],
|
||||
],
|
||||
},
|
||||
layout: 'noBorders',
|
||||
},
|
||||
|
||||
// Datos del Cliente (Adquiriente)
|
||||
{
|
||||
table: {
|
||||
widths: ['*'],
|
||||
body: [
|
||||
[
|
||||
{
|
||||
fillColor: '#f8fafc',
|
||||
margin: [6, 6, 6, 6],
|
||||
columns: [
|
||||
{
|
||||
width: '*',
|
||||
stack: [
|
||||
{ text: 'DATOS DEL ADQUIRIENTE / CLIENTE', fontSize: 8, bold: true, color: '#0f172a' },
|
||||
{ text: `Nombre / Razón Social: ${factura.customer.legalOrFullName}`, fontSize: 8, bold: true, margin: [0, 2, 0, 0] },
|
||||
{ text: `Identificación: ${factura.customer.identificationNumber}${factura.customer.dv ? `-${factura.customer.dv}` : ''}`, fontSize: 8 },
|
||||
{ text: `Dirección: ${factura.customer.address} - ${factura.customer.cityName}`, fontSize: 8 },
|
||||
],
|
||||
},
|
||||
{
|
||||
width: 200,
|
||||
stack: [
|
||||
{ text: `Email Fiscal: ${factura.customer.email}`, fontSize: 8 },
|
||||
{ text: `Teléfono: ${factura.customer.phone || 'No registra'}`, fontSize: 8 },
|
||||
{ text: `Régimen: ${factura.customer.taxRegime === '48' ? 'Responsable IVA' : 'No Responsable de IVA'}`, fontSize: 8 },
|
||||
],
|
||||
},
|
||||
],
|
||||
},
|
||||
],
|
||||
],
|
||||
},
|
||||
layout: 'noBorders',
|
||||
margin: [0, 0, 0, 10],
|
||||
},
|
||||
|
||||
// Tabla de Ítems
|
||||
{
|
||||
table: {
|
||||
headerRows: 1,
|
||||
widths: [65, '*', 45, 75, 40, 75],
|
||||
body: [
|
||||
[
|
||||
{ text: 'SKU', style: 'tableHeader' },
|
||||
{ text: 'Descripción', style: 'tableHeader' },
|
||||
{ text: 'Cant.', style: 'tableHeader', alignment: 'right' },
|
||||
{ text: 'Vr. Unitario', style: 'tableHeader', alignment: 'right' },
|
||||
{ text: 'IVA', style: 'tableHeader', alignment: 'center' },
|
||||
{ text: 'Total', style: 'tableHeader', alignment: 'right' },
|
||||
],
|
||||
...rows,
|
||||
],
|
||||
},
|
||||
layout: {
|
||||
fillColor: (rowIndex: number) => (rowIndex === 0 ? '#0f172a' : rowIndex % 2 === 0 ? '#f8fafc' : null),
|
||||
hLineWidth: () => 0.5,
|
||||
vLineWidth: () => 0,
|
||||
hLineColor: () => '#e2e8f0',
|
||||
},
|
||||
margin: [0, 0, 0, 12],
|
||||
},
|
||||
|
||||
// Resumen Financiero y Código QR
|
||||
{
|
||||
columns: [
|
||||
{
|
||||
width: 110,
|
||||
image: qrDataUrl,
|
||||
fit: [100, 100],
|
||||
},
|
||||
{
|
||||
width: '*',
|
||||
margin: [10, 0, 0, 0],
|
||||
stack: [
|
||||
{ text: 'CUFE (Código Único de Factura Electrónica):', fontSize: 7, bold: true, color: '#0f172a' },
|
||||
{ text: factura.cufe?.valor || 'N/A', fontSize: 6.5, color: '#475569', margin: [0, 2, 0, 6] },
|
||||
{
|
||||
text: 'Estado DIAN: ' + (factura.dianStatus === 'ACEPTADA' ? 'APROBADA Y VALIDADA' : factura.dianStatus),
|
||||
fontSize: 7.5,
|
||||
bold: true,
|
||||
color: factura.dianStatus === 'ACEPTADA' ? '#16a34a' : '#d97706',
|
||||
},
|
||||
{ text: `Software Propio: Innovación & Desarrollo S.A.S.`, fontSize: 6.5, color: '#64748b' },
|
||||
],
|
||||
},
|
||||
{
|
||||
width: 180,
|
||||
table: {
|
||||
widths: ['*', 70],
|
||||
body: [
|
||||
[{ text: 'Subtotal:', fontSize: 8 }, { text: factura.subtotal.toCurrencyString(), fontSize: 8, alignment: 'right' }],
|
||||
[{ text: 'Descuentos:', fontSize: 8 }, { text: factura.discountTotal.toCurrencyString(), fontSize: 8, alignment: 'right' }],
|
||||
[{ text: 'IVA (19%):', fontSize: 8, bold: true }, { text: factura.taxTotal.toCurrencyString(), fontSize: 8, alignment: 'right', bold: true }],
|
||||
[
|
||||
{ text: 'TOTAL A PAGAR:', fontSize: 9, bold: true, color: '#0f172a' },
|
||||
{ text: factura.grandTotal.toCurrencyString(), fontSize: 9, bold: true, alignment: 'right', color: '#2563eb' },
|
||||
],
|
||||
],
|
||||
},
|
||||
layout: 'lightHorizontalLines',
|
||||
},
|
||||
],
|
||||
},
|
||||
|
||||
// Pie Legal DIAN
|
||||
{
|
||||
margin: [0, 15, 0, 0],
|
||||
text: 'Esta factura electrónica de venta constituye título valor en los términos del artículo 774 del Código de Comercio. Representación gráfica generada según los estándares de la Resolución 000165 de 2023 de la DIAN.',
|
||||
fontSize: 6.5,
|
||||
color: '#94a3b8',
|
||||
alignment: 'center',
|
||||
},
|
||||
],
|
||||
styles: {
|
||||
tableHeader: {
|
||||
bold: true,
|
||||
fontSize: 8,
|
||||
color: '#ffffff',
|
||||
fillColor: '#0f172a',
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
return new Promise((resolve, reject) => {
|
||||
const pdfDoc = printer.createPdfKitDocument(docDefinition);
|
||||
const chunks: Buffer[] = [];
|
||||
|
||||
pdfDoc.on('data', (chunk: Buffer) => chunks.push(chunk));
|
||||
pdfDoc.on('end', () => resolve(Buffer.concat(chunks)));
|
||||
pdfDoc.on('error', (err) => reject(err));
|
||||
|
||||
pdfDoc.end();
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,34 @@
|
||||
import QRCode from 'qrcode';
|
||||
import { IQrGenerator } from '../../domain/ports/IDianClient.js';
|
||||
|
||||
export class QrGeneratorService implements IQrGenerator {
|
||||
public async generarDataUrl(contenido: string): Promise<string> {
|
||||
try {
|
||||
return await QRCode.toDataURL(contenido, {
|
||||
errorCorrectionLevel: 'M',
|
||||
margin: 2,
|
||||
width: 250,
|
||||
color: {
|
||||
dark: '#0f172a',
|
||||
light: '#ffffff',
|
||||
},
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('[QrGeneratorService] Error al generar QR Data URL:', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
public async generarSvg(contenido: string): Promise<string> {
|
||||
try {
|
||||
return await QRCode.toString(contenido, {
|
||||
type: 'svg',
|
||||
errorCorrectionLevel: 'M',
|
||||
margin: 2,
|
||||
});
|
||||
} catch (error) {
|
||||
console.error('[QrGeneratorService] Error al generar QR SVG:', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,35 @@
|
||||
import { createCipheriv, createDecipheriv, randomBytes } from 'node:crypto';
|
||||
|
||||
export class CryptoService {
|
||||
private readonly key: Buffer;
|
||||
|
||||
constructor(hexKey?: string) {
|
||||
const rawKey = hexKey || process.env.ENCRYPTION_KEY || '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef';
|
||||
this.key = Buffer.from(rawKey.slice(0, 64), 'hex');
|
||||
}
|
||||
|
||||
public encrypt(plainText: string): string {
|
||||
const iv = randomBytes(12); // 96 bits IV for AES-GCM
|
||||
const cipher = createCipheriv('aes-256-gcm', this.key, iv);
|
||||
let encrypted = cipher.update(plainText, 'utf8', 'hex');
|
||||
encrypted += cipher.final('hex');
|
||||
const authTag = cipher.getAuthTag().toString('hex');
|
||||
return `${iv.toString('hex')}:${authTag}:${encrypted}`;
|
||||
}
|
||||
|
||||
public decrypt(cipherText: string): string {
|
||||
const parts = cipherText.split(':');
|
||||
if (parts.length !== 3) {
|
||||
throw new Error('Formato de texto cifrado inválido para AES-GCM.');
|
||||
}
|
||||
const iv = Buffer.from(parts[0], 'hex');
|
||||
const authTag = Buffer.from(parts[1], 'hex');
|
||||
const encrypted = parts[2];
|
||||
|
||||
const decipher = createDecipheriv('aes-256-gcm', this.key, iv);
|
||||
decipher.setAuthTag(authTag);
|
||||
let decrypted = decipher.update(encrypted, 'hex', 'utf8');
|
||||
decrypted += decipher.final('utf8');
|
||||
return decrypted;
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,127 @@
|
||||
import { createHash, createSign } from 'node:crypto';
|
||||
import forge from 'node-forge';
|
||||
import { IXmlSigner } from '../../domain/ports/IDianClient.js';
|
||||
import { FirmaDigitalException } from '../../domain/exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export class XadesSigner implements IXmlSigner {
|
||||
/**
|
||||
* Aplica firma digital XAdES-BES Enveloped (UBL 2.1 DIAN)
|
||||
* Algoritmo: RSA-SHA256 con Canonicalización C14N
|
||||
*/
|
||||
public async firmarXadesBes(
|
||||
xmlRaw: string,
|
||||
p12Buffer?: Buffer,
|
||||
contrasenaP12?: string
|
||||
): Promise<string> {
|
||||
try {
|
||||
let certPem = '';
|
||||
let privateKeyPem = '';
|
||||
let certSerial = '1234567890';
|
||||
let issuerName = 'CN=ANDES SCD CA CLASE II, OU=Division de certificacion entidad final, O=ANDES SCD, C=CO';
|
||||
|
||||
if (p12Buffer && p12Buffer.length > 0 && contrasenaP12) {
|
||||
// Parsear certificado PKCS#12 con node-forge
|
||||
const p12Asn1 = forge.asn1.fromDer(p12Buffer.toString('binary'));
|
||||
const p12 = forge.pkcs12.pkcs12FromAsn1(p12Asn1, contrasenaP12);
|
||||
|
||||
// Extraer bolsa de claves y certificados
|
||||
const certBags = p12.getBags({ bagType: forge.pki.oids.certBag });
|
||||
const keyBags = p12.getBags({ bagType: forge.pki.oids.pkcs8ShroudedKeyBag });
|
||||
|
||||
const cert = certBags[forge.pki.oids.certBag]?.[0]?.cert;
|
||||
const key = keyBags[forge.pki.oids.pkcs8ShroudedKeyBag]?.[0]?.key;
|
||||
|
||||
if (cert && key) {
|
||||
certPem = forge.pki.certificateToPem(cert);
|
||||
privateKeyPem = forge.pki.privateKeyToPem(key);
|
||||
certSerial = cert.serialNumber;
|
||||
issuerName = cert.issuer.attributes
|
||||
.map((attr: any) => `${attr.shortName || attr.name}=${String(attr.value || '')}`)
|
||||
.join(', ');
|
||||
}
|
||||
}
|
||||
|
||||
// Si no se proporcionó P12 o no se pudo extraer, generar par de claves RSA 2048 para desarrollo
|
||||
if (!certPem || !privateKeyPem) {
|
||||
const keys = forge.pki.rsa.generateKeyPair(2048);
|
||||
const cert = forge.pki.createCertificate();
|
||||
cert.publicKey = keys.publicKey;
|
||||
cert.serialNumber = '9876543210';
|
||||
cert.validity.notBefore = new Date();
|
||||
cert.validity.notAfter = new Date();
|
||||
cert.validity.notAfter.setFullYear(cert.validity.notBefore.getFullYear() + 2);
|
||||
|
||||
const attrs = [
|
||||
{ name: 'commonName', value: 'INNOVACION & DESARROLLO S.A.S.' },
|
||||
{ name: 'countryName', value: 'CO' },
|
||||
{ shortName: 'OU', value: 'Facturacion Electronica Software Propio' },
|
||||
{ name: 'organizationName', value: 'INNOVACION & DESARROLLO S.A.S.' },
|
||||
];
|
||||
cert.setSubject(attrs);
|
||||
cert.setIssuer(attrs);
|
||||
cert.sign(keys.privateKey, forge.md.sha256.create());
|
||||
|
||||
certPem = forge.pki.certificateToPem(cert);
|
||||
privateKeyPem = forge.pki.privateKeyToPem(keys.privateKey);
|
||||
}
|
||||
|
||||
// Limpiar PEM del certificado para incrustar en ds:X509Certificate
|
||||
const certCleanBase64 = certPem
|
||||
.replace(/-----BEGIN CERTIFICATE-----/g, '')
|
||||
.replace(/-----END CERTIFICATE-----/g, '')
|
||||
.replace(/\s+/g, '');
|
||||
|
||||
// Calcular Digest SHA-256 del certificado para XAdES
|
||||
const certBinary = Buffer.from(certCleanBase64, 'base64');
|
||||
const certDigest = createHash('sha256').update(certBinary).digest('base64');
|
||||
|
||||
// Generar identificadores únicos de firma
|
||||
const sigId = `xmldsig-${createHash('md5').update(Date.now().toString()).digest('hex').slice(0, 8)}`;
|
||||
const keyInfoId = `${sigId}-keyinfo`;
|
||||
const signedPropertiesId = `${sigId}-signedprops`;
|
||||
|
||||
const signingTime = new Date().toISOString();
|
||||
|
||||
// Construcción del bloque xades:SignedProperties
|
||||
const signedPropertiesXml = `<xades:SignedProperties Id="${signedPropertiesId}" xmlns:xades="http://uri.etsi.org/01903/v1.3.2#"><xades:SignedSignatureProperties><xades:SigningTime>${signingTime}</xades:SigningTime><xades:SigningCertificate><xades:Cert><xades:CertDigest><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><ds:DigestValue>${certDigest}</ds:DigestValue></xades:CertDigest><xades:IssuerSerial><ds:X509IssuerName>${issuerName}</ds:X509IssuerName><ds:X509SerialNumber>${certSerial}</ds:X509SerialNumber></xades:IssuerSerial></xades:Cert></xades:SigningCertificate><xades:SignaturePolicyIdentifier><xades:SignaturePolicyId><xades:SigPolicyId><xades:Identifier>https://facturaelectronica.dian.gov.co/politicadefirma/v2/politicadefirmav2.pdf</xades:Identifier><xades:Description>Politica de firma para facturas electronicas de la Republica de Colombia</xades:Description></xades:SigPolicyId><xades:SigPolicyHash><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><ds:DigestValue>dMoMvtcG5aGcguqvVoFbSF6gPqmvMmTXDhHzuyPRo4w=</ds:DigestValue></xades:SigPolicyHash></xades:SignaturePolicyId></xades:SignaturePolicyIdentifier></xades:SignedSignatureProperties></xades:SignedProperties>`;
|
||||
|
||||
// Digest del SignedProperties
|
||||
const signedPropsDigest = createHash('sha256').update(signedPropertiesXml, 'utf8').digest('base64');
|
||||
|
||||
// Digest del contenido del documento XML original
|
||||
const docDigest = createHash('sha256').update(xmlRaw, 'utf8').digest('base64');
|
||||
|
||||
// SignedInfo
|
||||
const signedInfoXml = `<ds:SignedInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#"><ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/><ds:Reference Id="xmldsig-ref-doc" URI=""><ds:Transforms><ds:Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/></ds:Transforms><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><ds:DigestValue>${docDigest}</ds:DigestValue></ds:Reference><ds:Reference URI="#${signedPropertiesId}" Type="http://uri.etsi.org/01903#SignedProperties"><ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/><ds:DigestValue>${signedPropsDigest}</ds:DigestValue></ds:Reference></ds:SignedInfo>`;
|
||||
|
||||
// Firmar SignedInfo con RSA-SHA256
|
||||
const signer = createSign('RSA-SHA256');
|
||||
signer.update(signedInfoXml, 'utf8');
|
||||
const signatureValueBase64 = signer.sign(privateKeyPem, 'base64');
|
||||
|
||||
// Estructura completa ds:Signature
|
||||
const signatureBlockXml = `
|
||||
<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="${sigId}">
|
||||
${signedInfoXml}
|
||||
<ds:SignatureValue>${signatureValueBase64}</ds:SignatureValue>
|
||||
<ds:KeyInfo Id="${keyInfoId}">
|
||||
<ds:X509Data>
|
||||
<ds:X509Certificate>${certCleanBase64}</ds:X509Certificate>
|
||||
</ds:X509Data>
|
||||
</ds:KeyInfo>
|
||||
<ds:Object>
|
||||
<xades:QualifyingProperties Target="#${sigId}" xmlns:xades="http://uri.etsi.org/01903/v1.3.2#">
|
||||
${signedPropertiesXml}
|
||||
</xades:QualifyingProperties>
|
||||
</ds:Object>
|
||||
</ds:Signature>`.trim();
|
||||
|
||||
// Incrustar la firma en el placeholder de la extensión UBL
|
||||
const xmlFinal = xmlRaw.replace('<!-- SIGNATURE_PLACEHOLDER -->', signatureBlockXml);
|
||||
return xmlFinal;
|
||||
} catch (error) {
|
||||
const msg = error instanceof Error ? error.message : String(error);
|
||||
throw new FirmaDigitalException(`Error al generar la firma digital XAdES-BES: ${msg}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,98 @@
|
||||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||||
import { EmitirFacturaUseCase } from '../../application/use-cases/EmitirFacturaUseCase.js';
|
||||
import { ConsultarFacturasUseCase } from '../../application/use-cases/ConsultarFacturasUseCase.js';
|
||||
import { EmitirFacturaInputSchema } from '../../application/dtos/EmitirFacturaInputDto.js';
|
||||
import { AuthenticatedRequest } from '../middlewares/AuthenticationMiddleware.js';
|
||||
import { EstadoFacturaDian } from '../../domain/value-objects/FiscalEnums.js';
|
||||
|
||||
export class InvoiceController {
|
||||
constructor(
|
||||
private readonly emitirUseCase: EmitirFacturaUseCase,
|
||||
private readonly consultarUseCase: ConsultarFacturasUseCase
|
||||
) {}
|
||||
|
||||
public async emitir(req: FastifyRequest, reply: FastifyReply) {
|
||||
const authReq = req as AuthenticatedRequest;
|
||||
|
||||
// Si viene autenticado con master key, puede especificar tenantId en body o query
|
||||
let tenantId = authReq.tenant?.id;
|
||||
const bodyAny = req.body as any;
|
||||
if (authReq.isMaster && bodyAny?.tenantId) {
|
||||
tenantId = bodyAny.tenantId;
|
||||
}
|
||||
|
||||
if (!tenantId) {
|
||||
return reply.status(400).send({
|
||||
statusCode: 400,
|
||||
error: 'Bad Request',
|
||||
message: 'No se pudo determinar el tenant emisor. Especifique tenantId o use la API Key del tenant.',
|
||||
});
|
||||
}
|
||||
|
||||
const validatedInput = EmitirFacturaInputSchema.parse(req.body);
|
||||
const result = await this.emitirUseCase.ejecutar(validatedInput, { tenantId });
|
||||
|
||||
return reply.status(201).send({
|
||||
success: true,
|
||||
data: result,
|
||||
});
|
||||
}
|
||||
|
||||
public async listar(req: FastifyRequest, reply: FastifyReply) {
|
||||
const query = req.query as {
|
||||
tenantId?: string;
|
||||
estado?: EstadoFacturaDian;
|
||||
busqueda?: string;
|
||||
pagina?: string;
|
||||
limite?: string;
|
||||
};
|
||||
|
||||
const authReq = req as AuthenticatedRequest;
|
||||
const tenantId = authReq.isMaster ? query.tenantId : authReq.tenant?.id || query.tenantId;
|
||||
|
||||
const result = await this.consultarUseCase.listar({
|
||||
tenantId,
|
||||
estado: query.estado,
|
||||
busqueda: query.busqueda,
|
||||
pagina: query.pagina ? parseInt(query.pagina, 10) : 1,
|
||||
limite: query.limite ? parseInt(query.limite, 10) : 20,
|
||||
});
|
||||
|
||||
return reply.send({
|
||||
success: true,
|
||||
data: result.items,
|
||||
total: result.total,
|
||||
});
|
||||
}
|
||||
|
||||
public async obtenerPorId(req: FastifyRequest, reply: FastifyReply) {
|
||||
const { id } = req.params as { id: string };
|
||||
const invoice = await this.consultarUseCase.obtenerPorId(id);
|
||||
return reply.send({ success: true, data: invoice });
|
||||
}
|
||||
|
||||
public async descargarXml(req: FastifyRequest, reply: FastifyReply) {
|
||||
const { id } = req.params as { id: string };
|
||||
const xml = await this.consultarUseCase.obtenerXmlFirmado(id);
|
||||
reply.header('Content-Type', 'application/xml; charset=utf-8');
|
||||
reply.header('Content-Disposition', `attachment; filename="factura_${id}.xml"`);
|
||||
return reply.send(xml);
|
||||
}
|
||||
|
||||
public async descargarPdf(req: FastifyRequest, reply: FastifyReply) {
|
||||
const { id } = req.params as { id: string };
|
||||
const pdfBuffer = await this.consultarUseCase.generarPdf(id);
|
||||
reply.header('Content-Type', 'application/pdf');
|
||||
reply.header('Content-Disposition', `inline; filename="factura_${id}.pdf"`);
|
||||
return reply.send(pdfBuffer);
|
||||
}
|
||||
|
||||
public async obtenerMetricas(req: FastifyRequest, reply: FastifyReply) {
|
||||
const query = req.query as { tenantId?: string };
|
||||
const authReq = req as AuthenticatedRequest;
|
||||
const tenantId = authReq.isMaster ? query.tenantId : authReq.tenant?.id || query.tenantId;
|
||||
|
||||
const metrics = await this.consultarUseCase.obtenerMetricas(tenantId);
|
||||
return reply.send({ success: true, data: metrics });
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,28 @@
|
||||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||||
import { IResolucionRepository } from '../../domain/ports/IResolucionRepository.js';
|
||||
|
||||
export class ResolutionController {
|
||||
constructor(private readonly resolucionRepository: IResolucionRepository) {}
|
||||
|
||||
public async listar(req: FastifyRequest, reply: FastifyReply) {
|
||||
const resolutions = await this.resolucionRepository.listar();
|
||||
return reply.send({
|
||||
success: true,
|
||||
data: resolutions.map((r) => ({
|
||||
id: r.id,
|
||||
tenantId: r.tenantId,
|
||||
resolutionNumber: r.resolutionNumber,
|
||||
prefix: r.prefix,
|
||||
fromNumber: r.fromNumber.toString(),
|
||||
toNumber: r.toNumber.toString(),
|
||||
currentConsecutive: r.currentConsecutive.toString(),
|
||||
startDate: r.startDate.toISOString().split('T')[0],
|
||||
endDate: r.endDate.toISOString().split('T')[0],
|
||||
isActive: r.isActive,
|
||||
documentType: r.documentType,
|
||||
porcentajeConsumido: r.porcentajeConsumido(),
|
||||
diasRestantes: r.diasRestantesVigencia(),
|
||||
})),
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,23 @@
|
||||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||||
import { ITenantRepository } from '../../domain/ports/ITenantRepository.js';
|
||||
|
||||
export class TenantController {
|
||||
constructor(private readonly tenantRepository: ITenantRepository) {}
|
||||
|
||||
public async listar(req: FastifyRequest, reply: FastifyReply) {
|
||||
const tenants = await this.tenantRepository.listar();
|
||||
return reply.send({
|
||||
success: true,
|
||||
data: tenants.map((t) => ({
|
||||
id: t.id,
|
||||
name: t.name,
|
||||
slug: t.slug,
|
||||
status: t.status,
|
||||
economicActivityCode: t.economicActivityCode,
|
||||
contactEmail: t.contactEmail,
|
||||
webhookUrl: t.webhookUrl,
|
||||
createdAt: t.createdAt,
|
||||
})),
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -0,0 +1,56 @@
|
||||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||||
import { ITenantRepository } from '../../domain/ports/ITenantRepository.js';
|
||||
import { Tenant } from '../../domain/entities/Tenant.js';
|
||||
|
||||
export interface AuthenticatedRequest extends FastifyRequest {
|
||||
tenant?: Tenant;
|
||||
isMaster?: boolean;
|
||||
}
|
||||
|
||||
export function createAuthMiddleware(tenantRepository: ITenantRepository) {
|
||||
return async (req: FastifyRequest, reply: FastifyReply) => {
|
||||
// Rutas públicas que no requieren autenticación (health, swagger, etc.)
|
||||
const publicPaths = ['/health', '/api/docs', '/api/docs/json', '/api/docs/static'];
|
||||
if (publicPaths.some((p) => req.url.startsWith(p))) {
|
||||
return;
|
||||
}
|
||||
|
||||
const apiKey = (req.headers['x-api-key'] || req.headers['authorization']?.replace('Bearer ', '')) as string | undefined;
|
||||
|
||||
const masterKey = process.env.API_KEY_MASTER || 'dev_master_key_innovacion_2026_secure';
|
||||
|
||||
if (apiKey === masterKey) {
|
||||
(req as AuthenticatedRequest).isMaster = true;
|
||||
return;
|
||||
}
|
||||
|
||||
if (!apiKey) {
|
||||
return reply.status(401).send({
|
||||
statusCode: 401,
|
||||
error: 'Unauthorized',
|
||||
message: 'Cabecera de autenticación "x-api-key" requerida.',
|
||||
});
|
||||
}
|
||||
|
||||
const hash = Tenant.hashApiKey(apiKey);
|
||||
const tenant = await tenantRepository.buscarPorApiKeyHash(hash);
|
||||
|
||||
if (!tenant) {
|
||||
return reply.status(403).send({
|
||||
statusCode: 403,
|
||||
error: 'Forbidden',
|
||||
message: 'API Key inválida o no autorizada para el Hub Fiscal.',
|
||||
});
|
||||
}
|
||||
|
||||
if (!tenant.isActivo) {
|
||||
return reply.status(403).send({
|
||||
statusCode: 403,
|
||||
error: 'Forbidden',
|
||||
message: `El tenant "${tenant.name}" se encuentra suspendido.`,
|
||||
});
|
||||
}
|
||||
|
||||
(req as AuthenticatedRequest).tenant = tenant;
|
||||
};
|
||||
}
|
||||
@ -0,0 +1,35 @@
|
||||
import { FastifyError, FastifyRequest, FastifyReply } from 'fastify';
|
||||
import { ZodError } from 'zod';
|
||||
import { DomainException } from '../../domain/exceptions/ValidacionFiscalException.js';
|
||||
|
||||
export function errorHandler(error: FastifyError, req: FastifyRequest, reply: FastifyReply) {
|
||||
req.log.error(error);
|
||||
|
||||
if (error instanceof ZodError) {
|
||||
return reply.status(400).send({
|
||||
statusCode: 400,
|
||||
error: 'Bad Request',
|
||||
code: 'SCHEMA_VALIDATION_ERROR',
|
||||
message: 'Los datos suministrados no cumplen con el esquema fiscal requerido.',
|
||||
issues: error.issues.map((i) => ({
|
||||
campo: i.path.join('.'),
|
||||
mensaje: i.message,
|
||||
})),
|
||||
});
|
||||
}
|
||||
|
||||
if (error instanceof DomainException) {
|
||||
return reply.status(error.statusCode).send({
|
||||
statusCode: error.statusCode,
|
||||
error: error.name,
|
||||
code: error.code,
|
||||
message: error.message,
|
||||
});
|
||||
}
|
||||
|
||||
return reply.status(error.statusCode || 500).send({
|
||||
statusCode: error.statusCode || 500,
|
||||
error: 'Internal Server Error',
|
||||
message: error.message || 'Ha ocurrido un error inesperado en el Hub Fiscal.',
|
||||
});
|
||||
}
|
||||
@ -0,0 +1,45 @@
|
||||
import { FastifyInstance } from 'fastify';
|
||||
import { InvoiceController } from '../controllers/InvoiceController.js';
|
||||
import { TenantController } from '../controllers/TenantController.js';
|
||||
import { ResolutionController } from '../controllers/ResolutionController.js';
|
||||
|
||||
export function registerRoutes(
|
||||
server: FastifyInstance,
|
||||
invoiceController: InvoiceController,
|
||||
tenantController: TenantController,
|
||||
resolutionController: ResolutionController
|
||||
) {
|
||||
// Health Check
|
||||
server.get('/health', async () => {
|
||||
return {
|
||||
status: 'UP',
|
||||
service: 'DIAN Fiscal Hub - Software Propio',
|
||||
company: 'Innovación & Desarrollo S.A.S.',
|
||||
nit: '901.554.892-4',
|
||||
dianEnvironment: process.env.DIAN_ENVIRONMENT || 'HABILITACION',
|
||||
timestamp: new Date().toISOString(),
|
||||
uptimeSeconds: process.uptime(),
|
||||
memoryUsageMB: Math.round(process.memoryUsage().rss / 1024 / 1024),
|
||||
};
|
||||
});
|
||||
|
||||
// Prefijo API v1
|
||||
server.register(
|
||||
async (apiV1) => {
|
||||
// Invoices
|
||||
apiV1.post('/invoices', invoiceController.emitir.bind(invoiceController));
|
||||
apiV1.get('/invoices', invoiceController.listar.bind(invoiceController));
|
||||
apiV1.get('/invoices/metrics', invoiceController.obtenerMetricas.bind(invoiceController));
|
||||
apiV1.get('/invoices/:id', invoiceController.obtenerPorId.bind(invoiceController));
|
||||
apiV1.get('/invoices/:id/xml', invoiceController.descargarXml.bind(invoiceController));
|
||||
apiV1.get('/invoices/:id/pdf', invoiceController.descargarPdf.bind(invoiceController));
|
||||
|
||||
// Tenants
|
||||
apiV1.get('/tenants', tenantController.listar.bind(tenantController));
|
||||
|
||||
// Resolutions
|
||||
apiV1.get('/resolutions', resolutionController.listar.bind(resolutionController));
|
||||
},
|
||||
{ prefix: '/api/v1' }
|
||||
);
|
||||
}
|
||||
137
facturacion-dian-hub/backend/src/presentation/server.ts
Normal file
137
facturacion-dian-hub/backend/src/presentation/server.ts
Normal file
@ -0,0 +1,137 @@
|
||||
import fastify, { FastifyInstance } from 'fastify';
|
||||
import cors from '@fastify/cors';
|
||||
import helmet from '@fastify/helmet';
|
||||
import rateLimit from '@fastify/rate-limit';
|
||||
import swagger from '@fastify/swagger';
|
||||
import swaggerUi from '@fastify/swagger-ui';
|
||||
|
||||
import { RepositoryFactory } from '../infrastructure/database/RepositoryFactory.js';
|
||||
import { XadesSigner } from '../infrastructure/security/XadesSigner.js';
|
||||
import { DianSoapClient } from '../infrastructure/dian/DianSoapClient.js';
|
||||
import { QrGeneratorService } from '../infrastructure/qr/QrGeneratorService.js';
|
||||
import { PdfGeneratorService } from '../infrastructure/printing/PdfGeneratorService.js';
|
||||
|
||||
import { EmitirFacturaUseCase } from '../application/use-cases/EmitirFacturaUseCase.js';
|
||||
import { ConsultarFacturasUseCase } from '../application/use-cases/ConsultarFacturasUseCase.js';
|
||||
|
||||
import { InvoiceController } from './controllers/InvoiceController.js';
|
||||
import { TenantController } from './controllers/TenantController.js';
|
||||
import { ResolutionController } from './controllers/ResolutionController.js';
|
||||
|
||||
import { createAuthMiddleware } from './middlewares/AuthenticationMiddleware.js';
|
||||
import { errorHandler } from './middlewares/ErrorHandlerMiddleware.js';
|
||||
import { registerRoutes } from './routes/index.js';
|
||||
|
||||
export async function buildServer(): Promise<FastifyInstance> {
|
||||
const server = fastify({
|
||||
logger: {
|
||||
level: process.env.NODE_ENV === 'production' ? 'info' : 'info',
|
||||
},
|
||||
bodyLimit: 10 * 1024 * 1024, // 10MB limit for signed XML / certificates
|
||||
});
|
||||
|
||||
// 1. Seguridad y Plugins
|
||||
await server.register(helmet, {
|
||||
contentSecurityPolicy: false,
|
||||
crossOriginEmbedderPolicy: false,
|
||||
});
|
||||
|
||||
await server.register(cors, {
|
||||
origin: true,
|
||||
methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
|
||||
allowedHeaders: ['Content-Type', 'Authorization', 'x-api-key'],
|
||||
credentials: true,
|
||||
});
|
||||
|
||||
await server.register(rateLimit, {
|
||||
max: 300,
|
||||
timeWindow: '1 minute',
|
||||
});
|
||||
|
||||
// 2. Documentación OpenAPI / Swagger
|
||||
await server.register(swagger, {
|
||||
openapi: {
|
||||
info: {
|
||||
title: 'DIAN Electronic Invoicing Hub API',
|
||||
description:
|
||||
'Microservicio centralizado de Facturación Electrónica DIAN UBL 2.1 (Software Propio) para Innovación & Desarrollo S.A.S. (Multi-tenant: DripZone & PacificTrans)',
|
||||
version: '1.0.0',
|
||||
contact: {
|
||||
name: 'Equipo de Arquitectura e Innovación',
|
||||
email: 'arquitectura@innovacionydesarrollo.co',
|
||||
},
|
||||
},
|
||||
servers: [
|
||||
{
|
||||
url: 'http://localhost:3001',
|
||||
description: 'Servidor Local de Desarrollo',
|
||||
},
|
||||
],
|
||||
components: {
|
||||
securitySchemes: {
|
||||
apiKeyAuth: {
|
||||
type: 'apiKey',
|
||||
name: 'x-api-key',
|
||||
in: 'header',
|
||||
description: 'API Key del Tenant emisor (DripZone, PacificTrans) o Master Key.',
|
||||
},
|
||||
},
|
||||
},
|
||||
security: [{ apiKeyAuth: [] }],
|
||||
},
|
||||
});
|
||||
|
||||
await server.register(swaggerUi, {
|
||||
routePrefix: '/api/docs',
|
||||
uiConfig: {
|
||||
docExpansion: 'list',
|
||||
deepLinking: true,
|
||||
},
|
||||
});
|
||||
|
||||
// 3. Inyección de Dependencias
|
||||
const { facturaRepository, tenantRepository, resolucionRepository } =
|
||||
await RepositoryFactory.getRepositories();
|
||||
|
||||
const xmlSigner = new XadesSigner();
|
||||
const dianClient = new DianSoapClient({
|
||||
endpointUrl:
|
||||
process.env.DIAN_ENVIRONMENT === 'PRODUCCION'
|
||||
? process.env.DIAN_VPFE_PRODUCCION_URL || 'https://vpfe.dian.gov.co/WcfDianCustomerServices.svc'
|
||||
: process.env.DIAN_VPFE_HABILITACION_URL || 'https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc',
|
||||
environment: (process.env.DIAN_ENVIRONMENT as 'HABILITACION' | 'PRODUCCION') || 'HABILITACION',
|
||||
enableSimulator: true, // Habilitado para modo sandbox continuo
|
||||
});
|
||||
const qrGenerator = new QrGeneratorService();
|
||||
const pdfGenerator = new PdfGeneratorService();
|
||||
|
||||
const emitirUseCase = new EmitirFacturaUseCase(
|
||||
facturaRepository,
|
||||
tenantRepository,
|
||||
resolucionRepository,
|
||||
dianClient,
|
||||
xmlSigner,
|
||||
qrGenerator,
|
||||
pdfGenerator
|
||||
);
|
||||
|
||||
const consultarUseCase = new ConsultarFacturasUseCase(
|
||||
facturaRepository,
|
||||
resolucionRepository,
|
||||
qrGenerator,
|
||||
pdfGenerator
|
||||
);
|
||||
|
||||
const invoiceController = new InvoiceController(emitirUseCase, consultarUseCase);
|
||||
const tenantController = new TenantController(tenantRepository);
|
||||
const resolutionController = new ResolutionController(resolucionRepository);
|
||||
|
||||
// 4. Middlewares globales
|
||||
server.addHook('onRequest', createAuthMiddleware(tenantRepository));
|
||||
server.setErrorHandler(errorHandler);
|
||||
|
||||
// 5. Registro de Rutas
|
||||
registerRoutes(server, invoiceController, tenantController, resolutionController);
|
||||
|
||||
return server;
|
||||
}
|
||||
55
facturacion-dian-hub/backend/tests/DianFiscalRules.test.ts
Normal file
55
facturacion-dian-hub/backend/tests/DianFiscalRules.test.ts
Normal file
@ -0,0 +1,55 @@
|
||||
import { describe, it } from 'node:test';
|
||||
import assert from 'node:assert';
|
||||
import { Nit } from '../src/domain/value-objects/Nit.js';
|
||||
import { Cufe } from '../src/domain/value-objects/Cufe.js';
|
||||
import { SoftwareSecurityCode } from '../src/domain/value-objects/SoftwareSecurityCode.js';
|
||||
|
||||
describe('Reglas Fiscales DIAN Colombia UBL 2.1 (Resolución 000165 de 2023)', () => {
|
||||
it('Debe calcular correctamente el Dígito de Verificación (Módulo 11) para NIT de Innovación & Desarrollo S.A.S.', () => {
|
||||
// NIT 901554892 -> DV = 9
|
||||
const dvCalculado = Nit.calcularDigitoVerificacion('901554892');
|
||||
assert.strictEqual(dvCalculado, '9');
|
||||
|
||||
const nit = new Nit('901554892', '9');
|
||||
assert.strictEqual(nit.nitCompleto, '901554892-9');
|
||||
});
|
||||
|
||||
it('Debe calcular correctamente el DV para NIT DIAN (800197268 -> DV = 4)', () => {
|
||||
const dvDian = Nit.calcularDigitoVerificacion('800197268');
|
||||
assert.strictEqual(dvDian, '4');
|
||||
});
|
||||
|
||||
it('Debe generar un CUFE SHA-384 válido de 96 caracteres hexadecimales', () => {
|
||||
const cufe = Cufe.generar({
|
||||
numFac: 'DRIP-1001',
|
||||
fecFac: '2026-10-19',
|
||||
horFac: '17:00:00-05:00',
|
||||
valFac: 100000.0,
|
||||
codImp1: '01',
|
||||
valImp1: 19000.0,
|
||||
codImp2: '04',
|
||||
valImp2: 0.0,
|
||||
codImp3: '03',
|
||||
valImp3: 0.0,
|
||||
valTot: 119000.0,
|
||||
nitOFE: '901554892',
|
||||
numAdq: '1144123456',
|
||||
claveTecnica: 'fc8eac422eba16e22ffd8c6f94b3f40a6e38162c',
|
||||
tipoAmbiente: '2',
|
||||
});
|
||||
|
||||
assert.strictEqual(cufe.valor.length, 96);
|
||||
assert.match(cufe.valor, /^[a-f0-9]{96}$/);
|
||||
});
|
||||
|
||||
it('Debe generar un SoftwareSecurityCode SHA-384 consistente', () => {
|
||||
const code = SoftwareSecurityCode.generar(
|
||||
'd5e07b47-6aea-43cc-b38c-3c7d46b4a52f',
|
||||
'75319',
|
||||
'DRIP-1001'
|
||||
);
|
||||
|
||||
assert.strictEqual(code.hash.length, 96);
|
||||
assert.match(code.hash, /^[a-f0-9]{96}$/);
|
||||
});
|
||||
});
|
||||
20
facturacion-dian-hub/backend/tsconfig.json
Normal file
20
facturacion-dian-hub/backend/tsconfig.json
Normal file
@ -0,0 +1,20 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "NodeNext",
|
||||
"moduleResolution": "NodeNext",
|
||||
"lib": ["ES2022"],
|
||||
"outDir": "./dist",
|
||||
"rootDir": "./src",
|
||||
"strict": true,
|
||||
"esModuleInterop": true,
|
||||
"skipLibCheck": true,
|
||||
"forceConsistentCasingInFileNames": true,
|
||||
"declaration": true,
|
||||
"sourceMap": true,
|
||||
"resolveJsonModule": true,
|
||||
"types": ["node"]
|
||||
},
|
||||
"include": ["src/**/*"],
|
||||
"exclude": ["node_modules", "dist"]
|
||||
}
|
||||
74
facturacion-dian-hub/coolify-compose.yml
Normal file
74
facturacion-dian-hub/coolify-compose.yml
Normal file
@ -0,0 +1,74 @@
|
||||
# ========================================================
|
||||
# ARCHIVO DE DESPLIEGUE PARA COOLIFY (v4)
|
||||
# Hub Fiscal Facturación Electrónica DIAN UBL 2.1
|
||||
# Subdominio recomendado: https://facturacion.almeira.com.co
|
||||
# ========================================================
|
||||
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# 1. Base de datos PostgreSQL 16 Alpine
|
||||
postgres:
|
||||
image: postgres:16-alpine
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
POSTGRES_DB: dian_hub_db
|
||||
POSTGRES_USER: ${POSTGRES_USER:-postgres}
|
||||
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-dian_secure_prod_2026}
|
||||
volumes:
|
||||
- dian_db_data:/var/lib/postgresql/data
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-postgres} -d dian_hub_db"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
networks:
|
||||
- dian_network
|
||||
|
||||
# 2. Microservicio Backend (Fastify v4/v5 + TypeScript Strict)
|
||||
backend:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile.backend
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
PORT: 3001
|
||||
HOST: 0.0.0.0
|
||||
NODE_ENV: production
|
||||
DATABASE_URL: "postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-dian_secure_prod_2026}@postgres:5432/dian_hub_db?schema=public"
|
||||
API_KEY_MASTER: ${API_KEY_MASTER:-dev_master_key_innovacion_2026_secure}
|
||||
JWT_SECRET: ${JWT_SECRET:-super_secret_jwt_key_dian_hub_innovacion_2026}
|
||||
ENCRYPTION_KEY: ${ENCRYPTION_KEY:-0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef}
|
||||
DIAN_ENVIRONMENT: ${DIAN_ENVIRONMENT:-HABILITACION}
|
||||
DIAN_SOFTWARE_ID: ${DIAN_SOFTWARE_ID:-d5e07b47-6aea-43cc-b38c-3c7d46b4a52f}
|
||||
DIAN_SOFTWARE_PIN: ${DIAN_SOFTWARE_PIN:-75319}
|
||||
DIAN_TEST_SET_ID: ${DIAN_TEST_SET_ID:-c48d035e-c15c-4f76-905c-efbc912389a0}
|
||||
depends_on:
|
||||
postgres:
|
||||
condition: service_healthy
|
||||
networks:
|
||||
- dian_network
|
||||
|
||||
# 3. Frontend Panel (React 18 + Vite + Nginx) con Reverse Proxy integrado
|
||||
# Este servicio expone tanto la web como la API al subdominio configurado en Coolify
|
||||
frontend:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile.frontend
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
# Coolify asigna el subdominio y gestiona el certificado SSL con Traefik
|
||||
- COOLIFY_URL=https://facturacion.almeira.com.co
|
||||
depends_on:
|
||||
- backend
|
||||
networks:
|
||||
- dian_network
|
||||
|
||||
volumes:
|
||||
dian_db_data:
|
||||
name: dian_hub_db_data
|
||||
|
||||
networks:
|
||||
dian_network:
|
||||
name: dian_hub_network
|
||||
driver: bridge
|
||||
81
facturacion-dian-hub/docker-compose.yml
Normal file
81
facturacion-dian-hub/docker-compose.yml
Normal file
@ -0,0 +1,81 @@
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
# ========================================================
|
||||
# BASE DE DATOS: PostgreSQL 16 Alpine con ACID Estricto
|
||||
# ========================================================
|
||||
postgres:
|
||||
image: postgres:16-alpine
|
||||
container_name: dian_hub_postgres
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
POSTGRES_DB: dian_hub_db
|
||||
POSTGRES_USER: postgres
|
||||
POSTGRES_PASSWORD: postgres123_secure_hub
|
||||
ports:
|
||||
- "5432:5432"
|
||||
volumes:
|
||||
- dian_pgdata:/var/lib/postgresql/data
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U postgres -d dian_hub_db"]
|
||||
interval: 10s
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
networks:
|
||||
- dian_hub_network
|
||||
|
||||
# ========================================================
|
||||
# MICROSERVICIO BACKEND: Fastify + Clean Architecture UBL 2.1
|
||||
# ========================================================
|
||||
backend:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile.backend
|
||||
container_name: dian_hub_backend
|
||||
restart: unless-stopped
|
||||
environment:
|
||||
PORT: 3001
|
||||
HOST: 0.0.0.0
|
||||
NODE_ENV: production
|
||||
DATABASE_URL: "postgresql://postgres:postgres123_secure_hub@postgres:5432/dian_hub_db?schema=public"
|
||||
API_KEY_MASTER: "dev_master_key_innovacion_2026_secure"
|
||||
JWT_SECRET: "super_secret_jwt_key_dian_hub_innovacion_2026"
|
||||
ENCRYPTION_KEY: "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
|
||||
DIAN_ENVIRONMENT: "HABILITACION"
|
||||
DIAN_SOFTWARE_ID: "d5e07b47-6aea-43cc-b38c-3c7d46b4a52f"
|
||||
DIAN_SOFTWARE_PIN: "75319"
|
||||
DIAN_TEST_SET_ID: "c48d035e-c15c-4f76-905c-efbc912389a0"
|
||||
DIAN_VPFE_HABILITACION_URL: "https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc"
|
||||
DIAN_VPFE_PRODUCCION_URL: "https://vpfe.dian.gov.co/WcfDianCustomerServices.svc"
|
||||
ports:
|
||||
- "3001:3001"
|
||||
depends_on:
|
||||
postgres:
|
||||
condition: service_healthy
|
||||
networks:
|
||||
- dian_hub_network
|
||||
|
||||
# ========================================================
|
||||
# PANEL ADMINISTRATIVO WEB: React 18 + Vite + Nginx Alpine
|
||||
# ========================================================
|
||||
frontend:
|
||||
build:
|
||||
context: .
|
||||
dockerfile: Dockerfile.frontend
|
||||
container_name: dian_hub_frontend
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- "3000:80"
|
||||
depends_on:
|
||||
- backend
|
||||
networks:
|
||||
- dian_hub_network
|
||||
|
||||
volumes:
|
||||
dian_pgdata:
|
||||
name: dian_hub_pgdata
|
||||
|
||||
networks:
|
||||
dian_hub_network:
|
||||
name: dian_hub_network
|
||||
driver: bridge
|
||||
16
facturacion-dian-hub/frontend/index.html
Normal file
16
facturacion-dian-hub/frontend/index.html
Normal file
@ -0,0 +1,16 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="es" class="dark">
|
||||
<head>
|
||||
<meta charset="UTF-8" />
|
||||
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%2310b981' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'><path d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z'></path><polyline points='14 2 14 8 20 8'></polyline><line x1='16' y1='13' x2='8' y2='13'></line><line x1='16' y1='17' x2='8' y2='17'></line><polyline points='10 9 9 9 8 9'></polyline></svg>" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>Hub Fiscal DIAN | Innovación & Desarrollo S.A.S.</title>
|
||||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||||
<link href="https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@300;400;500;600;700;800&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
|
||||
</head>
|
||||
<body class="bg-[#070b14] text-slate-100 antialiased selection:bg-emerald-500/30 selection:text-emerald-300 min-h-screen">
|
||||
<div id="root"></div>
|
||||
<script type="module" src="/src/main.tsx"></script>
|
||||
</body>
|
||||
</html>
|
||||
2788
facturacion-dian-hub/frontend/package-lock.json
generated
Normal file
2788
facturacion-dian-hub/frontend/package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load Diff
29
facturacion-dian-hub/frontend/package.json
Normal file
29
facturacion-dian-hub/frontend/package.json
Normal file
@ -0,0 +1,29 @@
|
||||
{
|
||||
"name": "dian-fiscal-hub-panel",
|
||||
"private": true,
|
||||
"version": "1.0.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
"build": "tsc && vite build",
|
||||
"preview": "vite preview"
|
||||
},
|
||||
"dependencies": {
|
||||
"clsx": "^2.1.1",
|
||||
"lucide-react": "^0.453.0",
|
||||
"react": "^18.3.1",
|
||||
"react-dom": "^18.3.1",
|
||||
"tailwind-merge": "^2.5.4",
|
||||
"zustand": "^5.0.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/react": "^18.3.11",
|
||||
"@types/react-dom": "^18.3.1",
|
||||
"@vitejs/plugin-react": "^4.3.3",
|
||||
"autoprefixer": "^10.4.20",
|
||||
"postcss": "^8.4.47",
|
||||
"tailwindcss": "^3.4.14",
|
||||
"typescript": "^5.6.3",
|
||||
"vite": "^5.4.9"
|
||||
}
|
||||
}
|
||||
6
facturacion-dian-hub/frontend/postcss.config.js
Normal file
6
facturacion-dian-hub/frontend/postcss.config.js
Normal file
@ -0,0 +1,6 @@
|
||||
export default {
|
||||
plugins: {
|
||||
tailwindcss: {},
|
||||
autoprefixer: {},
|
||||
},
|
||||
}
|
||||
147
facturacion-dian-hub/frontend/src/App.tsx
Normal file
147
facturacion-dian-hub/frontend/src/App.tsx
Normal file
@ -0,0 +1,147 @@
|
||||
import React, { useEffect } from 'react';
|
||||
import { useHubStore } from './store/useHubStore.js';
|
||||
import { hubApi } from './api/hubApi.js';
|
||||
import { Navbar } from './components/layout/Navbar.js';
|
||||
import { KpiMetrics } from './components/ui/KpiMetrics.js';
|
||||
import { InvoicesTable } from './components/InvoicesTable.js';
|
||||
import { ResolutionsView } from './components/ResolutionsView.js';
|
||||
import { TenantsView } from './components/TenantsView.js';
|
||||
import { InvoiceDetailModal } from './components/InvoiceDetailModal.js';
|
||||
import { InvoiceEmitterModal } from './components/InvoiceEmitterModal.js';
|
||||
import {
|
||||
FileText,
|
||||
Server,
|
||||
ShieldCheck,
|
||||
Zap,
|
||||
Layers,
|
||||
Sparkles,
|
||||
ExternalLink,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const App: React.FC = () => {
|
||||
const {
|
||||
activeTab,
|
||||
selectedTenantId,
|
||||
setInvoices,
|
||||
setTenants,
|
||||
setResolutions,
|
||||
setMetrics,
|
||||
setLoading,
|
||||
setError,
|
||||
isLoading,
|
||||
setIsEmitterModalOpen,
|
||||
} = useHubStore();
|
||||
|
||||
useEffect(() => {
|
||||
async function loadInitialData() {
|
||||
setLoading(true);
|
||||
try {
|
||||
const [tenantsData, resData, metricsData, invoicesData] = await Promise.all([
|
||||
hubApi.getTenants(),
|
||||
hubApi.getResolutions(),
|
||||
hubApi.getMetrics(selectedTenantId),
|
||||
hubApi.getInvoices(selectedTenantId),
|
||||
]);
|
||||
|
||||
setTenants(tenantsData);
|
||||
setResolutions(resData);
|
||||
setMetrics(metricsData);
|
||||
setInvoices(invoicesData.items);
|
||||
} catch (err: any) {
|
||||
console.error('Error al inicializar datos:', err);
|
||||
setError(err.message || 'No se pudo conectar con el microservicio Fastify.');
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
}
|
||||
|
||||
loadInitialData();
|
||||
}, [selectedTenantId]);
|
||||
|
||||
return (
|
||||
<div className="min-h-screen bg-[#070b14] text-slate-100 flex flex-col font-sans">
|
||||
<Navbar />
|
||||
|
||||
<main className="flex-1 max-w-7xl w-full mx-auto px-4 sm:px-6 lg:px-8 py-8 space-y-8">
|
||||
{/* Banner Hero */}
|
||||
<div className="relative overflow-hidden rounded-3xl border border-slate-800 bg-gradient-to-r from-emerald-950/40 via-slate-900/60 to-blue-950/40 p-6 sm:p-8 backdrop-blur-xl">
|
||||
<div className="relative z-10 flex flex-col lg:flex-row items-start lg:items-center justify-between gap-6">
|
||||
<div className="space-y-2">
|
||||
<div className="inline-flex items-center gap-2 rounded-full border border-emerald-500/30 bg-emerald-500/10 px-3 py-1 text-xs font-semibold text-emerald-400">
|
||||
<Sparkles className="h-3.5 w-3.5" />
|
||||
<span>Resolución DIAN 000165 de 2023 & Anexos Vigentes</span>
|
||||
</div>
|
||||
<h1 className="text-2xl sm:text-3xl font-black tracking-tight text-white">
|
||||
Hub Central de Facturación Electrónica DIAN
|
||||
</h1>
|
||||
<p className="text-sm text-slate-300 max-w-2xl">
|
||||
Microservicio corporativo de Software Propio de{' '}
|
||||
<span className="font-semibold text-white">Innovación & Desarrollo S.A.S.</span>{' '}
|
||||
diseñado bajo Clean Architecture & DDD para emitir, firmar con XAdES-BES y
|
||||
validar comprobantes fiscales para <span className="text-purple-400 font-semibold">DripZone</span> y{' '}
|
||||
<span className="text-blue-400 font-semibold">PacificTrans</span>.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-3">
|
||||
<button
|
||||
onClick={() => setIsEmitterModalOpen(true)}
|
||||
className="flex items-center gap-2 rounded-xl bg-gradient-to-r from-emerald-500 to-teal-500 px-5 py-2.5 text-xs font-bold text-slate-950 shadow-lg shadow-emerald-500/20 hover:brightness-110 active:scale-95 transition-all"
|
||||
>
|
||||
<Zap className="h-4 w-4" />
|
||||
<span>Emitir Comprobante</span>
|
||||
</button>
|
||||
<a
|
||||
href="/api/docs"
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="flex items-center gap-1.5 rounded-xl border border-slate-700 bg-slate-900/80 px-4 py-2.5 text-xs font-semibold text-slate-200 hover:bg-slate-800 transition-all"
|
||||
>
|
||||
<span>Swagger OpenAPI</span>
|
||||
<ExternalLink className="h-3.5 w-3.5 text-slate-400" />
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* View Switcher */}
|
||||
{activeTab === 'dashboard' && (
|
||||
<div className="space-y-8">
|
||||
<KpiMetrics />
|
||||
<InvoicesTable />
|
||||
</div>
|
||||
)}
|
||||
|
||||
{activeTab === 'invoices' && (
|
||||
<div className="space-y-6">
|
||||
<InvoicesTable />
|
||||
</div>
|
||||
)}
|
||||
|
||||
{activeTab === 'resolutions' && <ResolutionsView />}
|
||||
|
||||
{activeTab === 'tenants' && <TenantsView />}
|
||||
</main>
|
||||
|
||||
{/* Footer */}
|
||||
<footer className="border-t border-slate-900 bg-[#060911] py-6 text-center text-xs text-slate-500">
|
||||
<div className="max-w-7xl mx-auto px-4 flex flex-col sm:flex-row items-center justify-between gap-3">
|
||||
<p>
|
||||
© 2026 <span className="text-slate-400 font-medium">Innovación & Desarrollo S.A.S.</span> • Software Propio DIAN UBL 2.1
|
||||
</p>
|
||||
<div className="flex items-center gap-4 text-[11px] font-mono text-slate-400">
|
||||
<span>Fastify v4/v5 (LTS)</span>
|
||||
<span>•</span>
|
||||
<span>Prisma ORM & PostgreSQL 16</span>
|
||||
<span>•</span>
|
||||
<span>XAdES-BES XMLDSig</span>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
{/* Modals */}
|
||||
<InvoiceDetailModal />
|
||||
<InvoiceEmitterModal />
|
||||
</div>
|
||||
);
|
||||
};
|
||||
72
facturacion-dian-hub/frontend/src/api/hubApi.ts
Normal file
72
facturacion-dian-hub/frontend/src/api/hubApi.ts
Normal file
@ -0,0 +1,72 @@
|
||||
import { Invoice, TenantInfo, DianResolutionInfo, FiscalMetrics } from '../types/index.js';
|
||||
|
||||
const API_BASE = '/api/v1';
|
||||
const MASTER_API_KEY = 'dev_master_key_innovacion_2026_secure';
|
||||
|
||||
async function fetchWithAuth(url: string, options: RequestInit = {}) {
|
||||
const headers = {
|
||||
'Content-Type': 'application/json',
|
||||
'x-api-key': MASTER_API_KEY,
|
||||
...(options.headers || {}),
|
||||
};
|
||||
|
||||
const response = await fetch(`${API_BASE}${url}`, {
|
||||
...options,
|
||||
headers,
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
const errorBody = await response.json().catch(() => ({ message: 'Error de conexión' }));
|
||||
throw new Error(errorBody.message || `Error HTTP ${response.status}`);
|
||||
}
|
||||
|
||||
return response.json();
|
||||
}
|
||||
|
||||
export const hubApi = {
|
||||
async getMetrics(tenantId?: string): Promise<FiscalMetrics> {
|
||||
const query = tenantId && tenantId !== 'all' ? `?tenantId=${tenantId}` : '';
|
||||
const res = await fetchWithAuth(`/invoices/metrics${query}`);
|
||||
return res.data;
|
||||
},
|
||||
|
||||
async getInvoices(tenantId?: string, search?: string): Promise<{ items: Invoice[]; total: number }> {
|
||||
const params = new URLSearchParams();
|
||||
if (tenantId && tenantId !== 'all') params.append('tenantId', tenantId);
|
||||
if (search) params.append('busqueda', search);
|
||||
|
||||
const qs = params.toString() ? `?${params.toString()}` : '';
|
||||
const res = await fetchWithAuth(`/invoices${qs}`);
|
||||
return { items: res.data, total: res.total };
|
||||
},
|
||||
|
||||
async getTenants(): Promise<TenantInfo[]> {
|
||||
const res = await fetchWithAuth('/tenants');
|
||||
return res.data;
|
||||
},
|
||||
|
||||
async getResolutions(): Promise<DianResolutionInfo[]> {
|
||||
const res = await fetchWithAuth('/resolutions');
|
||||
return res.data;
|
||||
},
|
||||
|
||||
async emitInvoice(payload: any, tenantId: string): Promise<Invoice> {
|
||||
const res = await fetchWithAuth('/invoices', {
|
||||
method: 'POST',
|
||||
body: JSON.stringify({ ...payload, tenantId }),
|
||||
});
|
||||
return res.data;
|
||||
},
|
||||
|
||||
async getXml(invoiceId: string): Promise<string> {
|
||||
const response = await fetch(`${API_BASE}/invoices/${invoiceId}/xml`, {
|
||||
headers: { 'x-api-key': MASTER_API_KEY },
|
||||
});
|
||||
if (!response.ok) throw new Error('No se pudo obtener el XML');
|
||||
return response.text();
|
||||
},
|
||||
|
||||
getPdfUrl(invoiceId: string): string {
|
||||
return `${API_BASE}/invoices/${invoiceId}/pdf`;
|
||||
},
|
||||
};
|
||||
@ -0,0 +1,311 @@
|
||||
import React, { useState, useEffect } from 'react';
|
||||
import { useHubStore } from '../store/useHubStore.js';
|
||||
import { hubApi } from '../api/hubApi.js';
|
||||
import {
|
||||
X,
|
||||
Copy,
|
||||
Check,
|
||||
FileCode,
|
||||
FileDown,
|
||||
ExternalLink,
|
||||
ShieldCheck,
|
||||
QrCode,
|
||||
Building,
|
||||
User,
|
||||
Hash,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const InvoiceDetailModal: React.FC = () => {
|
||||
const { selectedInvoice, setSelectedInvoice, isDetailModalOpen, setIsDetailModalOpen } =
|
||||
useHubStore();
|
||||
const [copiedCufe, setCopiedCufe] = useState(false);
|
||||
const [copiedXml, setCopiedXml] = useState(false);
|
||||
const [xmlContent, setXmlContent] = useState<string>('');
|
||||
const [activeTab, setActiveTab] = useState<'details' | 'xml'>('details');
|
||||
const [loadingXml, setLoadingXml] = useState(false);
|
||||
|
||||
useEffect(() => {
|
||||
if (selectedInvoice && activeTab === 'xml' && !xmlContent) {
|
||||
setLoadingXml(true);
|
||||
hubApi
|
||||
.getXml(selectedInvoice.id)
|
||||
.then((res) => setXmlContent(res))
|
||||
.catch(() => setXmlContent('<!-- No se pudo cargar el XML firmado -->'))
|
||||
.finally(() => setLoadingXml(false));
|
||||
}
|
||||
}, [selectedInvoice, activeTab, xmlContent]);
|
||||
|
||||
if (!isDetailModalOpen || !selectedInvoice) return null;
|
||||
|
||||
const handleCopyCufe = () => {
|
||||
if (selectedInvoice.cufe) {
|
||||
navigator.clipboard.writeText(selectedInvoice.cufe);
|
||||
setCopiedCufe(true);
|
||||
setTimeout(() => setCopiedCufe(false), 2000);
|
||||
}
|
||||
};
|
||||
|
||||
const handleCopyXml = () => {
|
||||
if (xmlContent) {
|
||||
navigator.clipboard.writeText(xmlContent);
|
||||
setCopiedXml(true);
|
||||
setTimeout(() => setCopiedXml(false), 2000);
|
||||
}
|
||||
};
|
||||
|
||||
const formatCop = (val: number) => {
|
||||
return new Intl.NumberFormat('es-CO', {
|
||||
style: 'currency',
|
||||
currency: 'COP',
|
||||
minimumFractionDigits: 0,
|
||||
}).format(val);
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="fixed inset-0 z-50 flex items-center justify-center bg-black/80 backdrop-blur-sm p-4 overflow-y-auto">
|
||||
<div className="relative w-full max-w-4xl rounded-2xl border border-slate-800 bg-[#0c1222] shadow-2xl overflow-hidden my-8">
|
||||
{/* Modal Header */}
|
||||
<div className="flex items-center justify-between border-b border-slate-800/80 px-6 py-4 bg-slate-900/40">
|
||||
<div className="flex items-center gap-3">
|
||||
<div className="flex h-10 w-10 items-center justify-center rounded-xl bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
|
||||
<ShieldCheck className="h-5 w-5" />
|
||||
</div>
|
||||
<div>
|
||||
<div className="flex items-center gap-2">
|
||||
<h3 className="text-base font-bold text-white">
|
||||
Factura Electrónica {selectedInvoice.fullNumber}
|
||||
</h3>
|
||||
<span className="rounded bg-emerald-500/10 px-2 py-0.5 text-[11px] font-semibold text-emerald-400 border border-emerald-500/20">
|
||||
DIAN Validada
|
||||
</span>
|
||||
</div>
|
||||
<p className="text-xs text-slate-400">
|
||||
Emitida el {selectedInvoice.issueDate} a las {selectedInvoice.issueTime} (COT)
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<button
|
||||
onClick={() => {
|
||||
setIsDetailModalOpen(false);
|
||||
setSelectedInvoice(null);
|
||||
}}
|
||||
className="rounded-lg border border-slate-800 p-1.5 text-slate-400 hover:text-white hover:bg-slate-800"
|
||||
>
|
||||
<X className="h-4 w-4" />
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{/* Subheader Navigation: Details vs XML */}
|
||||
<div className="flex items-center justify-between border-b border-slate-800 bg-slate-950/40 px-6 py-2.5">
|
||||
<div className="flex items-center gap-2">
|
||||
<button
|
||||
onClick={() => setActiveTab('details')}
|
||||
className={`rounded-lg px-3 py-1.5 text-xs font-semibold transition-all ${
|
||||
activeTab === 'details'
|
||||
? 'bg-emerald-500 text-slate-950 shadow'
|
||||
: 'text-slate-400 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
Comprobante y CUFE
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setActiveTab('xml')}
|
||||
className={`rounded-lg px-3 py-1.5 text-xs font-semibold transition-all flex items-center gap-1.5 ${
|
||||
activeTab === 'xml'
|
||||
? 'bg-emerald-500 text-slate-950 shadow'
|
||||
: 'text-slate-400 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
<FileCode className="h-3.5 w-3.5" />
|
||||
XML UBL 2.1 Firmado
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div className="flex items-center gap-2">
|
||||
<a
|
||||
href={hubApi.getPdfUrl(selectedInvoice.id)}
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="flex items-center gap-1.5 rounded-lg border border-slate-700 bg-slate-800/80 px-3 py-1.5 text-xs font-medium text-slate-200 hover:bg-slate-700 transition-all"
|
||||
>
|
||||
<FileDown className="h-3.5 w-3.5" />
|
||||
Descargar PDF
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Tab Content */}
|
||||
<div className="p-6 max-h-[70vh] overflow-y-auto">
|
||||
{activeTab === 'details' ? (
|
||||
<div className="space-y-6">
|
||||
{/* CUFE Banner */}
|
||||
<div className="rounded-xl border border-emerald-500/30 bg-emerald-950/20 p-4">
|
||||
<div className="flex items-center justify-between">
|
||||
<span className="text-xs font-bold uppercase tracking-wider text-emerald-400 flex items-center gap-1.5">
|
||||
<ShieldCheck className="h-4 w-4" />
|
||||
CUFE Oficial DIAN (SHA-384):
|
||||
</span>
|
||||
<button
|
||||
onClick={handleCopyCufe}
|
||||
className="flex items-center gap-1 rounded bg-emerald-500/20 px-2 py-1 text-[11px] font-semibold text-emerald-300 hover:bg-emerald-500/30 transition-all"
|
||||
>
|
||||
{copiedCufe ? <Check className="h-3 w-3" /> : <Copy className="h-3 w-3" />}
|
||||
{copiedCufe ? 'Copiado!' : 'Copiar CUFE'}
|
||||
</button>
|
||||
</div>
|
||||
<div className="mt-2 font-mono text-[11px] text-slate-300 break-all bg-slate-950/60 p-2.5 rounded-lg border border-slate-800">
|
||||
{selectedInvoice.cufe || 'No generado'}
|
||||
</div>
|
||||
<div className="mt-2 flex items-center gap-2 text-[11px] text-slate-400">
|
||||
<span>Validador Oficial:</span>
|
||||
<a
|
||||
href={`https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=${selectedInvoice.cufe}`}
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="text-emerald-400 hover:underline flex items-center gap-1 font-medium"
|
||||
>
|
||||
Consultar en Catálogo VPFE de la DIAN
|
||||
<ExternalLink className="h-3 w-3" />
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Grid: Cliente, QR y Emisor */}
|
||||
<div className="grid grid-cols-1 md:grid-cols-3 gap-4">
|
||||
{/* Cliente */}
|
||||
<div className="rounded-xl border border-slate-800 bg-slate-900/40 p-4 md:col-span-2">
|
||||
<h4 className="text-xs font-bold uppercase tracking-wider text-slate-400 flex items-center gap-1.5 mb-3">
|
||||
<User className="h-3.5 w-3.5 text-blue-400" />
|
||||
Datos del Adquiriente (Cliente)
|
||||
</h4>
|
||||
<div className="grid grid-cols-2 gap-3 text-xs">
|
||||
<div>
|
||||
<span className="text-slate-500">Nombre / Razón Social:</span>
|
||||
<p className="font-semibold text-white">{selectedInvoice.customer.legalOrFullName}</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className="text-slate-500">NIT / Identificación:</span>
|
||||
<p className="font-semibold text-white">
|
||||
{selectedInvoice.customer.identificationNumber}
|
||||
{selectedInvoice.customer.dv ? `-${selectedInvoice.customer.dv}` : ''}
|
||||
</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className="text-slate-500">Correo Electrónico:</span>
|
||||
<p className="font-semibold text-white">{selectedInvoice.customer.email}</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className="text-slate-500">Ciudad / Dirección:</span>
|
||||
<p className="font-semibold text-white">
|
||||
{selectedInvoice.customer.cityName} • {selectedInvoice.customer.address}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* QR Code */}
|
||||
<div className="rounded-xl border border-slate-800 bg-slate-900/40 p-4 flex flex-col items-center justify-center text-center">
|
||||
<div className="bg-white p-2 rounded-lg shadow">
|
||||
<img
|
||||
src={`https://api.qrserver.com/v1/create-qr-code/?size=110x110&data=${encodeURIComponent(
|
||||
selectedInvoice.qrContent || selectedInvoice.cufe || ''
|
||||
)}`}
|
||||
alt="Código QR Fiscal DIAN"
|
||||
className="h-24 w-24"
|
||||
/>
|
||||
</div>
|
||||
<span className="mt-2 text-[10px] font-mono text-slate-400">
|
||||
Escanear con App DIAN
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Items Table */}
|
||||
<div className="rounded-xl border border-slate-800 overflow-hidden">
|
||||
<div className="bg-slate-900/80 px-4 py-2.5 text-xs font-bold text-slate-300 border-b border-slate-800">
|
||||
Líneas de Detalle de Factura
|
||||
</div>
|
||||
<table className="w-full text-left text-xs text-slate-300">
|
||||
<thead className="bg-slate-950/60 uppercase tracking-wider text-[10px] text-slate-400">
|
||||
<tr>
|
||||
<th className="px-4 py-2.5">SKU</th>
|
||||
<th className="px-4 py-2.5">Descripción</th>
|
||||
<th className="px-4 py-2.5 text-right">Cant.</th>
|
||||
<th className="px-4 py-2.5 text-right">Precio Unitario</th>
|
||||
<th className="px-4 py-2.5 text-center">IVA</th>
|
||||
<th className="px-4 py-2.5 text-right">Total</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody className="divide-y divide-slate-800/60">
|
||||
{selectedInvoice.items.map((it) => (
|
||||
<tr key={it.lineNumber}>
|
||||
<td className="px-4 py-2.5 font-mono text-slate-400">{it.sku}</td>
|
||||
<td className="px-4 py-2.5 font-medium text-white">{it.description}</td>
|
||||
<td className="px-4 py-2.5 text-right font-mono">{it.quantity}</td>
|
||||
<td className="px-4 py-2.5 text-right">{formatCop(it.unitPrice)}</td>
|
||||
<td className="px-4 py-2.5 text-center font-semibold text-purple-400">
|
||||
{it.taxPercentage}%
|
||||
</td>
|
||||
<td className="px-4 py-2.5 text-right font-bold text-white">
|
||||
{formatCop(it.totalCost)}
|
||||
</td>
|
||||
</tr>
|
||||
))}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
{/* Financial Totals */}
|
||||
<div className="flex justify-end">
|
||||
<div className="w-full sm:w-72 rounded-xl border border-slate-800 bg-slate-900/60 p-4 space-y-2 text-xs">
|
||||
<div className="flex justify-between text-slate-400">
|
||||
<span>Subtotal:</span>
|
||||
<span className="font-semibold text-white">{formatCop(selectedInvoice.subtotal)}</span>
|
||||
</div>
|
||||
<div className="flex justify-between text-slate-400">
|
||||
<span>Descuentos:</span>
|
||||
<span className="font-semibold text-white">
|
||||
{formatCop(selectedInvoice.discountTotal)}
|
||||
</span>
|
||||
</div>
|
||||
<div className="flex justify-between text-emerald-400 font-medium">
|
||||
<span>IVA (19%):</span>
|
||||
<span className="font-bold">{formatCop(selectedInvoice.taxTotal)}</span>
|
||||
</div>
|
||||
<div className="pt-2 border-t border-slate-800 flex justify-between text-sm font-black text-white">
|
||||
<span>TOTAL A PAGAR:</span>
|
||||
<span className="text-emerald-400">{formatCop(selectedInvoice.grandTotal)}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
) : (
|
||||
<div>
|
||||
<div className="flex items-center justify-between mb-3">
|
||||
<span className="text-xs font-mono text-slate-400">
|
||||
UBL 2.1 con XMLDSig & XAdES-BES Enveloped Signature
|
||||
</span>
|
||||
<button
|
||||
onClick={handleCopyXml}
|
||||
className="flex items-center gap-1 rounded bg-slate-800 px-2.5 py-1 text-xs font-semibold text-slate-300 hover:bg-slate-700"
|
||||
>
|
||||
{copiedXml ? <Check className="h-3 w-3 text-emerald-400" /> : <Copy className="h-3 w-3" />}
|
||||
{copiedXml ? 'Copiado' : 'Copiar XML'}
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{loadingXml ? (
|
||||
<div className="py-20 text-center text-slate-500 text-xs">Cargando XML firmado...</div>
|
||||
) : (
|
||||
<pre className="rounded-xl border border-slate-800 bg-slate-950 p-4 text-[11px] font-mono text-emerald-300/90 overflow-x-auto max-h-[500px] leading-relaxed">
|
||||
{xmlContent}
|
||||
</pre>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
@ -0,0 +1,470 @@
|
||||
import React, { useState } from 'react';
|
||||
import { useHubStore } from '../store/useHubStore.js';
|
||||
import { hubApi } from '../api/hubApi.js';
|
||||
import {
|
||||
X,
|
||||
Zap,
|
||||
Plus,
|
||||
Trash2,
|
||||
Sparkles,
|
||||
CheckCircle2,
|
||||
AlertCircle,
|
||||
Truck,
|
||||
ShoppingBag,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const InvoiceEmitterModal: React.FC = () => {
|
||||
const { isEmitterModalOpen, setIsEmitterModalOpen, tenants, setInvoices, invoices, setMetrics } =
|
||||
useHubStore();
|
||||
|
||||
const [tenantId, setTenantId] = useState<string>(tenants[0]?.id || '');
|
||||
const [customerName, setCustomerName] = useState('Juan David Gómez');
|
||||
const [customerDoc, setCustomerDoc] = useState('1144987654');
|
||||
const [customerEmail, setCustomerEmail] = useState('juan.gomez@gmail.com');
|
||||
const [customerAddress, setCustomerAddress] = useState('Carrera 100 # 16-20');
|
||||
const [customerCity, setCustomerCity] = useState('Cali');
|
||||
|
||||
const [items, setItems] = useState([
|
||||
{
|
||||
sku: 'DZ-AIR-JORDAN-01',
|
||||
description: 'Air Jordan 1 Retro High OG Lost and Found (Talla 42)',
|
||||
quantity: 1,
|
||||
unitPrice: 890000,
|
||||
taxPercentage: 19,
|
||||
},
|
||||
]);
|
||||
|
||||
const [loading, setLoading] = useState(false);
|
||||
const [successResult, setSuccessResult] = useState<any | null>(null);
|
||||
const [errorMsg, setErrorMsg] = useState<string | null>(null);
|
||||
|
||||
if (!isEmitterModalOpen) return null;
|
||||
|
||||
const loadDripZonePreset = () => {
|
||||
const dz = tenants.find((t) => t.slug === 'dripzone');
|
||||
if (dz) setTenantId(dz.id);
|
||||
setCustomerName('Santiago Valderrama');
|
||||
setCustomerDoc('1130654321');
|
||||
setCustomerEmail('santiago.street@gmail.com');
|
||||
setCustomerAddress('Calle 9 # 66-12 Barrio Granada');
|
||||
setCustomerCity('Cali');
|
||||
setItems([
|
||||
{
|
||||
sku: 'DZ-YEEZY-350-ONYX',
|
||||
description: 'Sneakers Adidas Yeezy Boost 350 V2 Onyx',
|
||||
quantity: 1,
|
||||
unitPrice: 950000,
|
||||
taxPercentage: 19,
|
||||
},
|
||||
{
|
||||
sku: 'DZ-TEE-OVERSIZED-BLK',
|
||||
description: 'Camiseta DripZone Vintage Heavy Cotton Black',
|
||||
quantity: 2,
|
||||
unitPrice: 120000,
|
||||
taxPercentage: 19,
|
||||
},
|
||||
]);
|
||||
};
|
||||
|
||||
const loadPacificTransPreset = () => {
|
||||
const pt = tenants.find((t) => t.slug === 'pacifictrans');
|
||||
if (pt) setTenantId(pt.id);
|
||||
setCustomerName('Transportes & Carga del Valle S.A.S.');
|
||||
setCustomerDoc('900987123');
|
||||
setCustomerEmail('operaciones@cargavalle.com');
|
||||
setCustomerAddress('Avenida 3N # 45N-10');
|
||||
setCustomerCity('Cali');
|
||||
setItems([
|
||||
{
|
||||
sku: 'PT-FLETE-BUN-CALI-20',
|
||||
description: 'Servicio de Transporte de Carga Terrestre Contenedor 20ft Buenaventura a Yumbo',
|
||||
quantity: 1,
|
||||
unitPrice: 1850000,
|
||||
taxPercentage: 0, // Excluido
|
||||
},
|
||||
]);
|
||||
};
|
||||
|
||||
const addItem = () => {
|
||||
setItems([
|
||||
...items,
|
||||
{
|
||||
sku: `ITEM-${Date.now().toString().slice(-4)}`,
|
||||
description: 'Nuevo Producto / Servicio',
|
||||
quantity: 1,
|
||||
unitPrice: 50000,
|
||||
taxPercentage: 19,
|
||||
},
|
||||
]);
|
||||
};
|
||||
|
||||
const removeItem = (index: number) => {
|
||||
if (items.length > 1) {
|
||||
setItems(items.filter((_, i) => i !== index));
|
||||
}
|
||||
};
|
||||
|
||||
const updateItem = (index: number, field: string, value: any) => {
|
||||
const copy = [...items];
|
||||
copy[index] = { ...copy[index], [field]: value };
|
||||
setItems(copy);
|
||||
};
|
||||
|
||||
// Totales
|
||||
const subtotal = items.reduce((acc, it) => acc + (it.unitPrice || 0) * (it.quantity || 0), 0);
|
||||
const taxTotal = items.reduce(
|
||||
(acc, it) => acc + ((it.unitPrice || 0) * (it.quantity || 0) * (it.taxPercentage || 0)) / 100,
|
||||
0
|
||||
);
|
||||
const grandTotal = subtotal + taxTotal;
|
||||
|
||||
const formatCop = (val: number) => {
|
||||
return new Intl.NumberFormat('es-CO', {
|
||||
style: 'currency',
|
||||
currency: 'COP',
|
||||
minimumFractionDigits: 0,
|
||||
}).format(val);
|
||||
};
|
||||
|
||||
const handleSubmit = async (e: React.FormEvent) => {
|
||||
e.preventDefault();
|
||||
setLoading(true);
|
||||
setErrorMsg(null);
|
||||
setSuccessResult(null);
|
||||
|
||||
try {
|
||||
const activeTenant = tenantId || tenants[0]?.id;
|
||||
if (!activeTenant) throw new Error('Debe seleccionar un tenant.');
|
||||
|
||||
const payload = {
|
||||
operationType: '10',
|
||||
paymentType: '1',
|
||||
paymentMethodCode: '10',
|
||||
customer: {
|
||||
identificationType: customerDoc.length === 9 ? '31' : '13',
|
||||
identificationNumber: customerDoc,
|
||||
legalOrFullName: customerName,
|
||||
email: customerEmail,
|
||||
address: customerAddress,
|
||||
cityName: customerCity,
|
||||
taxRegime: customerDoc.length === 9 ? '48' : '49',
|
||||
},
|
||||
items: items.map((it) => ({
|
||||
sku: it.sku,
|
||||
description: it.description,
|
||||
quantity: Number(it.quantity),
|
||||
unitPrice: Number(it.unitPrice),
|
||||
taxPercentage: Number(it.taxPercentage),
|
||||
taxTypeCode: '01',
|
||||
discountAmount: 0,
|
||||
})),
|
||||
};
|
||||
|
||||
const invoice = await hubApi.emitInvoice(payload, activeTenant);
|
||||
setSuccessResult(invoice);
|
||||
|
||||
// Actualizar estado global
|
||||
setInvoices([invoice, ...invoices]);
|
||||
const newMetrics = await hubApi.getMetrics();
|
||||
setMetrics(newMetrics);
|
||||
} catch (err: any) {
|
||||
setErrorMsg(err.message || 'Error al emitir y validar factura ante la DIAN.');
|
||||
} finally {
|
||||
setLoading(false);
|
||||
}
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="fixed inset-0 z-50 flex items-center justify-center bg-black/85 backdrop-blur-sm p-4 overflow-y-auto">
|
||||
<div className="relative w-full max-w-3xl rounded-2xl border border-slate-800 bg-[#0c1222] shadow-2xl overflow-hidden my-8">
|
||||
{/* Header */}
|
||||
<div className="flex items-center justify-between border-b border-slate-800/80 px-6 py-4 bg-slate-900/40">
|
||||
<div className="flex items-center gap-3">
|
||||
<div className="flex h-10 w-10 items-center justify-center rounded-xl bg-gradient-to-tr from-emerald-600 to-teal-400 text-slate-950 font-bold shadow-lg shadow-emerald-500/20">
|
||||
<Zap className="h-5 w-5" />
|
||||
</div>
|
||||
<div>
|
||||
<h3 className="text-base font-bold text-white">
|
||||
Emisión de Factura Electrónica (UBL 2.1)
|
||||
</h3>
|
||||
<p className="text-xs text-slate-400">
|
||||
Genera el documento XML, calcula CUFE SHA-384, firma XAdES-BES y transmite a la DIAN.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<button
|
||||
onClick={() => {
|
||||
setIsEmitterModalOpen(false);
|
||||
setSuccessResult(null);
|
||||
}}
|
||||
className="rounded-lg border border-slate-800 p-1.5 text-slate-400 hover:text-white hover:bg-slate-800"
|
||||
>
|
||||
<X className="h-4 w-4" />
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{/* Content */}
|
||||
<div className="p-6 max-h-[75vh] overflow-y-auto">
|
||||
{successResult ? (
|
||||
<div className="text-center py-6 space-y-4">
|
||||
<div className="mx-auto flex h-16 w-16 items-center justify-center rounded-full bg-emerald-500/10 text-emerald-400 border border-emerald-500/30">
|
||||
<CheckCircle2 className="h-8 w-8" />
|
||||
</div>
|
||||
<div>
|
||||
<h4 className="text-lg font-bold text-white">
|
||||
¡Factura {successResult.fullNumber} Validada Exitosamente por la DIAN!
|
||||
</h4>
|
||||
<p className="text-xs text-slate-400 mt-1">
|
||||
Comprobante firmado con XAdES-BES y aceptado por el validador fiscal VPFE.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="rounded-xl border border-slate-800 bg-slate-950 p-4 text-left space-y-2">
|
||||
<div className="text-xs">
|
||||
<span className="text-slate-500 font-bold">CUFE: </span>
|
||||
<span className="font-mono text-[11px] text-emerald-300 break-all">
|
||||
{successResult.cufe}
|
||||
</span>
|
||||
</div>
|
||||
<div className="text-xs">
|
||||
<span className="text-slate-500 font-bold">Total Facturado: </span>
|
||||
<span className="font-bold text-white">{formatCop(successResult.grandTotal)}</span>
|
||||
</div>
|
||||
<div className="text-xs">
|
||||
<span className="text-slate-500 font-bold">Estado DIAN: </span>
|
||||
<span className="text-emerald-400 font-semibold">{successResult.dianStatusDescription}</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="flex items-center justify-center gap-3 pt-4">
|
||||
<a
|
||||
href={hubApi.getPdfUrl(successResult.id)}
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
className="rounded-lg bg-emerald-500 px-4 py-2 text-xs font-bold text-slate-950 shadow-lg shadow-emerald-500/20 hover:brightness-110"
|
||||
>
|
||||
Ver PDF Gráfico Oficial
|
||||
</a>
|
||||
<button
|
||||
onClick={() => setSuccessResult(null)}
|
||||
className="rounded-lg border border-slate-700 bg-slate-800 px-4 py-2 text-xs font-semibold text-slate-200 hover:bg-slate-700"
|
||||
>
|
||||
Emitir Otra Factura
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
) : (
|
||||
<form onSubmit={handleSubmit} className="space-y-6">
|
||||
{errorMsg && (
|
||||
<div className="flex items-center gap-2 rounded-xl border border-red-500/30 bg-red-950/20 p-3 text-xs text-red-300">
|
||||
<AlertCircle className="h-4 w-4 shrink-0 text-red-400" />
|
||||
<span>{errorMsg}</span>
|
||||
</div>
|
||||
)}
|
||||
|
||||
{/* Tenant & Quick Presets */}
|
||||
<div className="flex flex-col sm:flex-row items-start sm:items-center justify-between gap-3 p-3 rounded-xl border border-slate-800 bg-slate-900/60">
|
||||
<div className="w-full sm:w-auto">
|
||||
<label className="block text-[11px] font-semibold text-slate-400 mb-1">
|
||||
Tenant Emisor:
|
||||
</label>
|
||||
<select
|
||||
value={tenantId}
|
||||
onChange={(e) => setTenantId(e.target.value)}
|
||||
className="rounded-lg border border-slate-700 bg-slate-950 px-3 py-1.5 text-xs text-white outline-none focus:border-emerald-500"
|
||||
>
|
||||
{tenants.map((t) => (
|
||||
<option key={t.id} value={t.id}>
|
||||
{t.name} ({t.slug})
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
</div>
|
||||
|
||||
<div className="flex items-center gap-2 w-full sm:w-auto justify-end">
|
||||
<button
|
||||
type="button"
|
||||
onClick={loadDripZonePreset}
|
||||
className="flex items-center gap-1.5 rounded-lg border border-purple-500/30 bg-purple-950/30 px-2.5 py-1.5 text-xs font-semibold text-purple-300 hover:bg-purple-900/40 transition-all"
|
||||
>
|
||||
<ShoppingBag className="h-3.5 w-3.5" />
|
||||
Preset DripZone
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
onClick={loadPacificTransPreset}
|
||||
className="flex items-center gap-1.5 rounded-lg border border-blue-500/30 bg-blue-950/30 px-2.5 py-1.5 text-xs font-semibold text-blue-300 hover:bg-blue-900/40 transition-all"
|
||||
>
|
||||
<Truck className="h-3.5 w-3.5" />
|
||||
Preset PacificTrans
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Customer Fields */}
|
||||
<div>
|
||||
<h4 className="text-xs font-bold uppercase tracking-wider text-slate-400 mb-2">
|
||||
Datos del Adquiriente (Cliente)
|
||||
</h4>
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 gap-3">
|
||||
<div>
|
||||
<label className="block text-[11px] text-slate-400 mb-1">Nombre / Razón Social</label>
|
||||
<input
|
||||
type="text"
|
||||
required
|
||||
value={customerName}
|
||||
onChange={(e) => setCustomerName(e.target.value)}
|
||||
className="w-full rounded-lg border border-slate-800 bg-slate-950 px-3 py-1.5 text-xs text-white outline-none focus:border-emerald-500"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="block text-[11px] text-slate-400 mb-1">Cédula o NIT (sin DV)</label>
|
||||
<input
|
||||
type="text"
|
||||
required
|
||||
value={customerDoc}
|
||||
onChange={(e) => setCustomerDoc(e.target.value)}
|
||||
className="w-full rounded-lg border border-slate-800 bg-slate-950 px-3 py-1.5 text-xs text-white outline-none focus:border-emerald-500"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="block text-[11px] text-slate-400 mb-1">Email Facturación</label>
|
||||
<input
|
||||
type="email"
|
||||
required
|
||||
value={customerEmail}
|
||||
onChange={(e) => setCustomerEmail(e.target.value)}
|
||||
className="w-full rounded-lg border border-slate-800 bg-slate-950 px-3 py-1.5 text-xs text-white outline-none focus:border-emerald-500"
|
||||
/>
|
||||
</div>
|
||||
<div>
|
||||
<label className="block text-[11px] text-slate-400 mb-1">Dirección y Ciudad</label>
|
||||
<input
|
||||
type="text"
|
||||
required
|
||||
value={`${customerAddress} - ${customerCity}`}
|
||||
onChange={(e) => setCustomerAddress(e.target.value)}
|
||||
className="w-full rounded-lg border border-slate-800 bg-slate-950 px-3 py-1.5 text-xs text-white outline-none focus:border-emerald-500"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Items Line Editor */}
|
||||
<div>
|
||||
<div className="flex items-center justify-between mb-2">
|
||||
<h4 className="text-xs font-bold uppercase tracking-wider text-slate-400">
|
||||
Líneas de Detalle / Productos
|
||||
</h4>
|
||||
<button
|
||||
type="button"
|
||||
onClick={addItem}
|
||||
className="flex items-center gap-1 text-xs font-semibold text-emerald-400 hover:text-emerald-300"
|
||||
>
|
||||
<Plus className="h-3.5 w-3.5" />
|
||||
Agregar Ítem
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<div className="space-y-2">
|
||||
{items.map((it, idx) => (
|
||||
<div
|
||||
key={idx}
|
||||
className="grid grid-cols-12 gap-2 items-center rounded-lg border border-slate-800 bg-slate-950/60 p-2.5"
|
||||
>
|
||||
<div className="col-span-3 sm:col-span-2">
|
||||
<input
|
||||
type="text"
|
||||
placeholder="SKU"
|
||||
value={it.sku}
|
||||
onChange={(e) => updateItem(idx, 'sku', e.target.value)}
|
||||
className="w-full rounded border border-slate-800 bg-slate-900 px-2 py-1 text-xs text-white outline-none font-mono"
|
||||
/>
|
||||
</div>
|
||||
<div className="col-span-9 sm:col-span-4">
|
||||
<input
|
||||
type="text"
|
||||
placeholder="Descripción"
|
||||
value={it.description}
|
||||
onChange={(e) => updateItem(idx, 'description', e.target.value)}
|
||||
className="w-full rounded border border-slate-800 bg-slate-900 px-2 py-1 text-xs text-white outline-none"
|
||||
/>
|
||||
</div>
|
||||
<div className="col-span-4 sm:col-span-2">
|
||||
<input
|
||||
type="number"
|
||||
placeholder="Cant."
|
||||
value={it.quantity}
|
||||
min="1"
|
||||
onChange={(e) => updateItem(idx, 'quantity', parseFloat(e.target.value) || 1)}
|
||||
className="w-full rounded border border-slate-800 bg-slate-900 px-2 py-1 text-xs text-white outline-none text-right font-mono"
|
||||
/>
|
||||
</div>
|
||||
<div className="col-span-4 sm:col-span-2">
|
||||
<input
|
||||
type="number"
|
||||
placeholder="Precio"
|
||||
value={it.unitPrice}
|
||||
onChange={(e) => updateItem(idx, 'unitPrice', parseFloat(e.target.value) || 0)}
|
||||
className="w-full rounded border border-slate-800 bg-slate-900 px-2 py-1 text-xs text-white outline-none text-right font-mono"
|
||||
/>
|
||||
</div>
|
||||
<div className="col-span-3 sm:col-span-1">
|
||||
<select
|
||||
value={it.taxPercentage}
|
||||
onChange={(e) => updateItem(idx, 'taxPercentage', parseFloat(e.target.value))}
|
||||
className="w-full rounded border border-slate-800 bg-slate-900 px-1 py-1 text-xs text-white outline-none text-center font-mono"
|
||||
>
|
||||
<option value={19}>19%</option>
|
||||
<option value={5}>5%</option>
|
||||
<option value={0}>0%</option>
|
||||
</select>
|
||||
</div>
|
||||
<div className="col-span-1 text-right">
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => removeItem(idx)}
|
||||
className="text-slate-500 hover:text-red-400 p-1"
|
||||
>
|
||||
<Trash2 className="h-3.5 w-3.5" />
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Totals & Submit */}
|
||||
<div className="flex flex-col sm:flex-row items-center justify-between gap-4 pt-4 border-t border-slate-800">
|
||||
<div className="text-xs text-slate-400">
|
||||
<span>Subtotal: {formatCop(subtotal)} • </span>
|
||||
<span className="text-emerald-400">IVA: {formatCop(taxTotal)} • </span>
|
||||
<span className="font-bold text-white text-sm">TOTAL: {formatCop(grandTotal)}</span>
|
||||
</div>
|
||||
|
||||
<button
|
||||
type="submit"
|
||||
disabled={loading}
|
||||
className="flex items-center gap-2 rounded-xl bg-gradient-to-r from-emerald-500 to-teal-500 px-6 py-2.5 text-xs font-bold text-slate-950 shadow-lg shadow-emerald-500/20 hover:brightness-110 disabled:opacity-50 transition-all active:scale-95"
|
||||
>
|
||||
{loading ? (
|
||||
<>
|
||||
<div className="h-4 w-4 animate-spin rounded-full border-2 border-slate-950 border-t-transparent" />
|
||||
<span>Firmando y Transmitiendo a DIAN...</span>
|
||||
</>
|
||||
) : (
|
||||
<>
|
||||
<Sparkles className="h-4 w-4" />
|
||||
<span>Firmar XAdES-BES & Emitir DIAN</span>
|
||||
</>
|
||||
)}
|
||||
</button>
|
||||
</div>
|
||||
</form>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
263
facturacion-dian-hub/frontend/src/components/InvoicesTable.tsx
Normal file
263
facturacion-dian-hub/frontend/src/components/InvoicesTable.tsx
Normal file
@ -0,0 +1,263 @@
|
||||
import React, { useState } from 'react';
|
||||
import { useHubStore } from '../store/useHubStore.js';
|
||||
import { Invoice } from '../types/index.js';
|
||||
import { hubApi } from '../api/hubApi.js';
|
||||
import {
|
||||
Search,
|
||||
Eye,
|
||||
FileCode,
|
||||
FileDown,
|
||||
ExternalLink,
|
||||
CheckCircle2,
|
||||
AlertCircle,
|
||||
Clock,
|
||||
Sparkles,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const InvoicesTable: React.FC = () => {
|
||||
const { invoices, setSelectedInvoice, tenants } = useHubStore();
|
||||
const [searchTerm, setSearchTerm] = useState('');
|
||||
const [statusFilter, setStatusFilter] = useState<'ALL' | 'ACEPTADA' | 'RECHAZADA'>('ALL');
|
||||
|
||||
const getTenantName = (tenantId: string) => {
|
||||
const t = tenants.find((tenant) => tenant.id === tenantId);
|
||||
return t ? t.name : 'Innovación & Desarrollo';
|
||||
};
|
||||
|
||||
const getTenantBadge = (tenantId: string) => {
|
||||
const t = tenants.find((tenant) => tenant.id === tenantId);
|
||||
if (t?.slug === 'dripzone') {
|
||||
return (
|
||||
<span className="inline-flex items-center gap-1 rounded-md bg-purple-500/10 px-2 py-0.5 text-[11px] font-semibold text-purple-400 border border-purple-500/20">
|
||||
👟 DripZone
|
||||
</span>
|
||||
);
|
||||
}
|
||||
if (t?.slug === 'pacifictrans') {
|
||||
return (
|
||||
<span className="inline-flex items-center gap-1 rounded-md bg-blue-500/10 px-2 py-0.5 text-[11px] font-semibold text-blue-400 border border-blue-500/20">
|
||||
🚛 PacificTrans
|
||||
</span>
|
||||
);
|
||||
}
|
||||
return (
|
||||
<span className="inline-flex items-center gap-1 rounded-md bg-slate-500/10 px-2 py-0.5 text-[11px] font-semibold text-slate-400 border border-slate-500/20">
|
||||
🏢 Emisor
|
||||
</span>
|
||||
);
|
||||
};
|
||||
|
||||
const filteredInvoices = invoices.filter((inv) => {
|
||||
const matchesSearch =
|
||||
inv.fullNumber.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||
inv.customer.legalOrFullName.toLowerCase().includes(searchTerm.toLowerCase()) ||
|
||||
inv.customer.identificationNumber.includes(searchTerm) ||
|
||||
(inv.cufe && inv.cufe.toLowerCase().includes(searchTerm.toLowerCase()));
|
||||
|
||||
const matchesStatus = statusFilter === 'ALL' || inv.dianStatus === statusFilter;
|
||||
|
||||
return matchesSearch && matchesStatus;
|
||||
});
|
||||
|
||||
const formatCop = (val: number) => {
|
||||
return new Intl.NumberFormat('es-CO', {
|
||||
style: 'currency',
|
||||
currency: 'COP',
|
||||
minimumFractionDigits: 0,
|
||||
}).format(val);
|
||||
};
|
||||
|
||||
const handleDownloadXml = async (inv: Invoice, e: React.MouseEvent) => {
|
||||
e.stopPropagation();
|
||||
try {
|
||||
const xml = await hubApi.getXml(inv.id);
|
||||
const blob = new Blob([xml], { type: 'application/xml' });
|
||||
const url = URL.createObjectURL(blob);
|
||||
const a = document.createElement('a');
|
||||
a.href = url;
|
||||
a.download = `face_${inv.fullNumber}.xml`;
|
||||
a.click();
|
||||
URL.revokeObjectURL(url);
|
||||
} catch (err) {
|
||||
alert('Error al descargar el archivo XML.');
|
||||
}
|
||||
};
|
||||
|
||||
const handleDownloadPdf = (inv: Invoice, e: React.MouseEvent) => {
|
||||
e.stopPropagation();
|
||||
window.open(hubApi.getPdfUrl(inv.id), '_blank');
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="glass-card rounded-2xl border border-slate-800 overflow-hidden">
|
||||
{/* Header & Controls */}
|
||||
<div className="flex flex-col sm:flex-row items-center justify-between gap-4 p-5 border-b border-slate-800/80 bg-slate-900/40">
|
||||
<div>
|
||||
<h2 className="text-lg font-bold text-white flex items-center gap-2">
|
||||
Comprobantes Electrónicos UBL 2.1
|
||||
<span className="text-xs font-normal text-slate-400">({filteredInvoices.length} facturas)</span>
|
||||
</h2>
|
||||
<p className="text-xs text-slate-400">
|
||||
Historial de facturas firmadas con XAdES-BES y transmitidas a la DIAN.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-wrap items-center gap-2.5 w-full sm:w-auto">
|
||||
{/* Search Input */}
|
||||
<div className="relative flex-1 sm:w-64">
|
||||
<Search className="absolute left-3 top-2.5 h-3.5 w-3.5 text-slate-500" />
|
||||
<input
|
||||
type="text"
|
||||
placeholder="Buscar por número, cliente, NIT o CUFE..."
|
||||
value={searchTerm}
|
||||
onChange={(e) => setSearchTerm(e.target.value)}
|
||||
className="w-full rounded-lg border border-slate-800 bg-slate-950/80 py-2 pl-9 pr-3 text-xs text-slate-200 placeholder-slate-500 outline-none focus:border-emerald-500 focus:ring-1 focus:ring-emerald-500"
|
||||
/>
|
||||
</div>
|
||||
|
||||
{/* Status Filter */}
|
||||
<div className="flex items-center gap-1 rounded-lg border border-slate-800 bg-slate-950 p-1">
|
||||
<button
|
||||
onClick={() => setStatusFilter('ALL')}
|
||||
className={`rounded px-2.5 py-1 text-xs font-medium transition-all ${
|
||||
statusFilter === 'ALL' ? 'bg-slate-800 text-white' : 'text-slate-400 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
Todas
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setStatusFilter('ACEPTADA')}
|
||||
className={`rounded px-2.5 py-1 text-xs font-medium transition-all ${
|
||||
statusFilter === 'ACEPTADA' ? 'bg-emerald-500/20 text-emerald-400 font-semibold' : 'text-slate-400 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
Aceptadas
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setStatusFilter('RECHAZADA')}
|
||||
className={`rounded px-2.5 py-1 text-xs font-medium transition-all ${
|
||||
statusFilter === 'RECHAZADA' ? 'bg-red-500/20 text-red-400 font-semibold' : 'text-slate-400 hover:text-white'
|
||||
}`}
|
||||
>
|
||||
Rechazadas
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Invoices Table */}
|
||||
<div className="overflow-x-auto">
|
||||
<table className="w-full text-left text-xs text-slate-300">
|
||||
<thead className="bg-slate-950/60 uppercase tracking-wider text-[11px] text-slate-400 border-b border-slate-800">
|
||||
<tr>
|
||||
<th className="px-5 py-3.5 font-semibold">Comprobante</th>
|
||||
<th className="px-5 py-3.5 font-semibold">Tenant</th>
|
||||
<th className="px-5 py-3.5 font-semibold">Cliente / Adquiriente</th>
|
||||
<th className="px-5 py-3.5 font-semibold">Fecha Emisión</th>
|
||||
<th className="px-5 py-3.5 font-semibold text-right">Total (COP)</th>
|
||||
<th className="px-5 py-3.5 font-semibold text-center">Estado DIAN</th>
|
||||
<th className="px-5 py-3.5 font-semibold text-right">Acciones</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody className="divide-y divide-slate-800/60 font-medium">
|
||||
{filteredInvoices.length === 0 ? (
|
||||
<tr>
|
||||
<td colSpan={7} className="py-12 text-center text-slate-500">
|
||||
No se encontraron comprobantes fiscales que coincidan con la búsqueda.
|
||||
</td>
|
||||
</tr>
|
||||
) : (
|
||||
filteredInvoices.map((inv) => (
|
||||
<tr
|
||||
key={inv.id}
|
||||
onClick={() => setSelectedInvoice(inv)}
|
||||
className="cursor-pointer transition-colors hover:bg-slate-800/40"
|
||||
>
|
||||
{/* Comprobante */}
|
||||
<td className="px-5 py-4">
|
||||
<div className="font-mono font-bold text-white flex items-center gap-1.5">
|
||||
{inv.fullNumber}
|
||||
</div>
|
||||
<div className="text-[10px] text-slate-500 font-mono truncate max-w-[140px]">
|
||||
CUFE: {inv.cufe?.slice(0, 16)}...
|
||||
</div>
|
||||
</td>
|
||||
|
||||
{/* Tenant */}
|
||||
<td className="px-5 py-4">{getTenantBadge(inv.tenantId)}</td>
|
||||
|
||||
{/* Cliente */}
|
||||
<td className="px-5 py-4">
|
||||
<div className="font-semibold text-slate-200">{inv.customer.legalOrFullName}</div>
|
||||
<div className="text-[11px] text-slate-400">
|
||||
NIT/CC: {inv.customer.identificationNumber}
|
||||
</div>
|
||||
</td>
|
||||
|
||||
{/* Fecha */}
|
||||
<td className="px-5 py-4">
|
||||
<div className="text-slate-200">{inv.issueDate}</div>
|
||||
<div className="text-[11px] text-slate-500 font-mono">{inv.issueTime}</div>
|
||||
</td>
|
||||
|
||||
{/* Total */}
|
||||
<td className="px-5 py-4 text-right">
|
||||
<div className="font-bold text-white text-sm">{formatCop(inv.grandTotal)}</div>
|
||||
<div className="text-[10px] text-emerald-400">IVA: {formatCop(inv.taxTotal)}</div>
|
||||
</td>
|
||||
|
||||
{/* Estado DIAN */}
|
||||
<td className="px-5 py-4 text-center">
|
||||
{inv.dianStatus === 'ACEPTADA' ? (
|
||||
<span className="inline-flex items-center gap-1 rounded-full bg-emerald-500/10 px-2.5 py-1 text-[11px] font-semibold text-emerald-400 border border-emerald-500/20">
|
||||
<CheckCircle2 className="h-3 w-3" />
|
||||
Aceptada
|
||||
</span>
|
||||
) : inv.dianStatus === 'RECHAZADA' ? (
|
||||
<span className="inline-flex items-center gap-1 rounded-full bg-red-500/10 px-2.5 py-1 text-[11px] font-semibold text-red-400 border border-red-500/20">
|
||||
<AlertCircle className="h-3 w-3" />
|
||||
Rechazada
|
||||
</span>
|
||||
) : (
|
||||
<span className="inline-flex items-center gap-1 rounded-full bg-amber-500/10 px-2.5 py-1 text-[11px] font-semibold text-amber-400 border border-amber-500/20">
|
||||
<Clock className="h-3 w-3" />
|
||||
{inv.dianStatus}
|
||||
</span>
|
||||
)}
|
||||
</td>
|
||||
|
||||
{/* Acciones */}
|
||||
<td className="px-5 py-4 text-right">
|
||||
<div className="flex items-center justify-end gap-1.5" onClick={(e) => e.stopPropagation()}>
|
||||
<button
|
||||
onClick={() => setSelectedInvoice(inv)}
|
||||
title="Ver Detalles y CUFE"
|
||||
className="rounded-lg border border-slate-800 bg-slate-900 p-1.5 text-slate-400 hover:text-white hover:border-slate-700"
|
||||
>
|
||||
<Eye className="h-3.5 w-3.5" />
|
||||
</button>
|
||||
<button
|
||||
onClick={(e) => handleDownloadXml(inv, e)}
|
||||
title="Descargar XML UBL 2.1 Firmado"
|
||||
className="rounded-lg border border-slate-800 bg-slate-900 p-1.5 text-slate-400 hover:text-emerald-400 hover:border-emerald-500/30"
|
||||
>
|
||||
<FileCode className="h-3.5 w-3.5" />
|
||||
</button>
|
||||
<button
|
||||
onClick={(e) => handleDownloadPdf(inv, e)}
|
||||
title="Ver PDF Gráfico"
|
||||
className="rounded-lg border border-slate-800 bg-slate-900 p-1.5 text-slate-400 hover:text-blue-400 hover:border-blue-500/30"
|
||||
>
|
||||
<FileDown className="h-3.5 w-3.5" />
|
||||
</button>
|
||||
</div>
|
||||
</td>
|
||||
</tr>
|
||||
))
|
||||
)}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
151
facturacion-dian-hub/frontend/src/components/ResolutionsView.tsx
Normal file
151
facturacion-dian-hub/frontend/src/components/ResolutionsView.tsx
Normal file
@ -0,0 +1,151 @@
|
||||
import React from 'react';
|
||||
import { useHubStore } from '../store/useHubStore.js';
|
||||
import {
|
||||
FileCheck2,
|
||||
Calendar,
|
||||
Hash,
|
||||
Key,
|
||||
ShieldCheck,
|
||||
AlertTriangle,
|
||||
Building2,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const ResolutionsView: React.FC = () => {
|
||||
const { resolutions, tenants } = useHubStore();
|
||||
|
||||
const getTenantName = (tenantId?: string) => {
|
||||
if (!tenantId) return 'Resolución Global Corporativa';
|
||||
const t = tenants.find((item) => item.id === tenantId);
|
||||
return t ? t.name : 'Innovación & Desarrollo S.A.S.';
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<div className="flex flex-col sm:flex-row items-start sm:items-center justify-between gap-4">
|
||||
<div>
|
||||
<h2 className="text-lg font-bold text-white flex items-center gap-2">
|
||||
<FileCheck2 className="h-5 w-5 text-emerald-400" />
|
||||
Resoluciones de Numeración DIAN
|
||||
</h2>
|
||||
<p className="text-xs text-slate-400">
|
||||
Rangos autorizados por la DIAN para emisión de comprobantes fiscales (Resolución 000165 de 2023).
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2 rounded-lg border border-emerald-500/20 bg-emerald-500/10 px-3 py-1.5 text-xs text-emerald-400 font-medium">
|
||||
<ShieldCheck className="h-4 w-4" />
|
||||
<span>Vigilancia de Consecutivos en Tiempo Real</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-5">
|
||||
{resolutions.map((res) => {
|
||||
const isExpiringSoon = res.diasRestantes <= 60;
|
||||
const isNearExhaustion = res.porcentajeConsumido >= 85;
|
||||
|
||||
return (
|
||||
<div
|
||||
key={res.id}
|
||||
className="glass-card rounded-2xl border border-slate-800 p-6 space-y-5 transition-all hover:border-slate-700"
|
||||
>
|
||||
{/* Header */}
|
||||
<div className="flex items-start justify-between">
|
||||
<div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="font-mono text-lg font-black text-white">
|
||||
Prefijo: {res.prefix}
|
||||
</span>
|
||||
<span className="rounded bg-emerald-500/10 px-2 py-0.5 text-[10px] font-bold text-emerald-400 border border-emerald-500/20">
|
||||
AUTORIZADA
|
||||
</span>
|
||||
</div>
|
||||
<p className="text-xs text-slate-400 mt-1 flex items-center gap-1.5">
|
||||
<Building2 className="h-3.5 w-3.5 text-slate-500" />
|
||||
{getTenantName(res.tenantId)}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="text-right">
|
||||
<span className="text-[10px] font-mono text-slate-500 block">Formulario DIAN:</span>
|
||||
<span className="font-mono text-xs font-bold text-slate-300">
|
||||
No. {res.resolutionNumber}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Progress Bar of Consecutive Numbers */}
|
||||
<div>
|
||||
<div className="flex justify-between items-baseline text-xs mb-1.5">
|
||||
<span className="text-slate-400 flex items-center gap-1">
|
||||
<Hash className="h-3.5 w-3.5 text-slate-500" />
|
||||
Consecutivo Actual:
|
||||
</span>
|
||||
<span className="font-mono font-bold text-white text-sm">
|
||||
{res.prefix}-{parseInt(res.currentConsecutive, 10).toLocaleString()}
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div className="h-2 w-full overflow-hidden rounded-full bg-slate-800">
|
||||
<div
|
||||
className={`h-full rounded-full transition-all duration-700 ${
|
||||
isNearExhaustion
|
||||
? 'bg-red-500'
|
||||
: res.porcentajeConsumido > 60
|
||||
? 'bg-amber-500'
|
||||
: 'bg-emerald-500'
|
||||
}`}
|
||||
style={{ width: `${Math.max(5, res.porcentajeConsumido)}%` }}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div className="flex justify-between text-[11px] text-slate-500 mt-1 font-mono">
|
||||
<span>Desde: {res.fromNumber}</span>
|
||||
<span>{res.porcentajeConsumido}% consumido</span>
|
||||
<span>Hasta: {parseInt(res.toNumber, 10).toLocaleString()}</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Technical Key & Dates Grid */}
|
||||
<div className="rounded-xl border border-slate-800/80 bg-slate-950/60 p-4 space-y-3 text-xs">
|
||||
<div>
|
||||
<span className="text-slate-500 flex items-center gap-1 text-[11px] font-semibold uppercase tracking-wider mb-1">
|
||||
<Key className="h-3.5 w-3.5 text-amber-400" />
|
||||
Clave Técnica de Emisión DIAN (SHA-384 Input):
|
||||
</span>
|
||||
<p className="font-mono text-[11px] text-amber-300/90 break-all bg-slate-900/90 p-2 rounded border border-slate-800">
|
||||
••••••••••••••••••••••••••••••••••••••••
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-2 gap-2 pt-2 border-t border-slate-800/80">
|
||||
<div>
|
||||
<span className="text-slate-500 text-[11px] block">Vigencia Desde:</span>
|
||||
<span className="font-semibold text-white">{res.startDate}</span>
|
||||
</div>
|
||||
<div>
|
||||
<span className="text-slate-500 text-[11px] block">Vigencia Hasta:</span>
|
||||
<span className="font-semibold text-white">{res.endDate}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Status Alert Footer */}
|
||||
<div className="flex items-center justify-between text-xs pt-1">
|
||||
<span className="text-slate-400 flex items-center gap-1.5">
|
||||
<Calendar className="h-3.5 w-3.5 text-blue-400" />
|
||||
Días restantes de vigencia:
|
||||
</span>
|
||||
<span
|
||||
className={`font-bold font-mono ${
|
||||
isExpiringSoon ? 'text-amber-400' : 'text-emerald-400'
|
||||
}`}
|
||||
>
|
||||
{res.diasRestantes} días
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
})}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
150
facturacion-dian-hub/frontend/src/components/TenantsView.tsx
Normal file
150
facturacion-dian-hub/frontend/src/components/TenantsView.tsx
Normal file
@ -0,0 +1,150 @@
|
||||
import React, { useState } from 'react';
|
||||
import { useHubStore } from '../store/useHubStore.js';
|
||||
import {
|
||||
Building2,
|
||||
Key,
|
||||
Webhook,
|
||||
Mail,
|
||||
Check,
|
||||
Copy,
|
||||
ShieldCheck,
|
||||
ExternalLink,
|
||||
Code2,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const TenantsView: React.FC = () => {
|
||||
const { tenants } = useHubStore();
|
||||
const [copiedKey, setCopiedKey] = useState<string | null>(null);
|
||||
|
||||
const getDemoApiKey = (slug: string) => {
|
||||
if (slug === 'dripzone') return 'dz_live_key_98f4bc12e87a';
|
||||
if (slug === 'pacifictrans') return 'pt_live_key_33c9a184ef10';
|
||||
return 'inno_master_key_secure_2026';
|
||||
};
|
||||
|
||||
const handleCopy = (key: string, id: string) => {
|
||||
navigator.clipboard.writeText(key);
|
||||
setCopiedKey(id);
|
||||
setTimeout(() => setCopiedKey(null), 2000);
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<div className="flex flex-col sm:flex-row items-start sm:items-center justify-between gap-4">
|
||||
<div>
|
||||
<h2 className="text-lg font-bold text-white flex items-center gap-2">
|
||||
<Building2 className="h-5 w-5 text-emerald-400" />
|
||||
Tenants & Aplicaciones Cliente Conectadas
|
||||
</h2>
|
||||
<p className="text-xs text-slate-400">
|
||||
Microservicios y plataformas que consumen el Hub Fiscal como Software Propio.
|
||||
</p>
|
||||
</div>
|
||||
<div className="flex items-center gap-2 rounded-lg border border-purple-500/20 bg-purple-500/10 px-3 py-1.5 text-xs text-purple-300 font-medium">
|
||||
<ShieldCheck className="h-4 w-4" />
|
||||
<span>Aislamiento Criptográfico Multi-Inquilino</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-5">
|
||||
{tenants.map((t) => {
|
||||
const rawKey = getDemoApiKey(t.slug);
|
||||
const isDrip = t.slug === 'dripzone';
|
||||
|
||||
return (
|
||||
<div
|
||||
key={t.id}
|
||||
className="glass-card rounded-2xl border border-slate-800 p-6 space-y-5 transition-all hover:border-slate-700"
|
||||
>
|
||||
{/* Header */}
|
||||
<div className="flex items-start justify-between">
|
||||
<div className="flex items-center gap-3">
|
||||
<div
|
||||
className={`flex h-12 w-12 items-center justify-center rounded-2xl text-2xl shadow-lg ${
|
||||
isDrip
|
||||
? 'bg-gradient-to-tr from-purple-600 to-pink-500 shadow-purple-500/20'
|
||||
: 'bg-gradient-to-tr from-blue-600 to-cyan-500 shadow-blue-500/20'
|
||||
}`}
|
||||
>
|
||||
{isDrip ? '👟' : '🚛'}
|
||||
</div>
|
||||
<div>
|
||||
<h3 className="text-base font-bold text-white">{t.name}</h3>
|
||||
<div className="flex items-center gap-2 mt-0.5">
|
||||
<span className="font-mono text-xs text-slate-400">slug: {t.slug}</span>
|
||||
<span className="rounded bg-emerald-500/10 px-1.5 py-0.2 text-[10px] font-bold text-emerald-400 border border-emerald-500/20">
|
||||
{t.status}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Economic activity & Email */}
|
||||
<div className="grid grid-cols-1 sm:grid-cols-2 gap-3 text-xs">
|
||||
<div className="rounded-xl border border-slate-800/80 bg-slate-950/60 p-3">
|
||||
<span className="text-slate-500 text-[11px] block">Actividad Económica (CIIU):</span>
|
||||
<span className="font-semibold text-white mt-0.5 block">
|
||||
{t.economicActivityCode || 'General'}
|
||||
</span>
|
||||
</div>
|
||||
<div className="rounded-xl border border-slate-800/80 bg-slate-950/60 p-3">
|
||||
<span className="text-slate-500 text-[11px] block flex items-center gap-1">
|
||||
<Mail className="h-3 w-3" /> Correo Fiscal:
|
||||
</span>
|
||||
<span className="font-semibold text-white mt-0.5 block truncate">
|
||||
{t.contactEmail}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* API Key Box */}
|
||||
<div className="rounded-xl border border-slate-800/80 bg-slate-950/80 p-3 space-y-2">
|
||||
<div className="flex items-center justify-between text-xs">
|
||||
<span className="text-slate-400 flex items-center gap-1 font-semibold text-[11px]">
|
||||
<Key className="h-3.5 w-3.5 text-amber-400" />
|
||||
API Key de Autenticación:
|
||||
</span>
|
||||
<button
|
||||
onClick={() => handleCopy(rawKey, t.id)}
|
||||
className="flex items-center gap-1 rounded bg-slate-800 px-2 py-0.5 text-[11px] font-medium text-slate-300 hover:bg-slate-700 transition-all"
|
||||
>
|
||||
{copiedKey === t.id ? (
|
||||
<Check className="h-3 w-3 text-emerald-400" />
|
||||
) : (
|
||||
<Copy className="h-3 w-3" />
|
||||
)}
|
||||
{copiedKey === t.id ? 'Copiada' : 'Copiar'}
|
||||
</button>
|
||||
</div>
|
||||
<div className="font-mono text-xs text-amber-300/90 bg-slate-900 px-2.5 py-1.5 rounded border border-slate-800">
|
||||
{rawKey}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Webhook Endpoint */}
|
||||
<div className="text-xs space-y-1">
|
||||
<span className="text-slate-400 flex items-center gap-1 text-[11px]">
|
||||
<Webhook className="h-3.5 w-3.5 text-blue-400" />
|
||||
Webhook de Notificaciones Asíncronas DIAN:
|
||||
</span>
|
||||
<p className="font-mono text-[11px] text-slate-400 truncate bg-slate-950 px-2.5 py-1.5 rounded border border-slate-800">
|
||||
{t.webhookUrl || 'No configurado'}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
{/* Code Example Snippet */}
|
||||
<div className="pt-2 border-t border-slate-800/80 text-[11px] text-slate-400 flex items-center justify-between">
|
||||
<span className="flex items-center gap-1 font-mono">
|
||||
<Code2 className="h-3.5 w-3.5 text-emerald-400" />
|
||||
Header: x-api-key
|
||||
</span>
|
||||
<span className="text-emerald-400 font-medium">UBL 2.1 Ready</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
})}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
132
facturacion-dian-hub/frontend/src/components/layout/Navbar.tsx
Normal file
132
facturacion-dian-hub/frontend/src/components/layout/Navbar.tsx
Normal file
@ -0,0 +1,132 @@
|
||||
import React from 'react';
|
||||
import { useHubStore } from '../../store/useHubStore.js';
|
||||
import {
|
||||
FileText,
|
||||
Building2,
|
||||
PlusCircle,
|
||||
ShieldCheck,
|
||||
Layers,
|
||||
FileCheck2,
|
||||
Server,
|
||||
Zap,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const Navbar: React.FC = () => {
|
||||
const {
|
||||
activeTab,
|
||||
setActiveTab,
|
||||
selectedTenantId,
|
||||
setSelectedTenantId,
|
||||
tenants,
|
||||
setIsEmitterModalOpen,
|
||||
} = useHubStore();
|
||||
|
||||
return (
|
||||
<header className="sticky top-0 z-40 w-full border-b border-slate-800 bg-[#090d19]/90 backdrop-blur-md">
|
||||
<div className="mx-auto flex h-16 max-w-7xl items-center justify-between px-4 sm:px-6 lg:px-8">
|
||||
{/* Brand & Emisor Info */}
|
||||
<div className="flex items-center gap-3">
|
||||
<div className="flex h-10 w-10 items-center justify-center rounded-xl bg-gradient-to-tr from-emerald-600 to-teal-400 text-white shadow-lg shadow-emerald-500/20">
|
||||
<Zap className="h-5 w-5" />
|
||||
</div>
|
||||
<div>
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-base font-bold tracking-tight text-white">
|
||||
Hub Fiscal DIAN
|
||||
</span>
|
||||
<span className="rounded bg-emerald-500/10 px-1.5 py-0.5 text-[10px] font-semibold text-emerald-400 border border-emerald-500/20">
|
||||
Software Propio UBL 2.1
|
||||
</span>
|
||||
</div>
|
||||
<p className="text-xs text-slate-400">
|
||||
Innovación & Desarrollo S.A.S. • NIT 901.554.892-9
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Navigation Tabs */}
|
||||
<nav className="hidden md:flex items-center gap-1 rounded-lg border border-slate-800/80 bg-slate-900/60 p-1">
|
||||
<button
|
||||
onClick={() => setActiveTab('dashboard')}
|
||||
className={`flex items-center gap-2 rounded-md px-3 py-1.5 text-xs font-medium transition-all ${
|
||||
activeTab === 'dashboard'
|
||||
? 'bg-emerald-500 text-slate-950 shadow-sm font-semibold'
|
||||
: 'text-slate-300 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
<Layers className="h-3.5 w-3.5" />
|
||||
Dashboard
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setActiveTab('invoices')}
|
||||
className={`flex items-center gap-2 rounded-md px-3 py-1.5 text-xs font-medium transition-all ${
|
||||
activeTab === 'invoices'
|
||||
? 'bg-emerald-500 text-slate-950 shadow-sm font-semibold'
|
||||
: 'text-slate-300 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
<FileText className="h-3.5 w-3.5" />
|
||||
Facturas
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setActiveTab('resolutions')}
|
||||
className={`flex items-center gap-2 rounded-md px-3 py-1.5 text-xs font-medium transition-all ${
|
||||
activeTab === 'resolutions'
|
||||
? 'bg-emerald-500 text-slate-950 shadow-sm font-semibold'
|
||||
: 'text-slate-300 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
<FileCheck2 className="h-3.5 w-3.5" />
|
||||
Resoluciones
|
||||
</button>
|
||||
<button
|
||||
onClick={() => setActiveTab('tenants')}
|
||||
className={`flex items-center gap-2 rounded-md px-3 py-1.5 text-xs font-medium transition-all ${
|
||||
activeTab === 'tenants'
|
||||
? 'bg-emerald-500 text-slate-950 shadow-sm font-semibold'
|
||||
: 'text-slate-300 hover:text-white hover:bg-slate-800/50'
|
||||
}`}
|
||||
>
|
||||
<Building2 className="h-3.5 w-3.5" />
|
||||
Tenants
|
||||
</button>
|
||||
</nav>
|
||||
|
||||
{/* Right Controls: Tenant Switcher, DIAN Status & Emitter CTA */}
|
||||
<div className="flex items-center gap-3">
|
||||
{/* DIAN VPFE Connectivity Pill */}
|
||||
<div className="hidden lg:flex items-center gap-2 rounded-full border border-emerald-500/20 bg-emerald-500/5 px-2.5 py-1 text-xs text-emerald-400">
|
||||
<span className="relative flex h-2 w-2">
|
||||
<span className="absolute inline-flex h-full w-full animate-ping rounded-full bg-emerald-400 opacity-75"></span>
|
||||
<span className="relative inline-flex h-2 w-2 rounded-full bg-emerald-500"></span>
|
||||
</span>
|
||||
<span className="font-mono text-[11px] font-medium">DIAN VPFE: ONLINE</span>
|
||||
</div>
|
||||
|
||||
{/* Tenant Selector */}
|
||||
<select
|
||||
value={selectedTenantId}
|
||||
onChange={(e) => setSelectedTenantId(e.target.value)}
|
||||
className="rounded-lg border border-slate-700 bg-slate-900 px-2.5 py-1.5 text-xs font-medium text-slate-200 outline-none focus:border-emerald-500 focus:ring-1 focus:ring-emerald-500"
|
||||
>
|
||||
<option value="all">🏢 Todos los Tenants</option>
|
||||
{tenants.map((t) => (
|
||||
<option key={t.id} value={t.id}>
|
||||
{t.name}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
|
||||
{/* New Invoice Button */}
|
||||
<button
|
||||
onClick={() => setIsEmitterModalOpen(true)}
|
||||
className="flex items-center gap-1.5 rounded-lg bg-gradient-to-r from-emerald-500 to-teal-500 px-3 py-1.5 text-xs font-semibold text-slate-950 shadow-md shadow-emerald-500/20 transition-all hover:brightness-110 active:scale-95"
|
||||
>
|
||||
<PlusCircle className="h-4 w-4" />
|
||||
<span className="hidden sm:inline">Emitir Factura</span>
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</header>
|
||||
);
|
||||
};
|
||||
120
facturacion-dian-hub/frontend/src/components/ui/KpiMetrics.tsx
Normal file
120
facturacion-dian-hub/frontend/src/components/ui/KpiMetrics.tsx
Normal file
@ -0,0 +1,120 @@
|
||||
import React from 'react';
|
||||
import { useHubStore } from '../../store/useHubStore.js';
|
||||
import {
|
||||
TrendingUp,
|
||||
CheckCircle2,
|
||||
AlertTriangle,
|
||||
Receipt,
|
||||
ShieldCheck,
|
||||
Clock,
|
||||
} from 'lucide-react';
|
||||
|
||||
export const KpiMetrics: React.FC = () => {
|
||||
const { metrics, resolutions } = useHubStore();
|
||||
|
||||
const formatCop = (amount: number) => {
|
||||
return new Intl.NumberFormat('es-CO', {
|
||||
style: 'currency',
|
||||
currency: 'COP',
|
||||
maximumFractionDigits: 0,
|
||||
}).format(amount || 0);
|
||||
};
|
||||
|
||||
const totalConsumido = resolutions.reduce((acc, r) => acc + parseInt(r.currentConsecutive, 10), 0);
|
||||
const totalRango = resolutions.reduce((acc, r) => acc + parseInt(r.toNumber, 10), 0);
|
||||
const percentGlobal = totalRango > 0 ? Math.round((totalConsumido / totalRango) * 100) : 0;
|
||||
|
||||
return (
|
||||
<div className="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4">
|
||||
{/* Total Facturado */}
|
||||
<div className="glass-card rounded-2xl p-5 border border-slate-800 transition-all hover:border-slate-700">
|
||||
<div className="flex items-center justify-between">
|
||||
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400">
|
||||
Total Facturado (COP)
|
||||
</span>
|
||||
<div className="flex h-9 w-9 items-center justify-center rounded-xl bg-emerald-500/10 text-emerald-400 border border-emerald-500/20">
|
||||
<TrendingUp className="h-4 w-4" />
|
||||
</div>
|
||||
</div>
|
||||
<div className="mt-3">
|
||||
<div className="text-2xl font-black tracking-tight text-white">
|
||||
{formatCop(metrics?.totalFacturado || 0)}
|
||||
</div>
|
||||
<div className="mt-1 flex items-center gap-1.5 text-xs text-emerald-400">
|
||||
<span className="font-semibold">{metrics?.totalDocumentos || 0}</span> documentos emitidos
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Aceptación DIAN */}
|
||||
<div className="glass-card rounded-2xl p-5 border border-slate-800 transition-all hover:border-slate-700">
|
||||
<div className="flex items-center justify-between">
|
||||
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400">
|
||||
Validación DIAN (VPFE)
|
||||
</span>
|
||||
<div className="flex h-9 w-9 items-center justify-center rounded-xl bg-blue-500/10 text-blue-400 border border-blue-500/20">
|
||||
<CheckCircle2 className="h-4 w-4" />
|
||||
</div>
|
||||
</div>
|
||||
<div className="mt-3">
|
||||
<div className="text-2xl font-black tracking-tight text-white">
|
||||
{metrics?.aceptadasDian || 0} / {metrics?.totalDocumentos || 0}
|
||||
</div>
|
||||
<div className="mt-1 flex items-center gap-1.5 text-xs text-emerald-400">
|
||||
<ShieldCheck className="h-3.5 w-3.5" />
|
||||
<span className="font-semibold">
|
||||
{metrics?.totalDocumentos ? Math.round(((metrics.aceptadasDian / metrics.totalDocumentos) * 100)) : 100}%
|
||||
</span>
|
||||
tasa de éxito normativo
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* IVA Generado */}
|
||||
<div className="glass-card rounded-2xl p-5 border border-slate-800 transition-all hover:border-slate-700">
|
||||
<div className="flex items-center justify-between">
|
||||
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400">
|
||||
IVA 19% Generado
|
||||
</span>
|
||||
<div className="flex h-9 w-9 items-center justify-center rounded-xl bg-purple-500/10 text-purple-400 border border-purple-500/20">
|
||||
<Receipt className="h-4 w-4" />
|
||||
</div>
|
||||
</div>
|
||||
<div className="mt-3">
|
||||
<div className="text-2xl font-black tracking-tight text-white">
|
||||
{formatCop(metrics?.totalIvaRecaudado || 0)}
|
||||
</div>
|
||||
<div className="mt-1 flex items-center gap-1.5 text-xs text-slate-400">
|
||||
Para declaración bimestral DIAN
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{/* Rango de Numeración */}
|
||||
<div className="glass-card rounded-2xl p-5 border border-slate-800 transition-all hover:border-slate-700">
|
||||
<div className="flex items-center justify-between">
|
||||
<span className="text-xs font-semibold uppercase tracking-wider text-slate-400">
|
||||
Rangos DIAN Activos
|
||||
</span>
|
||||
<div className="flex h-9 w-9 items-center justify-center rounded-xl bg-amber-500/10 text-amber-400 border border-amber-500/20">
|
||||
<Clock className="h-4 w-4" />
|
||||
</div>
|
||||
</div>
|
||||
<div className="mt-3">
|
||||
<div className="flex items-baseline justify-between text-white">
|
||||
<span className="text-2xl font-black tracking-tight">{percentGlobal}%</span>
|
||||
<span className="text-xs text-slate-400 font-mono">
|
||||
{totalConsumido.toLocaleString()} / {totalRango.toLocaleString()}
|
||||
</span>
|
||||
</div>
|
||||
<div className="mt-2 h-1.5 w-full overflow-hidden rounded-full bg-slate-800">
|
||||
<div
|
||||
className="h-full bg-gradient-to-r from-emerald-500 to-amber-500 rounded-full transition-all duration-500"
|
||||
style={{ width: `${Math.max(5, percentGlobal)}%` }}
|
||||
></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
};
|
||||
44
facturacion-dian-hub/frontend/src/index.css
Normal file
44
facturacion-dian-hub/frontend/src/index.css
Normal file
@ -0,0 +1,44 @@
|
||||
@tailwind base;
|
||||
@tailwind components;
|
||||
@tailwind utilities;
|
||||
|
||||
@layer base {
|
||||
body {
|
||||
@apply bg-[#080d1a] text-slate-100 font-sans;
|
||||
background-image:
|
||||
radial-gradient(at 0% 0%, rgba(16, 185, 129, 0.08) 0px, transparent 50%),
|
||||
radial-gradient(at 100% 0%, rgba(59, 130, 246, 0.08) 0px, transparent 50%),
|
||||
radial-gradient(at 50% 100%, rgba(99, 102, 241, 0.05) 0px, transparent 50%);
|
||||
background-attachment: fixed;
|
||||
}
|
||||
}
|
||||
|
||||
/* Custom scrollbars */
|
||||
::-webkit-scrollbar {
|
||||
width: 6px;
|
||||
height: 6px;
|
||||
}
|
||||
::-webkit-scrollbar-track {
|
||||
background: #0f172a;
|
||||
}
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: #334155;
|
||||
border-radius: 9999px;
|
||||
}
|
||||
::-webkit-scrollbar-thumb:hover {
|
||||
background: #475569;
|
||||
}
|
||||
|
||||
.glass-card {
|
||||
background: rgba(15, 23, 42, 0.75);
|
||||
backdrop-filter: blur(12px);
|
||||
border: 1px solid rgba(255, 255, 255, 0.08);
|
||||
}
|
||||
|
||||
.glow-emerald {
|
||||
box-shadow: 0 0 25px -5px rgba(16, 185, 129, 0.3);
|
||||
}
|
||||
|
||||
.glow-blue {
|
||||
box-shadow: 0 0 25px -5px rgba(59, 130, 246, 0.3);
|
||||
}
|
||||
10
facturacion-dian-hub/frontend/src/main.tsx
Normal file
10
facturacion-dian-hub/frontend/src/main.tsx
Normal file
@ -0,0 +1,10 @@
|
||||
import React from 'react';
|
||||
import ReactDOM from 'react-dom/client';
|
||||
import { App } from './App.js';
|
||||
import './index.css';
|
||||
|
||||
ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
|
||||
<React.StrictMode>
|
||||
<App />
|
||||
</React.StrictMode>
|
||||
);
|
||||
54
facturacion-dian-hub/frontend/src/store/useHubStore.ts
Normal file
54
facturacion-dian-hub/frontend/src/store/useHubStore.ts
Normal file
@ -0,0 +1,54 @@
|
||||
import { create } from 'zustand';
|
||||
import { Invoice, TenantInfo, DianResolutionInfo, FiscalMetrics } from '../types/index.js';
|
||||
|
||||
interface HubState {
|
||||
activeTab: 'dashboard' | 'invoices' | 'emitter' | 'resolutions' | 'tenants';
|
||||
selectedTenantId: string | 'all';
|
||||
invoices: Invoice[];
|
||||
tenants: TenantInfo[];
|
||||
resolutions: DianResolutionInfo[];
|
||||
metrics: FiscalMetrics | null;
|
||||
selectedInvoice: Invoice | null;
|
||||
isEmitterModalOpen: boolean;
|
||||
isDetailModalOpen: boolean;
|
||||
isLoading: boolean;
|
||||
error: string | null;
|
||||
|
||||
setActiveTab: (tab: 'dashboard' | 'invoices' | 'emitter' | 'resolutions' | 'tenants') => void;
|
||||
setSelectedTenantId: (tenantId: string | 'all') => void;
|
||||
setInvoices: (invoices: Invoice[]) => void;
|
||||
setTenants: (tenants: TenantInfo[]) => void;
|
||||
setResolutions: (resolutions: DianResolutionInfo[]) => void;
|
||||
setMetrics: (metrics: FiscalMetrics) => void;
|
||||
setSelectedInvoice: (invoice: Invoice | null) => void;
|
||||
setIsEmitterModalOpen: (open: boolean) => void;
|
||||
setIsDetailModalOpen: (open: boolean) => void;
|
||||
setLoading: (loading: boolean) => void;
|
||||
setError: (error: string | null) => void;
|
||||
}
|
||||
|
||||
export const useHubStore = create<HubState>((set) => ({
|
||||
activeTab: 'dashboard',
|
||||
selectedTenantId: 'all',
|
||||
invoices: [],
|
||||
tenants: [],
|
||||
resolutions: [],
|
||||
metrics: null,
|
||||
selectedInvoice: null,
|
||||
isEmitterModalOpen: false,
|
||||
isDetailModalOpen: false,
|
||||
isLoading: false,
|
||||
error: null,
|
||||
|
||||
setActiveTab: (activeTab) => set({ activeTab }),
|
||||
setSelectedTenantId: (selectedTenantId) => set({ selectedTenantId }),
|
||||
setInvoices: (invoices) => set({ invoices }),
|
||||
setTenants: (tenants) => set({ tenants }),
|
||||
setResolutions: (resolutions) => set({ resolutions }),
|
||||
setMetrics: (metrics) => set({ metrics }),
|
||||
setSelectedInvoice: (selectedInvoice) => set({ selectedInvoice, isDetailModalOpen: !!selectedInvoice }),
|
||||
setIsEmitterModalOpen: (isEmitterModalOpen) => set({ isEmitterModalOpen }),
|
||||
setIsDetailModalOpen: (isDetailModalOpen) => set({ isDetailModalOpen }),
|
||||
setLoading: (isLoading) => set({ isLoading }),
|
||||
setError: (error) => set({ error }),
|
||||
}));
|
||||
84
facturacion-dian-hub/frontend/src/types/index.ts
Normal file
84
facturacion-dian-hub/frontend/src/types/index.ts
Normal file
@ -0,0 +1,84 @@
|
||||
export interface Customer {
|
||||
identificationType: string;
|
||||
identificationNumber: string;
|
||||
dv?: string;
|
||||
legalOrFullName: string;
|
||||
email: string;
|
||||
phone?: string;
|
||||
address: string;
|
||||
cityName: string;
|
||||
}
|
||||
|
||||
export interface InvoiceItem {
|
||||
lineNumber: number;
|
||||
sku: string;
|
||||
description: string;
|
||||
quantity: number;
|
||||
unitPrice: number;
|
||||
taxPercentage: number;
|
||||
taxAmount: number;
|
||||
totalCost: number;
|
||||
}
|
||||
|
||||
export interface Invoice {
|
||||
id: string;
|
||||
tenantId: string;
|
||||
fullNumber: string;
|
||||
prefix: string;
|
||||
consecutive: string;
|
||||
documentType: string;
|
||||
issueDate: string;
|
||||
issueTime: string;
|
||||
currency: string;
|
||||
subtotal: number;
|
||||
taxTotal: number;
|
||||
discountTotal: number;
|
||||
grandTotal: number;
|
||||
cufe?: string;
|
||||
qrContent?: string;
|
||||
dianStatus: 'ACEPTADA' | 'RECHAZADA' | 'FIRMADA' | 'PENDING' | 'ERROR_TRANSMISION' | 'CONTINGENCIA';
|
||||
dianStatusCode?: string;
|
||||
dianStatusDescription?: string;
|
||||
dianTrackingKey?: string;
|
||||
customer: Customer;
|
||||
items: InvoiceItem[];
|
||||
xmlSignedUrl?: string;
|
||||
pdfUrl?: string;
|
||||
createdAt?: string;
|
||||
}
|
||||
|
||||
export interface FiscalMetrics {
|
||||
totalFacturado: number;
|
||||
totalDocumentos: number;
|
||||
aceptadasDian: number;
|
||||
rechazadasDian: number;
|
||||
pendientesDian: number;
|
||||
totalIvaRecaudado: number;
|
||||
}
|
||||
|
||||
export interface TenantInfo {
|
||||
id: string;
|
||||
name: string;
|
||||
slug: string;
|
||||
status: string;
|
||||
economicActivityCode?: string;
|
||||
contactEmail: string;
|
||||
webhookUrl?: string;
|
||||
createdAt?: string;
|
||||
}
|
||||
|
||||
export interface DianResolutionInfo {
|
||||
id: string;
|
||||
tenantId?: string;
|
||||
resolutionNumber: string;
|
||||
prefix: string;
|
||||
fromNumber: string;
|
||||
toNumber: string;
|
||||
currentConsecutive: string;
|
||||
startDate: string;
|
||||
endDate: string;
|
||||
isActive: boolean;
|
||||
documentType: string;
|
||||
porcentajeConsumido: number;
|
||||
diasRestantes: number;
|
||||
}
|
||||
35
facturacion-dian-hub/frontend/tailwind.config.js
Normal file
35
facturacion-dian-hub/frontend/tailwind.config.js
Normal file
@ -0,0 +1,35 @@
|
||||
/** @type {import('tailwindcss').Config} */
|
||||
export default {
|
||||
content: [
|
||||
"./index.html",
|
||||
"./src/**/*.{js,ts,jsx,tsx}",
|
||||
],
|
||||
darkMode: 'class',
|
||||
theme: {
|
||||
extend: {
|
||||
colors: {
|
||||
brand: {
|
||||
50: '#f0fdf4',
|
||||
100: '#dcfce7',
|
||||
500: '#10b981',
|
||||
600: '#059669',
|
||||
700: '#047857',
|
||||
900: '#064e3b',
|
||||
},
|
||||
dian: {
|
||||
blue: '#1d4ed8',
|
||||
cyan: '#0284c7',
|
||||
emerald: '#10b981',
|
||||
amber: '#d97706',
|
||||
dark: '#090d16',
|
||||
card: '#0f172a',
|
||||
border: '#1e293b',
|
||||
}
|
||||
},
|
||||
fontFamily: {
|
||||
sans: ['Plus Jakarta Sans', 'Inter', 'system-ui', 'sans-serif'],
|
||||
}
|
||||
},
|
||||
},
|
||||
plugins: [],
|
||||
}
|
||||
20
facturacion-dian-hub/frontend/tsconfig.json
Normal file
20
facturacion-dian-hub/frontend/tsconfig.json
Normal file
@ -0,0 +1,20 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2020",
|
||||
"useDefineForClassFields": true,
|
||||
"lib": ["ES2020", "DOM", "DOM.Iterable"],
|
||||
"module": "ESNext",
|
||||
"skipLibCheck": true,
|
||||
"moduleResolution": "bundler",
|
||||
"allowImportingTsExtensions": true,
|
||||
"resolveJsonModule": true,
|
||||
"isolatedModules": true,
|
||||
"noEmit": true,
|
||||
"jsx": "react-jsx",
|
||||
"strict": true,
|
||||
"noUnusedLocals": false,
|
||||
"noUnusedParameters": false,
|
||||
"noFallthroughCasesInSwitch": true
|
||||
},
|
||||
"include": ["src"]
|
||||
}
|
||||
20
facturacion-dian-hub/frontend/vite.config.ts
Normal file
20
facturacion-dian-hub/frontend/vite.config.ts
Normal file
@ -0,0 +1,20 @@
|
||||
import { defineConfig } from 'vite';
|
||||
import react from '@vitejs/plugin-react';
|
||||
|
||||
export default defineConfig({
|
||||
plugins: [react()],
|
||||
server: {
|
||||
port: 3000,
|
||||
host: '0.0.0.0',
|
||||
proxy: {
|
||||
'/api': {
|
||||
target: 'http://localhost:3001',
|
||||
changeOrigin: true,
|
||||
},
|
||||
'/health': {
|
||||
target: 'http://localhost:3001',
|
||||
changeOrigin: true,
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
52
facturacion-dian-hub/nginx.conf
Normal file
52
facturacion-dian-hub/nginx.conf
Normal file
@ -0,0 +1,52 @@
|
||||
server {
|
||||
listen 80;
|
||||
server_name localhost;
|
||||
root /usr/share/nginx/html;
|
||||
index index.html index.htm;
|
||||
|
||||
# Compresión gzip para alto rendimiento
|
||||
gzip on;
|
||||
gzip_vary on;
|
||||
gzip_min_length 1024;
|
||||
gzip_proxied any;
|
||||
gzip_types text/plain text/css text/xml application/json application/javascript application/xml+rss application/atom+xml image/svg+xml;
|
||||
|
||||
# Encabezados de Seguridad
|
||||
add_header X-Frame-Options "SAMEORIGIN" always;
|
||||
add_header X-XSS-Protection "1; mode=block" always;
|
||||
add_header X-Content-Type-Options "nosniff" always;
|
||||
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
|
||||
|
||||
# Enrutamiento SPA React
|
||||
location / {
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
# Caché estática para assets generados por Vite
|
||||
location ~* \.(?:css|js|woff2?|svg|gif|png|jpg|jpeg|ico)$ {
|
||||
expires 1y;
|
||||
add_header Cache-Control "public, max-age=31536000, immutable";
|
||||
}
|
||||
|
||||
# Proxy inverso para llamadas al Backend Fastify
|
||||
location /api/ {
|
||||
proxy_pass http://backend:3001;
|
||||
proxy_http_version 1.1;
|
||||
proxy_set_header Upgrade $http_upgrade;
|
||||
proxy_set_header Connection 'upgrade';
|
||||
proxy_set_header Host $host;
|
||||
proxy_cache_bypass $http_upgrade;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
location /health {
|
||||
proxy_pass http://backend:3001/health;
|
||||
}
|
||||
|
||||
error_page 500 502 503 504 /50x.html;
|
||||
location = /50x.html {
|
||||
root /usr/share/nginx/html;
|
||||
}
|
||||
}
|
||||
16
facturacion-dian-hub/start-dev.ps1
Normal file
16
facturacion-dian-hub/start-dev.ps1
Normal file
@ -0,0 +1,16 @@
|
||||
Write-Host "==========================================================" -ForegroundColor Cyan
|
||||
Write-Host "🚀 INICIANDO DIAN ELECTRONIC INVOICING FISCAL HUB (Dev)" -ForegroundColor Green
|
||||
Write-Host "🏢 Empresa: Innovación & Desarrollo S.A.S. (NIT 901.554.892-9)" -ForegroundColor White
|
||||
Write-Host "==========================================================" -ForegroundColor Cyan
|
||||
|
||||
# Iniciar Backend en una nueva ventana de terminal
|
||||
Start-Process powershell -ArgumentList "-NoExit", "-Command", "cd '$PSScriptRoot\backend'; Write-Host '--- FASTIFY BACKEND API (Port 3001) ---' -ForegroundColor Yellow; npm.cmd run dev"
|
||||
|
||||
# Iniciar Frontend en una nueva ventana de terminal
|
||||
Start-Process powershell -ArgumentList "-NoExit", "-Command", "cd '$PSScriptRoot\frontend'; Write-Host '--- VITE REACT ADMIN PANEL (Port 3000) ---' -ForegroundColor Green; npm.cmd run dev"
|
||||
|
||||
Write-Host "`n✅ Servicios iniciados exitosamente:" -ForegroundColor Green
|
||||
Write-Host " 👉 Frontend Panel: http://localhost:3000" -ForegroundColor White
|
||||
Write-Host " 👉 Backend API: http://localhost:3001" -ForegroundColor White
|
||||
Write-Host " 👉 Swagger Docs: http://localhost:3001/api/docs" -ForegroundColor White
|
||||
Write-Host " 👉 Health Check: http://localhost:3001/health`n" -ForegroundColor White
|
||||
Loading…
Reference in New Issue
Block a user