Motores — Visão geral

Os motores (engines) de crédito e de decisão são automações de análise que rodam através da Taktile, uma plataforma externa de motores de decisão. Cada motor é configurado num flow para classificar clientes e cards a partir de uma política — o conjunto de regras, cálculos e critérios definidos na Taktile.

O motor de decisão classifica um cliente em módulos temáticos (por exemplo, cadastro, compliance, restrições de crédito), retornando um resultado ilustrativo por campo (como 🟢/🟡/🔴).

O motor de crédito calcula uma pontuação (score), uma classificação de risco (rating) e, opcionalmente, um valor sugerido/liberado (value), além de um detalhamento por critérios em output[].

Ambos seguem o mesmo fluxo de vida: uma política é registrada na Taktile, depois vinculada a uma configuração de motor no flow (policyId), e então executada sobre cards e clientes específicos.

Endpoints deste domínio

Execução sobre o card

Método	Caminho	Descrição
`GET`	`/v1/cards/{cardId}/actions/decision-engine/clients/{clientId}`	Consulta o resultado do motor de decisão para o cliente
`POST`	`/v1/cards/{cardId}/actions/decision-engine/clients/{clientId}`	Executa o motor de decisão para o cliente
`GET`	`/v1/cards/{cardId}/actions/credit-engine/policies/{policyId}/clients/{clientId}/inputs`	Consulta os inputs que seriam enviados ao motor de crédito, sem executar
`GET`	`/v1/cards/{cardId}/actions/credit-engine/policies/{policyId}/clients/{clientId}`	Consulta o resultado do motor de crédito para o cliente
`POST`	`/v1/cards/{cardId}/actions/credit-engine/policies/{policyId}/clients/{clientId}`	Executa o motor de crédito para o cliente

Configuração do motor de decisão

Método	Caminho	Descrição
`GET`	`/v1/flows/{flowId}/decision-engine-config`	Consulta a configuração do motor de decisão do flow
`POST`	`/v1/flows/{flowId}/decision-engine-config`	Cria a configuração do motor de decisão
`PUT`	`/v1/flows/{flowId}/decision-engine-config/{id}`	Atualiza a configuração do motor de decisão
`DELETE`	`/v1/flows/{flowId}/decision-engine-config/{id}`	Remove a configuração do motor de decisão

Configuração do motor de crédito e políticas

Método	Caminho	Descrição
`GET`	`/v1/flows/credit-engine-config/{id}`	Consulta o detalhe completo de uma configuração do motor de crédito
`POST`	`/v1/flows/{flowId}/credit-engine-config`	Cria a configuração do motor de crédito
`PUT`	`/v1/flows/{flowId}/credit-engine-config/{id}`	Atualiza a configuração do motor de crédito
`DELETE`	`/v1/flows/{flowId}/credit-engine-config/{id}`	Remove a configuração do motor de crédito
`GET`	`/v1/flows/{flowId}/credit-engine/policies`	Lista as configurações do motor de crédito registradas no flow
`GET`	`/v1/flows/{flowId}/credit-engine/policies/cards/{cardId}/clients/{clientId}`	Lista as políticas de crédito aplicáveis a um card e cliente específicos

Atenção: dois identificadores diferentes chamados "policyId"

Este é o comportamento mais confuso do domínio, e vale a leitura atenta antes de qualquer chamada de execução ou consulta do motor de crédito sobre um card.

O caminho dos três endpoints de execução/consulta do motor de crédito sobre um card usa um segmento {policyId}:

/v1/cards/{cardId}/actions/credit-engine/policies/{policyId}/clients/{clientId}[/inputs]

Apesar do nome do segmento, esse valor não é o identificador (UUID) da política Taktile — o mesmo que aparece no campo policyId do corpo salvo da configuração do motor (credit-engine-config). Ele é, na verdade, o identificador da própria configuração do motor de crédito no flow: um ObjectId no formato do MongoDB, com 24 caracteres hexadecimais.

Enviar o identificador errado (por exemplo, o UUID da política Taktile) nesse caminho retorna erro 400 de validação.

Antes de chamar qualquer um desses três endpoints, obtenha o identificador correto em GET /v1/flows/{flowId}/credit-engine/policies — use o campo id de cada item retornado. O motor de decisão não tem esse problema: seu caminho de execução sobre o card (/v1/cards/{cardId}/actions/decision-engine/clients/{clientId}) não inclui identificador de política.

Sandbox e publicação em produção

Toda política registrada na Taktile — de crédito ou de decisão — nasce em ambiente de testes (sandbox). Antes de processar cards reais em produção, a política correspondente precisa ser publicada. Sem essa publicação, o motor pode até responder às chamadas, mas não reflete decisões reais sobre os dados do card.

Comportamentos importantes

Regras opostas entre motor de crédito e motor de decisão no nível raiz do payload. A configuração do motor de crédito (credit-engine-config) EXIGE os campos title, description e hasValue no nível raiz, tanto na criação quanto na atualização. A configuração do motor de decisão (decision-engine-config) REJEITA esses mesmos campos title e description — enviá-los retorna erro 400.

companyId é obrigatório na criação e proibido na atualização, em ambos os motores (crédito e decisão). Enviá-lo no PUT retorna erro 400.

O campo path em output[].fields[] do motor de decisão se comporta de forma oposta entre criar e atualizar: obrigatório na criação (use o valor literal generate para campos calculados automaticamente), e deve ser omitido na atualização.

Os campos de saída do motor de crédito (output[].segments[].fields[]) nunca têm path — apenas os itens de aggregates[], quando presentes, têm path, apontando para a origem de cada valor agregado.

Os campos nativos score, rating e value do motor de crédito são calculados automaticamente pelo motor em tempo de execução — não devem ser incluídos em output[].segments[].fields[].

As chaves (key) usadas em input[] e output[] de ambos os motores devem corresponder exatamente às chaves declaradas na política Taktile no momento do registro — o motor rejeita, na execução, chaves de configuração que a política não declarou.

GET /v1/flows/{flowId}/decision-engine-config retorna 200 com corpo vazio ({}) quando o flow ainda não tem motor de decisão configurado, em vez de um código de erro.

GET /v1/flows/credit-engine-config/{id} tem uma forma de caminho diferente dos demais endpoints deste domínio: não inclui o identificador do flow — é /v1/flows/credit-engine-config/{id}, e não /v1/flows/{flowId}/credit-engine-config/{id}.

Remover a configuração de um motor não remove automaticamente a ação de fase (credit-engine ou decision-engine) que a habilita numa fase — recomendamos revisar e remover essa ação de fase antes ou logo após a remoção da configuração.

Motores — Visão Geral

Motores — Visão geral#

Endpoints deste domínio#

Execução sobre o card#

Configuração do motor de decisão#

Configuração do motor de crédito e políticas#

Atenção: dois identificadores diferentes chamados "policyId"#

Sandbox e publicação em produção#

Comportamentos importantes#