Where to find the dev requirements to integrate?

General
1

do the three pdfs at the zatca portal include all the requirements and everything you need to know to integrate with zatca phase 1 and 2?

i looked everywhere but all i found was scattered info here and there, nothing official that states “this is all you need to know to get started until you comply successfully”

here’s the portal link i am talking about:

https://zatca.gov.sa/ar/E-Invoicing/SystemsDevelopers/Pages/TechnicalRequirementsSpec.aspx

2

Dear @ahmad2,

the documents are comprehensive and designed to complement each other, please refer to the educational library section, please note that there are some other documents for XML implementation and security standards.

Educational library

For the practical steps of the integraion part, we highly recommend to watch the published integration video steps

https://www.youtube.com/watch?v=IugzfwPlAgo&t=3127s&ab_channel=هيئةالزكاةوالضريبةوالجمارك

Regards,

3

I am not a taxpayer so i can’t benefit really from the educational library which was designed for taxpayers, and the practical video only showed some testing with postman which any developer can do, I am trying to build a system here and i am realizing that some information is missing, for example please explain the following:

in the xml implementation standards pdf:

in BT-114 there was no explanation on what does the rounding amount refer to, if you think of it as self explanatory then you would think they’re talking about how much is being rounded but when you check the invoice sample provided in the sdk you will see the following:

<cbc:LineExtensionAmount currencyID="SAR">4.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="SAR">4.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="SAR">4.60</cbc:TaxInclusiveAmount>
<cbc:AllowanceTotalAmount currencyID="SAR">0.00</cbc:AllowanceTotalAmount>
<cbc:PrepaidAmount currencyID="SAR">0.00</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="SAR">4.60</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="PCE">2.000000</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="SAR">4.00</cbc:LineExtensionAmount>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="SAR">0.60</cbc:TaxAmount>
<cbc:RoundingAmount currencyID="SAR">4.60</cbc:RoundingAmount>
</cac:TaxTotal>
<cac:Item>
<cbc:Name>قلم رصاص</cbc:Name>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="SAR">2.00</cbc:PriceAmount>
<cac:AllowanceCharge>
<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
<cbc:AllowanceChargeReason>discount</cbc:AllowanceChargeReason>
<cbc:Amount currencyID="SAR">0.00</cbc:Amount>
</cac:AllowanceCharge>
</cac:Price>
</cac:InvoiceLine>```

the math is not adding up to me, could you please clarify to me a little bit? thank you.
4

@ahmad2
Please note that there are two tags with different usage:

Line Amount Inclusive of VAT (KSA-12) is cac:InvoiceLine / cac:TaxTotal / cbc:RoundingAmount

Rounding amount (BT-114) is cac:LegalMonetaryTotal/cbc:PayableRoundingAmount

In SDK sample referred above, there is no BT-114 rounding amount. Amount you see under tag <cac:InvoiceLine / cac:TaxTotal / cbc:RoundingAmount> represents Line Amount Incl VAT (KSA-12).

Hope this clarifies.

1 Like