AvalaraAvalaraDeveloperDeveloper
  • Productsdown arrow
      Calculations
      AvaTax
      AvaTax Brazil
      AvaTax for Communications
      AvaTax for Excise
      Avalara Tax Content
      E-invoicing
      Activation Service
      Avalara E-Invoicing and Live Reporting
      Brazil
      Brazil Customer Portal
      Tax Compliance (Brazil)
      Tax Central
      Data Staging
      Returns
      Avalara Managed Returns API
      MyLodgeTax
      Avalara Returns Excise
      VAT Reporting
      Shared service
      Shared Services
      1099 & W-9
      Avalara 1099 & W-9
      Tax registrations and business licenses
      Avalara License Guidance
      Sales Tax Registrations
      Payroll tax registrations
      Avalara license filings
      ECM
      Exemption Certificate Management
      Avalara Cross-Border
      Automated Tariff Code Classification
      Self-Serve Tariff Code Classification
      Managed and Premium Tariff Code Classification
      AvaTax Cross-Border (Estimator + Calculator)
      Avalara Trade Compliance
      Avalara Trade and Tariff Library
  • Learndown arrow
      Integrations guides
      Refactor guides
      Get certified
  • Get starteddown arrow
      AvaTax 90 days free trial
      Playground
      Become a partner
      Build with Avalara using AI
  • Developdown arrow
      APIs
      SDKs
      MCPs
      Agent to Agent (A2A)
      AI use cases
      API versioning
  • Resourcesdown arrow
      Avalara NEXT recordings
      Avalara University
      Knowledge Center
  • Support
MENU
Search Icon

No results found for

Profile
  • Sign In
Sign In
Search Icon

No results found for

  • Productsdown arrow
      Calculations
      AvaTax
      AvaTax Brazil
      AvaTax for Communications
      AvaTax for Excise
      Avalara Tax Content
      E-invoicing
      Activation Service
      Avalara E-Invoicing and Live Reporting
      Brazil
      Brazil Customer Portal
      Tax Compliance (Brazil)
      Tax Central
      Data Staging
      Returns
      Avalara Managed Returns API
      MyLodgeTax
      Avalara Returns Excise
      VAT Reporting
      Shared service
      Shared Services
      1099 & W-9
      Avalara 1099 & W-9
      Tax registrations and business licenses
      Avalara License Guidance
      Sales Tax Registrations
      Payroll tax registrations
      Avalara license filings
      ECM
      Exemption Certificate Management
      Avalara Cross-Border
      Automated Tariff Code Classification
      Self-Serve Tariff Code Classification
      Managed and Premium Tariff Code Classification
      AvaTax Cross-Border (Estimator + Calculator)
      Avalara Trade Compliance
      Avalara Trade and Tariff Library
  • Learndown arrow
      Integrations guides
      Refactor guides
      Get certified
  • Get starteddown arrow
      AvaTax 90 days free trial
      Playground
      Become a partner
      Build with Avalara using AI
  • Developdown arrow
      APIs
      SDKs
      MCPs
      Agent to Agent (A2A)
      AI use cases
      API versioning
  • Resourcesdown arrow
      Avalara NEXT recordings
      Avalara University
      Knowledge Center
  • Support
Profile
  • Sign In
Sign In
Sales (877) 282-5585
cardImage
Home
cardImage
Calculation
  • Sales Tax
  • CDIT
  • VAT
  • Use Tax
  • Communications Tax
  • Excise Tax
  • Brazil Services Tax
  • Brazil Goods Tax
  • Tax Content
  • Beverage Alcohol
  • Fees
cardImage
E-Invoice
  • AvaTax Brazil E-Invoice Services
  • AvaTax Brazil E-Invoice Goods
  • Avalara E-Invoicing and Live Reporting
cardImage
Filing
  • Compliance Extractor
  • Brazil Returns
  • Lodging Tax Extractor
  • 1099/W9
cardImage
Utility
  • Address Validation
  • Exemption Certificate Management
  • Provisioning
Requirements for certify calculation for goods transactions
View as markdown

Requirements for certify calculation for goods transactions

Introduction

The connector certification requirements for services calculations are designed so that the end-user

has a simple implementation process.

There are options to obtain certification on sales and purchase transactions.

The partner will need to define if they desire to implement one or both transaction types.

Below are the minimum scenarios necessary for certification.

Premises

The partner can be certified at any time, but will only be considered "Launched" to the market, after two customers in production using the connector.

The partner will be responsible for support customers in production and give the maintenance of the developed connector.

The partner will be responsible for providing training and a guide to support customers.

To present an SLA (Service Level Agreement)plan.

Present a schedule detailing development times, unit tests, and integration tests.

We inform the importance of our partners complying with the rules and determinations of the General Data Protection Law -LGPD (Law No. 13,709), not disclosing or exposing customer data.

Goods Transactions

Sales Transaction

Mandatory Suggested

Scenarios

Transactions

Type

Point of Attention

Suggested

Free Zone Operation

Sales

Goods

Suggested

Statutory Retail Price

Sales

Goods

Suggested

Simplified Entrepreneur Sales

Sales

Goods

Mandatory

Interstate Sale for ICMS Taxpayer

Sales

Goods

Mandatory

Interstate Sale for Non-ICMS Taxpayer

Sales

Goods

Mandatory

Sale Within the State

Sales

Goods

Suggested

Sale for Future Delivery

Sales

Goods

Mandatory

Complementary Sale Invoice

Sales

Goods

Suggested

Export Goods

Sales

Goods

Suggested

Shipping Operations for Fairs or Demos

Shipping

Goods

Suggested

Shipping Operations for Future Delivery

Shipping

Goods

Suggested

Transfers between Headquarter and Branches

Transfer

Goods

Suggested

Total Outbound Goods Return

Goods Return

Goods

  • Reference item ID
  • Reference document ID

Suggested

Partial Outbound Goods Returns

Goods Return

Goods

  • Reference item ID
  • Decision point: If this is a supplier perspective or if this is an about accounting

Purchase Transactions

Mandatory Suggested

Scenarios

Transactions

Type

Point of Attention

Suggested

Shipping Operations for Future Delivery

Shipping

Goods

Suggested

Shipping Operations for Fairs or Demos

Shipping

Goods

Suggested

Partial Inbound Goods Returns

Goods Return

Goods

  • Reference item ID
  • Decision point: If this is a supplier perspective or if this is an about accounting

Suggested

Total Outbound Goods Return

Goods Return

Goods

  • Reference item ID
  • Reference document ID

Suggested

Simplified Entrepreneur Purchase

Purchase

Goods

Mandatory

Interstate Purchase

Purchase

Goods

Mandatory

Purchase Within the State

Purchase

Goods

Mandatory

Transport Purchase

Purchase

Goods

Suggested

Import Goods

Purchase

Goods

Minimum Taxes

Connectors needing certification will need to be able to prepare to receive and process the list of taxes below:
  • PIS
  • PIS-ST
  • PIS-DESON
  • COFINS
  • COFINS-ST
  • COFINS-DESON
  • ICMS
  • ICMS-FCP
  • ICMS-ST
  • ICMS-ST-FCP
  • ICMS-ST-SD
  • ICMS-ST-SD-FCP
  • ICMS-OWN-PAYER
  • ICMS-EFF
  • ICMS-PART-PAYER
  • ICMS-PART-DEST
  • ICMS-DIFAL-FCP
  • ICMS-DIFAL-DEST
  • ICMS-DIFAL-REMET
  • ICMS-DESON-RJ
  • ICMS-DESON
  • IPI
  • IPI-RETURNED
  • II
  • IOF
  • FUST
  • FUNTTEL
  • APPROXIMATE VALUE OF TAXES - MUNICIPALITY
  • APPROXIMATE VALUE OF TAXES - FEDERAL

Mandatory requirements to get the certification.

As a user, I will navigate to one place on the application, and I should be able to:

Mandatory Suggested

Use Cases

Notes

Mandatory

Setup Avalara Credentials

The best practice is to enhance the UI for easy entry of Avalara credentials including:

  • Client ID Token
  • Secret Token
  • Avalara end point URL

Mandatory

Test Authentication Connection - Heath Service (PING)

There are two methods available:

  • One for authentication /AUTH
  • another for service availability /PING

Suggested

Enable/Disable Service Utilization

In this case, the user can enable or disable the AvaTax BR service at any time. The flag will indicate that the service is operational.

Mandatory

Comprehensive Logging

Given that all transactions are based on request/response JSON, the connector should provide logs of these transactions for troubleshooting, if necessary. Partners can define the time necessary to keep those data on the system.

Mandatory

Set the timeout to API calls

Set a timeout to API call, as recommended by best practices.

Mandatory

Security Communication Protocol – HTTPS/SLL

The platform (ERP´s, middleware’s, e-commerce, etc.) that will be the API calls should be prepared to support TLS 1.2.

Previous versions will be discontinued and are not recommended

Mandatory

Checking Environment

Provide evidence that demonstrates which environment (Production or Sandbox) the client/partner is operating

Mandatory

Version

Inform version compatibility with the ERP with the connector.

Mandatory

Architecture

Inform the connector architecture, as well as the prerequisites for operation, either on Premise or in the cloud.

Mandatory

Namespaces – SAP

Exclusive for partners who will develop a connector for SAP ERP, it is mandatory to have a reserved domain within the SAP system, which must be active and licensed.

Knowledge CenterDeveloper Support
Avalara.com|Terms of Use|Privacy Policy
© 2026 Avalara, Inc.