avalara_sdk - the Unified Java SDK for next gen Avalara services.

Unified SDK consists of services on top of which the Avalara Compliance Cloud platform is built. These services are foundational and provide functionality such as einvoicing.

  • Package version: 24.12.0

Installation

gem install avalara_sdk

Getting Started

Please follow the installation procedure and then run the following code:

require 'time'
require 'avalara_sdk'
# setup authorization
config = AvalaraSdk::Configuration.new
config.environment = 'sandbox'                # Set the environment (sandbox, production, etc.)
config.app_name = 'testApp'                   # Set your application name
config.app_version = '1.2.3'                  # Set your application version
config.machine_name = 'testMachine'           # Set your machine name
config.bearer_token = 'Your_Bearer_token' # Set your OAuth2 Bearer Token (replace with actual token)

api_client = AvalaraSdk::ApiClient.new config
api_instance = AvalaraSdk::EInvoicing::V1::MandatesApi.new api_client
get_mandates_request = AvalaraSdk::EInvoicing::V1::GetMandatesRequest.new
get_mandates_request.set_x_avalara_client('x_avalara_client_example')

begin
  # Retrieve geolocation information for a specified address
  result = api_instance.get_mandates(get_mandates_request)
  p result
rescue AvalaraSdk::ApiError => e
  puts "Error when calling MandatesApi->get_mandates: #{e}"
end

Documentation for API Endpoints

EInvoicing V1 API Documentation

Class Method HTTP request Description
DataInputFieldsApi get_data_input_fields GET /data-input-fields Returns the optionality of document fields for different country mandates
DocumentsApi download_document GET /documents/documentId/$download Returns a copy of the document
DocumentsApi fetch_documents POST /documents/$fetch Fetch the inbound document from a tax authority
DocumentsApi get_document_list GET /documents Returns a summary of documents for a date range
DocumentsApi get_document_status GET /documents/documentId/status Checks the status of a document
DocumentsApi submit_document POST /documents Submits a document to Avalara E-Invoicing API
InteropApi submit_interop_document POST /interop/documents Submit a document
MandatesApi get_mandate_data_input_fields GET /mandates/mandateId/data-input-fields Returns document field information for a country mandate, a selected document type, and its version
MandatesApi get_mandates GET /mandates List country mandates that are supported by the Avalara E-Invoicing platform
SubscriptionsApi create_webhook_subscription POST /webhooks/subscriptions Create a subscription to events
SubscriptionsApi delete_webhook_subscription DELETE /webhooks/subscriptions/subscription-id Unsubscribe from events
SubscriptionsApi get_webhook_subscription GET /webhooks/subscriptions/subscription-id Get details of a subscription
SubscriptionsApi list_webhook_subscriptions GET /webhooks/subscriptions List all subscriptions
TradingPartnersApi batch_search_participants POST /trading-partners/batch-searches Creates a batch search and performs a batch search in the directory for participants in the background.
TradingPartnersApi download_batch_search_report GET /trading-partners/batch-searches/id/$download-results Download batch search results in a csv file.
TradingPartnersApi get_batch_search_detail GET /trading-partners/batch-searches/id Get the batch search details for a given id.
TradingPartnersApi list_batch_searches GET /trading-partners/batch-searches List all batch searches that were previously submitted.
TradingPartnersApi search_participants GET /trading-partners Returns a list of participants matching the input query.

A1099 V2 API Documentation

Class Method HTTP request Description
CompaniesW9Api create_company POST /w9/companies Creates a new company
CompaniesW9Api delete_company DELETE /w9/companies/id Deletes a company
CompaniesW9Api get_companies GET /w9/companies List companies
CompaniesW9Api get_company GET /w9/companies/id Retrieve a company
CompaniesW9Api update_company PUT /w9/companies/id Update a company
Forms1099Api bulk_upsert1099_forms POST /1099/forms/$bulk-upsert Creates or updates multiple 1099 forms.
Forms1099Api create1099_form POST /1099/forms Creates a 1099 form.
Forms1099Api delete1099_form DELETE /1099/forms/id Deletes a 1099 form.
Forms1099Api get1099_form GET /1099/forms/id Retrieves a 1099 form.
Forms1099Api get1099_form_pdf GET /1099/forms/id/pdf Retrieves the PDF file for a single 1099 by form id.
Forms1099Api list1099_forms GET /1099/forms Retrieves a list of 1099 forms based on query parameters.
Forms1099Api update1099_form PUT /1099/forms/id Updates a 1099 form.
FormsW9Api create_w9_form POST /w9/forms Create a W9/W4/W8 form
FormsW9Api delete_w9_form DELETE /w9/forms/id Delete a form
FormsW9Api get_w9_form GET /w9/forms/id Retrieve a W9/W4/W8 form
FormsW9Api get_w9_form_request GET /w9/forms/requests/formRequestId Retrieve a form request
FormsW9Api list_w9_forms GET /w9/forms List W9/W4/W8 forms.
FormsW9Api send_w9_form_email POST /w9/forms/id/$send-email Sends a W9 email request to a vendor/payee
FormsW9Api update_w9_form PUT /w9/forms/id Update a W9/W4/W8 form
FormsW9Api upload_w9_files PUT /w9/forms/id/attachment Upload files for a W9/W4/W8 form
Issuers1099Api create_issuer POST /1099/issuers Create an issuer
Issuers1099Api delete_issuer DELETE /1099/issuers/id Delete an issuer
Issuers1099Api get_issuer GET /1099/issuers/id Get an issuer
Issuers1099Api get_issuers GET /1099/issuers List issuers
Issuers1099Api update_issuer PUT /1099/issuers/id Update an issuer
Jobs1099Api get_job GET /1099/jobs/id Retrieves information about the job

Documentation for Models

EInvoicing V1 Model Documentation

A1099 V2 Model Documentation