ml-connector
Infor CloudSuiteWalmart Marketplace

Infor CloudSuite and Walmart Marketplace integration

Infor CloudSuite runs finance and supply chain. Walmart Marketplace is where sellers manage orders, inventory, and customer returns. Connecting the two keeps your ecommerce revenue in agreement with your general ledger. Orders from Walmart Marketplace post into CloudSuite's receivables and revenue accounts without manual data entry, and returns flow back as adjustments. ml-connector handles the different OAuth 2.0 implementations, Walmart's webhook push and polling options, and CloudSuite's region-specific tenant URLs to move the data on a schedule you control.

How Infor CloudSuite works

Infor CloudSuite is a cloud ERP platform available in multiple product lines (CloudSuite Industrial with SyteLine, CloudSuite Financials, Distribution, LN, M3) that manages procurement, finance, and supply chain operations. It exposes suppliers, purchase orders, invoices, payments, GL accounts, customers, and items through REST APIs via the ION API Gateway, authenticated with OAuth 2.0 service account credentials extracted from a per-customer .ionapi credentials file. The base URL and token endpoint are region and customer-specific, and token lifetime ranges from 1 to 24 hours depending on tenant configuration. CloudSuite does not support traditional webhooks; instead, it offers ION BOD document flows that require administrative configuration in ION Desk to enable push notifications. The primary integration approach is polling via REST API by modified date or transaction status.

How Walmart Marketplace works

Walmart Marketplace is the third-party seller platform on Walmart.com where sellers list items, manage inventory and pricing across multiple fulfillment nodes, fulfill orders, handle returns and refunds, and access settlement and performance reports. It exposes items, inventory quantities, orders, returns, refunds, pricing, and reconciliation reports through REST APIs at https://marketplace.walmartapis.com and a sandbox at https://sandbox.walmartapis.com. Authentication uses OAuth 2.0 client credentials with a 15-minute token expiry, and access tokens are passed via a non-standard header WM_SEC.ACCESS_TOKEN rather than the Authorization header. Walmart Marketplace pushes order, inventory, item, return, and report events via webhooks with automatic retry at 5-minute, 15-minute, and 45-minute intervals before dropping the event. The API also supports polling for orders (maximum 10,000 from the last 180 days), items, returns, and reports.

What moves between them

The main flow runs from Walmart Marketplace into Infor CloudSuite. Orders placed on Walmart Marketplace are read via polling or webhook, mapped to CloudSuite customers and GL accounts, and posted as revenue transactions into the ledger. Returns approved by the seller flow in the same direction as adjustments to revenue. Reference data such as customer master records may be aligned in both directions if a seller maintains a product catalog in both systems. Walmart data is read-only in most respects, so ml-connector does not write pricing or inventory back to Walmart.

How ml-connector handles it

ml-connector stores both credential sets encrypted and refreshes the Walmart access token proactively every 14 minutes to avoid the 15-minute expiry. On the CloudSuite side, it parses the per-customer .ionapi credentials file to extract the region-specific base URL and token endpoint, authenticates with the OAuth 2.0 resource owner password credentials grant, and polls orders and returns on a cadence tied to your selling and returns processing calendar. When Walmart Marketplace webhooks are enabled, ml-connector receives and verifies push notifications for orders and returns, then reconciles against the polling schedule to avoid duplicates. Each order line is mapped to a CloudSuite customer and a GL revenue account configured per seller, and the transaction is posted with the order date and Walmart order ID for audit traceability. Returns are posted as negative revenue adjustments to the same accounts. ml-connector respects Walmart's rate limits and CloudSuite's per-minute request quotas, tracks token expiry on both sides, and maintains a full audit log so a failed GL posting can be replayed once the issue is resolved.

A real-world example

A mid-sized seller runs Infor CloudSuite Financials for accounting and general ledger, and uses Walmart Marketplace to sell consumer goods across multiple fulfillment nodes. Before the integration, the finance team exported daily order reports from Walmart Marketplace and manually entered the revenue totals and returns into CloudSuite each morning, which meant lag time between order placement and ledger posting, and frequent reconciliation errors during month-end close when Walmart's export and CloudSuite's AR aging did not agree. With Walmart Marketplace and CloudSuite connected, each day's orders and returns post automatically to the revenue ledger, allocated to the correct GL accounts by category, and the seller can close the books on day one of month-end knowing Walmart revenue is already locked in.

What you can do

  • Post Walmart Marketplace orders into Infor CloudSuite's receivables and revenue GL accounts daily, mapped to customer master records and GL dimensions.
  • Track Walmart returns and refunds as adjustments to revenue, maintaining full traceability with order ID and return date.
  • Authenticate Walmart Marketplace with OAuth 2.0 and bridge the 15-minute token expiry, and CloudSuite with region-specific tenant credentials.
  • Receive Walmart Marketplace webhook push notifications for orders and returns when enabled, while also polling on a schedule to ensure no data is missed.
  • Maintain a complete audit trail on every order and return, with the ability to replay a posting if a downstream GL call fails.

Questions

Which direction does data move between Infor CloudSuite and Walmart Marketplace?
The main flow is Walmart Marketplace into Infor CloudSuite. Orders and returns move from Walmart into CloudSuite as revenue and adjustment transactions posted to the GL. Customer master records may be aligned in both directions if the seller maintains the same product catalog in both systems. Walmart Marketplace data is read-only in the integration, so ml-connector does not write pricing or inventory back.
How does ml-connector handle Walmart's 15-minute token expiry and webhook retries?
ml-connector refreshes the Walmart access token proactively every 14 minutes before expiry, eliminating downtime from token refresh failures. When Walmart Marketplace webhooks are enabled, ml-connector receives push notifications for orders and returns, verifies them, and reconciles them against the polling schedule to ensure no duplicates are posted to CloudSuite. Webhook events that fail to process are replayed according to Walmart's retry schedule.
Does the integration work with Infor CloudSuite's region-specific URLs and lack of traditional webhooks?
Yes. ml-connector parses the per-customer .ionapi credentials file to extract the region-specific base URL and OAuth token endpoint, since CloudSuite publishes no shared hostname. Because CloudSuite does not support traditional webhooks, ml-connector polls orders and returns from Walmart on a schedule you control, and can also integrate with Walmart's webhook push notifications for lower-latency posting.

Related integrations

Connect Infor CloudSuite and Walmart Marketplace

Free to use. Add your credentials, ping your real systems, and see if we fit.

Get started