# Planning your integration

Source: https://developer.avalara.com/goods-calculation-en/beforeyoubegin/planning_your_integration/

This section provides an overview of the _Goods Calculation_ badge requirements that you need to meet to become a certified partner. Review this section to help you plan your integration.

**Advice:** Before you start your integration plan, it's important to define the main operations type and use type covered during the certification program.

[![Closed](https://avalara-devdocs-prod.mcoutput.com/goods-calculation-en/Skins/Default/Stylesheets/Images/transparent.gif)Administration and utilities requirements](javascript:void\(0\);)

The table below describes the requirements and best practices for your application's user experience.

Mandatory/Suggested

Use Cases

Notes

Level

Mandatory

Setup Avalara Credentials

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

-   Client ID Token

-   Secret Token

UI

Mandatory

Test Authentication Connection - Health Service (PING)

There is one method available for service availability/PING

UI

Mandatory

Enable/Disable Service Utilization

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

UI

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.

UI

Mandatory

Select environment option

Provide environment option in order to allow the key user to change between sandbox and production environment

UI

Mandatory

Checking Environment

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

UI

Suggested

Set the timeout to API calls

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

Hide configuration

Mandatory

API Base URL

The URLs should be system settings

Hide configuration

Mandatory

Version

Inform version compatibility with the ERP with the connector.

Documentation

Mandatory

Architecture

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

Documentation

[![Closed](https://avalara-devdocs-prod.mcoutput.com/goods-calculation-en/Skins/Default/Stylesheets/Images/transparent.gif)Scenarios for Sales](javascript:void\(0\);)

The table below describes requirements and suggestions for sales transactions.

Mandatory/Suggested

Scenario

Transaction type

Suggested

Free zone operation

Sales

Suggested

Statutory retail price

Sales

Suggested

Simplified entrepreneur sales

Sales

Mandatory

Interstate sale for ICMS taxpayers

Sales

Mandatory

Interstate sale for non-ICMS taxpayers

Sales

Mandatory

Sale within the state

Sales

Suggested

Sale for future delivery

Sales

Mandatory

Complementary sales invoice

Sales

Suggested

Export goods

Sales

Suggested

Shipping operations for fairs or demos

Shipping

Suggested

Shipping operations for future delivery

Shipping

Suggested

Transfers between headquarters and branches

Transfer

Suggested

Total outbound goods return

Goods Return

Suggested

Partial outbound goods returns

Goods Return

[![Closed](https://avalara-devdocs-prod.mcoutput.com/goods-calculation-en/Skins/Default/Stylesheets/Images/transparent.gif)Scenarios for purchases](javascript:void\(0\);)

The table below describes requirements and suggestions for purchase transactions.

Mandatory/Suggested

Scenario

Transaction type

Suggested

Shipping operations for future delivery

Shipping

Suggested

Shipping operations for fairs or demos

Shipping

Suggested

Partial inbound goods returns

Goods Return

Suggested

Total outbound goods return

Goods Return

Suggested

Simplified entrepreneur purchase

Purchase

Mandatory

Interstate purchase

Purchase

Mandatory

Purchase within the state

Purchase

Mandatory

Transport purchase

Purchase

Suggested

Import goods

Purchase