Zoho Books and Walmart Marketplace integration

What moves between them

Sales order and item data flow from Zoho Books into Walmart Marketplace via bulk feed submission. Zoho Books invoices and items are mapped to Walmart feed format (SKU, price, quantity, description) and submitted as async bulk operations. Walmart Marketplace orders, returns, and reconciliation reports flow back to Zoho Books via webhooks where configured or polling on a schedule tied to your order cutoff and reconciliation cycle. Pricing updates move bidirectionally: Zoho Books can update prices via Walmart bulk price feeds, and Walmart price changes are read back for accounting review.

How ml-connector handles it

ml-connector stores both credential sets encrypted: the Zoho Books OAuth2 refresh token and the Walmart Client ID and Secret. On the Zoho Books side, it routes all calls to the correct regional base URL determined by the region field in the customer credential, appends organization_id to every request, and refreshes the access token proactively when it approaches the 1-hour expiry. On the Walmart side, it refreshes the Client Credentials token every 15 minutes (before expiry) and injects the WM_SEC.ACCESS_TOKEN header on every call instead of using the Authorization header. For inventory and price syncs, ml-connector batches Zoho Books items into Walmart bulk feed format and submits them as async feed operations, polling the feed submission status until complete. Orders and reconciliation reports from Walmart are received via webhooks (with HMAC signature verification) or polled from Walmart's endpoints within the 180-day window, then mapped back to Zoho Books invoices and line items for accounting close. Every feed submission and order sync carries a full audit trail and can be replayed if a downstream step fails.

A real-world example

A small e-commerce business sells craft goods through their own website (invoiced in Zoho Books) and also lists on Walmart Marketplace. Before the integration, the owner manually exported inventory from Zoho Books, reformatted it into Walmart's bulk feed template, uploaded it weekly, and then manually recorded Walmart orders in Zoho Books at month-end for financial reconciliation. Walmart's actual inventory often drifted out of sync with Zoho Books during the week, causing oversells. With Zoho Books and Walmart Marketplace connected, inventory levels, prices, and SKU data sync automatically via bulk feeds whenever items or quantities change in Zoho Books. Walmart orders arrive as webhooks and are reconciled in Zoho Books daily, so the owner has a single source of truth for both sales channels and can close the books without manual re-entry.

What you can do

• •Sync items, pricing, and inventory from Zoho Books to Walmart Marketplace via bulk feed submissions, updating SKUs, quantities, and prices without manual reformatting.
• •Receive Walmart orders and refunds as webhooks and record them in Zoho Books invoices and journals for real-time financial visibility.
• •Map Zoho Books Chart of Accounts and items to Walmart Marketplace SKUs and fulfillment nodes so pricing is accurate and inventory is balanced across all sellers.
• •Manage OAuth2 token refresh for both systems: user-delegated tokens for Zoho Books with region-specific URL routing, and Client Credentials tokens for Walmart with the required custom header.
• •Maintain a full audit trail on every bulk feed submission, order sync, and price update, with replay capability if a feed fails or an order record cannot be posted.

Questions

How does the integration handle Zoho Books regional URLs and organization ID?

Zoho Books has eight regional instances with different base URLs (US, EU, India, Australia, Japan, Canada, China, Saudi Arabia). ml-connector stores the region field with the credential, routes all API calls to the correct regional endpoint, and appends organization_id to every request as a query parameter. The region is determined from the OAuth2 token response when the credential is first saved.

Why does Walmart Marketplace require bulk feeds for inventory and price updates?

Walmart throttles single-item price updates at 100 per hour, making them unsuitable for frequent syncs. Bulk feed operations let you update hundreds of items asynchronously in a single submission. ml-connector batches Zoho Books items into Walmart bulk feed format, submits them as async operations, and polls the feed status until complete, so large inventory changes are efficient and reliable.

How do Walmart orders get back into Zoho Books for accounting?

Walmart Marketplace supports outgoing webhooks for order and return events. ml-connector receives these webhooks (with HMAC signature verification), maps Walmart orders to Zoho Books invoices, and posts them to Zoho Books via the REST API. If webhooks are not configured, ml-connector polls Walmart orders within the 180-day window on a schedule you set, so every order is captured for reconciliation.