Avalara E-Invoicing and Live Reporting (ELR) helps you automate compliance with global e-invoicing and real-time reporting mandates. Use a single API to handle country-specific formats, validations, and submission requirements.

Core capabilities

Manage e-invoicing and live reporting across countries through a single API.

Centralized global compliance

Handle local invoice formats, digital signatures, clearance models, and real-time reporting requirements.

Support for country-specific formats and mandates

Connect to ERP and billing systems using prebuilt connectors or REST APIs.

Prebuilt ERP and billing integrations

Add new countries without rebuilding integrations using configuration and a centralized dashboard.

Single integration, multi-country coverage

Access API documentation, integration guides, and environment setup in the developer portal. E-invoicing services are provisioned through standard onboarding to configure the correct mandates and connectivity.

Getting started

Avalara ELR integrates with ERP, accounting, ecommerce, and billing systems to exchange invoice data across your transaction workflows. Use APIs or prebuilt connectors to send data to tax authority platforms and e-invoice networks such as PEPPOL or national government platforms.

How it integrates

What Avalara E-Invoicing and Live Reporting solves

When to use Avalara E-Invoicing and Live Reporting

Avalara E-Invoicing and Live Reporting

API reference

This guide describes the steps you should follow to integrate Avalara E-Invoicing and Live Reporting into your platform.

E-Invoicing and Live Reporting

Directives for caching mechanisms in requests and responses

Controls resources the user agent is allowed to load for a given page

Controls the amount of referrer information sent with requests

Defines the permitted cross-domain policies

X-Avalara-Client

The version of the API to use, e.g., "1.6".

avalara-version

Whether to include the total count of records in the result.

count

Whether to return only the count of records, without the list of records.

countOnly

The number of items to skip in the result.

$skip

The number of items to include in the result.

$top

Document types for which this field is applicable for

Returns an HTTP status code and message for a 'bad request'

The three-digit HTTP error code for the bad request

Represents detailed error information for an individual entry in a batch request. Includes the index of the failed item and associated validation errors.

The index of the request that caused the error in the batch.

Represents a single batch search operation

BadInput

Timestamp when the batch search was created

Email of the user who created the batch search

Response schema for listing batch search details.

Count of code lists for the given query parameters

Array of code lists matching query parameters

Returns a code list definition for a specific country

Code list of document type identifiers for France, based on UN/CEFACT document type codes, with national (local) extensions where applicable.

System-generated unique identifier of the code list definition. Typically a UUID used to reference this code list internally or via APIs.

Human-readable name of the code list, usually describing what the codes represent (for example, document types, tax categories, currencies).

Two-letter ISO 3166-1 alpha-2 country code indicating the jurisdiction this code list applies to.

Textual description of the code list, including what it is used for and whether it represents a global standard (e.g., UN/CEFACT, ISO, EN16931) or a jurisdiction-specific/local extension of that standard.

Identifier of the underlying standard or authoritative source for this code list. This may be a formal code list name (e.g., UNCL1001), a standard reference (e.g., EN16931), or an internal standard identifier.

Array of versioned definitions of this code list for the given jurisdiction. Each entry represents a version that is valid for a specific effective/sunset date range, optionally per locale.

Displays a summary of information about a code list

Represents a single code entry in a code list version

The actual code value used in documents or systems. This is typically what appears in the e-invoice payload, such as a numeric or alphanumeric code from the official code list.

Detailed explanation of what the code represents, localized according to the locale field of the version.

Human-readable label or name for the code, localized according to the locale field of the version.

Represents a versioned definition of a code list for a specific jurisdiction and date range

Date from which this version of the code list becomes legally or operationally effective in the jurisdiction. Typically corresponds to a go-live, mandate, or release date.

Date after which this version of the code list must no longer be used in the jurisdiction. Use a far-future date (e.g., 9999-12-31) when the sunset is not yet known.

Array of code entries defined in this version of the code list. Each entry contains the machine-readable code value and its human-readable description in the given locale.

List of free-text reasons explaining why this version of the code list exists (for example, initial introduction, regulatory update, addition/deprecation of codes). Useful for audit and change tracking.

Common document attributes shared across all country mandates.

The buyer's reference identifier for the document.

The order reference identifier associated with the document.

The reference identifier of the originating document.

The email address of the document receiver.

The email address of the document sender.

Mandates for which this field is conditional

Array of scenarios which describe when a particular field is conditional for a country mandate

Indicates whether the trading partner consents to being listed in the directory. If not provided in the payload, its value will default to true.

Specification identifier: An identification of the specification containing the total set of rules regarding semantic content, cardinalities and business rules to which the data contained in the instance document conforms.

An object representing the acceptable values for this field

Array of CountryMandate names for which this field is not used.

Array of CountryMandate names for which this field is optional.

Array of CountryMandate names for which this field is required.

Count of collections for the given date range

Array of documents matching query parameters

Describes a document media type associated with a document by its direction (`context`) and `mediaType`.

Direction of the document media type relative to the document. `INPUT` is a payload supplied by the caller (e.g. the original UBL submission); `OUTPUT` is a payload generated by the platform or tax authority (e.g. a clearance XML or human-readable PDF).

Media type of the document, suitable for use as the `Accept` header when downloading via `GET /documents/{documentId}/$download`. May be a standard type (e.g. `application/pdf`) or an Avalara-defined custom type.

Returns the current document ID and status

Real-time list of the submitted and generated artefacts that are currently available for this business document. Anything listed here is downloadable via `GET /documents/{documentId}/$download`. **Returned only when `availableMediaTypes` is requested via the `$include` query parameter.**

Represents the document's business lifecycle state based on responses from external actors (Tax Authority, PDP, or ERP), such as acceptance, rejection, or validation.

The date and time when a new media type/artefact was most recently added to this document, displayed in ISO 8601 format with timezone. Compare against a previously stored value to detect newly available downloadable content without diffing `availableMediaTypes` yourself.

Array of reports associated with this document. Returns an empty array when no reports are present.

Document status. See the `supportedDocumentStatuses` field in the GET /mandates response for full status definitions.

Returns an HTTP status code and message for an 'exception'

The three-digit HTTP status code for the exception

Returns the unique ID of a successful document submission

Unique ID for this document that can be used for status checking and file downloads. This is a UID created by the Avalara E-Invoicing platform.

Displays a summary of information about the document

Country-specific document attributes returned alongside the standard document summary. The shape of this object varies by country mandate. Each attribute within this object is individually searchable using `$filter` with dot notation (for example, `$filter=additionalDocAttributes.incarcare eq 'UP1312321'`).

Unique identifier that represents the company within the system.

The two-letter ISO-3166 country code for the country where the document is being submitted

The e-invoicing mandate for the specified country

The date and time when the document was created in the system, displayed in ISO 8601 format with timezone

The name of the customer in the transaction

Array of status events associated with this document. Events are included in each document in the response only when the query parameter $include=events is passed; otherwise the events array is not populated.

The document direction, where issued = `out` and received = `in`

The date and time when a new media type/artefact was most recently added to this document, displayed in ISO 8601 format with timezone. Unlike `lastUpdatedAt`, this only changes when a new media type becomes available - not on every document update - making it suitable as a polling cursor to detect new downloadable content.

The date and time when the document was last updated in the system, displayed in ISO 8601 format with timezone

The date and time when the document was processed, displayed in the format YYYY-MM-DDThh:mm:ss

The document recipient based on the interface

The name of the supplier in the transaction

Array of string values associated with the custom attribute.

Returns an optional message with a 'forbidden' response

A message that informs the user that they may not access a resource

The algorithm used to create the signature.

Unique identifier of this specific resource.

Optional array used to carry additional metadata or configuration values for the identifier.

Identifier name (e.g., Peppol Participant ID).

Returns an optional message with a 'InternalServerError' response

A message explaining the bad request error

Additional document attributes specific to the Italian e-invoicing mandate (SdI).

The unique identifier assigned by the Italian Sistema di Interscambio (SdI) upon successful receipt of the document.

The mandate supporting B2G eInvoicing in Australia. This function will create a Peppol BIS 3.0 file and sends the invoice to the related recipient via the Peppol network

**[LEGACY]** This field is retained for backward compatibility. It is recommended to use `mandateId` instead.
The `countryMandate` similar to the `mandateId` is comprised of the country code, mandate type, and the network or regulation type (for example, AU-B2G-PEPPOL). 

The type of e-invoicing flow for this mandate

Link to the documentation for this mandate's e-invoicing flow

List of available media types for downloading invoices for this mandate

Format and version used when inputting the data

The `mandateId` is comprised of the country code, mandate type, and the network or regulation type (for example, AU-B2G-PEPPOL). Keep in mind the following when specifying a `mandateId`.
- A country can have multiple mandate types (B2C, B2B, B2G).
- A entity/company can opt in for multiple mandates.
- A `mandateId` is the combination of country + mandate type + network/regulation.

Lists the supported output document formats for the country mandate. For countries where specifying an output document format is required (e.g., France), this array will contain the applicable formats. For other countries where output format selection is not necessary, the array will be empty.

Indicates whether this mandate supported by the ELR API

List of document statuses defined by the mandate.

Indicates whether this mandate supports inbound digital documents

An Array representing the acceptable values for this field

Represents the number of times an element can appear within the document

Determines if the field if Required/Conditional/Optional or not required.

No sinature configuration properties are required when the no signature is used.

No properties are required when the no signature is included.

Returns an HTTP error code and message for a 'not found' error

The three-digit HTTP error code for a not found error

Mandates for which this field is not used

Mandates for which this field is optional

Format and version used when outputting the data

The total count of records in the dataset.

Additional document attributes specific to the Polish e-invoicing mandate (KSeF).

The KSeF reference number assigned by the Polish National e-Invoice System upon successful registration.

Represents a report associated with a document

Represents a single error returned by the tax authority for a rejected document.

The detailed error message, as returned by the tax authority.

The reason code and description for the error, as returned by the tax authority.

Represents a single document included in a report.

The report code assigned to the report this document belongs to. Corresponds to `reportCode` in the `Report` and `ReportItem` schemas.

The e-invoicing mandate for the specified country.

Array of errors returned by the tax authority for this document. Populated only when the tax authority rejected this document; otherwise empty.

The index position of this document in the full/final report.

The index position of this document in the original input report.

Returns the requested list of documents associated with a report.

URL to retrieve the next page of results when more items match the query. Omitted or null when there is no next page.

Count of documents matching the filter for the given query. Present when the request includes $count=true.

Array of documents associated with the report, matching the query parameters.

Returns a pre-signed URL to download the report file.

A pre-signed URL to download the report file. This URL is time-limited.

Represents a single event in the lifecycle history of a report.

The date and time when the event occurred.

The receiver associated with this event, if applicable.

The type of number or acknowledgement returned by the tax authority (if applicable).

The corresponding value associated with the response key.

The sender associated with this event, if applicable.

Represents a single report with full details including metadata and associated transaction IDs.

The name of the tax authority for this report. Replaces the deprecated `taName` field.

Represents the report's status as reported by external actors (Tax Authority), such as acceptance, rejection, or validation.

The two-letter ISO-3166 country code for which this report was generated.

The e-invoicing mandates associated with this report, when more than one mandate applies.

**Deprecated.** Not reliable; always returned as null. The sub-type of the document.

**Deprecated.** Not reliable; always returned as null. The type of document covered by this report.

**Deprecated.** Not reliable; always returned as null. The unique ID of the job that generated this report.

The date and time when a media type (file) was last added to this report.

The date and time when this report was last updated.

**Deprecated.** Not reliable; always returned as null. The MIME type of the report file.

The date and time when the report was generated.

**Deprecated.** Not reliable; always returned as null. An internal reference path for the report.

The current status of the report. Possible values include: PENDING, PROCESSING, COMPLETED, FAILED, SENT_TO_PPF, ERROR.

**Deprecated.** Not reliable; always returned as null. The name of the tax authority for this report. Use `authorityName` instead.

**Deprecated.** Not reliable; always returned as null. The total invoice amount covered by this report.

The tenant identifier associated with this report.

**Deprecated.** Not reliable; always returned as null. The total tax amount covered by this report.

**Deprecated.** Not reliable; always returned as null. List of transaction IDs associated with this report. Use `GET /reports/{reportId}/documents` to track the documents included in a specific report.

Returns the requested list of reports matching the query parameters.

Count of reports matching the filter for the given query. Present when the request includes $count=true.

Array of reports matching the query parameters.

Describes a report media type associated with a report by its direction (`context`) and `mediaType`.

Direction of the report media type relative to the report. `INPUT` is a payload supplied to the platform (e.g. by the tax authority); `OUTPUT` is a payload generated by the platform (e.g. the submitted report).

Media type of the report artefact, suitable for use as the `Accept` header when downloading the artefact. May be a standard type or an Avalara-defined custom type.

Represents a single report with full details, including its lifecycle event history.

Additional document attributes specific to the Romanian e-invoicing mandate.

Download identifier assigned by the Romanian tax authority (ANAF) for retrieving the processed document.

Upload identifier assigned by the Romanian tax authority (ANAF) upon successful submission.

The date and time when the status event occurred, displayed in the format YYYY-MM-DDThh:mm:ss

 The type of number or acknowledgement returned by the tax authority (if applicable). For example, it could be an identification key, acknowledgement code, or any other relevant identifier.

The corresponding value associated with the response key. This value is provided by the tax authority in response to the event.

The document to be submitted, as indicated by the metadata fields 'dataFormat' and 'dataFormatVersion'

Basic webhook configuration without signature

The URL of the webhook endpoint to which event messages will be delivered

Unique identifier for the new or updated entity.

Avalara E-Invoicing and Live Reporting

DocumentStatusResponse