🇬🇹 Guatemala

This sheet assumes you know the xPOS-Core communication protocol. Here we only document what is specific to Guatemala.

Summary

Aspect	Value
country code	gt
Tax authority	Megaprint / SAT
Pattern	A — XML with XSD
Supported inputType	json, xml, xdoc, txt
Extra endpoint	–
Output	Signed tax XML

XSLT mapping

XSLT	Use
input_to_dte_gt.xslt	json and xml inputs → XML <root> → Gosocket XML.
other_to_dte_gt.xslt	txt input → Gosocket XML. Does not go through input_to_dte.
xdoc_to_dte_gt.xslt	xdoc input → Gosocket XML. Does not go through input_to_dte.
dte_to_fiscal_gt.xslt	Gosocket XML → SAT tax DTE.
custom_response_gt.xslt	Generates custom_response when applicable.

Document types (typeDoc)

WebSocket example uses typeDoc=1.

Guatemala is the only country where the fiscal code and the typeDoc are different: the SAT's FEL codes are alphanumeric, and the typeDoc is the platform's internal numeric code. How each one travels: the numeric typeDoc goes in the request parameter; the FEL code goes inside the document, in the <Tipo> node of the generic DTE.

typeDoc	FEL code	Document
1	FACT	Electronic invoice
2	NCRE	Electronic credit note
3	NDEB	Electronic debit note
4	FAPE	Small taxpayer invoice, electronic regime
5	FCPE	Small taxpayer exchange invoice, electronic regime
6	FCAM	Exchange invoice
7	FPEQ	Small taxpayer invoice
8	FCAP	Small taxpayer exchange invoice
9	FESP	Special invoice
10	NABN	Payment note (nota de abono)
11	RDON	Donation receipt
12	RECI	Receipt
13	CTNG	Contingency
15	FACA	Agricultural taxpayer invoice
16	FCCA	Agricultural taxpayer exchange invoice
17	FAAE	Agricultural taxpayer invoice, special electronic regime

The catalog does not include typeDoc 14. Type 13 (CTNG) is the special contingency document.

Guatemala-specific response fields

Guatemala returns the core + tax echo (statusCode/Description/Message), without applicationResponse or timeGeneration/Validation.

countryIdentificationCode in Guatemala is the SAT authorization number.

WebSocket example

Illustrative values. The structure is real; the data are examples.

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

Particular notes

• PAC: submission to SAT is done via Megaprint.
• Publishes in API/Storage Gosocket.

Changes in version 2.7.0

• Pre-validation of the signed document against the SAT's official schemas, both online and in contingency: format problems are detected before sending.
• More stable issuance on devices with several issuers: each submission to Megaprint travels with the identity of the corresponding issuer.