Zoho Books and Amazon Seller Central integration

What moves between them

Amazon order revenue and settlement payments flow into Zoho Books. When an order is placed in Amazon Seller Central, ml-connector captures the order total, conversion fees, and promotional adjustments, and posts them as revenue journal entries in Zoho Books mapped to your sales account. When Amazon processes a settlement payment, the financial event flows in as a Zoho Books journal entry mapped to your merchant deposits account. Reference data such as product SKUs and currency codes are aligned so revenue lines post to the correct accounts. Financial events older than 2 years may not be available from Amazon depending on the region.

How ml-connector handles it

ml-connector stores Zoho Books OAuth2 credentials (client_id, client_secret, refresh_token) encrypted and routes all requests to the correct regional base URL determined by the organization credential region field. It refreshes the Zoho Books access token proactively before expiry and includes the required organization_id query parameter on every API call. On the Amazon side, it stores the seller refresh_token encrypted and calls the Selling Partner API regional endpoints. Because Amazon Seller Central does not offer direct HTTP webhooks, ml-connector polls the Finances API and Orders API on a schedule you define, extracting financial event groups and order details. Each Amazon financial event is mapped to a Zoho Books journal entry using the exchange_rate and currency_id fields to ensure multi-currency accuracy. Both platforms rate-limit to 100 requests per minute (Zoho Books) and variable Amazon throttles, so ml-connector backs off and retries on 429 responses. Every record carries a full audit trail and can be replayed if a downstream write fails.

A real-world example

A mid-sized online retailer sells across North America and Europe using Amazon as a primary sales channel and Zoho Books for accounting. Before the integration, the accountant exported daily settlement reports from Amazon, converted them to the local currency, and manually entered the revenue and settlement journal entries into Zoho Books by hand. This introduced currency conversion errors and lagged the books by one to two days. With Amazon Seller Central and Zoho Books connected, each order and settlement flows into Zoho Books automatically in the correct regional currency, posted to the appropriate revenue and merchant account. Month-end close begins with all Amazon revenue already recorded and reconciled, and the daily manual entry step is eliminated.

What you can do

• •Post Amazon order revenue into Zoho Books journal entries mapped to your sales and revenue accounts, with multi-currency support.
• •Record Amazon settlement payments and adjustments as Zoho Books journal entries mapped to your merchant deposit account.
• •Align product SKUs and currency codes between Amazon and Zoho Books so revenue lines post to the correct accounts.
• •Authenticate both Zoho Books and Amazon Seller Central with OAuth2 credentials and handle multi-region routing for both platforms.
• •Poll Amazon financial events and orders on a schedule you control, with retries and a full audit trail on every record.

Questions

Which direction does data move between Zoho Books and Amazon Seller Central?

The main flow is Amazon Seller Central into Zoho Books. Order revenue and settlement payments from Amazon flow into Zoho Books as journal entries. Reference data such as product codes and currency rates are aligned in both directions so revenue lines post to valid accounts. Zoho Books invoices and journal entries are read-only from Amazon perspective.

How does the integration handle Amazon's multi-region setup and lack of HTTP webhooks?

ml-connector stores the seller refresh_token encrypted and calls the Selling Partner API endpoints for the region where the seller account is active. Because Amazon does not offer direct HTTP webhooks, ml-connector polls the Finances API and Orders API on a schedule you define, extracting order totals and financial settlement events. The Finances API returns all events since the last poll, so polling once per day covers all daily settlements.

How does multi-currency accounting work in this integration?

Each Amazon order and settlement event carries a currency_id and exchange_rate. ml-connector pulls the exchange rate from the Amazon settlement and applies it when posting the journal entry into Zoho Books, using the correct currency_id from the Books organization. This ensures the home-currency total in your ledger matches the actual settlement amount received.