ml-connector
Oracle Fusion Cloud ERPTaxJar

Oracle Fusion Cloud ERP and TaxJar integration

Oracle Fusion Cloud ERP manages your financials, AR, and sales orders. TaxJar calculates real-time sales tax and manages reporting to state authorities. Connecting the two keeps your tax liability accurate in your general ledger and ensures TaxJar knows about every taxable transaction. When you issue an invoice in Oracle Fusion Cloud ERP, ml-connector sends it to TaxJar for tax calculation, reads back the tax amount, and posts it as a journal line in Oracle Fusion Cloud ERP. Sales tax transactions reconcile automatically instead of being hand-calculated or re-keyed after the fact.

How Oracle Fusion Cloud ERP works

Oracle Fusion Cloud ERP exposes receivables invoices, sales orders, customers, GL accounts, and journal batch templates through REST business document APIs at each customer's pod-specific URL. The cloud product authenticates with OAuth2 Bearer tokens generated against an OCI Identity Domain, with tokens valid for approximately one hour. Oracle Fusion Cloud ERP publishes no direct outbound webhooks to external URLs without Oracle Integration Cloud middleware, so tax connectors must poll the REST API by filtering on LastUpdateDate or CreationDate timestamps every 5 to 15 minutes.

How TaxJar works

TaxJar exposes tax rate lookups, transaction reporting, customer exemption records, and nexus regions through a REST API with token-based API Key authentication. The API is accessed at https://api.taxjar.com/v2/ in production or a sandbox endpoint, and requires an x-api-version header. TaxJar does not support OAuth2, does not publish webhooks to external endpoints, and is poll-only by design. Merchants store API tokens generated from the TaxJar web app and pass them in the Authorization header on each request.

What moves between them

The flow is Oracle Fusion Cloud ERP into TaxJar and back. When an invoice or sales order is created or modified in Oracle Fusion Cloud ERP, ml-connector polls for new records and posts them to TaxJar for tax rate lookup and state nexus tracking. TaxJar returns the calculated tax amount and applicable jurisdictions. ml-connector then reads that response, maps the tax back to the customer and invoice in Oracle Fusion Cloud ERP, and posts a journal line to the appropriate tax GL account, so the tax liability appears in your general ledger immediately without manual entry. The cadence is once per business day or per your transaction volume preference.

How ml-connector handles it

ml-connector stores both the Oracle Fusion Cloud ERP OAuth2 credentials and the TaxJar API token encrypted. On each poll cycle, it fetches recent invoices and orders from Oracle Fusion Cloud ERP's REST API by querying with LastUpdateDate filters and the Bearer token in the Authorization header. For each transaction, ml-connector builds a TaxJar transaction request with customer address, line item amounts, and item categories, then POSTs to TaxJar's /taxes endpoint using the API Key header. TaxJar returns the calculated tax and nexus list. ml-connector then creates a journal entry in Oracle Fusion Cloud ERP by writing a journal batch with lines mapping to the tax GL account for each jurisdiction. Oracle Fusion Cloud ERP's PATCH behavior does not cascade defaulting, so account combinations must be pre-established in Oracle's chart of accounts. Retries on both sides follow exponential backoff if a rate limit or timeout occurs, and every transaction carries an audit entry so failed records can be replayed. Sandbox tokens and sandboxes are available on TaxJar's Professional plan and higher, and are stateless so they validate format only.

A real-world example

A mid-sized e-commerce retailer processes hundreds of orders daily across multiple sales channels, all synced into Oracle Fusion Cloud ERP for AR and GL. Before the integration, the finance team exported sales transactions from Oracle Fusion Cloud ERP weekly and hand-entered them into TaxJar to calculate liabilities, then copied the tax amounts back into Oracle Fusion Cloud ERP as manual GL journal entries. Reconciliation was slow and error-prone, with mismatches between what was calculated and what was recorded. With Oracle Fusion Cloud ERP and TaxJar connected, each new order flows to TaxJar automatically, tax is calculated in real time, and the journal entry posts into the GL the same day. Month-end tax reporting is accurate and reconciles without searching for missing transactions.

What you can do

  • Post sales invoices and orders from Oracle Fusion Cloud ERP to TaxJar for real-time tax rate calculation and nexus tracking.
  • Retrieve calculated tax amounts from TaxJar and post them as journal lines in Oracle Fusion Cloud ERP's general ledger by customer and jurisdiction.
  • Authenticate Oracle Fusion Cloud ERP with OAuth2 tokens scoped to customer OCI Identity Domains and TaxJar with token-based API Keys.
  • Poll Oracle Fusion Cloud ERP for new and updated transactions using LastUpdateDate filters every 5 to 15 minutes on a schedule you control.
  • Maintain encrypted credential storage for both systems, with full audit trails and retry logic on failed posts to either system.

Questions

How does ml-connector get data from Oracle Fusion Cloud ERP if there are no webhooks?
Oracle Fusion Cloud ERP can push events through Oracle Integration Cloud middleware, but ml-connector uses the standard polling approach for standalone connectors. It queries the REST API using LastUpdateDate or CreationDate filters every 5 to 15 minutes, so new invoices and orders are picked up as soon as they are created or modified. This avoids the need for OIC and keeps the integration simple.
What happens if TaxJar returns a different tax amount than Oracle Fusion Cloud ERP calculated?
ml-connector uses TaxJar's calculated amount as the source of truth and posts it to Oracle Fusion Cloud ERP as a journal line entry. If a prior manual entry exists, you can reconcile the difference or reverse the old entry. The system of record becomes TaxJar's calculation, synchronized daily into your GL.
Can ml-connector handle exemptions and special tax rules?
Yes. TaxJar tracks customer-level exemptions and exemption types in its customer records. ml-connector reads those exemptions when posting a transaction and passes them to the TaxJar API, and TaxJar applies the exemption logic before returning the calculated tax. Oracle Fusion Cloud ERP's account combinations for tax GL accounts must be pre-established in your chart of accounts so the journal line posts to the correct account.

Related integrations

Connect Oracle Fusion Cloud ERP and TaxJar

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

Get started