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
SALES TAX FOR MARKETPLACES MILESTONES
cardImage
Before you begin
  • About this guide
  • Are you a marketplace or an ecommerce site?
  • Determine where you'll collect and pay tax
  • Planning your integration
  • Additional resources
  • Glossary
cardImage
Authentication
  • Authentication in AvaTax
  • Sandbox vs Production environments
  • Authentication methods
  • Ping the server
  • Troubleshooting
  • Test authentication
  • Authentication FAQs
cardImage
Error handling
  • AvaTax error messages
  • cardImage
    Recommended approach
    • Consume and display error messages from API responses
cardImage
Configure AvaTax
  • Configure your account
  • cardImage
    Setting up a company
    • The marketplace collects and pays everywhere
    • The marketplace selectively collects and pays tax
  • Test your setup
  • FAQs
cardImage
AvaTax transaction concepts
  • Transactions in AvaTax
  • cardImage
    Simple transactions
    • Simple transactions in AvaTax
    • Addresses in transactions
    • Company codes
    • Customer codes
    • Document codes
    • Document dates
    • Document types
    cardImage
    Nonstandard item transactions
    • Nonstandard item transactions in AvaTax
    • Taxability of shipping charges
    • Taxability of handling charges
  • Transaction lines
  • Transaction statuses
  • Item classification
  • cardImage
    Discounts and overrides
    • Discounts and overrides in AvaTax
    • Discount a transaction
    • Override a transaction
    cardImage
    Exemptions
    • Exemptions in AvaTax
    • Reasons tax can be zero
    • Exemption certificates
    • Exemption numbers
    • Entity use codes
    • Single-use exemptions
    • Override exemptions
  • Void/delete documents
  • Currency conversion
  • Fees and rates in responses
  • cardImage
    Refunds
    • Refund methods in AvaTax
    • Refunds using the RefundTransaction API
    • Refunds using the CreateTransaction API
  • Transaction FAQs
cardImage
Design the user experience
  • Design considerations
  • cardImage
    Administration and utilities
    • Address validation service
    • Pass integration identifier information
    • Request timeout definition
    • Option to display prices with tax included
    cardImage
    Customer record integration
    • Customer codes
    • Entity use codes
    cardImage
    Item/charge integration
    • Item code
    • Item description
    • Non-standard items
    • AvaTax tax code mapping
    • Tax code mapping group
    • Tax code lookup
    cardImage
    Sales/billing documentation integration
    • Document code
    • Customer code
    • Document date
    • Tax calculation date
    • Document type
    • Ship-to address (header and line levels)
    • Ship-from address (header and line levels)
    • Line number
    • Item code
    • Item description
    • Quantity
    • Amount
    • Tax code
    • Merchant seller identifier
    • Verify that the transaction uses the Avalara-calculated tax amount
    • Shipping/freight handling
    • Sales order/sales invoice workflow
    • Commit transactions
    • Discount transactions
    • Void/delete a document
    • Point-of-order origin address (header and line levels)
    • Point-of-order acceptance address (header and line levels)
    • Location code
    • Purchase order number
    • Entity use code (header and line levels)
    • Latitude/longitude support
    • A reasonable ratio of calculation and address validation calls to committed documents
    cardImage
    Refunds integration
    • Return order/return invoices workflow
    • Send the original invoice date as the tax calculation date for refunds
    • Send a negative line item amount with a positive quantity
    • Send the current transaction date as the document date for refunds
    • Support tax-only adjustments
    • Support tax amount tax overrides
    cardImage
    POS integration
    • Use the correct address type for your POS
    • Reporting location code
  • FAQs
cardImage
Design the transaction workflow
  • Transaction workflow considerations
  • Marketplace workflow where the marketplace collects and pays tax everywhere
  • Marketplace workflow where the marketplace collects and pays tax selectively
  • When should I calculate tax?
  • When to commit
  • FAQs
cardImage
Test transactions
  • Multi-merchant scenario
  • Direct sale scenario
  • Tax amount scenario
  • Discounts scenario
  • Entity use code scenario
  • Refunds scenario
  • POS scenario
cardImage
Calculate tax offline
  • Offline tax calculation overview
  • Detect a dropped connection
  • Retry or fallback
  • Reconcile transactions after an outage
cardImage
Functional review
  • Reviewing your integration
Revision history

Merchant seller identifier

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