Classificação de Transações

A categorização de transações é um recurso onde classificamos suas Transações em categorias úteis (Restaurantes, Postos de Gasolina, Renda, etc.) usando nosso motor de IA de categorização. Isso permite que você resuma, agrupe e extraia rapidamente insights valiosos das transações dos seus itens logo de cara.

Por exemplo, você poderia entender quanto um usuário gastou no mês passado em alimentação, quanto em serviços, e assim por diante, e com isso mostrar a eles um resumo de suas despesas (como em nosso guia Criando um caso de uso do zero), ou você pode usá-lo para criar qualquer tipo de soluções, desde perfil de cliente até análise de renda.

Usando a categorização#

Retornamos o resultado da nossa categorização no campo category de uma transação, esta é a categoria principal correspondente ao nosso modelo.

{
    "id": "6ec156fe-e8ac-4d9a-a4b3-7770529ab01c",
    "description": "TED Example",
    "amount": 1500,
    "date": "2021-04-12T00:00:00.000Z",
    // O nome da categoria é fornecido
    "category": "Transfer - TED",
    "categoryId": "05080000",
    ...
}

A categoria será uma string se uma categoria foi encontrada, ou null se não conseguimos interpretar nenhuma categoria conhecida.

Recurso de Teste/Premium

A categorização está habilitada por padrão durante o período de teste. Depois disso, é um recurso premium opcional.

Se você não tiver o recurso de categorização de transações habilitado, category será null para todas as transações.

Como as categorias são organizadas#

Veja todas as categorias possíveis em nosso endpoint GET /categories. Podemos encontrar a categoria da transação nesta lista com seu categoryId:

[
  {
    "id": "05080000",
    "description": "Transfer - TED",
    "descriptionTranslated": "Transferencia - TED",
    "parentId": "05000000",
    "parentDescription": "Transfers"
  },
  ...
]

Podemos ver sua tradução para o português no campo descriptionTranslated.

Você pode notar que tem uma parentDescription Transfers. Isso significa que está sob uma categoria mais geral chamada Transfers:

[
  ...
  {
    "id": "05000000",
    "description": "Transfers"
  },
  ...
]

As categorias são organizadas em uma árvore. Isso permite que você use categorias mais gerais ou específicas, dependendo de suas necessidades particulares. A Árvore de Categorias é detalhada no final deste guia.

Precisão da categoria#

Por mais que constantemente treinem nosso modelo de categorização, a categorização nunca é perfeita. Caso você encontre uma categoria errada em uma transação, você pode corrigi-la usando nosso endpoint Transaction Update, ou do Demo clicando no campo Category.

Depois de enviar uma correção de categoria, você receberá o campo category corrigido na transação e também fornecerá feedback sobre a anotação correta em nosso modelo, melhorando ainda mais a qualidade da categorização.

Regras de Categoria#

A Pluggy trabalha na melhoria contínua da precisão da categorização, para fornecer os melhores rótulos do mercado, mas às vezes podemos retornar rótulos que não estão alinhados às expectativas do cliente. As regras de categoria permitem que os clientes adicionem suas próprias regras antes da nossa solução de rotulagem e forneçam feedback instantâneo ao nosso modelo, que pode ser estabelecido como um ponto de dados em nosso modelo de ML.

As Regras de Categoria serão usadas no início do processo, para rotular as transações com a categoria desejada. Essas regras têm uma correspondência exata insensível com as informações fornecidas para categorizar. As Regras de Categoria são específicas do cliente e são válidas apenas para um client_id específico.

Transações que são recategorizadas criarão automaticamente uma Regra de Categoria para o cliente da transação.

Para mais informações, visite nossa API Reference.

Árvore de Categorias#