Products

O Building Block Products fornece funcionalidades para configuração de produtos de crédito na Catalisa Platform.

Visão Geral

O módulo Products e tenant-scoped e permite:

• Configurar produtos de empréstimo
• Definir taxas de juros (min/max)
• Configurar limites de valores e parcelas
• Especificar método de amortização
• Gerenciar tarifas e encargos

Base URL

https://api.catalisa.io/products

Recursos

Recurso	Descrição
Produtos	Configuração de produtos de crédito

Endpoints

Método	Endpoint	Descrição	Permissão
POST	/api/v1/products	Criar produto	PRODUCTS_CREATE
GET	/api/v1/products	Listar produtos	PRODUCTS_READ
GET	/api/v1/products/:id	Obter produto	PRODUCTS_READ
PATCH	/api/v1/products/:id	Atualizar produto	PRODUCTS_UPDATE
DELETE	/api/v1/products/:id	Excluir produto	PRODUCTS_DELETE

Tipos de Produto

Tipo	Descrição
PERSONAL_LOAN	Empréstimo pessoal
PAYROLL_LOAN	Empréstimo consignado
VEHICLE_LOAN	Financiamento de veiculo
HOME_EQUITY	Home equity
CREDIT_CARD	Cartao de crédito
WORKING_CAPITAL	Capital de giro
INVOICE_FINANCING	Antecipação de recebiveis

Métodos de Amortização

Método	Descrição
PRICE	Tabela Price - parcelas fixas
SAC	Sistema de Amortização Constante

Estrutura de Dados

Produto

{
  "data": {
    "type": "products",
    "id": "uuid",
    "attributes": {
      "name": "Empréstimo Pessoal Standard",
      "productType": "PERSONAL_LOAN",
      "description": "Empréstimo pessoal para clientes CLT",
      "active": true,
      "minAmount": { "amount": 1000, "currency": "BRL" },
      "maxAmount": { "amount": 50000, "currency": "BRL" },
      "minInterestRate": 0.0199,
      "maxInterestRate": 0.0599,
      "minInstallments": 6,
      "maxInstallments": 48,
      "registrationTariffRate": 0.02,
      "insuranceRate": 0.003,
      "iofAdditionalRate": 0.0038,
      "iofDailyRate": 0.000082,
      "amortizationMethod": "PRICE"
    }
  }
}

Taxas e Encargos

Campo	Descrição	Exemplo
minInterestRate	Taxa de juros minima (mensal)	0.0199 = 1.99%
maxInterestRate	Taxa de juros maxima (mensal)	0.0599 = 5.99%
registrationTariffRate	Taxa de cadastro (sobre principal)	0.02 = 2%
insuranceRate	Taxa de seguro (mensal)	0.003 = 0.3%
iofAdditionalRate	IOF adicional	0.0038 = 0.38%
iofDailyRate	IOF diario	0.000082

informação

Todas as taxas são expressas em decimal (0-1), onde 0.01 = 1%.