--- title: Brightpearl API Integration on Truto slug: brightpearl category: Accounting canonical: "https://truto.one/integrations/detail/brightpearl/" --- # Brightpearl API Integration on Truto **Category:** Accounting **Status:** Generally available ## Unified APIs ### Unified Accounting API - **Contact Groups** — ContactGroup represents the groupings used by the company for their contacts - **Contacts** — Contacts represents the company's vendor or a customer - **Currencies** — Currency represents the currencies used by the company - **Journal Entries** — Journal Entries represents the journal entries of the company - **Payment Method** — Payment method represents the payment methods of the company - **Payments** — Payments represents the payments of the company - **Purchase Orders** — Purchase Orders represents the purchase orders of the company - **Tax Rates** — TaxRates represents the tax rates of the company - **Tracking Categories** — TrackingCategories represents the tracking categories of the company ## How it works 1. **Link your customer's Brightpearl account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Brightpearl.** The Proxy API is a 1-to-1 mapping of the Brightpearl API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync retail financial data into your analytics platform** — If you're building an FP&A or business intelligence tool for eCommerce brands, pulling journal entries, purchase orders, and payment data from Brightpearl gives you real ledger-level financials — including COGS, multi-currency transactions, and channel-level profitability — without relying on surface-level sales dashboards. - **Automate wholesale order and contact management** — B2B commerce platforms can read and write contacts, contact groups, and purchase orders in Brightpearl to automate wholesale workflows like credit limit checks, VIP tier assignment, and supplier PO creation — eliminating manual data entry for your mutual customers. - **Power tax compliance with real-time tax rate and journal data** — Tax automation SaaS products can pull tax rates, journal entries, and tracking categories from Brightpearl to ensure cross-border transactions are accurately classified, especially for merchants selling across multiple channels and currencies. - **Close the order-to-cash loop from your fulfillment software** — Shipping and logistics platforms can push payment confirmations and track payment methods back into Brightpearl, letting the platform's automation engine handle downstream accounting like ledger updates and customer notifications without your app needing to manage that complexity. - **Build multi-channel P&L reporting using tracking categories** — If your product helps merchants understand profitability per sales channel, you can ingest Brightpearl journal entries filtered by tracking categories (e.g., Shopify vs. Amazon vs. wholesale) to construct granular profit and loss views your users can't easily get elsewhere. ## What you can build - **Automated supplier PO ingestion** — Pull purchase orders from Brightpearl to give your users real-time visibility into inbound inventory, lead times, and accounts payable obligations. - **Channel-level journal entry sync** — Ingest journal entries with their associated tracking categories so your product can break down revenue, COGS, and margin by individual sales channel. - **Contact and contact group two-way sync** — Read and manage Brightpearl contacts and contact groups to keep customer, supplier, and wholesale tier data in sync between your app and your users' retail back office. - **Multi-currency transaction normalization** — Pull currency configurations from Brightpearl to accurately convert and reconcile international transactions inside your platform. - **Payment and payment method reconciliation** — Sync payments and payment methods from Brightpearl to automate cash application, reconciliation workflows, or AR/AP aging reports in your product. - **Tax rate mapping for global compliance** — Fetch Brightpearl tax rates to automatically map them to your tax engine's codes, ensuring invoices and orders carry the correct tax treatment across jurisdictions. ## FAQs ### What authentication method does Brightpearl use? Brightpearl uses an OAuth-style flow where an application is authorized against a specific Brightpearl account. Truto handles the full auth lifecycle — token acquisition, storage, and refresh — so your end users connect their Brightpearl accounts without you managing credentials directly. ### What Brightpearl data can I access through Truto's Unified Accounting API? Truto's Unified Accounting API supports Contact Groups, Contacts, Currencies, Journal Entries, Payment Methods, Payments, Purchase Orders, Tax Rates, and Tracking Categories for Brightpearl. These cover the core accounting and contact management surfaces of the Brightpearl API. ### Does Truto handle Brightpearl's API rate limits and pagination? Yes. Brightpearl enforces request rate limits and uses its own pagination scheme. Truto abstracts both — it manages throttling, retries, and cursor-based pagination so your application receives clean, complete result sets without building rate-limit handling logic. ### Can I request additional Brightpearl resources beyond what's in the Unified Accounting API? Yes. Brightpearl has no pre-built tools yet, but Truto builds them on request. If you need access to resources like Sales Orders, Goods-Out Notes, Inventory, or Warehouses, you can request them and Truto will scope and build the integration to your requirements. ### How does Brightpearl handle contacts — are customers and suppliers separate? In Brightpearl, Customers, Suppliers, and Staff are all stored as Contacts and differentiated by type and contact group membership. Through Truto's Unified Accounting API, you access them via the Contacts and Contact Groups resources, and can filter or categorize as needed. ### Are tracking categories useful for my integration? Very likely, if your users sell across multiple channels. Brightpearl uses tracking categories to tag journal entries by dimensions like sales channel (Shopify, Amazon, POS). Pulling these through Truto lets you build per-channel financial breakdowns without custom parsing logic.