과테말라¶
소개¶
With the Guatemalan localization, you can connect to the tax authority Superintendencia de Administración Tributaria (SAT) to generate electronic documents with its XML, fiscal folio, and electronic signature.
지원되는 문서는 다음과 같습니다.
FACT-Factura,
FCAM-Factura Cambiaria,
FPEQ-Factura de Pequeño Contribuyente,
NCRE-신용 전표,
NDEB-차변전표,
NABN-Nota de Abono,
FCAP-Factura Cambiaria Pequeño Contribuyente,
FACT-Factura with Export Complement.
The localization requires an Infile account, which enables users to generate electronic documents within Odoo.
용어 사전¶
The following terms are used throughout the Guatemalan localization:
SAT: Superintendencia de Administración Tributaria is the government entity responsible for enforcing tax payments in Guatemala.
FEL: Factura Electrónica en Línea is the electronic invoicing system mandated by the SAT in Guatemala, which requires businesses to issue and manage electronic documents in compliance with local regulations.
EDI: 전자 데이터 교환 이란 전자 문서를 전송하는 것을 의미합니다.
Infile: is the third-party organization that facilitates the interchange of electronic documents between companies and the Guatemalan government.
UUID: Universally Unique Identifier is a unique alphanumeric code assigned by the SAT to each certified electronic document in the FEL system, used for traceability and official validation.
구문: 구문 유형에 특정한 시나리오 코드를 지정하여 과테말라 현지화에서 SAT 요건에 부합할 수 있도록 사용합니다. 발행자 제도, 수신자 및 작업 유형에 맞추어 추가해야 합니다. 이러한 구문은 XML 및 PDF 문서에서 사용합니다.
Establishment Code: A unique identifier assigned by the SAT to each business establishment, which is required for electronic invoicing.
Quetzal: The official currency of Guatemala, represented by the symbol GTQ. This is the base currency for all financial transactions in the Guatemalan localization.
환경설정¶
모듈 설치¶
Install the following modules to get all the features of the Guatemalan localization:
이름 |
기술적 명칭 |
설명 |
---|---|---|
Guatemala - Accounting |
|
기본 재정 현지화 패키지. 이 패키지에는 과테말라 현지화에 맞추어 회계 상의 특징적인 내용이 추가되어 있으며, 이는 SAT 에서 정한 지침에 따라 과테말라에서 회사를 운영하는 데 필요한 최소한의 환경설정이 완료되어 있습니다. 이 모듈을 설치하면 계정과목표 및 세금이 자동으로 로드됩니다. |
Guatemala Accounting EDI |
|
Includes all the technical and functional requirements to generate and validate Electronics Documents, based on the technical documentation published by the SAT. The authorized documents are listed above. |
참고
Odoo automatically installs the base module Guatemala - Accounting when a database is
installed with Guatemala
selected as the country. However, to enable electronic invoicing, the
Guatemala Accounting EDI (l10n_gt_edi
) module needs to be manually installed.
회사¶
To configure your company information, open the Settings app, scroll down to the Companies section, click Update Info, and configure the following:
회사명
주소 이며, 여기에는 도로명, 시/도, 지역, 우편번호, 국가 등이 있습니다.
Tax ID: Enter the identification number for the selected taxpayer type.
VAT Affiliation: Select the VAT affiliation for the company, which is the type of Regime the company belongs to.
Legal Name: The legal name of the company, which is used in the XML and PDF documents.
Establishment Code: A necessary part of the XML when creating an electronic document. If this field is not set, all electronic documents will be rejected.
To locate the Establishment Code in your SAT account, go to . The list of registered establishments is displayed along with their corresponding codes.
중요
After configuring the company in the database settings, navigate to the company’s contact form and verify that the Identification Number Type is set to NIT.
Electronic invoicing credentials¶
In Guatemala, electronic invoicing is mandatory for most businesses. Odoo connects with the authorized provider, Infile, to generate and submit electronic documents to the SAT for validation.
Before issuing electronic documents, you must configure and connect Odoo to Infile to ensure they are properly validated and assigned an official UUID.
Infile¶
Sign a service agreement directly with Infile. Infile will then provide the necessary credentials to input in Odoo.
Odoo¶
In Odoo, once you have completed the Infile process, navigate to Guatemalan Localization section, then follow these steps:
, scroll down to theSelect the Infile Web Services environment, either Test or Production.
Enter the Infile Credentials:
Infile WS Username or Prefix
인파일 토큰
인파일 키
Click on Save.
참고
The Infile Credentials are provided by Infile and are required for both test and production environments. If they are not available, contact Infile support.
팁
The demo environment is for testing only and does not generate legal documents, UUID keys, or fiscal folios. No Infile account or credentials are needed to use the demo environment.
다중 통화¶
The official currency exchange rate in Guatemala is provided by the Bank of Guatemala. Odoo can connect directly to its services and get the currency rate either automatically or manually.
더 보기
마스터 데이터¶
계정과목표¶
계정과목표 는 기본값으로 설치되며, 현지화 모듈에 포함된 데이터 세트의 일부입니다. 계정은 세금, 기본 미지급금 및 기본 미수금 항목에 자동으로 매핑됩니다.
회사에서 필요에 따라 계정을 추가하거나 삭제할 수 있습니다.
연락처¶
The following fields must be completed on contact forms:
회사명
주소 이며, 여기에는 도로명, 시/도, 지역, 우편번호, 국가 등이 있습니다.
식별 번호:
Type: Select an identification type.
Number: Required to confirm an electronic invoice.
참고
To automatically include a specific phrase in the XML and PDF of every electronic invoice for a contact, select it in Phrases field in the Sales & purchase tab of the contact form.
세금¶
As part of the Guatemala localization module, taxes are automatically created with their configuration and related financial accounts.
전자 청구서¶
Once the database has been configured successfully, electronic documents can be created and sent.
Once customer invoices are validated, they can be sent electronically to SAT via Infile, provided the following fields are completed:
Customer: Type the customer’s information.
GT Document Type: Select the type of document you want to create, i.e., FACT - Factura Electrónica or FCAM - Factura Cambiara. By default, the document type is set to FACT.
Due date: To compute if the invoice is due now or later.
Journal: Select the sales journal.
Products: Specify the product(s) with the correct taxes.
완료되면 :guilabel:`확인`을 클릭합니다.
참고
If you need to add a specific phrase based on the transaction, go to the Other Info tab and add the corresponding phrase in GT Phrases. These phrases are used in the XML and PDF documents.
참고
청구서에 별도 자료를 추가해야 하는 경우 이용 약관 필드를 이용하여 추가할 수 있습니다. 추가 자료는 XML 문서에 포함되며 청구서와 관련된 추가 정보나 메모를 제공하는 데 사용할 수 있습니다.
청구서를 확정한 후에는 보내기 를 클릭합니다. 마법사가 나타나면 SAT로 보내기 및 이메일로 보내기 확인란을 선택하여 XML을 SAT 로 전송합니다. Infile 웹 서비스를 통해 확정한 청구서를 클라이언트 이메일로 전송하고 보내기 를 클릭합니다. 그러면 다음과 같이 진행됩니다.
XML 문서가 생성되었습니다.
The UUID is generated.
The XML is processed synchronously by Infile.
If accepted, the file is displayed in the chatter, and the email to the client with the corresponding
pdf
andxml
file is sent.If the file contains errors, a warning message displays the reason(s) and the email is not sent.

The SAT tab then displays the following:
Datetime: Timestamp recorded of the XML creation.
GT Status: Status result obtained in the SAT response. If the file contains errors, a warning message displays the reason(s) and the email is not sent.
UUID: The unique identifier assigned by the SAT to the electronic document.
Download Certificate: To download the sent XML file, even if the SAT result was rejected.

Debit and credit notes¶
To send a debit or credit note to Infile, first create the debit or credit note.
Then, in the Send window, click Send to SAT (Guatemalan EDI) to submit it for real-time validation. Upon successful validation, the QR code from Infile is embedded in the debit or credit note PDF.
청구서 내보내기¶
Exportation invoices must meet the following conditions:
The customer’s Identification type must be VAT, Passport, or Foreign ID.
The following fields must be defined in the customer invoice’s Other Info tab, under the Accounting section:
인코텀즈
GT Phrases: Type 4 Code 1
위탁 회사
All invoice lines must include taxes set to 0%.
