> ## 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.

# Tax Sync Data Mapping

export const RememberCallout = ({title, children, icon = "🪢"}) => <div style={{
  backgroundColor: 'var(--recommended-bg)',
  borderLeft: '4px solid #f63b92',
  borderRadius: '10px',
  padding: '18px 22px',
  marginBottom: '20px',
  boxShadow: '1px 1px 3px rgba(0,0,0,0.06)'
}}>
    <div style={{
  display: 'flex',
  alignItems: 'flex-start',
  gap: '14px'
}}>
      <span style={{
  fontSize: '22px',
  lineHeight: '1',
  flexShrink: 0
}}>
        {icon}
      </span>
      <div>
        {title && <div style={{
  fontSize: '16px',
  fontWeight: 600,
  color: 'var(--recommended-title)',
  marginBottom: '6px'
}}>
            {title}
          </div>}
        <div style={{
  fontSize: '14px',
  lineHeight: 1.65
}}>
          {children}
        </div>
      </div>
    </div>
  </div>;

This page describes how data from the Accounting System is mapped to Pleo's Tax Codes API during Tax Sync.

Data mapping ensures that tax codes from the AS are reflected accurately in Pleo's Tax Codes.

## Implementation

* [Tax Sync Workflow Guide](/docs/current/guides/accounting-integrations/imports/tax-sync-workflow-guide): workflow context and sequencing
* [How to Fetch and Match Tax Codes](/docs/current/how-tos/accounting-integrations/imports/tax-codes/how-to-fetch-and-match-tax-codes): API usage and step-by-step instructions

## Tax Codes: Data Mapping

Map the following datapoints from AS tax codes to Pleo Tax Codes API fields.

| Pleo Tax Codes API Field | AS Tax Code Datapoint                                                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                   | The identifier of the tax code in the AS. Used for matching.                                                                                                                |
| `name`                   | Name of the tax code                                                                                                                                                        |
| `rate`                   | Rate of the tax code as a decimal (for example: `0.20` for 20%)                                                                                                             |
| `type: reverse`          | Use only for reverse taxes                                                                                                                                                  |
| `type: inclusive`        | Use for all other taxes                                                                                                                                                     |
| `archived: false`        | Use when creating new active Tax Codes or unarchiving existing Tax Codes                                                                                                    |
| `archived: true`         | Use when archiving Tax Codes that no longer have a matching active tax code in the AS, or that were previously synced but have since been deleted, archived, or deactivated |

## Matching Field

Tax Codes are matched to their AS counterparts using the **`code`** field on both ends.

Matching is **case insensitive**. The `code` field is the stable identifier used to track a tax code across sync runs, even if its name or rate changes.

## Tax Code Type Mapping

| AS Tax Code                                               | Pleo `type` |
| --------------------------------------------------------- | ----------- |
| [Reverse tax](https://blog.pleo.io/en/vat-reverse-charge) | `reverse`   |
| All other taxes                                           | `inclusive` |

Although `exclusive` appears as a valid enum value in the API spec, it is not currently supported. Attempting to create a Tax Code with `type: exclusive` returns a `400 BAD_REQUEST` error. Do not use this value.

<RememberCallout title="Remember">
  The Pleo Web App labels these types **Standard** and **Reverse**. The API uses `inclusive` and `reverse`. `inclusive` corresponds to **Standard** in the Web App: there is no separate `standard` value.
</RememberCallout>

***

## What Comes Next?

* [Tax Sync Periodicity and Scheduling](/docs/current/integration-design/accounting-integrations/imports/tax-codes/integration-design-tax-sync-periodicity)

***

## Related Reading

* [Sync Tax Codes](/docs/current/integration-design/accounting-integrations/imports/tax-codes/integration-design-tax-sync)
* [Tax Sync Workflow Guide](/docs/current/guides/accounting-integrations/imports/tax-sync-workflow-guide)
* [Platform Capabilities: Tax Sync](/docs/current/platform/accounting-integrations/imports/tax-codes/tax-sync-overview)

***