Financial Institutions
Instituições financeiras, o vínculo de cada CNPJ do grupo com uma IF e as credenciais técnicas desse vínculo.
A instituição financeira (IF) é global. O que é do tenant é o vínculo de um CNPJ do grupo com a IF
(financial_institution_accounts). As credenciais técnicas, usadas pelo sistema para falar com a IF, pertencem a esse
vínculo e não a uma loja; um vínculo pode ter várias.
Tabelas (3)
| Tabela | Para quê |
|---|---|
financial_institutions | Catálogo global de IFs, com código opcional e único. |
financial_institution_accounts | Vínculo de um CNPJ do tenant com uma IF; único por par (CNPJ, IF). |
financial_institution_credentials | Credencial técnica de um vínculo CNPJ × IF, por ambiente, no mesmo tenant do vínculo. |
Referência
financial_institutions
Catálogo global de IFs, com código opcional e único.
| Coluna | Tipo | Nulo | Observação |
|---|---|---|---|
id | bigint | não | identity (GENERATED ALWAYS) |
name | text | não | |
code | text | sim | |
disabled_at | timestamptz | sim | |
created_at | timestamptz | não | padrão clock_timestamp() |
updated_at | timestamptz | não | padrão clock_timestamp() |
Chaves estrangeiras
- nenhuma
Referenciada por: financial_institution_accounts, financial_institution_products, store_codes, user_banks.
Garantido pelo banco
| Tipo | Nome | Definição |
|---|---|---|
| PK | financial_institutions_pkey | PRIMARY KEY (id) |
| UNIQUE | financial_institutions_code_unique | UNIQUE (code) |
Fora do banco
- Nenhuma regra registrada além das constraints acima.
financial_institution_accounts
Vínculo de um CNPJ do tenant com uma IF; único por par (CNPJ, IF).
| Coluna | Tipo | Nulo | Observação |
|---|---|---|---|
id | bigint | não | identity (GENERATED ALWAYS) |
tenant_id | bigint | não | |
tenant_account_id | bigint | não | |
financial_institution_id | bigint | não | |
status | text | não | padrão 'draft' |
created_at | timestamptz | não | padrão clock_timestamp() |
updated_at | timestamptz | não | padrão clock_timestamp() |
Chaves estrangeiras
(tenant_account_id, tenant_id)→tenant_accounts (id, tenant_id)(mesmo tenant)financial_institution_id→financial_institutions.id
Referenciada por: financial_institution_account_products, financial_institution_credentials, store_codes, team_financial_institution_accounts.
Garantido pelo banco
| Tipo | Nome | Definição |
|---|---|---|
| PK | financial_institution_accounts_pkey | PRIMARY KEY (id) |
| UNIQUE | financial_institution_accounts_account_institution_key | UNIQUE (tenant_account_id, financial_institution_id) |
| UNIQUE | financial_institution_accounts_id_institution_tenant_key | UNIQUE (id, financial_institution_id, tenant_id) |
| UNIQUE | financial_institution_accounts_id_tenant_key | UNIQUE (id, tenant_id) |
Fora do banco
status(padrãodraft) não tem CHECK de valores.
financial_institution_credentials
Credencial técnica de um vínculo CNPJ × IF, por ambiente, no mesmo tenant do vínculo.
| Coluna | Tipo | Nulo | Observação |
|---|---|---|---|
credential_id | bigint | não | |
financial_institution_account_id | bigint | não | |
environment | text | não | |
label | text | não | |
created_at | timestamptz | não | padrão clock_timestamp() |
revoked_at | timestamptz | sim | |
tenant_id | bigint | não | credencial técnica dentro do tenant |
Chaves estrangeiras
(financial_institution_account_id, tenant_id)→financial_institution_accounts (id, tenant_id)(mesmo tenant)credential_id→credentials.idfinancial_institution_account_id→financial_institution_accounts.id
Garantido pelo banco
| Tipo | Nome | Definição |
|---|---|---|
| PK | financial_institution_credentials_pkey | PRIMARY KEY (credential_id) |
Fora do banco
environmentnão tem CHECK de valores.