사우디 아라비아¶
모듈¶
The following modules related to the Saudi Arabian localization are available:
이름 |
기술적 명칭 |
설명 |
|---|---|---|
사우디 아라비아 - 회계 |
|
Default fiscal localization package for Saudi Arabia with Phase 1 QR code support. |
사우디아라비아 - 회계 보고서 |
|
사우디아라비아용 회계 보고서 |
사우디 아라비아 - 전자 청구서 |
|
전자 청구서 규정에 부합할 수 있도록 ZATCA 2단계 API 통합 기능을 활성화합니다. |
사우디아라비아 - 전자 청구서 (간이 버전) |
|
POS를 통해 전자 청구서 기능을 활성화합니다. |
사우디아라비아 - POS |
|
POS 청구서 관련 규정에 맞도록 필드와 동작을 추가합니다. |
사우디아라비아 - 원천징수세 |
|
Forces the installation of the Withholding Tax on Payment module. |
참고
The localization’s core modules are installed automatically with the localization. The rest can be manually installed.
더 보기:
현지화의 전반적인 흐름¶
The Saudi Arabian localization package ensures compliance with Saudi Arabian fiscal and accounting regulations. It includes tools for managing taxes, fiscal positions, reporting, and a predefined chart of accounts tailored to Saudi Arabia’s standards.
The Saudi Arabian localization package provides the following key features to ensure compliance with local fiscal and accounting regulations:
계정과목표: 사우디아라비아 규정에 부합하도록 사전에 지정되어 있는 계정과목표
세금: preconfigured tax rates, including standard 15% VAT, zero-rated, and exempt options
재정 위치 (세금 및 계정 매핑): 고객 또는 공급업체 등록 상태에 따라 자동으로 세금 조정
Withholding taxes: predefined withholding tax rules for applicable service categories
세금 신고: 세금 신고 자동화
E-invoicing (ZATCA): integration for electronic invoicing in line with Saudi Arabian government requirements
세금¶
The Saudi Arabian localization includes preconfigured sales, purchase, and withholding taxes:
- Standard VAT (15%): The prevailing rate applied to the majority of goods and services supplied within the Kingdom.The supplier charges 15% VAT on the sale (Output VAT) and is generally entitled to deduct the VAT paid on its business purchases (Input VAT).
Example
Most commercial sales, retail goods, telecommunication services, non-exempt private education, and non-exempt private healthcare.
- Zero-rated VAT (0%): These are taxable supplies where the rate of tax applied is 0%.The supplier charges no VAT on the sale, but, critically, is fully entitled to recover the input VAT paid on costs related to making those supplies.
Example
Exports: Supplies of goods and services to a non-GCC resident or for consumption outside the Kingdom.
International transport: Services for the international transport of passengers and goods, and related services.
Specific goods: Supplies of qualifying medicines and qualifying medical equipment, as specified by ZATCA/Ministry of Health.
Residential property: First supply of a new residential building/property to a Saudi citizen, up to a value of SAR 1,000,000 (subject to specific conditions).
Investment metals: Qualifying gold, silver, and platinum of 99% purity or higher (supplied for investment).
- Exempt transactions: These transactions fall outside the scope of VAT, meaning they are not subject to the tax.The supplier does not charge any VAT on the sale and is not entitled to recover the input VAT paid on costs related to making these supplies (resulting in an unrecoverable cost).
Example
Financial services: interest on loans, provision of credit, operations of current/deposit/savings accounts, issuance or transfer of money or securities, and life insurance.
부동산: 순수 주거용 부동산에 대한 임대(리스)입니다.
- Import VAT: VAT is levied on goods brought into the Kingdom from a non-GCC country.VAT is typically calculated at the standard rate (15%) and is paid to the Customs Authority at the point of importation.
중요
When assigning discounts to invoices, assign a 15% tax on the line containing a global discount to comply with ZATCA rules.
역과세 메커니즘 (RCM)¶
Description: Mechanism that shifts the responsibility for accounting for VAT from the non-resident supplier to the resident recipient of the goods or services.
Mechanism: The VAT-registered recipient must calculate and account for the VAT (as both output VAT and input VAT) in their VAT return. This typically results in a net zero effect on the VAT return, provided the input tax is fully deductible.
Application: Primarily used for B2B supplies of services from a non-resident supplier to a VAT-registered business in Saudi Arabia.
원천징수 세금¶
There are two available methods for calculating withholding tax: gross and deducted.
Gross withholding: This is the primary configuration, where the withholding amount is calculated in addition to the bill total. For example, if the total bill is entered as 115 SAR, the system calculates the base plus Withholding Tax (WHT) without reducing the payment amount.
Deducted withholding: It reduces the payable amount by the withholding amount directly, meaning the total payment reflects the deduction upfront. This affects how the accounting entries and payable lines are booked.
참고
Deducted withholding taxes are not enabled by default. To activate it, go to Accounting –> Configuration –> Taxes and enable the relevant withholding tax.
The following Withholding Tax (WHT) configurations are preloaded and available for use:
5% Withholding Tax: Applied on payments for rent, dividends, technical and consulting services, air and maritime freight, as well as interest, insurance, and reinsurance premiums.
15% Withholding Tax: Applies to royalties and other general service payments made to non-residents.
20% Withholding Tax: Reserved for management fees and specific high-value service payments.
세금 신고¶
The VAT and Withholding Return provide a detailed breakdown of taxable, zero-rated, exempt, and withholding transactions. Like other financial reports, the VAT and Withholding Return can be filtered by period, compared against other periods, and exported in Excel and PDF formats, ensuring compliance with Saudi Arabia tax laws.
회사 및 문의처¶
To ensure proper integration with ZATCA, the following fields are required on the company record:
Company Name, limited to a maximum of 63 characters to comply with ZATCA requirements.
All relevant Address fields, including the District, Building Number, and Plot Identification
식별 체계
세금 식별 번호
비즈니스 등록 번호
Momra 라이선스
MLSD 라이선스
700 번호
Sagia 라이선스
부가가치세 번호
통화 는 반드시 SAR 로 설정해야 합니다.
중요
All fields must be completed accurately to avoid rejection during ZATCA onboarding.
참고
The same configuration applies to all relevant contact forms.
브랜치 환경설정¶
Set up your company branches in compliance with ZATCA rules.
중요
On the branch contact form, enter the same VAT Number as the parent company and enter the branch Commercial Registration Number (CRN) in the Identification Scheme field.
참고
Either use the parent company’s sales journal to follow a centralized billing system model, or onboard a new branch-specific journal to set up a multi-threaded system with parallel invoice processing.
청구서 사용 언어¶
Invoices can be issued in different languages to meet regional or customer-specific requirements at two levels:
Customer level: To assign a preferred language to a customer, go to or , and open the relevant customer form. In the Language field, update the language. All documents are then automatically generated in the selected language for that customer.
중요
Saudi Arabia’s VAT regulations require Tax Invoices and Simplified Tax Invoices (along with corresponding credit notes or debit notes) to be in Arabic, mandatorily. Invoices can be bilingual, including English.
Company level: To add Arabic as a secondary language to meet Saudi Arabia VAT regulations:
For Tax Invoices: Go to , in the Customer Invoices section.
For Point of Sale receipts: Go to , and navigate to the Bills & Receipts section.
Then, enable the Gulf Cooperation Council Format option, and Save.
ZATCA 전차 청구서 발행¶
ZATCA 전자 청구서 발행 시스템은 사우디아라비아에서 운영되는 기업의 청구서 발행 프로세스를 간소화하고 디지털화할 수 있도록 설계되었습니다.
ZATCA Phase 2 employs a clearance e-invoicing model for Business-to-Business (B2B) transactions. Conversely, for Business-to-Consumer (B2C) transactions, Odoo generates a QR code and subsequently reports these transactions to the Fatoora reporting endpoint.
In a B2B scenario, a Tax Invoice is issued, whereas in a B2C scenario, a Simplified Tax Invoice is generated.
더 보기:
단계별 프로세스¶
When onboarding to ZATCA (Phase 2), there are three modes:
Sandbox: Common pre-configured testing environment; use it to simulate integration functionality out of the box.
Simulation (Pre-Production): User-specific testing environment; use it to simulate your unique integration.
프로덕션: 가동 환경
샌드박스¶
팁
Use VAT Number 399999999900003 on your company setup for sandbox testing.
- 데이터베이스 설정Go to and, in the Saudi Arabia Electronic Invoicing section, ensure the ZATCA API mode is set to Sandbox.
- 회사 정보 확인회사 정보가 모두 입력되어 있는지 확인하세요.
판매 전표 등록
로 이동합니다.
판매 전표를 엽니다.
ZATCA 탭에서 온보딩 을 클릭합니다.
In the Enter the OTP window, the 6-digit OTP is pre-populated. Click Confirm.
청구서 테스트
Once the invoice is confirmed, a blue banner appears; click Process now.
Ensure the response from the API is Action Successful. If not, review the API response displayed in the chatter and take the appropriate actions.
시뮬레이션 (프로덕션 사전 환경)¶
데이터베이스 설정
운영/프로덕션 데이터베이스를 복제합니다.
Go to and, in the Saudi Arabia Electronic Invoicing section, ensure the ZATCA API mode is set to Simulation (Pre-Production).
- 회사 정보 확인회사 정보가 모두 입력되어 있는지 확인하세요.
판매 전표 등록
로 이동합니다.
판매 전표를 엽니다.
ZATCA 탭에서 온보딩 을 클릭합니다.
In the Enter the OTP window, enter the 6-digit OTP retrieved from the Fatoora Simulation Portal under the Testing Environment. Then click Confirm.
청구서 테스트
Once the invoice is confirmed, a blue banner appears; click Process now.
Ensure the response from the API is Action Successful. If not, review the API response displayed in the chatter and take the appropriate actions.
참고
:guilabel:`시뮬레이션 (사전 프로덕션)`모드의 청구서는 법적으로 유효하지 않습니다.
프로덕션¶
- 운영/프로덕션 데이터베이스Go to and, in the Saudi Arabia Electronic Invoicing section, ensure the ZATCA API mode is set to Production.
- 회사 정보 확인회사 정보가 모두 입력되어 있는지 확인하세요.
판매 전표 등록
로 이동합니다.
판매 전표를 엽니다.
ZATCA 탭에서 온보딩 을 클릭합니다.
In the Enter the OTP window, enter the 6-digit OTP retrieved from the Fatoora Portal under the Production Environment. Then click Confirm.
청구서 동기화
Once the invoice is confirmed, a blue banner appears; click Process now.
Ensure the response from the API is Action Successful. If not, review the API response displayed in the chatter and take the appropriate actions.
참고
판매 전표는 반드시 각 전표별로 온보딩 작업을 해야 합니다.
If a sales journal is no longer needed as a ZATCA solution unit, make sure to revoke it in your Fatoora portal. To do so, click View List of Solutions And Devices, select the relevant solution and device under Revoke CSID, then click Revoke and Confirm.
경고
Once the API mode is switched to Production and an invoice is submitted to ZATCA, it cannot be changed back to Sandbox or Simulation (Pre-Production).
OTP’s generated from either the Fatoora Simulation or Production portal expire after 60 minutes and need to be regenerated.
청구서를 ZATCA에 제출하기¶
After submitting the invoice to ZATCA, a structured response message is returned by the API in the chatter.
Example
[202] BR-KSA-F-13 : [BR-KSA-F-13] - Please recheck Other Seller/Buyer ID (BT-29 or BT-46) as it contains an invalid value.
수신 가능한 일반 코드:
코드 |
활동 |
|---|---|
200 – 작업 성공 |
추가 조치할 사항이 없습니다. |
202 – 작업 성공 (경고 포함) |
|
303 – 승인 해제 |
Submit the invoice through the reporting flow instead of clearance. |
400 – 작업 실패 (거부) |
Review the detailed error message, correct the issue, and resubmit. |
401 – 권한 없음 |
|
413 – 페이로드 크기가 너무 큼 (청구서 수신 실패) |
청구서 페이로드 크기를 줄인 후 재전송합니다. |
429 – 요청이 너무 많음 (청구서 수신 실패) |
청구서를 다시 전송합니다. |
500 – 내부 서버 오류 (청구서 수신 실패) |
청구서를 다시 전송합니다. |
503 – 서비스 불가 (청구서 수신 실패) |
청구서를 다시 전송합니다. |
504 – 요청 시간 초과 (청구서 수신 실패) |
청구서를 다시 전송합니다. |
The color of the message displayed in the chatter after an invoice is confirmed and submitted indicates the following information:
Green: invoice successfully accepted - The invoice is fully compliant and has been successfully validated by ZATCA.
Yellow: invoice accepted with warnings - The invoice is legally valid but was accepted with a warning. The issue should be reviewed and corrected for future submissions.
Red: invoice was rejected - The invoice was not accepted by ZATCA and is not legally valid. It must be corrected and resubmitted.
If the invoice is rejected, an error message is displayed in the invoice’s chatter. Correct the underlying issue described in the message description in the invoice or company settings. Then, to resubmit the invoice, click Retry.
중요
Invoices rejected by ZATCA remain in a Rejected state and are not considered legally valid.
In case of any incidents, technical errors, or emergency matters that prevent the generation of e-invoices/e-receipts, notify ZATCA. Once the issue has been resolved, contact ZATCA again using the same communication channel. For specific failure scenarios, refer to the steps outlined in ZATCA’s guidelines (page 45).
QR 코드 승인¶
To verify the QR Code on the invoice, scan it using the official ZATCA app.
Once in the app, click Services. In the E-Invoice Validation section, click Start Service. Then, begin scanning the invoices’ QR codes.
참고
The QR verification output does not display a currency symbol. The invoice amount is always shown as a plain numeric value, irrespective of the currency used.
An invoice with a related contact (e.g., Invoicing Address) is sent to the clearance API (B2B).
대변표 및 신용전표¶
To create a credit or debit note, include a ZATCA-approved reason from the ZATCA Reason field in the Credit/Debit window, as required by ZATCA regulations:
Cancellation or suspension of the supplies after their occurrence, either wholly or partially.
Essential change or amendment in the supply that results in a change to the VAT due.
Amendment of the supply value that was pre-agreed between the supplier and the consumer.
상품 또는 서비스를 환불합니다.
판매자 또는 구매자 정보를 변경합니다.
팁
The ZATCA Reason field is also available in the credit/debit note Other Info tab.
참고
Whenever the credit/debit note is unrelated/independent, fill in the sequential number of the original invoice(s) that the credit/debit note is related to in the Customer Reference field.
계약금 (선지급금)¶
Handle down payments (advance payments) in compliance with ZATCA’s guidelines.
보유율¶
Retention is an amount temporarily held by the customer, defined by the commercial contract, to ensure the quality and completion of the work. It is usually a percentage of the invoice value (e.g., 5-10%) and serves as security against future defects; it is ultimately paid back to the contractor once the warranty period expires.
For ZATCA, the commonly applied rule is that VAT is calculated based on the full invoice amount, even if the customer withholds a portion as retention. ZATCA advises taxpayers to first determine the tax position, specifically whether the retention amount reduces the taxable amount or not. Tax position depends on contractual terms.
The Odoo retention workflow ensures, through tax position, that the retention amount does not reduce the taxable amount.
참고
보류세 여부 확인란에 체크를 해 두면 세금을 음수로 설정하더라도(예: -20%) UBL 2.1에 영향이 없습니다. 보류세는 일반 세금(예: 15%)과 함께 청구서 항목에 적용이 되는 경우에만 의미가 있으며, 해당 청구서 항목에 대한 백분율을 나타냅니다. 예를 들어, 납세자가 청구 금액의 20%를 보류하려는 경우 15% 세금과 -20% 보류세가 모두 청구서 항목에 적용됩니다.
Within this same tax position, retention can also be applied at the invoice level as an separate negative invoice line using a 0% (Not Subject to VAT) tax rate.
경고
Adding either a negative tax with Is Retention enabled and a generic tax on the invoice line, or a separate negative invoice line with a 0% (Not Subject to VAT) tax rate at the invoice level, usually indicates that VAT has been paid on the full taxable amount. Therefore, the final invoice for releasing the retention amount does not qualify as a Tax Invoice and should not be submitted to ZATCA.
The 0% (Not Subject to VAT) tax is already preconfigured according to ZATCA rules; do not modify it.
중요
When creating a new retention tax, create a Retention tax group and assign it to this newly created retention tax to comply with ZATCA rules.
To add the Retention Amount as a note on the invoice line, click Add a note to comply with ZATCA rules. For example - Retention Amount:
[retention amount] SAR
생성된 문서¶
Once an invoice is submitted, a UBL 2.1 XML file is generated and sent to ZATCA API endpoints. For auditability, this XML file is stored in the chatter. To display it, click the (attachments) icon.
Additionally, the invoice PDF generated when using Send is displayed in the chatter. Both the XML and PDF files are permanently attached to the invoice and cannot be deleted to ensure compliance with ZATCA regulations.
중요
Successfully ZATCA-submitted invoices can only be reset to draft in Sandbox or Simulation (Pre-Production) modes.
팁
To automatically generate a PDF/A-3 with the embedded UBL 2.1, click Send.
POS¶
ZATCA 통합 환경설정¶
참고
Make sure the Saudi Arabia - E-invoicing (Simplified) (l10n_sa_edi_pos) module is installed.
PoS orders must be properly reported in compliance with ZATCA Phase 2. To do so, follow these steps:
Onboard the Invoices default journal in the PoS settings:
Go to . In the yellow banner, select the relevant Point of Sale, then navigate to the Accounting section.
In the Default Journals section, find the Invoices field and click the (right arrow) to open the default Sales journal.
ZATCA 탭에서 온보딩 을 클릭합니다.
In the Enter the OTP window, enter the 6-digit OTP retrieved from the Fatoora Portal under the Production Environment. Then click Confirm.
Assign a customer to the order before finalizing the transaction.
These steps ensure that each receipt is processed as a compliant e-invoice and reported to the ZATCA portal in real time. Once the receipt is generated, the Phase 2 QR code automatically appears on both the printed receipt and the PDF.