Formato GUF (Gosocket Universal Format)
El GUF es el formato canónico de Gosocket para documentos tributarios electrónicos. Un integrador construye el documento una sola vez en GUF y la plataforma lo serializa al formato fiscal de cada país (DTE en Chile, CFDI en México, UBL DIAN en Colombia, etc.).
Esta sección documenta el modelo con tres registros interconectados, generados a partir de las fuentes de conocimiento internas (modelo canónico v3, análisis GAP por país y perfiles de validación):
- Referencia de campos — cada campo con su descripción, tipo, formato, obligatoriedad, xPath GUF, xPath del XML tributario del país y su concepto canónico (con referencia EN 16931 cuando existe).
- Registro de reglas — cada regla de validación con un identificador estable
(por ejemplo
CL33-OBL-IdDoc.Tipo), enlazada en ambas direcciones con los campos que afecta. - Catálogos — las listas de valores permitidos, como registros de primera clase (ver los catálogos de Chile · ver los catálogos de México).
Esta entrega cubre los 12 tipos de documento electrónico de Chile (Factura, Boleta, Guía de Despacho, Notas de Débito/Crédito y sus variantes exenta/exportación) y los 21 complementos CFDI de México (Carta Porte, Nómina, Pago, INE, IEDU, Comercio Exterior, entre otros — ver el detalle abajo). La misma estructura se extenderá al resto de países.
Documentos disponibles
Chile
Cargando documentos disponibles…
México
Cargando documentos disponibles…
Cómo leer la referencia
Cada campo lleva una insignia de obligatoriedad:
| Insignia | Significado |
|---|---|
| M | Obligatorio — el documento se rechaza si falta |
| C | Condicional — obligatorio cuando se cumple la condición indicada |
| O | Opcional |
| N/A | No aplica para este tipo de documento |
Cada campo tiene un enlace permanente: al seleccionarlo en la referencia, la URL se actualiza con su ancla y puede compartirse en tickets de soporte o mensajes de error.
Glosario
| Término | Definición |
|---|---|
| M | Dato Mandatorio. El dato debe estar en el documento siempre, independiente de las características de la transacción. |
| O | Dato Opcional |
| C | Dato condicional. El dato no es obligatorio en todas los tipos de documentos, pero pasa a ser obligatorio en determinadas operaciones si se cumple una cierta condición. |
| N/A | No Aplicable, este dao nunca debe enviarse para ese tipo de documento |
| minLen | Longitud mínima permitida para el dato, en número de caracteres. |
| maxLen | Longitud máxima permitida para el dato, en número de caracteres. |
| totalDig | Número total de dígitos permitidos para un valor numérico (parte entera + parte fraccionaria) |
| fracDig | Número de dígitos permitidos en la parte fraccionaria (decimales) de un valor numérico |
| minIncl | Valor mínimo permitido para el dato, incluido (es decir, el dato puede ser igual a este valor o mayor) |
| maxIncl | Valor máximo permitido para el dato, incluido (es decir, el dato puede ser igual a este valor o menor) |
| N | No es obligatorio que el campo sea impreso en el documento |
| I | I = Debe estar impreso. La impresión de un dato no debe necesariamente ser igual al formato que se especifica en el presente documento. Como ejemplo, una fecha no tiene necesariamente que estar en el formato AAAA-MMDD, sino que puede ser impresa con el mes en letras o cambiando el orden en que aparecen el año, el mes y día, de manera de facilitar su lectura. Adicionalmente, se puede optar porque un dato que es obligatorio imprimir, esté preimpreso. |
| P | Debe estar impresa traduciendo el código a la correspondiente glosa (expresado en palabras.) Por ejemplo: en el documento electrónico el tipo de documento está codificado, sin embargo en la representación impresa del documento se debe indicar el nombre del documento (Factura electrónica, Nota de Crédito electrónica, etc.) |