Expense information | Amnis API Docs

📄️ Retrieve a single expense category

This API endpoint is tailored to retrieve detailed information about an individual expense category, serving as a valuable tool for accessing specific expense category data within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Retrieve a collection of expense categories

This API endpoint is designed to retrieve a collection of expense categories, providing a valuable tool for accessing recent expense category data for an account within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Create an expense category

This endpoint is intended to create a new expense category. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission. Request Body: <ul> <li>name: The name of the category. Multiple categories with the same name cannot be added.</li> <li>accountingAccountNumber: Optional.</li> <li>externalId: Optional. The identifier in the external accounting program. Multiple categories with the same name cannot be added.</li><li>allowedTransactionTypes: Optional. Defines which type of transactions can be attached to this category. Multiple choices can be added.</li><li>allowedCardGroups: Optional. Defines which card groups can be attached to this category. Multiple choices can be added.</li></ul>

📄️ Retrieve a single expense cost center

This API endpoint is tailored to retrieve detailed information about an individual expense cost center, serving as a valuable tool for accessing specific expense cost center data within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Retrieve a collection of expense cost centers

This API endpoint is designed to retrieve a collection of expense cost centers, providing a valuable tool for accessing recent expense cost center data for an account within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Create an expense cost center

This endpoint is intended to create a new expense cost center. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission. Request Body: <ul> <li>name: The name of the cost center. Multiple cost centers with the same name and number combination cannot be added.</li> <li>number: Optional.</li><li>allowedTransactionTypes: Optional. Defines which type of transactions can be attached to this category. Multiple choices can be added.</li><li>allowedCardGroups: Optional. Defines which card groups can be attached to this category. Multiple choices can be added.</li></ul>

📄️ Retrieve a single expense VAT

This API endpoint is tailored to retrieve detailed information about an individual expense VAT, serving as a valuable tool for accessing specific expense VAT data within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Retrieve a collection of expense VAT rates

This API endpoint is designed to retrieve a collection of expense VAT rates, providing a valuable tool for accessing recent expense VAT rates data for an account within your system. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

📄️ Create an expense VAT

This endpoint is intended to create a new expense VAT. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission. Request Body: <ul> <li>name: The name of the VAT. Multiple VATs with the same name cannot be added.</li> <li>value: Required.</li><li>externalId: Optional.</li><li>importTax: Optional.</li></ul>

📄️ Toggle expense completion for a transaction

This endpoint is intended to mark a card transaction expense as completed or reset it to draft. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission. Request Body: <ul> <li>markAsComplete: Boolean flag to set expense completion.</li></ul> Validation Errors: Responses return status 422 with an errors array containing field, code, and message. Possible code values include: <ul> <li>transaction.type.not_supported</li> <li>input.mark_as_complete.not_valid</li> <li>expense.category.required</li> <li>expense.cost_center.required</li> <li>expense.vat.required</li> <li>expense.receipt.required</li> <li>expense.vat.not_valid</li> <li>invalid</li></ul>

📄️ Update expense information for a transaction

This endpoint is intended to update expense information for an existing card transaction. Prerequisites: To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission. Request Body: <ul> <li>category: Expense category IRI.</li> <li>costCenter: Expense cost center IRI.</li> <li>vatRate: Array of 1-3 VAT rates.</li> <li>vatAmount: Array of 1-3 VAT gross amounts.</li> <li>note: Optional comment.</li></ul> Async Notice: Expense completion is calculated asynchronously. The expenseCompletedAt value in the response may reflect the last stored state and update shortly after processing. Validation Errors: Responses return status 422 with an errors array containing field, code, and message. Possible code values include: <ul> <li>transaction.type.not_supported</li> <li>input.category.not_valid</li> <li>input.cost_center.not_valid</li> <li>input.vat_rate.not_valid</li> <li>input.vat_amount.not_valid</li> <li>input.comment.not_valid</li> <li>expense.vat.not_valid</li> <li>expense.category.transaction_type_not_allowed</li> <li>expense.cost_center.transaction_type_not_allowed</li> <li>expense.category.card_group_not_allowed</li> <li>expense.cost_center.card_group_not_allowed</li> <li>invalid</li></ul>