Procurando a documentação anterior?Acesse v1.docs.pluggy.ai
PluggyDocs
POST/categories/rules

Criar Regra de Categoria

Criar uma regra de categoria única

Criar Regras de Categoria requer apenas o envio do categoryId que você pode recuperar da lista de Categorias.

Exemplo de criação de uma regra:

json
{
    "description": "Mc Donalds",
    "categoryId": "11010000"
}

Request Body

required
object

Criar regra de categoria de cliente

descriptionrequiredstring

Descrição da regra de transação.

categoryIdrequiredstring

Identificador da categoria

transactionTypestring

Tipo de transação (DÉBITO/CREDITO)

accountTypestring

Tipo de conta (CHECKING_ACCOUNT/CREDIT_CARD)

matchTypestring

Tipo de correspondência usada para identificar a regra (exato/contém/começaCom/terminaCom), se não fornecido, o padrão é 'exato'

Example

json
{
  "description": "uber payment",
  "categoryId": "05000000",
  "transactionType": "DEBIT",
  "accountType": "CHECKING_ACCOUNT"
}

Responses

200Cria uma Regra de Categoria e recupera o resultado
object

Regra de categoria por ID do cliente

idrequiredstring (uuid)

Identifier of the rule. Use it to delete the rule with DELETE /categories/rules/{id}.

descriptionrequiredstring

Descrição da regra de transação.

categoryIdstring

Identificador da categoria

categoryrequiredstring

Descrição da categoria

clientIdstring

Identificador do cliente

transactionTypestring

Tipo de transação (DÉBITO/CREDITO)

accountTypestring

Tipo de conta (CHECKING_ACCOUNT/CREDIT_CARD)

matchTypestring

How the rule description is matched against the transaction description. Defaults to 'exact'.

exactcontainsstartsWithendsWith

Example response

json
{
  "id": "d5c3f6a2-7b1e-4f0c-9a8d-2e6b1c4f7a90",
  "description": "uber payment",
  "category": "Salary/pro-labore",
  "categoryId": "05000000",
  "clientId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
  "transactionType": "DEBIT",
  "accountType": "CHECKING_ACCOUNT",
  "matchType": "exact"
}
curl -X POST \
'https://api.pluggy.ai/categories/rules' \
-H 'Content-Type: application/json' \
-H 'X-API-KEY: YOUR_API_KEY' \
-d '{ "description": "uber payment", "categoryId": "05000000", "transactionType": "DEBIT", "accountType": "CHECKING_ACCOUNT" }'
Resposta de exemplo
{
"id": "d5c3f6a2-7b1e-4f0c-9a8d-2e6b1c4f7a90",
"description": "uber payment",
"category": "Salary/pro-labore",
"categoryId": "05000000",
"clientId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
"transactionType": "DEBIT",
"accountType": "CHECKING_ACCOUNT",
"matchType": "exact"
}