Pleo · Schema
AccountingEntryCoreV6
Expense ManagementCompany CardsSpend ManagementReimbursementsAccountingFinTechFinance
Properties
| Name | Type | Description |
|---|---|---|
| accountCode | string | The account code allocated to the specific accounting entry. For example, an expense incurred for meals and drinks account would have a specific account code. |
| accountId | string | Unique identification number of the account (Category) allocated to the transaction. If `I don't know` is selected, then in the API endpoint response, `"00000000-0000-0000-0000-000000000000"` is retur |
| bookkeepingDate | string | The date when the transaction was settled, except for out of pocket expenses; for out of pocket expense, the bookkeeping date is when the purchase was done. |
| companyId | string | The unique identifier of the company that to which the accounting entry belongs. |
| createdAt | string | The date and time when the specific accounting entry is created. |
| deletedAt | string | If the accounting entry is deleted, this field specifies the date and time of deletion. |
| employeeId | string | The unique identifier of the employee who incurred the expense. |
| exportStatus | string | This can be one of `ExportStatus` values. `CREATED`: The accounting entry has been created. `EXPORTED`: The accounting entry has been exported. `EXPORTING`: The accounting entry is in the process of b |
| externalAccountId | string | The external id of the account specified for this accounting entry. |
| family | string | This can be one of `AccountingEntryFamily` values. `BALANCE_AMENDMENT`: Represents manual wallet balance adjustments, often through human intervention. `BILL_INVOICE`: Represents an invoice issued to |
| fees | object | A mapping of fee type to fee amount, for example foreign transaction fees. |
| foreignExtensionId | string | This is an auto-generated ID that populates when the Accounting Entries API endpoints interact with other Pleo APIs. |
| grossBillValue | object | **DEPRECATED** Please use the Tax Calculation API instead. Bill value **before** taxes. Currency is the same as `transactionWalletValue` |
| id | string | The unique identifier of the specific accounting entry. |
| netBillValue | object | **DEPRECATED** Please use the Tax Calculation API instead. Bill value **after** taxes. Currency is the same as `transactionWalletValue` |
| note | string | An optional note that can be added to the accounting entry. |
| performedAt | string | The date and time when the transaction was performed. |
| receiptIds | array | IDs of any receipts associated with the specific accounting entry. |
| reconciliationId | string | The id of the specific reconciliation that was used to export and book this accounting entry. |
| reviewStatus | string | This can be one of `ReviewStatus` values. `NOT_OK`: The accounting entry has been reviewed as `Not OK`. `NOT_REQUIRED`: The accounting entry does not require review. `NOT_SET`: The accounting entry ha |
| settledAt | string | The date and time when the transaction was settled. For example in the case of a card purchase, the date when the transaction was finalized. |
| spendTransactionIds | array | A list of IDs of spend transactions associated with the specific accounting entry. |
| status | string | This can be one of `AccountingEntryStatus` values. `DRAFT`: The accounting entry is still in a work-in-progress stage; the details might change. `PENDING`: Payment is in progress. The transaction amou |
| subFamily | string | This can be one of `AccountingEntrySubFamily` values. `ATM`: A `CARD_PURCHASE` that was performed at an ATM. `IN_STORE`: A `CARD_PURCHASE` that was performed at a physical store. `ONLINE`: A `CARD_PUR |
| supplier | object | |
| taxBillValue | object | **DEPRECATED** Please use the Tax Calculation API instead. Specifies the tax amount. Currency is the same as `transactionWalletValue` |
| taxCodeId | string | A unique identifier that references the specific `TaxCode` applied to the specific accounting entry. |
| teamId | string | A unique identifier of the team to which the accounting entry belongs. For example, an accounting entry is associated with the Design team of a company. So, the entry specifies the Design Team ID |
| totalBillValue | object | The total amount that is either debited or credited from the Pleo wallet of the company. - Could be more than the `transactionWalletValue` as in a card purchase, payment processing fees are included. |
| transactionValue | object | The transaction amount in the specific currency the payment was performed. For example, an expense is incurred in France. So the value returned is in Euro ( EUR ). |
| transactionWalletValue | object | The transaction amount in the functional currency of the company. For example, a company is based in the United Kingdom. An employee incurs an expense in France. The `transactionWalletValue` is the am |
| updatedAt | string | Specifies the date and time when details of the specific accounting entry is modified. |
JSON Schema
{
"required": [
"companyId",
"createdAt",
"exportStatus",
"family",
"fees",
"id",
"performedAt",
"receiptIds",
"reviewStatus",
"status",
"transactionValue",
"updatedAt"
],
"type": "object",
"properties": {
"accountCode": {
"type": "string",
"description": "The account code allocated to the specific accounting entry. For example, an expense incurred for meals and drinks account would have a specific account code."
},
"accountId": {
"type": "string",
"description": "Unique identification number of the account (Category) allocated to the transaction. If `I don't know` is selected, then in the API endpoint response, `\"00000000-0000-0000-0000-000000000000\"` is returned, implying no category is yet selected for the specific accounting entry. ",
"format": "uuid"
},
"bookkeepingDate": {
"type": "string",
"description": "The date when the transaction was settled, except for out of pocket expenses; for out of pocket expense, the bookkeeping date is when the purchase was done.",
"format": "date-time"
},
"companyId": {
"type": "string",
"description": "The unique identifier of the company that to which the accounting entry belongs.",
"format": "uuid"
},
"createdAt": {
"type": "string",
"description": "The date and time when the specific accounting entry is created.",
"format": "date-time"
},
"deletedAt": {
"type": "string",
"description": "If the accounting entry is deleted, this field specifies the date and time of deletion.",
"format": "date-time"
},
"employeeId": {
"type": "string",
"description": "The unique identifier of the employee who incurred the expense.",
"format": "uuid"
},
"exportStatus": {
"type": "string",
"description": "This can be one of `ExportStatus` values.\n\n`CREATED`: The accounting entry has been created.\n`EXPORTED`: The accounting entry has been exported.\n`EXPORTING`: The accounting entry is in the process of being exported.\n`QUEUED`: The accounting entry is in the queue to be exported.\n",
"example": "CREATED"
},
"externalAccountId": {
"type": "string",
"description": "The external id of the account specified for this accounting entry.",
"format": "uuid"
},
"family": {
"type": "string",
"description": "This can be one of `AccountingEntryFamily` values.\n\n`BALANCE_AMENDMENT`: Represents manual wallet balance adjustments, often through human intervention.\n`BILL_INVOICE`: Represents an invoice issued to the company. If payment of the invoice is made via Pleo, the payment is recorded separately, using the `BILL_INVOICE_PAYMENT` family.\n`CARD_PURCHASE`: Represents a purchase made using a physical or virtual Pleo card.\n`CASHBACK`: An amount of money that is returned to the company through Pleo cashback.\n`CREDIT_NOTE`: Represents a credit note issued to the company, stored only in the accounting entry metadata table.\n`MILEAGE`: Represents a Mileage expense incurred by an employee. The amount is owed to the employee.\n`OUT_OF_POCKET`: Represents an amount that is spent by an employee out of their own pocket. The amount is owed to the employee.\n`OVERDRAFT`: Represents either the monthly subscription fee for using Pleo Overdraft, or a the interest incurred on an existing overdraft.\n`PER_DIEM`: Represents a daily allowance given to an employee during travel - the amount is owed to the employee.\n`PLEO_INVOICE`: Represents the SaaS invoice from Pleo to the company.\n`REIMBURSEMENT`: Represents a reimbursement from the company to the employee or vice-versa.\n`WALLET`: Represents a top up or withdrawal on the Pleo wallet\n`BILL_INVOICE_PAYMENT`: Represents a payment of an invoice from the company wallet.\n",
"example": "BALANCE_AMENDMENT"
},
"fees": {
"type": "object",
"additionalProperties": {
"description": "A mapping of fee type to fee amount, for example foreign transaction fees.",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"description": "A mapping of fee type to fee amount, for example foreign transaction fees."
},
"foreignExtensionId": {
"type": "string",
"description": "This is an auto-generated ID that populates when the Accounting Entries API endpoints interact with other Pleo APIs."
},
"grossBillValue": {
"description": "**DEPRECATED** Please use the Tax Calculation API instead. Bill value **before** taxes. Currency is the same as `transactionWalletValue`",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"id": {
"type": "string",
"description": "The unique identifier of the specific accounting entry.",
"format": "uuid"
},
"netBillValue": {
"description": "**DEPRECATED** Please use the Tax Calculation API instead. Bill value **after** taxes. Currency is the same as `transactionWalletValue`",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"note": {
"type": "string",
"description": "An optional note that can be added to the accounting entry."
},
"performedAt": {
"type": "string",
"description": "The date and time when the transaction was performed.",
"format": "date-time"
},
"receiptIds": {
"uniqueItems": true,
"type": "array",
"description": "IDs of any receipts associated with the specific accounting entry.",
"items": {
"type": "string",
"description": "IDs of any receipts associated with the specific accounting entry.",
"format": "uuid"
}
},
"reconciliationId": {
"type": "string",
"description": "The id of the specific reconciliation that was used to export and book this accounting entry.",
"example": "4113617"
},
"reviewStatus": {
"type": "string",
"description": "This can be one of `ReviewStatus` values.\n\n`NOT_OK`: The accounting entry has been reviewed as `Not OK`.\n`NOT_REQUIRED`: The accounting entry does not require review.\n`NOT_SET`: The accounting entry has not been reviewed yet.\n`OK`: The accounting entry has been reviewed as `OK`.\n`WAITING_FOR_EXPENSE_OWNER`: The accounting entry is waiting for more details from the Expense Owner.\n`WAITING_FOR_REVIEWER`: The accounting entry is waiting for review by a reviewer.\n`WAITING_FOR_COMPANY_REVIEWER`: The accounting entry is waiting for review by a company reviewer.\n`WAITING_FOR_TEAM_REVIEWER`: The accounting entry is waiting for review by a team reviewer.\n`WAITING_FOR_TAG_REVIEWER`: The accounting entry is waiting for review by a tag reviewer.\n",
"example": "NOT_OK"
},
"settledAt": {
"type": "string",
"description": "The date and time when the transaction was settled. For example in the case of a card purchase, the date when the transaction was finalized.",
"format": "date-time"
},
"spendTransactionIds": {
"uniqueItems": true,
"type": "array",
"description": "A list of IDs of spend transactions associated with the specific accounting entry.",
"items": {
"type": "string",
"description": "A list of IDs of spend transactions associated with the specific accounting entry.",
"format": "uuid"
}
},
"status": {
"type": "string",
"description": "This can be one of `AccountingEntryStatus` values.\n\n`DRAFT`: The accounting entry is still in a work-in-progress stage; the details might change.\n`PENDING`: Payment is in progress. The transaction amount in the specific currency is final, yet the funds have not\n yet been settled.> \u26a0\ufe0f **Note**: The customer can no longer cancel this expense.\n> amount/currency is fixed, funds have been reserved but not yet settled,\n> and expense can no longer be canceled by user\n`COMPLETED`: The transaction is complete, implying the funds have been settled for the final bill amount.\n`COMPLETED_EXTERNALLY`: Payment has completed *outside of Pleo*. Hence, it does not impact the Pleo wallet\n`CANCELLED`: Canceled by user, Pleo, or an external party\n`REJECTED`: Rejected by user, Pleo or an external party\n`ERROR`: An error prevented the accounting entry from being settled\n",
"example": "DRAFT"
},
"subFamily": {
"type": "string",
"description": "This can be one of `AccountingEntrySubFamily` values.\n\n`ATM`: A `CARD_PURCHASE` that was performed at an ATM.\n`IN_STORE`: A `CARD_PURCHASE` that was performed at a physical store.\n`ONLINE`: A `CARD_PURCHASE` that was performed online.\n`PLEO_INVOICE`: A `PLEO_INVOICE` that was paid.\n`PLEO_INVOICE_REFUND`: A `PLEO_INVOICE` that was refunded.\n`REIMBURSEMENT_TO_COMPANY`: A `REIMBURSEMENT` was made to the company.\n`REIMBURSEMENT_TO_EMPLOYEE`: A `REIMBURSEMENT` was made to the employee.\n`REIMBURSEMENT_TO_EMPLOYEE_REFUND`: A `REIMBURSEMENT` to the employee was refunded.\n`LOAD`: Either a `WALLET` or a BALANCE_AMENDMENT` load.\n`UNLOAD`: Either a `WALLET` or a BALANCE_AMENDMENT` unload - Money leaves the Pleo wallet.\n`WITHDRAWAL`: A `WALLET` withdrawal.\n`FEE`: A monthly fee paid for using overdraft.\n`INTEREST`: Interest paid for the amount over drafted.\n`BILL_INVOICE_PAYMENT_RETURNED`: A `BILL_INVOICE_PAYMENT` that was returned.\n`BILL_INVOICE_PAYMENT_RECEIVED`: A `BILL_INVOICE_PAYMENT` that was received.\n",
"example": "ATM"
},
"supplier": {
"$ref": "#/components/schemas/AccountingEntrySupplier"
},
"taxBillValue": {
"description": "**DEPRECATED** Please use the Tax Calculation API instead. Specifies the tax amount. Currency is the same as `transactionWalletValue`",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"taxCodeId": {
"type": "string",
"description": "A unique identifier that references the specific `TaxCode` applied to the specific accounting entry.",
"format": "uuid"
},
"teamId": {
"type": "string",
"description": "A unique identifier of the team to which the accounting entry belongs. For example, an accounting entry is associated with the Design team of a company. So, the entry specifies the Design Team ID",
"format": "uuid"
},
"totalBillValue": {
"description": "The total amount that is either debited or credited from the Pleo wallet of the company.\n- Could be more than the `transactionWalletValue` as in a card purchase, payment processing fees are included.\n- `BILL_INVOICE` includes scheduled payments. They are included in the `totalBillValue`, yet they do not impact the actual Pleo wallet balance.",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"transactionValue": {
"description": " The transaction amount in the specific currency the payment was performed. For example, an expense is incurred in France. So the value returned is in Euro ( EUR ).",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"transactionWalletValue": {
"description": "The transaction amount in the functional currency of the company. For example, a company is based in the United Kingdom. An employee incurs an expense in France. The `transactionWalletValue` is the amount in Great Britain Pound ( GBP ) equivalent to the Euro ( EUR ) spent for the purchase. ",
"allOf": [
{
"$ref": "#/components/schemas/Money"
}
]
},
"updatedAt": {
"type": "string",
"description": "Specifies the date and time when details of the specific accounting entry is modified.",
"format": "date-time"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "AccountingEntryCoreV6"
}