Building Blocks
O que são Building Blocks?
Building Blocks são módulos independentes que fornecem funcionalidades específicas para a construção de produtos financeiros. Cada Building Block possui sua própria API REST e pode ser utilizado de forma isolada ou em conjunto com outros módulos.
Building Blocks
| Building Block | Descrição |
|---|---|
| IAM | Gerenciamento de identidade e acesso (OAuth2, RBAC) |
| Customers | Cadastro e gestão de clientes (Pessoas e Empresas) |
| Products | Catálogo e configuração de produtos de crédito |
| File Storage | Armazenamento S3, presigned URLs e categorias |
| Decision Engine | Execução de regras de negócio via Camunda DMN |
| API Keys | Gerenciamento de chaves de API e quotas |
| Audit Trail | Logs de conformidade e trilha de auditoria |
| Billing | Faturamento, assinaturas e medição de uso |
| Calculations | Cálculo de parcelas, IOF, CET (Price/SAC) |
| Feature Flags | Alternância de recursos e segmentação |
| Decision Platform | Orquestração e histórico de decisões |
| Pricing Engine | Precificação baseada em risco e faixas |
| Webhooks Engine | Entrega de eventos com lógica de retry |
Building Blocks Futuros
Estes são building blocks planejados para complementar o ecossistema:
Gestão do Ciclo de Vida do Empréstimo
| Building Block | Descrição |
|---|---|
| Loan Servicing | Gestão de contratos, cronograma de pagamentos e amortização |
| Collections | Gestão de inadimplência e recuperação de crédito |
| Payments | Processamento de pagamentos (PIX, boleto, cartão) |
Onboarding e Análise
| Building Block | Descrição |
|---|---|
| KYC & Onboarding | Know Your Customer e processo de onboarding |
| Credit Analysis | Integração com bureaus de crédito (Serasa, SPC, Quod) |
| Document Verification | Validação e verificação de documentos com OCR |
Comunicação
| Building Block | Descrição |
|---|---|
| Notifications | Envio multicanal (Email, SMS, WhatsApp, Push) |
| Document Templates | Geração de documentos e contratos a partir de templates |
Compliance e Segurança
| Building Block | Descrição |
|---|---|
| Fraud Detection | Detecção e prevenção de fraudes em tempo real |
Gestão e Analytics
| Building Block | Descrição |
|---|---|
| Reports & Analytics | Relatórios e dashboards de performance |
| Credit Limits | Gestão de limites de crédito e pré-aprovações |
Processos e Garantias
| Building Block | Descrição |
|---|---|
| Workflow Engine | Orquestração de processos de negócio (BPMN) |
| Collateral Management | Gestão de garantias e colaterais |
Ambientes
Para detalhes sobre a topologia e acesso aos servidores, consulte o Guia de Ambientes.
| Ambiente | Base URL | Finalidade |
|---|---|---|
| Staging | https://*.stg.catalisa.app | Homologação e Testes |
| Production | https://api.catalisa.app | Produção |
Formato da API
Todas as APIs seguem o padrão JSON:API com a seguinte estrutura:
Request
{
"data": {
"type": "resource-type",
"attributes": {
"campo1": "valor1",
"campo2": "valor2"
}
}
}
Response
{
"data": {
"type": "resource-type",
"id": "uuid",
"attributes": {
"campo1": "valor1",
"campo2": "valor2"
},
"links": {
"self": "/api/v1/resource/uuid"
}
}
}
Próximos Passos
- Guia de Início Rápido - Aprenda a fazer sua primeira requisição
- Autenticação - Entenda como autenticar suas requisições
- Tratamento de Erros - Conheça os códigos de erro da API