Brazil Returns (Tax compliance) - English

Before you begin

Authentication

Errors

Concepts

Design the user experience

Transactions

Functional review

FAQs

BRAZIL RETURNS MILESTONES

<div class="layout-wrap__column">                                                <div class="layout-wrap__content">                                        <div class="sectiontitle parbase"><div class="section-title">    <h1 class=" h1 ava-gray-darkest text-left d-flex flex-column" style="padding-top: 0px; padding-bottom: 0px;">          <span class="position-relative">              FAQs                        </span>                          </h1></div></div>            <div class="richtext parbase">										 <p>Below are answers to common questions that users face when integrating TaxCompliance.</p>	</div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991830-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991830-ans" aria-controls="mcfaq-1647529991830-ans">                                                            <span class="h5">What is our API type?</span>                        </div>                                        <div id="mcfaq-1647529991830-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991830-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>REST API.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div><div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991836-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991836-ans" aria-controls="mcfaq-1647529991836-ans">                                                            <span class="h5">Do we accept files sent via XML or just JSON file model?</span>                        </div>                                        <div id="mcfaq-1647529991836-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991836-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>Only JSON file model is accepted.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card  col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991844-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991844-ans" aria-controls="mcfaq-1647529991844-ans">                                                            <span class="h5">What is the difference between the Sandbox and Production environments?</span>                        </div>                                        <div id="mcfaq-1647529991844-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991844-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>The sandbox environment is available so that the partner has an environment where they can carry out tests and simulate operations at project time, and before go-live. Therefore, there are no technical differences between environments, except for the data source.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991852-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991852-ans" aria-controls="mcfaq-1647529991852-ans">                                                            <span class="h5">Can I use my credentials in both Sandbox and Production?</span>                        </div>                                        <div id="mcfaq-1647529991852-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991852-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>No, the credentials are unique to each environment.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991860-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991860-ans" aria-controls="mcfaq-1647529991860-ans">                                                            <span class="h5">What authentication methods are supported?</span>                        </div>                                        <div id="mcfaq-1647529991860-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991860-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>The authentication method supported is&nbsp;OAuth 2.0 bearer token authentication.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991868-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991868-ans" aria-controls="mcfaq-1647529991868-ans">                                                            <span class="h5">What is the Sandbox URL?</span>                        </div>                                        <div id="mcfaq-1647529991868-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991868-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p><a href="https://portal.sandbox.avalarabrasil.com.br/Login" class="avalink--external">https://portal.sandbox.avalarabrasil.com.br/Login</a></p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991877-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991877-ans" aria-controls="mcfaq-1647529991877-ans">                                                            <span class="h5">Who do I contact if my Sandbox account has expired?</span>                        </div>                                        <div id="mcfaq-1647529991877-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991877-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>If your Sandbox account has expired, you should contact the Partner Launch Brazil team.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991885-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991885-ans" aria-controls="mcfaq-1647529991885-ans">                                                            <span class="h5">How can I confirm if the service is up?</span>                        </div>                                        <div id="mcfaq-1647529991885-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991885-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p><a href="https://api-gateway.sandbox.avalarabrasil.com.br/portal/health" class="avalink--external">https://api-gateway.sandbox.avalarabrasil.com.br/portal/health</a></p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991893-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991893-ans" aria-controls="mcfaq-1647529991893-ans">                                                            <span class="h5">What can you do if your “Secret Token” was exposed?</span>                        </div>                                        <div id="mcfaq-1647529991893-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991893-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>If your “Secret Token” has been exposed, it is possible to revoke it through the Avara Portal.&nbsp;</p><ol><li>Select the token that will be revoked and click "revogar" to revoke the token.&nbsp;</li><li>Select "confirmar" to confirm the operation.&nbsp;</li></ol>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991901-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991901-ans" aria-controls="mcfaq-1647529991901-ans">                                                            <span class="h5">What should I do if I lose my “Secret Token”?</span>                        </div>                                        <div id="mcfaq-1647529991901-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991901-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>If you did not save your “Secret Token” in a safe place and lost it, you must revoke your token and create a new one.&nbsp;</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991909-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991909-ans" aria-controls="mcfaq-1647529991909-ans">                                                            <span class="h5">How can I obtain my “Client ID”?</span>                        </div>                                        <div id="mcfaq-1647529991909-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991909-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>You can access your Client ID in two different ways.</p><ul><li>When you create your Secret token, your client ID is shown.</li><li>You can also find your client ID in&nbsp;assinatura&nbsp;and&nbsp;infomações da assinatura.&nbsp; &nbsp;</li></ul>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991917-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991917-ans" aria-controls="mcfaq-1647529991917-ans">                                                            <span class="h5">What happens if I send the JSON request WITHOUT “disableTokenRefresh”?</span>                        </div>                                        <div id="mcfaq-1647529991917-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991917-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>You will receive a "refresh_token" in the response.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="mcfaqcontainer"><div class="container-fluid">        <div class="row align-items-start ">        <div class="w-100">            <div class="mcfaq-item section">                        <div class="faq-card faq-card--light col-12">                                <div class="faq-card__wrap" >                                                                    <div id="mcfaq-1647529991925-que" class="faq-card__question collapsed" onclick="faqTracking(this)" data-toggle="collapse" data-target="#mcfaq-1647529991925-ans" aria-controls="mcfaq-1647529991925-ans">                                                            <span class="h5">What happens if I send the JSON request WITH “disableTokenRefresh” set to “true”?</span>                        </div>                                        <div id="mcfaq-1647529991925-ans" class="collapse faq-card__answer" aria-labelledby="mcfaq-1647529991925-que">                            <div class="faq-card__parsys">            <div class="richtext parbase">										 <p>You will not receive the "refresh_token" in the response, and it will be necessary to send the credentials again, after the session expires.</p>	</div></div>                        <div class="faq-card__richtext">										 	</div>                    </div>                </div>                 </div>            </div>        </div>    </div></div></div>            <div class="spacer parbase"><div class="row pt-8  "></div></div>            <div class="layout"><div class="layout-wrap                                          ">                <div class="container layout-wrap__inner ">        <div class="row justify-content-start ">                            <div class="top                        col-6                        col-md-6                        col-lg-6                                                 ">                                        <div class="layout-wrap__column null">                                                <div class="layout-wrap__content">                                        <div class="cta parbase"> <div class="justify-content-start clearfix row" activitymap.region="en_gb:CTA">                                                    <a href="/extractor-en/functional_review/whats_next" target="_self" class="avalara__btn__btn-primary btn-primary-css orange-theme  cta--one">                                                                                            Previous</a>            </div></div>                        </div>                    </div>                </div>                            <div class="top                        col-6                        col-md-6                        col-lg-6                                                 ">                                        <div class="layout-wrap__column null">                                                <div class="layout-wrap__content">                                                    </div>                    </div>                </div>                    </div>    </div></div></div>            <div class="spacer parbase"><div class="row pt-10  "></div></div>                        </div>                    </div>

Brazil Returns FAQs

Tax Compliance processes and validates tax and accounting data to generate required returns across federal, state, and municipal jurisdictions.

Core capabilities

Aggregate tax, accounting, and operational data from ERP systems and other sources into a unified dataset.

Consolidated data processing

Calculate taxes and generate required reports and filings based on current regulatory formats.

Automated returns generation

Validate data before submission to identify inconsistencies and reduce rework and compliance risk.

Validation and error prevention

Support federal, state, and municipal returns, including digital reporting such as SPED.

Multi-level compliance coverage

Access Tax Compliance integration guides and documentation in the developer portal. Setup involves connecting data sources, configuring compliance workflows, and enabling reporting based on regulatory requirements.

Getting started

Tax Compliance integrates with ERP systems, financial platforms, and other data sources to extract and process transactional data. Tax Compliance transforms this data into the formats required by tax authorities and supports submission workflows through standardized formats.

How it integrates

What Tax Compliance (Brazil) solves

When to use Tax Compliance (Brazil)

Tax Compliance (Brazil)

Get Started

This guide describes the steps you should follow to integrate fiscal and account data into the TaxCompliance application.

Este guia descreve as etapas que você deve seguir para integrar dados fiscais e contábeis na aplicação TaxCompliance.