# Í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 |