Transaction Category

Quick Links

Accounts Accounting Entries Products Customers Sales quotes Sales invoices Suppliers Purchase invoices

HTTP	Operation	Type	Object
POST	List	Query	`transactioncategories`

Description

Configuration of accounting transaction categories used to classify accounting operations.
The Transaction Categories resource allows you to retrieve all available categories and their settings.

Set up to classify purchase and expense transactions linked to suppliers.
Set up to classify bank transactions not linked to customers or suppliers.
Set up to record adjustment transactions used during bank reconciliation, such as currency exchange differences or miscellaneous accounting adjustments.

How to retrieve purchase transaction categories?

GraphQL Query

query {
  transactionCategories(
    where: {
      type: { eq: PURCHASE }
    }
  ) {
    edges {
      node {
        id
        reason
        accountingAccountId
        accountingAccount {code name}
        taxTreatmentId
        taxTreatment {taxCode}
        type
        createdByDefault
        disabled
        default
      }
    }
  }
}

Example Response (type = PURCHASE)

{
  "data": {
    "transactionCategories": {
      "edges": [
        {
          "node": {
            "id": "02d964fa-24f5-4953-81e1-a974fa572328",
            "reason": "Entretien et réparations des locaux",
            "accountingAccountId": "51d78706-4721-4f2f-a257-3b8c2dc7ee0b",
            "accountingAccount": {
              "code": "615000",
              "name": "Entretien et réparations"
            },
            "taxTreatmentId": "40904303-5c02-4784-a505-9c0325b7a40f",
            "taxTreatment": {
              "taxCode": "C0005"
            },
            "type": "PURCHASE",
            "createdByDefault": true,
            "disabled": false,
            "default": false
          }
        },
        {
          "node": {
            "id": "045c83ad-f992-4f52-b71c-9994e2ce250a",
            "reason": "Audit",
            "accountingAccountId": "51d78706-46dd-4f2f-a257-3b8c2dc7ee0b",
            "accountingAccount": {
              "code": "622600",
              "name": "Honoraires"
            },
            "taxTreatmentId": "40904303-5c02-4784-a505-9c0325b7a40f",
            "taxTreatment": {
              "taxCode": "C0005"
            },
            "type": "PURCHASE",
            "createdByDefault": true,
            "disabled": false,
            "default": false
          }
        },
        {
          "node": {
            "id": "05101b46-5ca7-4867-ac40-e31350926226",
            "reason": "Achats intracommunautaires",
            "accountingAccountId": "51d78706-4999-4f2f-a257-3b8c2dc7ee0b",
            "accountingAccount": {
              "code": "601090",
              "name": "Achats intracommunautaires"
            },
            "taxTreatmentId": "80b4ba02-3459-4472-9233-5dc778efebe7",
            "taxTreatment": {
              "taxCode": "C0036"
            },
            "type": "PURCHASE",
            "createdByDefault": true,
            "disabled": false,
            "default": false
          }
        },
        // ..............
      ]
    }
  }
}

Key	Value
`Authorization`	Bearer Current access Token How to find?
~~`X-TenantId`~~ DeprThis field is now deprecated, and we recommend using an alternative solution	Current tenant id Why deprecated ?
`X-OrganizationId`	Current organization Id How to find?
`x-api-key`	Primary or secondary subscription key of your app How to find?

transactioncategories

Fields	Type	Description
idSSystem field that cannot be assigned	UUID	Id
creationDateSSystem field that cannot be assigned	DateTime	Creation Date
modificationDateSSystem field that cannot be assigned	DateTime	Modification Date

reason *The value of the field or object is mandatory	String	Optional reason associated with the category
type *The value of the field or object is mandatory	NOT_SPECIFIED ADJUSTMENTS NON_INVOICE PURCHASE	Category type See InfoAdditional information is available in the Info block below
default *The value of the field or object is mandatory	Boolean	Indicates if the category is the default one
createdByDefault *The value of the field or object is mandatory	Boolean	Indicates if the category was system-generated
disabled *The value of the field or object is mandatory	Boolean	Indicates if the category is disabled
disabledDate *The value of the field or object is mandatory	DateTime	Date when the category was disabled

accountingAccount DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	AccountingAccount	Fields of AccountingAccount
accountingAccountId	UUID	Id of accountingAccount

taxTreatment DATALOADERUtilize the DATALOADER feature to enrich your query by adding additional resource fields directly in the query.	TaxTreatment	Fields of TaxTreatment
taxTreatmentId	UUID	Id of taxTreatment

Info

type: Category classification used to drive business rules and UI grouping.
- PURCHASE - Used to classify purchase and expense transactions linked to suppliers.
- NON_INVOICE - Used to classify bank transactions not linked to customers or suppliers.
- ADJUSTMENTS - Used to record adjustment transactions during bank reconciliation, such as currency exchange differences or miscellaneous accounting adjustments.