system-docs/03_MODELO_DATOS/hst-schemas-index.md

Í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

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

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

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