Add HST schemas index with 13 document types
This commit is contained in:
ARCHITECT
192
03_MODELO_DATOS/hst-schemas-index.md
Normal file
192
03_MODELO_DATOS/hst-schemas-index.md
Normal file
@@ -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 |
|
||||||
Reference in New Issue
Block a user