Configration

Enable UAE E-Invoicing

Navigate to:
Company → UAE E-Invoicing Section

Enable the option:
☑ UAE E-Invoice Enabled

⚠️ Note: Invoices will be submitted to FTA only when this option is enabled.

Configure API Credentials

Enter the required details:

• Base URL
  Example: https://sb-ae-api.flick.network
• Participant ID
  Unique identifier assigned to your business
• X-Flick-Auth-Key
  Secret key used for API authentication

Verify Token

Click: Verify Token
If successful, you will receive a response like:

This confirms:

• Credentials are valid
• System is successfully connected to Flick

Generate OAuth2 Access Token

Using:

• Client ID
• Client Secret

The system generates an Access Token, which is required for:

• Invoice submission
• API communication

The token is automatically stored and reused until it expires.

Fetch Participant Details

Click: Get Participant Details
This retrieves:

• Business identifiers (e.g., VAT/TRN)
• Contact details
• Registration information

Invoice Submission Flow

Once the setup is complete, the process becomes fully automated:

1. User creates a Sales Invoice in ERPNext
2. System checks if:
   UAE E-Invoice Enabled = ON
3. System automatically:
• Generates invoice payload (structured format)
• Determines authentication method:
• Uses X-Flick-Auth-Key for direct authentication
• Otherwise → OAuth2 is configured → Authenticates using Access Token
• Submits invoice to Flick API using the selected authentication methodFlick forwards the invoice to FTA
4. Response is received and stored in ERPNext

UAE Integration Fields

• Invoice out of scope of tax
  → Marks the invoice as not subject to VAT under UAE regulations.
• Credit note related to goods or services (out of scope)
  → Indicates a credit note for transactions that are not subject to VAT.
• VAT Category
  → Defines the VAT classification applied to the invoice (e.g., standard, zero-rated, exempt).
• Frequency Billing Code List
  → Specifies the billing frequency type (e.g., daily, weekly).
• Invoice Note
  → Provides additional information or description related to the invoice.
• Payment Means Codes
  → Indicates the method of payment used (e.g., cash, bank transfer, etc.).
• Is Return (Credit Note)
  → Enable this before submitting the invoice to process it as a credit note for a return or adjustment against a previous invoice.

Status Fields

• UAE E-Invoice Status
  → Shows the submission status of the invoice in the UAE e-invoicing system.
• Reporting Status
  → Indicates whether the invoice has been successfully reported to the authority.