Egypt uses 2 different IDs for validation purposes. You are required to provide both:

• Tax Registration Number (TRN)
• Unique Identification Number (UIN)

If you only send one of these, the ID will not be validated. You must include both.

Settings

If you cannot provide either, you can use one of the following settings:

• Set all transactions to be treated as B2C.
• Validate only the syntax of the TRN. Treat validated transactions as B2B.

You can make the usual B2B settings as described in the Country Settings topic.

For example, here are the B2B settings for Egypt:

API Integration

Tax Registration Number (TRN)

The Tax Registration Number (TRN) is used to help identify the business for tax purposes in Egypt.

Standalone users can add this to {tax_number} variable in the URL they use for validation for the Validate VAT number request.

Integrated users can use the buyer_tax_number field to add this to their requests, like Store transaction.

Unique Identification Number (UIN)

You also need to provide a Unique Identification Number (UIN) alongside the Egyptian Tax ID, the TRN, to identify the party.

Standalone users can use the additional_id parameter to add this to the URL they use for validation for the Validate VAT number request.

Integrated users can add use the additional_interactions.additional_id element to add this to their requests, like Store transaction.

Examples

Standalone

Standalone users can include the For example, Standalone users can use the following URL. It specifies the TRN in the request's URL:

https://services.taxamo.com/api/v2/tax/vat_numbers/{TRN}/validate?country_code={country-code}&additional_id={UIN}

where:

• {TRN} is the Tax Registration Number (TRN). This is placed in the same way as any other Tax ID.
• {UIN} is the Unique Identification Number (UIN). It is specified in the additional_id parameter.
• {country-code} is the country code. EGY for Egypt.

For example:

https://services.taxamo.com/api/v2/tax/vat_numbers/{TRN}/validate?country_code=EGY&additional_id=12345678912345678912345678912345678912

Integrated

Users of the integrated version of Vertex Validator can use the additional_interactions element to add the UIN:

"additional_interactions": [{"interaction_key": "egypt-b2b-UIN",
                             "additional_id":    "{UIN}"}

where {UIN} is the UIN. The interaction_key element is always "egypt-b2b-UIN".

For example:

"additional_interactions": [{"interaction_key": "egypt-b2b-UIN",
                             "additional_id":    "12345678912345678912345678912345678912"}