🇬🇹 Guatemala

Esta ficha asume que conoces el protocolo de comunicación xPOS-Core. Aquí solo documentamos lo especifico de Guatemala.

Resumen

Aspecto	Valor
Código country	gt
Entidad tributaria	Megaprint / SAT
Patrón	A — XML con XSD
inputType soportados	json, xml, xdoc, txt
Endpoint extra	–
Output	XML tributario firmado

Mapeo de XSLT

XSLT	Uso
input_to_dte_gt.xslt	Entradas json y xml → XML <root> → XML Gosocket.
other_to_dte_gt.xslt	Entrada txt → XML Gosocket. No pasa por input_to_dte.
xdoc_to_dte_gt.xslt	Entrada xdoc → XML Gosocket. No pasa por input_to_dte.
dte_to_fiscal_gt.xslt	XML Gosocket → DTE tributario SAT.
custom_response_gt.xslt	Genera custom_response cuando aplica.

Tipos de documento (typeDoc)

Ejemplo WebSocket usa typeDoc=1.

Guatemala es el único país donde el código fiscal y el typeDoc son distintos: los códigos FEL del SAT son alfanuméricos, y el typeDoc es el código numérico interno de la plataforma. Cómo viaja cada uno: el typeDoc numérico va en el parámetro de la petición; el código FEL va dentro del documento, en el nodo <Tipo> del DTE genérico.

typeDoc	Código FEL	Documento
1	FACT	Factura electrónica
2	NCRE	Nota de crédito electrónica
3	NDEB	Nota de débito electrónica
4	FAPE	Factura pequeño contribuyente régimen electrónico
5	FCPE	Factura cambiaria pequeño contribuyente régimen electrónico
6	FCAM	Factura cambiaria
7	FPEQ	Factura pequeño contribuyente
8	FCAP	Factura cambiaria pequeño contribuyente
9	FESP	Factura especial
10	NABN	Nota de abono
11	RDON	Recibo por donación
12	RECI	Recibo
13	CTNG	Contingencia
15	FACA	Factura contribuyente agropecuario
16	FCCA	Factura cambiaria contribuyente agropecuario
17	FAAE	Factura contribuyente agropecuario régimen electrónico especial

El catálogo no incluye el typeDoc 14. El 13 (CTNG) es el documento especial de contingencia.

Campos del response específicos de Guatemala

Guatemala devuelve el nucleo + eco tributario (statusCode/Description/Message), sin applicationResponse ni timeGeneration/Validation.

countryIdentificationCode en Guatemala es el número de autorización SAT.

Ejemplo WebSocket

Valores ilustrativos. La estructura es real; los datos son ejemplos.

{
"env": "sbx",
"operation": "consolidate",
"typeDoc": 1,
"country": "gt",
"inputType": "xml",
"origin": "<taxId del emisor>",
"document": { /* DTE Guatemala */ }
}

Notas particulares

• PAC: el envío a SAT se hace vía Megaprint.
• Publica en API/Storage Gosocket.

Cambios en la versión 2.7.0

• Validación previa del documento firmado contra los esquemas oficiales del SAT, tanto en línea como en contingencia: los problemas de formato se detectan antes de enviar.
• Emisión más estable en equipos con varios emisores: cada envío a Megaprint viaja con la identidad del emisor que corresponde.