Documentation
Platform OverviewDemoContactImprint

E-Invoicing Provider Avalara

With Avalara ELR (E-Invoicing & Live Reporting), you can automate the compliant, real-time transmission of invoice documents to tax authorities or e-invoicing networks – directly from the Nitrobox platform.

Suggest Edits

What is Avalara ELR?

Avalara ELR is an API-based solution that supports global e-invoicing requirements. It handles validation, formatting, and submission of invoice data to systems such as:
• Tax authorities (e.g., Italy, Spain)
• E-invoicing networks (e.g., Peppol, KSeF)
• Real-time reporting platforms (e.g., Hungary, Romania)

Country-specific formats like UBL 2.1, FatturaPA, XRechnung, or local CTC variants are automatically applied by Avalara.

Requirements

To use Avalara ELR, you need:
• An active Avalara ELR account
• Your Client ID and Client Secret
• A configured tenant in Nitrobox

Contract Options

To use Avalara ELR, there are two options:

  1. Direct contract with Avalara:
    You can sign a contract directly with Avalara. Nitrobox is an official Avalara Technology Partner, and we have implemented full support for the Avalara ELR interface. After completing your contract setup with Avalara, you can enter your Client ID and Secret in Nitrobox to activate the service.
  2. Contract via Nitrobox (NBX E-Invoicing provided by Avalara)
    Alternatively, you can use Avalara ELR through Nitrobox as part of our NBX E-Invoicing offering. In this case, Nitrobox handles the contract and technical provisioning on your behalf.
    → Please contact your Nitrobox Professional Services representative for more details and activation.

Configuration in Avalara ELR Webportal

  1. Create a company

    As an administrator, you can create subsidiary companies for other countries or based on your business needs.
    1. Go to the E-Invoicing and Live Reporting home page and select Settings > Companies. The Companies page appears.
    2. Select Add a company. The company details page appears.
    3. Enter your company details, such as the company name and primary business address.
      If your company is in Saudi Arabia (PDF A/3), Germany (ZUGFeRD), or France (FACTUR-X), upload the company logo in the Company logo section using the Choose file option. Select the Effective date for the logo. This logo is used until the effective date that you select. Select Next. The Compliance contact page appears.
    4. Enter your compliance contact details and select Save.

  2. Add mandates

    When you create a new company, you need to add mandates to the company based on your business requirements.
    1. Go to the E-Invoicing and Live Reporting Home and select E-Invoicing > Activations. The E-Invoicing tasks page appears.
    2. Select Add/edit mandates from the Company Profiles section. The E-Invoicing and Live Reporting selections page appears.
    3. Search for your company or locate the panel for the company you want to add mandates to. Expand the panel, choose the activations you want, and select Add. A review panel appears with your selection. Select Edit to update your selections.
    4. When you've completed your selections, select Save and Complete.
    5. For each activation you selected, a task is updated in the E-Invoicing tasks page. Complete the activation process for each mandate that you selected.

  3. Complete activation task

    Understand the steps to complete activation for mandates based on country-specific requirements.
    After you add a mandate for your company, complete activation for the mandates. Document requirements and activation processes vary by country and depend on mandates set by the network or tax authorities.
    1. Complete activations for Peppol
      1. From E-Invoicing and Live Reporting Home, go to the Activation tasks tab in the Tasks section. Locate and select Complete activation for Peppol for your company. The Complete Activation panel appears.
      2. In the Provide information tab:
        1. If you already have a Peppol ID:
          1. Choose I already have a Peppol ID. Enter your Peppol ID, confirm you’re not associated with another Peppol provider, and select a country from the Country list.
          2. Select Next. The Review tab appears.
        2. If you don’t have a Peppol ID, update your business information in the respective fields, and select Next. The Review tab appears.
      3. In the Review tab, confirm that your activation is in progress. When activation is complete, the Activation Complete tab appears. Your Peppol number is displayed here, and you’ll receive an email with your Peppol activation number.
        Note It may take a few minutes to review and update the Peppol activation number.
      4. On the E-Invoicing tasks page, check for status changes or notifications. If additional information is required, a message appears in the Complete activation for Peppol section, and our team will contact you.
    2. Complete activations for countries not part of Peppol network: Here you can find detailed and comprehensive guides for each supported country.

Configuration in Nitrobox

  1. Authentication

    Implement ELR authentication via Avalara’s supported methods before invoking ELR APIs

  2. Configuration

    • Add Avalara ELR under Integration → E‑Invoicing Provider → Avalara ELR

    • Provide Client ID, Client Secret



    • Enable Avalara ELR

    • Enable Client Side Logging for API logs include request/response payloads







  1. Mandate & Mapping Setup

    Before invoice provisioning, you need to create a Mandate Mapping:

    1. Navigate to Integration -> E-Invoicing Provider -> Avalara ELR

    2. To define a mandate mapping, click the + icon in the “Avalara ELR Company and Mandate Mapping” section and fill in the following fields:


    3. Ident: Enter any unique identifier for this mapping. It is used internally only.

    4. Company: Select the company that corresponds to your Avalara ELR account. (This must be configured in the Avalara ELR web portal.

    5. Invoice address country: Select the destination country of the invoice. This is used to determine the applicable mandate.

    6. Mandate Ident: Based on the selected country, available mandates (e.g., RO-B2C-PEPPOL, RO-B2B-PEPPOL) will be listed. Choose the one relevant for your use case.

    7. Validation document Ident: The document number entered here will be used during saving to verify the JSONata mapping. The document number must exist in this environment, and the corresponding document should be relevant to this e-invoicing case.

    8. JSONata mapping: Enter the transformation logic that maps Nitrobox invoice data to the required e-invoicing schema. This field must contain valid JSON structure and JSONata expressions.
      JSONata mapping:

    The JSONata mapping defines how Nitrobox data is transformed into the required e-invoicing format (e.g., UBL, FatturaPA) expected by Avalara.
    This mapping translates internal Nitrobox fields into the target format structure using JSONata – a lightweight query and transformation language for JSON.
    In the mapping, placeholders like ident, documentDate, items[].prices.total.net or customerDetail.invoiceAddress.vatId refer to fields in the Nitrobox data model. Conditional logic (e.g., $boolean(...), $mapQuantityType(...)) allows for dynamic generation depending on invoice contents.

  2. Document Provisioning Setup

    Once the mandate mapping is created, define the Document Provision Settings to determine under which conditions e-invoicing will be generated:

    1. Navigate to Configuration -> Billing -> Document Provisioning

    2. Create or edit a provisiong rule

      1. Define document conditions (e.g. Billing Group, Document Type, Customer Type, etc.)
      2. Set the Document Provision Method to Avalara ELR
      3. Assign the corresponding Avalara Mandate Mapping

Invoice Submission Workflow

If Avalara ELR is activated, invoices are processed as follows:

  1. The invoice is created as usual in Nitrobox.
  2. If Avalare ELR is enabled, the document is automatically:
    1. validated
    2. transformed into the correct format
    3. submitted to Avalara
  3. Avalara handles transmission to the appropriate target platform.
  4. The transmission status is returned and shown in Nitrobox.

Transmission Status & Logs

In the E-Invoicing Provider -> Workflows for each invoice, you can view:

  • the transmission protocol
  • the technical status (Pending, Success, Failed)
  • any error messages (e.g., XML validation issues)

If you have enabled API logging, you’ll also see:

  • full request/response payloads
  • timestamps and target systems
  • plain text messages from Avalara

Additional Resources

Note

Avalara ELR is designed to support complex regulatory e-invoicing requirements. Please speak to your Nitrobox contact before activating the service to ensure all country-specific rules are correctly configured.

Updated 2 days ago