Skip to content

Commit 29377e4

Browse files
committed
Merge branch 'master' into ORB-486
1 parent 8d01776 commit 29377e4

39 files changed

+1180
-1814
lines changed

README.md

+13-7
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
1-
![Build](https://github.com/openbanking-brasil/draft-openapi/workflows/Build/badge.svg)
2-
![Stoplight](https://github.com/openbanking-brasil/draft-openapi/workflows/Stoplight/badge.svg)
3-
# draft-openapi
4-
This repository provides the necessary support for API management in Draft an Release Candidate stages
1+
![Build](https://github.com/openbanking-brasil/areadesenvolvedor/workflows/Build/badge.svg)
2+
![Stoplight](https://github.com/openbanking-brasil/areadesenvolvedor/workflows/Stoplight/badge.svg)
3+
# Repositório Open Banking Brasil
4+
5+
aRepositório para documentação e requisitos das APIs regulatórias do Open Banking Brasil.
6+
7+
## O que é?
8+
9+
O Open Banking, ou sistema financeiro aberto, é a possibilidade de clientes de produtos e serviços financeiros permitirem o compartilhamento de suas informações entre diferentes instituições autorizadas pelo Banco Central e a movimentação de suas contas bancárias a partir de diferentes plataformas e não apenas pelo aplicativo ou site do banco, de forma segura, ágil e conveniente.
10+
11+
Mais informações em: https://www.bcb.gov.br/estabilidadefinanceira/openbanking
12+
513

614
## Diretórios
715

816
- ### / swagger-apis
9-
Contains the last versions and the older versions of specifications (OAS 3.0) of Open Banking APIs.
10-
- ### / dictionary
11-
Contains the dictionaries of last APIs versions.
17+
Contém as ultimas versões e as versões anteriores das especificações (OAS 3.0) das APIs do Open Banking.

dictionary/customersGetPersonalFinancialRelations_v1.csv

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ OUTROS";1;12;"";Não permitido;array;SEGURO
2121
Representante legal - Nome Civil completo da Pessoa Natural que represente uma entidade ou uma empresa e é nomeado em seu ato constitutivo, ou seja, no contrato social ou estatuto social.
2222
Procurador - é qualquer pessoa que represente a Pessoa Natural em algum negócio, mediante autorização escrita do mesmo.";Texto;19;Obrigatório;;"REPRESENTANTE_LEGAL
2323
PROCURADOR
24-
NAO_SE_APLICA";1;1;"";Não permitido;string;PROCURADOR
24+
NAO_APLICA";1;1;"";Não permitido;string;PROCURADOR
2525
/data/procurators/cpfNumber;cpfNumber;Número completo do CPF. O CPF é o Cadastro de Pessoa natural. Ele é um documento feito pela Receita Federal e serve para identificar os contribuintes. O CPF é uma numeração com 11 dígitos, que só mudam por decisão judicial. O documento é emitido pela receita federal;Texto;11;Obrigatório;^\d{11}$|^NA$;;1;1;"";Não permitido;string;73677831148
2626
/data/procurators/civilName;civilName;Nome civil completo da pessoa natural. (Direito fundamental da pessoa, o nome civil é aquele atribuído à pessoa natural desde o registro de seu nascimento, com o qual será identificada por toda a sua vida, bem como após a sua morte);Texto;70;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Elza Milena Stefany Teixeira
2727
/data/procurators/socialName;socialName;Nome social da pessoa natural, se houver. (aquele pelo qual travestis e transexuais se reconhecem, bem como são identificados por sua comunidade e em seu meio social, conforme Decreto Nº 51.180, de 14 de janeiro de 2010);Texto;70;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Carlos

dictionary/investmentsGetFixedIncomeBank_v1.csv

+1-1
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ OUTROS";1;1;"";Não permitido;string;CDI
3737
/data/investmentConditions/minimumAmount;minimumAmount;Valor mínimo de aplicação no ativo.;Texto;19;Obrigatório;^\d{1,16}\.\d{2}$;;1;1;"";Não permitido;string;100.00
3838
/data/investmentConditions/redemptionTerm;redemptionTerm;Capacidade de conversão do título em dinheiro (resgate ou recompra).<br><br><ol><li>diária</li><li>na data de vencimento</li><li>diária após prazo de carência</li></ol>;Texto;29;Obrigatório;;"DIARIA
3939
DATA_VENCIMENTO
40-
DIARIA_APOS_PRAZO_CARENCIA";1;1;"";Não permitido;string;DIARIA
40+
DIARIA_PRAZO_CARENCIA";1;1;"";Não permitido;string;DIARIA
4141
/data/investmentConditions/minimumExpirationTerm;minimumExpirationTerm;Prazo mínimo referente ao vencimento do título;Número;;Obrigatório;;;1;1;"";Não permitido;number;30
4242
/data/investmentConditions/maximumExpirationTerm;maximumExpirationTerm;Prazo máximo referente ao vencimento do título;Número;;Obrigatório;;;1;1;"";Não permitido;number;720
4343
/data/investmentConditions/minimumGracePeriod;minimumGracePeriod;Prazo mínimo da carência, ou seja, quando passa a ser possível resgatar o investimento;Número;;Obrigatório;;;1;1;"";Não permitido;number;5

dictionary/investmentsGetFunds_v1.csv

+7-3
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,12 @@
88
/data/name;name;Nome oficial do fundo de investimento.;Texto;250;Obrigatório;;;1;1;"";Não permitido;string;FUNDO DE INVESTIMENTO EM COTAS DE FUNDOS DE INVESTIMENTO
99
/data/cnpjNumber;cnpjNumber;CNPJ do fundo de investimento.;Texto;14;Obrigatório;^\d{14}$;;1;1;"";Não permitido;string;64108803000191
1010
/data/isinCode;isinCode;"Código universal que identifica cada valor mobiliário ou instrumento financeiro, conforme Norma ISO 6166.<br><br>DEFINIÇÃO&#58;O ISIN (International Securities Identification Number) é um código que identifica um valor mobiliário, conforme a norma ISO 6166.<br>ESTRUTURA<br>O ISIN é um código alfanumérico que possui 12 caracteres com a seguinte estrutura&#58;<ul><li>um prefixo, composto de 2 caracteres alfa, que identifica o código do país (Norma ISO 3166);</li><li>o número básico, composto de 9 caracteres alfabéticos ou numéricos em sua extensão;</li><li>um dígito numérico de controle.</li></ul>";Texto;12;Opcional;^[A-Z]{2}([A-Z0-9]){9}\d{1}$;;0;1;"";Não permitido;string;BRAAAAAAA000
11-
/data/admin;admin;"";"";;Obrigatório;;;1;1;"";Não permitido;;
12-
/data/fundManager;fundManager;"";"";;Obrigatório;;;1;1;"";Não permitido;;
11+
/data/admin;admin;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
12+
/data/admin/name;name;Razão social da pessoa jurídica autorizada pela CVM para o exercício de administrador de carteiras de valores mobiliários e responsável pela administração do fundo.;Texto;100;Obrigatório;;;1;1;"";Não permitido;string;ADM OPEN BANKING DTVM S.A.
13+
/data/admin/cnpjNumber;cnpjNumber;CNPJ do administrador.;Texto;14;Obrigatório;^\d{14}$;;1;1;"";Não permitido;string;14511732000150
14+
/data/fundManager;fundManager;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
15+
/data/fundManager/name;name;Pessoa natural ou jurídica responsável pela gestão profissional dos ativos da carteira de valores mobiliários autorizado pela CVM.;Texto;100;Obrigatório;;;1;1;"";Não permitido;string;GESTOR OPEN BANKING DTVM S.A.
16+
/data/fundManager/cnpjNumber;cnpjNumber;CNPJ do gestor do fundo de investimento.;Texto;14;Obrigatório;^\d{14}$;;1;1;"";Não permitido;string;16332711000101
1317
/data/anbimaCategory;anbimaCategory;Conforme classificação ANBIMA, que segue a deliberação 77 da ANBIMA.<br><ol><li>Renda Fixa</li><li>Ações</li><li>Multimercado</li><li>Cambial</li></ol><br><br>;Texto;12;Obrigatório;;"RENDA_FIXA
1418
ACOES
1519
MULTIMERCADO
@@ -55,7 +59,7 @@ OUTROS";0;1;"";Não permitido;string;CDI
5559
/data/generalConditions;generalConditions;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
5660
/data/generalConditions/minimumAmount;minimumAmount;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
5761
/data/generalConditions/minimumAmount/value;value;Valor mínimo do primeiro aporte.;Texto;19;Obrigatório;^\d{1,16}\.\d{2}$;;1;1;"";Não permitido;string;100000.12
58-
/data/generalConditions/minimumAmount/currency;currency;Moeda referente ao valor da transação, segundo modelo ISO-4217. p.ex. 'BRL'<br>Todos os saldos informados estão representados com a moeda vigente do Brasil;Texto;;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL
62+
/data/generalConditions/minimumAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL
5963
/data/generalConditions/redemption;redemption;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
6064
/data/generalConditions/redemption/quotationDays;quotationDays;Prazo em dias indicada no regulamento do fundo para a conversão das cotas em dinheiro.;Inteiro;;Obrigatório;;;1;1;"";Não permitido;integer;3
6165
/data/generalConditions/redemption/quotationTerm;quotationTerm;Período em dias corridos ou dias úteis do prazo de cotização.<br><br><ol><li>Dias corridos</li><li>Dias úteis</li></ol>;Texto;13;Obrigatório;;"DIAS_CORRIDOS

dictionary/paymentsGetConsentsConsentId_v1.csv

+40-12
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,46 @@ Para o cenário em que o status assumiu AUTHORISED, o tempo máximo do expiratio
99
O tempo do expirationDateTime é garantido com os 15 minutos do access token, sendo possível utilizar mais três refresh tokens até totalizar 60 minutos.";Date Hora;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)Z$;;1;1;"";Não permitido;string;2021-05-21T08:30:00Z
1010
/data/statusUpdateDateTime;statusUpdateDateTime;Data e hora em que o recurso foi atualizado. Uma string com data e hora conforme especificação RFC-3339, sempre com a utilização de timezone UTC(UTC time format).;Date Hora;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)Z$;;1;1;"";Não permitido;string;2021-05-21T08:30:00Z
1111
/data/status;status;"Retorna o estado do consentimento, o qual no momento de sua criação será AWAITING_AUTHORISATION.
12-
Este estado será alterado depois da autorização do consentimento na detentora da conta do pagador (Debtor) para AUTHORISED ou REJECTED.
13-
O consentimento fica no estado CONSUMED após ocorrer a iniciação do pagamento referente ao consentimento.
14-
Em caso de consentimento expirado a detentora deverá retornar o status REJECTED.
15-
Estados possíveis:
16-
AWAITING_AUTHORISATION - Aguardando autorização
17-
AUTHORISED - Autorizado
18-
REJECTED - Rejeitado
19-
CONSUMED - Consumido";Texto;22;Obrigatório;;"AWAITING_AUTHORISATION
12+
Este estado será alterado depois da autorização do consentimento na detentora da conta do pagador (Debtor) para AUTHORISED, REJECTED ou REVOKED.
13+
O consentimento fica no estado CONSUMED após ocorrer a iniciação do pagamento referente ao consentimento.
14+
Em caso de consentimento expirado a detentora deverá retornar o status REJECTED.
15+
Em caso de revogação do consentimento a detentora deverá retornar o status REVOKED.
16+
Estados possíveis:
17+
AWAITING_AUTHORISATION - Aguardando autorização
18+
AUTHORISED - Autorizado
19+
REJECTED - Rejeitado
20+
CONSUMED - Consumido
21+
REVOKED - Revogado";Texto;22;Obrigatório;;"AWAITING_AUTHORISATION
2022
AUTHORISED
2123
REJECTED
22-
CONSUMED";1;1;"";Não permitido;string;AWAITING_AUTHORISATION
23-
/data/loggedUser;loggedUser;Usuário (pessoa natural) que encontra-se logado na instituição Iniciadora de Pagamento.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
24-
/data/loggedUser/document;document;"";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
24+
CONSUMED
25+
REVOKED";1;1;"";Não permitido;string;REVOKED
26+
/data/revocation;revocation;Objeto que contém as informações das circunstância da revogação.;Objeto;;Condicional;;;0;1;" O campo loggedUser deve ser preenchido quando a revogação for feita pelo usuário final, ou seja, se o campo data.revocation.revokedBy estiver com o valor 'USER'.
27+
";Não permitido;object;
28+
/data/revocation/loggedUser;loggedUser;Usuário (pessoa natural) que encontra-se logado na instituição Iniciadora de Pagamento.;Objeto;;Condicional;;;0;1;" Deve obrigatoriamente ser enviado quando a revogação for feita pelo usuário final, ou seja, se o campo revokedBy estiver com o valor 'USER'.
29+
";Não permitido;object;
30+
/data/revocation/loggedUser/document;document;Objeto que contém os dados de identificação do usuário.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
31+
/data/revocation/loggedUser/document/identification;identification;Número do documento de identificação oficial do usuário.;Texto;11;Obrigatório;^\d{11}$;;1;1;"";Não permitido;string;11111111111
32+
/data/revocation/loggedUser/document/rel;rel;Tipo do documento de identificação oficial do usuário.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;CPF
33+
/data/revocation/revokedBy;revokedBy;"Define qual das partes envolvidas na transação está realizando a revogação. Valores possíveis:
34+
- USER (Revogado pelo usuário)
35+
- ASPSP (Provedor de serviços de pagamento para serviços de conta - Detentora de conta)
36+
- TPP (Instituições Provedoras - iniciadora de pagamentos)";Texto;8;Obrigatório;;"USER
37+
ASPSP
38+
TPP";1;1;"";Não permitido;string;USER
39+
/data/revocation/reason;reason;Define a razão pela qual o consentimento foi revogado.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
40+
/data/revocation/reason/code;code;"Define o código da razão pela qual o consentimento foi revogado.
41+
Valores possíveis: 
42+
FRAUD - Indica suspeita de fraude 
43+
ACCOUNT_CLOSURE - Indica que a conta do usuário foi encerrada 
44+
OTHER - Indica que motivo do cancelamento está fora dos motivos pré-estabelecidos.";Texto;22;Obrigatório;;"FRAUD
45+
ACCOUNT_CLOSURE
46+
OTHER";1;1;"";Não permitido;string;OTHER
47+
/data/revocation/reason/additionalInformation;additionalInformation;Contém informações adicionais definidas pelo requisitante da revogação.;Texto;140;Condicional;[\w\W\s]*;;0;1;" Deverá ser obrigatoriamente preenchido quando a revogação for feita pela iniciadora ou pela detentora unilateralmente, ou seja, quando o campo revokedBy for igual a TPP ou ASPSP e o motivo de revogação for OTHER.
48+
";Não permitido;string;Não quero mais o serviço
49+
/data/loggedUser;loggedUser;Usuário (pessoa natural) que encontra-se logado na instituição Iniciadora de Pagamento.;Objeto;;Condicional;;;1;1;" Deve obrigatoriamente ser enviado quando a revogação for feita pelo usuário final, ou seja, se o campo revokedBy estiver com o valor 'USER'.
50+
";Não permitido;object;
51+
/data/loggedUser/document;document;Objeto que contém os dados de identificação do usuário.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
2552
/data/loggedUser/document/identification;identification;Número do documento de identificação oficial do usuário.;Texto;11;Obrigatório;^\d{11}$;;1;1;"";Não permitido;string;11111111111
2653
/data/loggedUser/document/rel;rel;Tipo do documento de identificação oficial do usuário.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;CPF
2754
/data/businessEntity;businessEntity;Usuário (pessoa jurídica) que encontra-se logado na instituição Iniciadora de Pagamento.;Objeto;;Condicional;;;0;1; Preenchimento obrigatório se usuário logado na instituição Iniciadora de Pagamento for um CNPJ (pessoa jurídica).;Não permitido;object;
@@ -39,7 +66,8 @@ O CNPJ será utilizado com 14 números e deverá ser informado sem pontos ou tra
3966
Em caso de pessoa jurídica deve ser informada a razão social ou o nome fantasia da conta do recebedor.";Texto;140;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Marco Antonio de Brito
4067
/data/payment;payment;Objeto contendo dados de pagamento para consentimento.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;
4168
/data/payment/type;type;Este campo define o tipo de pagamento que será iniciado após a autorização do consentimento.;Texto;3;Obrigatório;;PIX;1;1;"";Não permitido;string;PIX
42-
/data/payment/date;date;Data do pagamento, conforme especificação RFC-3339.;Data;10;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-01-01
69+
/data/payment/schedule;schedule;"";"";;Opcional;;;0;1;"";Não permitido;;
70+
/data/payment/date;date;Mutuamente exclusivo com o objeto schedule. Este campo é obrigatório no caso de pagamento único. Neste caso, o objeto schedule não deve ser informado.;Data;10;Opcional;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;0;1;"";Não permitido;string;2021-01-01
4371
/data/payment/currency;currency;"Código da moeda nacional segundo modelo ISO-4217, ou seja, 'BRL'.
4472
Todos os valores monetários informados estão representados com a moeda vigente do Brasil.";Texto;3;Obrigatório;^([A-Z]{3})$;;1;1;"";Não permitido;string;BRL
4573
/data/payment/amount;amount;Valor da transação com 2 casas decimais.;Texto;19;Obrigatório;^((\d{1,16}\.\d{2}))$;;1;1;"";Não permitido;string;100000.12

0 commit comments

Comments
 (0)