# Planning your integration

Source: https://developer.avalara.com/services-calculation-en/before_you_begin/planning_your_integration/

# Planning your integration

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

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

**Administration and utilities**

Administration & utilities

**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 - Health Service (PING)

There are two methods available:

-   One for authentication /AUTH
-   One for service availability /PING

Mandatory

Enable/Disable Service Utilization

In this case, the user can enable or disable the AvaTax Brazil service at any time. The flag indicates 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.

Suggested

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 has 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 and 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.

**Scenarios for Sales** 

Sales transactions

**Mandatory Suggested**

**Scenarios**

**Transactions**

Mandatory 

Service Sales Within Origin Company City 

Sales 

Mandatory 

Services Sales Out of Origin Company City 

Sales 

Suggested 

Export Services 

Sales

Suggested 

Service Sales with Deductions 

Sales 

**Scenarios for Purchase**

Purchase Transactions

**Mandatory Suggested**

**Scenarios**

**Transactions**

Suggested 

Service Purchase with Deductions 

Purchase 

Mandatory 

Services Purchase Out of Origin Company City 

Purchase 

Mandatory 

Services Purchase Within Origin Company City 

Purchase

[Previous](/for-review-only/en/leila-paul/services-calculation-en/before_you_begin/about_the_program)

[Next](/for-review-only/en/leila-paul/services-calculation-en/before_you_begin/resources/api_reference)