> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pleo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

The rules and requirements for building accounting integrations with Pleo. These pages explain what your integration must do, how to handle each scenario, and what Pleo expects. Select a section to get started.

## Exports

### Level 1: Expense Items Exporting

The foundation for all integration levels. Understand how to detect and process export jobs from Pleo and post expense data to your Accounting System, including bookkeeping method resolution, accounts mapping, data mapping, and attachment handling.

<CardGroup cols={2}>
  <Card title="Overview" icon="map" href="/docs/current/integration-design/exports/integration-design-exports-overview">
    <div className="text-sm mt-2">The execution model, job lifecycle, and requirements for the full export workflow.</div>
  </Card>

  <Card title="Detect and Start Export Jobs" icon="radar" href="/docs/current/integration-design/exports/integration-design-exports-detect-and-start-export-jobs">
    <div className="text-sm mt-2">How to detect when export jobs are available in Pleo and start them correctly.</div>
  </Card>

  <Card title="Pre-Export Validation" icon="shield-check" href="/docs/current/integration-design/exports/integration-design-exports-pre-export-validation">
    <div className="text-sm mt-2">The validation rules your integration must apply before fetching and processing export items.</div>
  </Card>

  <Card title="Fetch Export Items (Control Layer)" icon="sliders" href="/docs/current/integration-design/exports/integration-design-exports-fetch-export-items-control-layer">
    <div className="text-sm mt-2">How to retrieve the list of export items from Pleo for a given export job.</div>
  </Card>

  <Card title="Fetch Export Items (Data Layer)" icon="database" href="/docs/current/integration-design/exports/integration-design-exports-fetch-export-items-data-layer">
    <div className="text-sm mt-2">How to fetch the full expense data for each export item, including line items and metadata.</div>
  </Card>

  <Card title="Process and Record Export Items" icon="gears" href="/docs/current/integration-design/exports/integration-design-exports-bookkeeping-method-resolution">
    <div className="text-sm mt-2">The rules for resolving bookkeeping methods, mapping accounts and data, handling attachments, and applying posting behaviour.</div>
  </Card>

  <Card title="Update Export Items" icon="pen-to-square" href="/docs/current/integration-design/exports/integration-design-exports-update-export-items">
    <div className="text-sm mt-2">How and when to update the status of individual export items during processing.</div>
  </Card>

  <Card title="Update and Complete Export Job" icon="circle-check" href="/docs/current/integration-design/exports/integration-design-exports-update-and-complete-export-job">
    <div className="text-sm mt-2">How to mark export items as processed and complete the export job in Pleo.</div>
  </Card>
</CardGroup>

## Imports

### Level 2: Tags Sync

Understand how to sync Accounting Dimensions from your Accounting System into Pleo as Tags, so bookkeepers can assign the correct dimensions to expenses before export. Covers Dimension selection, Tag Group and Tag reconciliation, data mapping, and scheduling.

<CardGroup cols={2}>
  <Card title="Overview" icon="map" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-overview">
    <div className="text-sm mt-2">The execution model, reconciliation behaviour, and implementation requirements for Tags Sync.</div>
  </Card>

  <Card title="Dimension Selection" icon="filter" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-dimension-selection">
    <div className="text-sm mt-2">The rules for selecting which Accounting Dimensions to sync, including auto-selection logic and limits.</div>
  </Card>

  <Card title="Sync Tag Groups with Dimensions" icon="folder-tree" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-sync-tag-groups">
    <div className="text-sm mt-2">The reconciliation rules for keeping Tag Groups in Pleo aligned with selected Dimensions.</div>
  </Card>

  <Card title="Sync Tags with Dimension Values" icon="tags" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-sync-tags">
    <div className="text-sm mt-2">The reconciliation rules for keeping Tags in Pleo aligned with Dimension Values from the AS.</div>
  </Card>

  <Card title="Data Mapping" icon="table" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-data-mapping">
    <div className="text-sm mt-2">How to map Accounting Dimension data from your AS to Pleo's Tags API fields.</div>
  </Card>

  <Card title="Periodicity and Scheduling" icon="clock" href="/docs/current/integration-design/accounting-integrations/imports/tags/integration-design-tags-periodicity">
    <div className="text-sm mt-2">When Tags Sync runs, how it is triggered, and the rate limit constraints to respect.</div>
  </Card>
</CardGroup>

### Level 3: Chart of Accounts Sync

Understand how to sync the Chart of Accounts from your Accounting System into Pleo, so bookkeepers can assign the correct accounts to expense categories before export. Covers the reconciliation model, matching by externalId, create/update/archive operations, data mapping, and scheduling.

<CardGroup cols={2}>
  <Card title="Overview" icon="map" href="/docs/current/integration-design/accounting-integrations/imports/accounts/integration-design-accounts-overview">
    <div className="text-sm mt-2">The execution model, reconciliation behaviour, and implementation requirements for Chart of Accounts Sync.</div>
  </Card>

  <Card title="Sync Accounts" icon="rotate" href="/docs/current/integration-design/accounting-integrations/imports/accounts/integration-design-accounts-sync">
    <div className="text-sm mt-2">The reconciliation algorithm for creating, updating, unarchiving, and archiving Accounts in Pleo.</div>
  </Card>

  <Card title="Data Mapping" icon="table" href="/docs/current/integration-design/accounting-integrations/imports/accounts/integration-design-accounts-data-mapping">
    <div className="text-sm mt-2">How to map Chart of Accounts data from your AS to Pleo's Chart of Accounts API fields.</div>
  </Card>

  <Card title="Periodicity and Scheduling" icon="clock" href="/docs/current/integration-design/accounting-integrations/imports/accounts/integration-design-accounts-periodicity">
    <div className="text-sm mt-2">When Chart of Accounts Sync runs, how it is triggered, and the rate limit constraints to respect.</div>
  </Card>
</CardGroup>
