From e2c308eb6ff0c57f76f77a4428217611a1dd3b65 Mon Sep 17 00:00:00 2001 From: ARCHITECT Date: Thu, 1 Jan 2026 19:52:43 +0000 Subject: [PATCH] Add HST schemas index with 13 document types --- 03_MODELO_DATOS/hst-schemas-index.md | 192 +++++++++++++++++++++++++++ 1 file changed, 192 insertions(+) create mode 100644 03_MODELO_DATOS/hst-schemas-index.md diff --git a/03_MODELO_DATOS/hst-schemas-index.md b/03_MODELO_DATOS/hst-schemas-index.md new file mode 100644 index 0000000..34f0d65 --- /dev/null +++ b/03_MODELO_DATOS/hst-schemas-index.md @@ -0,0 +1,192 @@ +# Índice de Schemas HST + +**Versión:** 1.0 +**Actualizado:** 2026-01-01 + +--- + +## Resumen + +El sistema HST (HashTag Semántico) define 13 schemas de documentos comerciales siguiendo una arquitectura de 6 capas (L1-L6). Los schemas están almacenados en R2 y registrados en la base de datos HST. + +--- + +## Documentos Comerciales + +### Flujo de Ventas + +| Tag | Nombre ES | Nombre EN | Campos | Descripción | +|-----|-----------|-----------|--------|-------------| +| `bgt` | Presupuesto | Budget/Estimate | 120 | Cálculo económico sin compromiso | +| `gtc` | Condiciones Generales | General Terms | 90 | Términos legales reutilizables | +| `off` | Oferta | Offer | 180 | Propuesta vinculante (bgt + gtc) | +| `ord` | Pedido | Order | 200 | Instrucción de compra | +| `dpa` | Aviso de Despacho | Despatch Advice | 180 | Notificación de envío | +| `dnt` | Albarán | Delivery Note | 160 | Documento de entrega | +| `inv` | Factura | Invoice | 250 | Documento fiscal | +| `cct` | Contrato | Contract | 280 | Acuerdo legal vinculante | + +### Flujo de Compras (Perspectiva) + +| Tag | Nombre ES | Base | Descripción | +|-----|-----------|------|-------------| +| `qtt` | Cotización | off | Oferta recibida de proveedor | +| `sod` | Pedido Proveedor | ord | Pedido emitido a proveedor | +| `siv` | Factura Proveedor | inv | Factura recibida de proveedor | + +### Gestión + +| Tag | Nombre ES | Nombre EN | Campos | Descripción | +|-----|-----------|-----------|--------|-------------| +| `evt` | Evento | Event | 80 | Registro de actividad | +| `tsk` | Tarea | Task | 70 | Unidad de trabajo | + +--- + +## Flujo Documental + +``` +VENTAS: +bgt ──────────────────────────────────────────────────┐ + │ │ + └──▶ off (+gtc) ──▶ ord ──▶ dpa ──▶ dnt ──▶ inv │ + │ │ + └──▶ cct ────────────────────────────────┘ + +COMPRAS: + qtt ──▶ sod ──▶ (dpa) ──▶ (dnt) ──▶ siv +``` + +--- + +## Arquitectura de 6 Capas + +| Capa | Nombre | Descripción | +|------|--------|-------------| +| **L1** | Core | Datos principales: header, partes, líneas, totales | +| **L2** | Tax/Legal | Información fiscal y legal | +| **L3** | Execution | Firmas, estados, seguimiento | +| **L4** | Regional | Requisitos por país (Peppol, CFDI, etc.) | +| **L5** | Links | Referencias a otros documentos | +| **L6** | Extended | Metadata, workflow, integraciones | + +--- + +## Estándares Soportados + +- **UBL 2.1** - Universal Business Language +- **Peppol BIS 3.0** - Pan-European Public Procurement Online +- **EN16931** - Norma europea de facturación electrónica +- **Factur-X / ZUGFeRD** - Factura híbrida PDF/XML +- **CFDI 4.0** - Comprobante Fiscal Digital (México) +- **FacturaE 3.2** - Factura electrónica (España) +- **INCOTERMS 2020** - Términos de comercio internacional +- **eIDAS** - Reglamento europeo de firma electrónica + +--- + +## Ubicaciones + +### Schemas Completos (R2) + +``` +s3://architect/system/skynet v8/03_MODELO_DATOS/sistema hst/ +├── HST_Budget_Standard_v1.0.md +├── HST_Delivery_Note_Standard_v1.0.md +├── HST_Despatch_Advice_Standard_v1.0.md +├── HST_Event_Standard_v1.0.md +├── HST_General_Terms_Standard_v1.0.md +├── HST_Global_Contract_Standard_v1.0.md +├── HST_Global_Invoice_Standard_v1.0.md +├── HST_Offer_Standard_v1.0.md +├── HST_Order_Standard_v1.0.md +├── HST_Quotation_Standard_v1.0.md +├── HST_Supplier_Invoice_Standard_v1.0.md +├── HST_Supplier_Order_Standard_v1.0.md +└── HST_Task_Standard_v1.0.md +``` + +### Base de Datos (HST Server) + +- **Servidor:** 72.62.2.84 +- **Base de datos:** lumalia +- **Tabla:** hst +- **Campo:** descripcion_modelo (JSONB) + +--- + +## Consultas Útiles + +### Listar schemas disponibles + +```sql +SELECT ref, nombre_es, + descripcion_modelo->>'name_en' as name_en, + descripcion_modelo->>'total_fields' as campos +FROM hst +WHERE descripcion_modelo IS NOT NULL +ORDER BY ref; +``` + +### Ver flujo documental de un tipo + +```sql +SELECT ref, + descripcion_modelo->'document_flow'->>'input' as entrada, + descripcion_modelo->'document_flow'->>'output' as salida +FROM hst +WHERE ref = 'ord'; +``` + +### Listar capas de un schema + +```sql +SELECT ref, + jsonb_object_keys(descripcion_modelo->'layers') as capa +FROM hst +WHERE ref = 'inv'; +``` + +--- + +## Tipos de Documento + +### Tipos de Factura (inv/siv) +| Código | UNTDID 1001 | Descripción | +|--------|-------------|-------------| +| 380 | Commercial Invoice | Factura comercial | +| 381 | Credit Note | Nota de crédito | +| 383 | Debit Note | Nota de débito | +| 384 | Corrective Invoice | Factura rectificativa | +| 389 | Self-billed Invoice | Autofactura | +| 751 | Invoice Information | Factura informativa | + +### Tipos de Pedido (ord/sod) +| Código | Descripción | +|--------|-------------| +| STD | Pedido estándar | +| BLK | Pedido abierto/marco | +| REL | Liberación de pedido abierto | +| SPT | Pedido puntual | +| RPT | Pedido repetitivo | +| RUS | Pedido urgente | +| SVC | Pedido de servicios | + +### Tipos de Contrato (cct) +| Código | Descripción | +|--------|-------------| +| FRM | Contrato marco | +| SVC | Servicios | +| NDX | Anexo/Adenda | +| LIC | Licencia | +| EMP | Empleo | +| LEA | Arrendamiento | +| PUR | Compraventa | + +--- + +## Changelog + +| Fecha | Versión | Cambios | +|-------|---------|---------| +| 2026-01-01 | 1.0 | Versión inicial con 13 schemas |