- Understand system boundaries and responsibilities
- Evaluate integration feasibility and patterns
- Learn how expense data becomes accounting-ready
System Boundaries
Pleo is a spend management (pre-accounting) platform, not an accounting system. It prepares accounting-ready data that is exported or synchronised into your ERP or AS.| Pleo is responsible for | Your accounting system remains responsible for |
|---|---|
| Capturing spend and reimbursements | Ledger integrity |
| Enforcing company policy | Posting rules |
| Collecting required accounting information | Period control |
| Locking data once approved | Financial reporting |
| Exporting immutable accounting records | Statutory compliance |
Platform Foundations
Pleo provides integrations through four core capabilities that support all integration types:- Master Data Synchronisation: Ensures employees, legal entities, chart of accounts, vendors, categories, and tags exist in Pleo.
- Expense Lifecycle & Approval: Manages expense entry, validation, and approvals, producing immutable accounting-ready data.
- Export Pipeline & Bookkeeping: Provides a consistent, traceable mechanism to export approved data for downstream systems.
- Event-Driven Automation: Notifies integrations of key events (e.g., export job creation, master data changes) to enable timely reactions.
These foundations apply regardless of whether you use pre-built or custom integrations.See Multi-Entity & API Scope for details on company-level API constraints.
Integration Models
Pleo supports multiple ERP and Accounting System integration models. The same platform capabilities apply regardless of how data is exchanged.Pre-Built Integrations
Pleo provides pre-built integrations with selected ERP, Accounting Systems, and HRIS.- Configured directly from the Pleo web application
- Managed and supported by Pleo
- Designed for standard accounting workflows
- Authentication and authorisation handled internally by the platform
CSV Export Integrations
For some ERP or accounting workflows, CSV export using ERP-specific templates can be used as an alternative to API integrations.- Export files are generated from the Pleo Web App
- Data is formatted using ERP-specific CSV templates
- Files can be imported directly into the accounting system
- No API development is required
- Provides a simple and controlled export mechanism
Custom (Export-Driven) Integrations
Custom integrations (commonly referred to as Accounting Integrations) use Pleo’s APIs to transfer accounting-ready data to external ERP or accounting systems via an export-driven model. In this approach:- A user initiates export jobs via the Pleo Web App
- Immutable, structured JSON records representing approved expenses are produced over the API
- Records are consumed programmatically by the integration or middleware and mapped into the target system
Key Characteristics
- Export jobs are triggered by the user in the Pleo Web App, not directly by the integration
- Immutable, accounting-ready JSON records delivered via API
- Traceable export job and item states
- Clear error reporting and retry mechanisms
- Supports bespoke data mapping and complex accounting logic
- Authenticated using OAuth 2.0 or API Keys
Deployment Options
Accounting integrations can be deployed in different ways depending on your ERP/Accounting system and integration partner setup:-
Module / On-Premises
Some ERP/accounting systems allow the integration to run within their environment. Benefits include higher stability, tighter connectivity, and leveraging the system’s tech stack for configuration. Typically requires a single authorisation (OAuth 2.0) step to access Pleo data. -
Cloud Platform
The integration runs on a cloud platform or middleware. Export jobs are initiated from the Pleo Web App, and your integration consumes the immutable JSON records via the API using OAuth 2.0. This approach is common for partner-hosted integrations or more complex multi-system workflows.
Event-Driven Notifications (Webhooks)
- Webhooks notify integrations of key events (currently
v1.export.job-createdandv1.vendor.created) - Events act as triggers, not data carriers; full data is fetched explicitly via the API
- Integrations may also poll the API instead of relying on webhooks
- Enables near-real-time responsiveness without manual intervention
- Reacting to new export jobs
- Monitoring export lifecycle and operational status
- Detecting master data changes (e.g., vendor creation)
- Unsupported or bespoke ERP / accounting systems
- Complex accounting or multi-entity requirements
- Controlled, batch-based accounting workflows
Accounting Integration Lifecycle
A typical Accounting integration follows this lifecycle:- Onboard to Staging (OAuth 2.0 or API Keys)
- Integrate your ERP or Accounting System
- Synchronise master data into Pleo (e.g., tags, categories, vendors)
- Capture and approve expenses in Pleo
- Export accounting-ready data via your integration
- Monitor jobs and handle exceptions
- Promote your integration from Staging to Production
Platform Guarantees & Constraints
- Only approved and complete expenses are exportable
- Exported expense data is immutable
- Strict legal-entity isolation is enforced
- Master data dependencies must be satisfied
- Rate limits apply per API surface
Specific workflows may vary depending on organisational policies and configuration.
Pleo adapts to each business while consistently ensuring approved expenses are export-ready.
Pleo adapts to each business while consistently ensuring approved expenses are export-ready.
Next Steps
- Familiarise yourself with the API surfaces Review the Pleo Platform API Overview to see how your integration can interact with master data, the expense lifecycle, and export jobs.