Instrução Normativa BCB N° 615
Sumário Regulatório
Extraído do BCB
Conteúdo do Documento
Resolução Nº 222 INSTRUÇÃO NORMATIVA BCB Nº 615, DE 6 DE MAIO DE 2025 Divulga a versão 7.0 do Manual de APIs do Open Finance. Os Chefes do Departamento de Regulação do Sistema Financeiro (Denor) e do Departamento de Tecnologia da Informação (Deinf), no uso das atribuições que lhes conferem o art. 23, inciso I, alínea "a", do Regimento Interno do Banco Central do Brasil,...
<span style="font-family:calibri;font-size:17.3333px;color:#444444;">
</span><span style="font-family:calibri;font-size:17.3333px;color:#444444;">
</span><title style="font-family:calibri;font-size:17.3333px;color:#444444;">Resolução Nº 222</title><span style="font-family:calibri;font-size:17.3333px;color:#444444;">
</span><style style="font-family:calibri;font-size:17.3333px;color:#444444;">
</style><span style="font-family:calibri;font-size:17.3333px;color:#444444;">
</span><div class="WordSection1"><span style="color:#444444;">
<p class="MsoNormal" align="center" style="margin-bottom:18pt;text-align:center;"><span style="text-transform:uppercase;font-family:calibri;font-size:17.3333px;color:#444444;">INSTRUÇÃO NORMATIVA
BCB Nº 615, DE 6 DE MAIO DE 2025</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 18pt 255.1pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Divulga
a versão 7.0 do Manual de APIs do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:18pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Os Chefes do
Departamento de Regulação do Sistema Financeiro (Denor) e do Departamento de
Tecnologia da Informação (Deinf), no uso das atribuições que lhes conferem o
art. 23, inciso I, alínea "a", do Regimento Interno do Banco Central
do Brasil, anexo à Resolução BCB nº 340, de 21 de setembro de 2023, com base no
art. 3º, inciso II, da Resolução BCB nº 32, de 29 de outubro de 2020,</span></p>
<p class="MsoNormal" style="margin-bottom:18pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">R E S O L V E M :</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;text-indent:70.9pt;background:white;"><span style="color:#444444;"><a name="_Hlk134005566"></a><a name="OLE_LINK51"></a><a name="OLE_LINK49"></a><a name="OLE_LINK50"></a><a name="OLE_LINK42"></a><a name="OLE_LINK43"></a><a name="OLE_LINK44"></a><a name="Texto21"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Art. 1º  Esta Instrução
Normativa divulga a versão 7.0 do Manual de APIs do <i>Open Finance</i>, </span></a><a name="_Hlk55486380"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">de
observância obrigatória por parte das instituições participantes,</span></a><span style="font-family:calibri;font-size:17.3333px;"> conforme Anexo.</span></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;text-indent:70.9pt;background:white;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Parágrafo único.  O manual de que trata o <i>caput</i>, em sua
versão mais recente, estará acessível na página do <i>Open Finance</i> no sítio
eletrônico do Banco Central do Brasil na internet e no Portal do <i>Open
Finance</i> no Brasil, mantido pela Estrutura de Governança do <i>Open Finance</i>
de que trata o art. 44, § 1º, da Resolução Conjunta nº 1, de 4 de maio de 2020.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;text-indent:70.9pt;background:white;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Art. 2º  Fica revogada a Instrução Normativa nº 574, de 20 de dezembro
de 2024, publicada no Diário Oficial da União de 30 de dezembro de 2024.</span></p>
<p class="MsoNormal" style="margin-bottom:12pt;text-align:justify;text-indent:70.9pt;background:white;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Art. 3º  Esta Instrução Normativa entra em vigor em 1º de julho de
2025.</span></p>
<p class="MsoNormal" style="text-align:justify;text-indent:70.9pt;background:white;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">MARDILSON FERNANDES
QUEIROZ                       CAIO MOREIRA FERNANDES<br></span><span style="font-family:calibri;font-size:17.3333px;text-indent:70.9pt;">                        Chefe do Denor                                                         Chefe
do Deinf</span></p><span style="font-family:calibri;font-size:17.3333px;">
</span><span style="font-family:calibri;font-size:17.3333px;"><br clear="all">
</span><span style="font-family:calibri;font-size:17.3333px;">
</span><p class="MsoNormal" style="margin-bottom:10pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"> </span></p>
<p class="MsoNormal" align="center" style="margin-bottom:18pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">ANEXO À INSTRUÇÃO NORMATIVA BCB Nº 615,
DE 6 DE MAIO DE 2025</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Manual de APIs do <i>Open Finance</i> Versão
7.0</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc14166332"></a><a name="_Toc14193634"></a><a name="_Toc14354699"></a><a name="_Toc14354849"></a><a name="_Toc14681789"></a><a name="_Toc52541656"></a><a name="_Toc54368699"></a><a name="_Toc54717499"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Histórico de revisão</b></a></span></p>
<span style="color:#444444;"></span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><table class="Tabelacomgrade3" border="1" cellspacing="0" cellpadding="0" width="680" style="width:510.05pt;border-collapse:collapse;border:none;">
<tbody><tr style="height:11.75pt;"><td width="100" valign="top" style="width:75.15pt;border:1pt solid windowtext;padding:0cm 5.4pt;height:11.75pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Data</b></p>
</td>
<td width="62" valign="top" style="width:46.4pt;border-top:1pt solid windowtext;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:none;padding:0cm 5.4pt;height:11.75pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Versão</b></p>
</td>
<td width="518" valign="top" style="width:388.5pt;border-top:1pt solid windowtext;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:none;padding:0cm 5.4pt;height:11.75pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Descrição das
alterações</b></p>
</td>
</tr>
<tr style="height:18.6pt;"><td width="100" rowspan="2" style="width:75.15pt;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 5.4pt;height:18.6pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">6/5/2025</span></p>
</td>
<td width="62" rowspan="2" style="width:46.4pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;height:18.6pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">7.0</span></p>
</td>
<td width="518" valign="top" style="width:388.5pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;height:18.6pt;">
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Subseção 5.1.1:
atualização dos limites de tráfego.</span></p>
</td>
</tr>
<tr style="height:18.6pt;">
<td width="518" valign="top" style="width:388.5pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;height:18.6pt;">
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Subseção 5.2: atualização
dos limites operacionais.</span></p>
</td>
</tr>
</tbody></table>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc52541658"></a><a name="_Toc54366376"></a><a name="_Toc54717501"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"> </span></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Termos de Uso</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><a name="_Toc52541659"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Este manual
detalha os requisitos técnicos para a implementação dos elementos necessários à
operacionalização do <i>Open Finance</i>, complementando a regulamentação
vigente sobre o tema. </span></a></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O manual será revisto e atualizado
periodicamente a fim de preservar a compatibilidade com a regulamentação, bem
como para incorporar os aprimoramentos decorrentes da evolução do <i>Open
Finance</i> e da tecnologia.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Informações mais detalhadas e exemplos
da aplicação deste manual poderão ser encontrados nos guias e tutoriais
disponíveis no Portal do <i>Open Finance</i> no Brasil, na Área do
Desenvolvedor.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Sugestões, críticas ou pedidos de
esclarecimento de dúvidas relativas ao conteúdo deste documento podem ser
enviados ao Banco Central do Brasil por meio dos canais institucionais dessa
autarquia.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc54366377"></a><a name="_Toc54717502"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Referências</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações baseiam-se,
referenciam e complementam, quando aplicável, os seguintes documentos:</span></p>
<span style="color:#444444;"></span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="680" style="width:18cm;margin-left:-0.25pt;border-collapse:collapse;border:none;">
<tbody><tr style="height:12.1pt;"><td width="265" style="width:7cm;border:1pt solid windowtext;background:white;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" align="center" style="text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Referência</b></p>
</td>
<td width="416" style="width:11cm;border-top:1pt solid windowtext;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:none;background:white;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" align="center" style="text-align:center;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">Origem</b></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Resolução
Conjunta nº 1, de 2020</span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">https://www.bcb.gov.br/estabilidadefinanceira/exibenormativo?tipo=Resolu%C3%A7%C3%A3o%20Conjunta&numero=1<u>
</u></span></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Resolução
BCB nº 32, de 2020</span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">https://www.bcb.gov.br/estabilidadefinanceira/exibenormativo?tipo=Resolu%C3%A7%C3%A3o%20BCB&numero=32</span></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">Hypertext Transfer Protocol – HTTP/1.1</span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><span lang="EN-US">https://tools.ietf.org/html/rfc2616</span><span lang="EN-US"> </span></span></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">ISO 20022</span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">https://www.iso20022.org/<u>
</u></span></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">OpenAPI Specification</span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">https://github.com/OAI/OpenAPI-Specification/blob/3.0.0/versions/3.0.0.md<u>
</u></span></p>
</td>
</tr>
<tr style="height:12.1pt;"><td width="265" style="width:7cm;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">Representational State Transfer </span></p>
</td>
<td width="416" style="width:11cm;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 3.5pt;height:12.1pt;">
<p class="MsoNormal" style="margin:2pt 0cm;text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;">https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm<u>
</u></span></p>
</td>
</tr>
</tbody></table>
<p class="MsoNormal" style="text-align:justify;"><span lang="EN-US" style="font-family:calibri;font-size:17.3333px;color:#444444;"> </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc52541660"></a><a name="_Toc54366378"></a><a name="_Toc54717503"></a><a name="_Toc47386159"></a><b style="font-family:calibri;font-size:17.3333px;">1. Introdução</b></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O <i>Open Finance</i> está
intrinsecamente ligado às APIs, interfaces por meio das quais é possível
interligar os diferentes sistemas das instituições. Ao serem disponibilizadas
pelos participantes, as APIs devem satisfazer condições tais como
padronização, robustez e segurança, a fim de que o objetivo de compartilhamento
de dados e serviços seja atendido a contento.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Nesse sentido, este manual visa a definir
os principais aspectos relativos às especificações e implementações das APIs
que integram o <i>Open Finance</i> no País, observando as disposições da
Resolução Conjunta nº 1, de 4 de maio de 2020, e da Resolução BCB nº 32, de 29
de outubro de 2020.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">São tratados neste manual aspectos
como: formato para a troca de dados, desenho da interface, protocolo para
transmissão de dados, versionamento, modelo de APIs e <i>endpoints.</i> Desse
modo, o manual estabelece as diretrizes gerais sem esgotar todos os aspectos
necessários à implementação das APIs para o <i>Open Finance</i>. As demais
definições a cargo das instituições participantes, por meio da Estrutura de Governança
do <i>Open Finance</i>, estarão disponíveis no Portal do <i>Open Finance </i>no
Brasil, no qual poderão ser encontrados guias, tutoriais e outras informações
operacionais sobre as APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Ao longo deste manual, será constante
o uso de siglas e terminologia específica para designar algumas expressões
cotidianas dos profissionais da área de tecnologia. Alguns exemplos das mais
frequentemente utilizadas, com as correspondentes definições, são as seguintes:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - API (<i>Application Programming Interface</i>): um conjunto
de definições sobre como um sistema pode acessar dados ou funcionalidades
providos por um outro sistema;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - REST (<i>Representational State Transfer</i>):
estilo arquitetural de <i>software</i>;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - API RESTful: API que adere às
restrições do estilo arquitetural
REST;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - OpenAPI: linguagem de
especificação de APIs RESTful;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V - <i>endpoint</i>: elemento de uma especificação OpenAPI
sobre o qual podem ser executadas operações para acessar dados ou
funcionalidades;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VI - HTTP (<i>Hypertext Transfer
Protocol</i>): protocolo para sistemas hipermídia,
distribuídos e colaborativos; </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VII - operação: elemento de uma
especificação OpenAPI que declara uma maneira válida de se acessar um <i>endpoint</i>,
informando qual método HTTP (GET, POST etc.) utilizar, nomes e tipos de
parâmetros;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VIII - provedor da API: instituição que
disponibiliza uma API para ser consumida por outras instituições. Nas APIs de "Serviços
de Iniciação de Pagamentos", é a instituição detentora de contas; no caso
de APIs de "Dados Cadastrais e Transacionais", é a instituição
transmissora de dados;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IX - consumidor da API: instituição que
consome uma API provida por outras instituições. Nas APIs de "Serviços de
Iniciação de Pagamentos", é a instituição iniciadora de pagamentos; no
caso de APIs de "Dados Cadastrais e Transacionais", é a instituição
receptora de dados; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">X - <i>gateway</i> de API: é um serviço, dispositivo ou <i>proxy</i>
que atua como intermediário, aceitando, transformando, encaminhando e
gerenciando o tráfego de APIs para serviços de <i>back-end</i>. Ele permite a
comunicação e a transferência de dados entre <i>endpoints</i> e pode ser útil
quando há várias plataformas que precisam interagir umas com as outras sem
conceder acesso direto às APIs umas das outras. Além disso, um <i>gateway</i>
de API pode lidar com tarefas como autenticação, limitação de taxas,
armazenamento em cache e transformação de solicitação/resposta, reduzindo a
carga sobre o aplicativo e melhorando a segurança geral e o desempenho do
sistema.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687726"></a><a name="_Toc54366379"></a><a name="_Toc54717504"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">2. APIs do </b></a><b style="font-family:calibri;font-size:17.3333px;"><i>Open Finance</i></b></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As APIs a serem providas pelas
instituições no âmbito do <i>Open Finance</i> devem ser categorizadas em um dos
seguintes tipos:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - Dados Abertos;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - Dados Cadastrais e Transacionais;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - Serviços; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - Relatórios e Métricas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687727"></a><a name="_Toc54366380"></a><a name="_Toc54717505"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3. Princípios</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Os princípios abaixo norteiam as
especificações e implementações das APIs do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687728"></a><a name="_Toc54366381"></a><a name="_Toc54717506"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.1 Experiência do usuário</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações e implementações das
APIs devem oferecer uma boa experiência para os usuários, sejam eles
implementadores ou consumidores das APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687729"></a><a name="_Toc54366382"></a><a name="_Toc54717507"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.2 Independência de tecnologia</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações das APIs devem ser independentes
de tecnologia, podendo ser implementadas e consumidas em diferentes linguagens,
tais como Java, JavaScript e Python; ou plataformas, tais como Windows, Linux,
Android e iOS.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687730"></a><a name="_Toc54366383"></a><a name="_Toc54717508"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.3 Segurança</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Procedimentos e controles (assinaturas
digitais, criptografia, protocolos de autenticação e autorização, entre outros)
devem ser adotados de forma a proteger os participantes do <i>Open Finance</i>,
seus clientes, os consumidores das APIs e demais participantes do ecossistema,
observada a compatibilidade com a política de segurança cibernética da
instituição.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687731"></a><a name="_Toc54366384"></a><a name="_Toc54717509"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.4 Extensibilidade</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">No futuro, as APIs poderão ser
evoluídas para atender a novos casos de uso e, portanto, devem ser
especificadas e implementadas de forma a permitir e facilitar extensões como,
por exemplo, novos <i>endpoints</i>, operações, parâmetros e propriedades.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687732"></a><a name="_Toc54366385"></a><a name="_Toc54717510"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.5 Padrões abertos</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Padrões abertos devem ser adotados
sempre que possível.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687733"></a><a name="_Toc54366386"></a><a name="_Toc54717511"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.6 APIs RESTful</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações das APIs devem
atender às restrições do estilo arquitetural REST sempre que possível.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687734"></a><a name="_Toc54366387"></a><a name="_Toc54717512"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.7 ISO 20022</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As respostas das APIs devem ter como
base os elementos e componentes de mensagem ISO 20022 (https://www.iso20022.org/).
Os casos particulares em que a adoção do padrão ISO não seja possível ou
recomendada poderão sofrer adequações, desde que especificamente apontados para
avaliação pelo Banco Central do Brasil.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687735"></a><a name="_Toc54366388"></a><a name="_Toc54717513"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">3.8 Declaração de obrigatoriedade</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todos os elementos que compõem as
especificações das APIs (<i>endpoints</i>, operações, parâmetros, propriedades
de respostas etc.) devem ser explicitamente declarados como "Obrigatório",
"Opcional" ou "Condicional", caso sejam obrigatórios apenas
em certas condições.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;line-height:107%;"><span style="line-height:107%;font-family:calibri;font-size:17.3333px;color:#444444;">Funcionalidades
que sejam de implementação opcional pelo transmissor devem ficar explícitas na
sua documentação, tanto para informar adequadamente ao público transmissor, que
poderá ou não implementar a funcionalidade, quanto ao público consumidor, que pode
não encontrar a funcionalidade disponível em alguns transmissores.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687736"></a><a name="_Toc54366389"></a><a name="_Toc54717514"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4. Definições e recomendações</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As definições e recomendações abaixo
devem ser observadas pelas especificações e implementações das APIs do <i>Open
Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687737"></a><a name="_Toc54366390"></a><a name="_Toc54717515"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.1 Especificações</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As APIs devem ser especificadas com a
versão 3.0.0 ou superior da linguagem OpenAPI
(https://github.com/OAI/OpenAPI-Specification/blob/3.0.0/versions/3.0.0.md).</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações das APIs devem ser analisadas com a versão
5.9.0 ou superior do <i>software</i> livre e de código aberto Spectral (https://github.com/stoplightio/spectral/tree/v5.9.0).
A análise deve ser feita com o conjunto de regras (<i>ruleset</i>) padrão desta versão do <i>Spectral</i>. O
resultado da análise não deve conter erros ou alertas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">É recomendado que a versão 3.0.25 ou
superior do <i>software</i> livre e de código aberto Swagger Codegen (https://github.com/swagger-api/swagger-codegen/tree/v3.0.25)
seja utilizada para gerar o código de clientes e também o código inicial de
implementações das APIs a partir de suas especificações. Recomenda-se que o
código gerado seja analisado com o intuito de identificar possíveis recursos da
linguagem OpenAPI que foram utilizados nas especificações, mas que não são
adequadamente suportados pelo Swagger Codegen e, possivelmente, por outros <i>softwares</i>
que trabalham com especificações OpenAPI. Caso isso ocorra, deve-se avaliar se
não é possível alterar as especificações para não mais fazer uso desses
recursos.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Devem ser disponibilizadas implementações
de exemplo das APIs. Os dados retornados por elas não precisam ser dados reais
e nem volumosos, pois o objetivo da disponibilização é dar ao Banco Central do
Brasil, aos implementadores e aos consumidores das APIs mais um recurso para
dirimir eventuais dúvidas acerca de suas especificações e implementações.<a name="_Toc53687738"> É recomendado que o código inicial de implementações das
APIs mencionado anteriormente seja complementado de forma a constituir-se nas
implementações de exemplo.</a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As informações disponibilizadas nos
dicionários de dados devem ser consistentes com as especificações OpenAPI associadas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todos os <i>endpoints </i>das APIs implementados
devem ser previamente registrados no diretório de participantes. </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todos os <i>endpoints</i> registrados
que retornem listas, caso os parâmetros sejam válidos, devem retornar a lista
associada, mesmo que seja lista vazia. Não é considerado um retorno válido o
erro 404, neste cenário, quando não houver a informação associada.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc54366391"></a><a name="_Toc54717516"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.2 Versionamento</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As versões das especificações das APIs
serão tipificadas como "<i>major</i>", "<i>minor</i>", "<i>patch</i>"
e "<i>release candidate</i>" de acordo com os critérios a seguir:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - <i>major</i>: inclui novas
características da implementação, mudanças e correções a serem incorporadas,
que podem ser incompatíveis com versões anteriores, por exemplo, v1.0.0 e
v2.0.0;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - <i>minor</i>: pequenas mudanças
nos elementos já existentes, com manutenção da compatibilidade com as versões
até a <i>major</i> imediatamente anterior, por exemplo, v1.1.0 e v1.2.0;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - <i>patch</i>: esclarecimentos às
especificações "<i>minor</i>", não incluem alterações funcionais, por
exemplo, v1.1.1, v1.1.2; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - <i>release candidate</i>: versões
de pré-lançamento de qualquer versão futura do tipo "<i>patch</i>", "<i>minor</i>"
ou "<i>major</i>", por exemplo, v1.0.0-rc e v1.0.0-rc2.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A Estrutura de Governança do <i>Open
Finance</i>, de que trata o art. 44, § 1º, da Resolução Conjunta nº 1, de 2020,
pode lançar novas versões das APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O Banco Central do Brasil pode definir:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - o cronograma de implantação das
novas versões das especificações das APIs e de certificação das instituições
participantes; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - a tipificação de determinadas
alterações como "<i>minor</i>" ou "<i>patch</i>"
independentemente dos critérios definidos nos incisos de I a IV desta subseção.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Alterações feitas na especificação de
uma API devem sempre ser documentadas com um novo versionamento desta especificação.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por fim, credenciais de acesso
associadas às APIs devem ser agnósticas às suas versões.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc54717517"></a><a name="_Toc53687739"></a><a name="_Toc54366392"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.3 Portal do </b></a><b style="font-family:calibri;font-size:17.3333px;"><i>Open Finance</i></b><b style="font-family:calibri;font-size:17.3333px;"> no Brasil</b></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Hlk53687679"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O sítio
eletrônico de que trata o art. 15 da Resolução BCB nº 32, de 2020, </span></a><span style="font-family:calibri;font-size:17.3333px;">deverá conter definições e
recomendações acessórias não presentes neste manual, bem como outros artefatos
necessários à especificação, implementação e consumo das APIs do <i>Open
Finance</i>. Todas as definições e recomendações acessórias e artefatos
publicados no portal deverão estar em concordância com este e com os demais
manuais do <i>Open Finance</i>.</span></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687740"></a><a name="_Toc54366393"></a><a name="_Toc54717518"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.4 Cronograma</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O Portal do <i>Open Finance</i> deverá
listar as APIs em produção, suas versões atuais, datas em que entraram em
produção, <i>link</i> para suas especificações e lista de mudanças desde a
última publicação. Também deverá apresentar o cronograma de homologação das
APIs, indicando versão, data de divulgação, data prevista de entrada em
produção e outras informações relevantes. </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.5 <i>Logs</i> de mudanças</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todas as versões já publicadas das
APIs devem ser listadas no Portal do <i>Open Finance</i>, juntamente com os
respectivos <i>logs</i> de mudanças e períodos em que estiveram em produção.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687741"></a><a name="_Toc54366394"></a><a name="_Toc54717519"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.6 Definições acessórias</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A Estrutura de Governança do <i>Open Finance</i>
deverá estabelecer e publicar no Portal do <i>Open Finance</i> um guia de
estilo de especificações de APIs contendo definições e recomendações para os
seguintes elementos:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - estrutura de <i>Uniform Resource
Identifiers</i> (URIs);</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - cabeçalhos HTTP;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - códigos de <i>status</i> HTTP;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - convenções de corpo de
requisições e respostas;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V - convenções de nomenclatura;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VI - tipos de dados comuns;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VII - paginação; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VIII - estabilidade de
identificadores.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687742"></a><a name="_Toc54366395"></a><a name="_Toc54717520"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.7 Processo de gerência de mudanças</b></a></span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.05pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A
Estrutura de Governança do
<i>Open Finance</i> deve estabelecer
e publicar no Portal do <i>Open Finance</i> o processo que ela adotará para
gerenciar mudanças nas especificações das APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.8 Tutoriais</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todas as informações necessárias para
o desenvolvimento, testes e entrada em produção de aplicações ou APIs no <i>Open
Finance</i> devem estar disponíveis em tutoriais publicados na Área do
Desenvolvedor no Portal do <i>Open Finance</i>. Cada tutorial deve conter todos
os passos necessários para o completo desenvolvimento da atividade em questão,
como desenvolvimento e uso de aplicações e APIs, autenticação e autorização,
uso da <i>Sandbox</i>, aplicação de testes de conformidade e cadastramento no
diretório. Quando pertinente, devem ser fornecidos exemplos de código fonte ou
de capturas de telas, tornando o processo o mais claro possível para todos os
participantes e interessados.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">4.9 Extensibilidade</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As especificações das APIs do <i>Open
Finance</i> podem não dar acesso a todos os dados e funcionalidades que um ou
mais participantes desejam expor para os consumidores das APIs. Isso pode ser
necessário para melhor suportar casos de uso ou possibilitar inovações em
produtos e serviços financeiros. Para atender estas e outras necessidades, é
facultado aos participantes implementarem versões estendidas das APIs
inteiramente compatíveis com as especificações padrões das APIs que são:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - novos <i>endpoints</i>;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - novas operações em <i>endpoints</i>
pré-existentes;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - novos parâmetros em operações
pré-existentes, desde que opcionais; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - novas propriedades em respostas
pré-existentes.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A Estrutura de Governança do <i>Open
Finance</i> deverá publicar no Portal do <i>Open Finance</i> as definições e
recomendações acessórias relacionadas às extensões das APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todas as extensões implementadas pelos
participantes deverão estar listadas, com sua documentação referenciada, em
seção específica no Portal do <i>Open Finance</i> e disponíveis para consumo,
observadas as regras de ressarcimento de despesas previstas na regulamentação
vigente.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687743"></a><a name="_Toc54366396"></a><a name="_Toc54717521"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5. Requisitos não funcionais</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Esta seção apresenta os requisitos não
funcionais que as instituições participantes devem observar na implementação
das APIs do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Para auxiliar na definição de alguns
requisitos não funcionais, é necessário que cada <i>endpoint</i> seja classificado
no Portal do <i>Open Finance</i> de acordo com a sua frequência de atualização
dos dados, conforme as opções abaixo:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - alta frequência;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - média-alta frequência;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - média frequência; e </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - baixa frequência </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Os Limites de tráfego por origem,
limites operacionais e tempo de resposta (desempenho) serão definidos baseados
nessa classificação.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;line-height:107%;"><span style="line-height:107%;font-family:calibri;font-size:17.3333px;color:#444444;">Os <i>endpoints</i>
das APIs do tipo "Serviços", das APIs de "Segurança" (<i>Token</i>
– consumo OAuth 2.0 (FAPI), <i>Token</i> – DCR/DCM) e das APIs de "Recursos"
e de "Consentimento" devem ser considerados como de alta frequência.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;line-height:107%;"><span style="line-height:107%;font-family:calibri;font-size:17.3333px;color:#444444;">Destaca-se
que, especialmente em requisitos não funcionais, o termo "<i>endpoint</i>"
deve considerar as operações específicas associadas a cada caminho. Por
exemplo, as chamadas GET /consents/{consentId} e DELETE /consents/{consentId}
representam operações distintas e, portanto, devem ser monitoradas de forma
independente.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687744"></a><a name="_Toc54366397"></a><a name="_Toc54717522"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.1 Limites de tráfego</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.1.1 Limites por origem</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Cada <i>endpoint</i> implementado no <i>Open
Finance</i> pode ter uma restrição quanto ao tráfego a partir de determinada
origem. Em APIs do tipo "Dados Abertos" a origem é o IP de onde
partiu a requisição, em APIs autenticadas é a <i>organizationId</i> da
instituição que fez a requisição.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">No caso de uma instituição implementar
limites, eles devem respeitar os valores mínimos de Transações por Minuto (TPM),
conforme definido abaixo:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - em <i>endpoints</i> classificados
como de alta frequência, por <i>endpoint</i> e por origem, de acordo com o
número de consentimentos possuídos por uma determinada instituição receptora de
dados com uma determinada instituição transmissora de dados:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">a) nas hipóteses em que a quantidade
de consentimentos ativos possuídos por uma determinada instituição receptora de
dados com uma determinada instituição transmissora de dados for inferior ou
igual a seis milhões, conforme a tabela abaixo:</span></p>
<div align="center">
<span style="color:#444444;"></span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><span style="color:#444444;">
</span><table class="Tabelacomgrade3" border="1" cellspacing="0" cellpadding="0" style="border-collapse:collapse;border:none;">
<tbody><tr><td width="284" style="width:212.65pt;border:1pt solid windowtext;padding:0cm 5.4pt;">
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Quantidade de
Consentimentos Ativos da instituição receptora de dados por instituição
transmissora de dados (QCA)</span></p>
</td>
<td width="51" style="width:38.2pt;border-top:1pt solid windowtext;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:none;padding:0cm 5.4pt;">
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">TPM</span></p>
</td>
</tr>
<tr><td width="284" valign="top" style="width:212.65pt;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">0 < QCA ≤
1.000.000</span></p>
</td>
<td width="51" style="width:38.2pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">2.500</span></p>
</td>
</tr>
<tr><td width="284" style="width:212.65pt;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">1.000.000 < QCA
≤ 2.000.000</span></p>
</td>
<td width="51" style="width:38.2pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">5.000</span></p>
</td>
</tr>
<tr><td width="284" style="width:212.65pt;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">2.000.000 < QCA
≤ 3.000.000</span></p>
</td>
<td width="51" style="width:38.2pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">8.000</span></p>
</td>
</tr>
<tr><td width="284" style="width:212.65pt;border-right:1pt solid windowtext;border-bottom:1pt solid windowtext;border-left:1pt solid windowtext;border-top:none;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">3.000.000 < QCA
≤ 6.000.000</span></p>
</td>
<td width="51" style="width:38.2pt;border-top:none;border-left:none;border-bottom:1pt solid windowtext;border-right:1pt solid windowtext;padding:0cm 5.4pt;">
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">10.000</span></p>
</td>
</tr>
</tbody></table>
</div>
<p class="MsoNormal" style="margin:6pt 0cm;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">b)
nas hipóteses em que a quantidade de consentimentos ativos possuídos por uma determinada
instituição receptora de dados com uma determinada instituição transmissora de
dados for superior a seis
milhões, o limite de TPM deve ser calculado considerando faixas de dois em dois
milhões, sendo o TPM equivalente ao limite de TPM da faixa anterior acrescido
de dois mil. Exemplo: na faixa de quantidade de consentimentos ativos acima de seis
milhões e menor ou igual a oito milhões, o limite de TPM deve ser igual a 12.000;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - em <i>endpoints</i> classificados
como de média-alta frequência, por <i>endpoint</i> e por origem, 2.000 TPM;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - em <i>endpoints</i>
classificados como de média frequência, por <i>endpoint</i> e por origem, 1.500
TPM; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - em <i>endpoints</i> classificados
como de baixa frequência, por <i>endpoint</i> e por origem, 1.000 TPM.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Aplicabilidade: Alguns <i>endpoints</i>
não podem ter limites de tráfego definidos por origem, como nas APIs do tipo "Serviços",
nas APIs de "Segurança", e de "Recursos" e de "Consentimento".
A informação se o limite por origem é "aplicável" ou "não aplicável"
deve estar explícito por <i>endpoint</i> no Portal do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A quantidade de consentimentos detidos
por cada instituição receptora de dados com cada instituição transmissora de
dados deve ser atualizada no primeiro dia de cada mês para fins da
classificação nas faixas de TPM do inciso I desta subseção, que diz respeito à
capacidade de TPM a ser provida pelas instituições transmissoras de dados às
instituições receptoras de dados no caso de <i>endpoints</i> classificados como
de alta frequência.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As requisições que excederem os
limites implementados deverão ser respondidas com <i>status code</i> HTTP 429 (<i>Too
Many Requests</i>). Caso a instituição transmissora de dados opte por não
aplicar as restrições de tráfego por <i>endpoint</i> por origem estabelecidas
neste manual, ela não poderá utilizar o <i>status code</i> HTTP 429.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por fim, as requisições que
ultrapassarem os limites deverão ser desprezadas no cálculo do tempo de
resposta das implementações das APIs.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.1.2 Limites globais </b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A infraestrutura das instituições
provendo APIs no <i>Open Finance</i> deve ter a capacidade de, no mínimo, atender
a 300 requisições simultâneas por segundo (TPS).</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Caso uma instituição atinja o limite
de 300 TPS, no contexto do <i>Open Finance</i>, ela deve ampliar sua capacidade
de infraestrutura para possibilitar um acréscimo de 150 TPS ao limite anterior.
Tal aumento deve ocorrer novamente a cada vez que o limite vigente naquela instituição
seja atingido. Eventual redução pode ser realizada somente se durante trinta
dias a capacidade a ser reduzida não tiver sido utilizada.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As requisições que excederem os
limites de TPS deverão ser respondidas com <i>status code</i> HTTP 529 (<i>Site
is overloaded</i>) e o seu volume diário deve ser inferior a 0,5% das
requisições válidas, nos termos da subseção 5.4 deste Manual.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Com vistas a cumprir o limite máximo
de volume de requisições com <i>status code</i> HTTP 529, cada instituição deve
implementar monitoramento preventivo, cuja metodologia é definida pela
Estrutura de Governança do <i>Open Finance </i>e deve estar disponível no
Portal do<i> Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A execução do processo de
monitoramento preventivo não isenta a instituição participante de aumentos
emergenciais de infraestrutura para atender a 99,5% das requisições válidas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><i>Endpoints</i> criados dentro do conceito de
extensibilidade, sejam dentro de novas APIs ou em APIs existentes, não devem ser
considerados para controle do limite global de transações simultâneas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Considerando que o Manual de
Monitoramento do <i>Open Finance</i> estabelece que o período de apuração do
volume de requisições com <i>status code</i> HTTP 529 é mensal, assim que o mês
de referência se encerrar, a Estrutura de Governança do <i>Open Finance</i>
deve verificar se os volumes diários de requisições com <i>status code</i> HTTP
529 de uma determinada instituição participante em relação às suas requisições
válidas foram superiores ou iguais ao limite de 0,5%.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Para fins do processo de
monitoramento, considera-se que uma determinada instituição participante está
em conformidade caso tenha respeitado o limite de 0,5% em pelo menos 90% dos
dias do mês de referência, arredondando-se para o número inteiro mais próximo,
desde que o volume diário de requisições com <i>status code</i> HTTP 529 dos
demais dias não tenha sido superior a 5%.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Evidências do processo de
acompanhamento de limites de TPS devem estar à disposição do Banco Central do
Brasil por um período de doze meses.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.2 Limites operacionais</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">É facultado às instituições participantes
implementar um limite de acesso mensal por <i>endpoint </i>e por cliente. </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Em <i>endpoints</i> que acessem
recursos ou produtos, os limites serão também considerados por recurso ou produto.
</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A contabilização dos acessos deve ser
feita por:</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.15pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I
- mês;</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.15pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II
- <i>endpoint</i>;</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.15pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III
- objeto mais granular referenciado na chamada (consentimento/recurso/produto);</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.15pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV
- cliente (CPF ou CNPJ); e</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 6pt 0.15pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V
- instituição consumidora da informação.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por exemplo: uma instituição receptora
"A" pode acessar um <i>endpoint</i> "B", acessando o
recurso "C", de um cliente "D" da instituição transmissora "E",
no mínimo "N" vezes (ou chamadas) com sucesso por mês. </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Aplicabilidade dos limites
operacionais: todos os <i>endpoints </i>das APIs do tipo Dados Cadastrais e Transacionais
(conforme classificação por tipo),
excetuando-se os <i>endpoints</i> das APIs de Consentimento (<i>Consents</i>) e
Recursos (<i>Resources</i>). As APIs dos tipos Dados Abertos, de Serviços (como
de Iniciação de Pagamento) e de Segurança não podem ter restrições de limites
operacionais.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A implementação dos limites
operacionais é opcional pelas instituições transmissoras, mas, uma vez que
sejam implementados, devem garantir o consumo mínimo estabelecido no Portal do <i>Open
Finance</i>. É facultada à instituição a possibilidade de ampliar estes limites,
mas vedada a implementação de limites inferiores aos estabelecidos.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">O Portal do <i>Open Finance</i> deve listar
os valores mínimos de limites operacionais a serem considerados, por <i>endpoint</i>,
que devem ser iguais ou maiores que os abaixo, de acordo com a classificação de
frequência de utilização:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - 8 chamadas ao mês, para <i>endpoint</i>
classificado como de baixa frequência;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - 30 chamadas ao mês, para <i>endpoint</i>
classificados como de média frequência;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - 120 chamadas ao mês, para <i>endpoint</i>
classificados como de média-alta frequência;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - 240 chamadas ao mês, para <i>endpoint</i>
classificado como de alta frequência; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V - 420 chamadas ao mês, para os
seguintes <i>endpoints</i> da API de Contas: "Saldos da conta" e "Limites
da conta".Só deverão
ser contabilizadas nos limites operacionais as requisições respondidas com <i>status
code</i> HTTP 2XX (com sucesso),
sendo que as requisições adicionais a um <i>endpoint</i> para fins de paginação
não devem ser contabilizadas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As requisições que excederem os
limites operacionais deverão ser respondidas com <i>status code</i> HTTP 423.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Todas as requisições autenticadas em <i>endpoints</i>
sujeitos ao limite operacional devem possuir o atributo <i>x-fapi-interaction-id</i>
preenchido no seu <i>header</i> pela instituição receptora de dados, que deve
ser copiado pela instituição transmissora de dados nos <i>headers</i> da
resposta. Essa definição objetiva permitir um adequado rastreamento de
divergências que podem ocorrer entre instituições transmissoras e receptoras de
dados associadas ao limite operacional.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687745"></a><a name="_Toc54366398"></a><a name="_Toc54717523"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.3 Desempenho</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Deverá ser medido o tempo de resposta
de cada requisição, ou seja, o tempo transcorrido entre o recebimento de uma
requisição que não ultrapassa os limites de tráfego e o momento em que a
requisição é completamente respondida. Adicionalmente, esta medição deverá ser
feita de maneira que os tempos medidos sejam os mais próximos possíveis dos
tempos de resposta experimentados por quem fez a requisição. A medição na
instituição provedora da API deve iniciar quando a requisição é recebida pelo <i>gateway</i>
e deve terminar após o último <i>byte</i> da resposta desta requisição ser
enviado.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.3.1 Cálculo do desempenho</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Para fins do cálculo do desempenho,
deve-se considerar o valor do percentil 95 e as requisições para medir o
desempenho, que pretende minimizar impacto do aparecimento de valores extremos
(<i>outliers</i>). O valor do percentil 95 pode ser obtido da seguinte maneira:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - coleta dos dados: Seja R o
conjunto de todos os tempos de resposta de um dia, onde r<sub>i</sub> é o tempo
de resposta da i-ésima requisição. Ou seja, R={r<sub>1</sub>, r<sub>2</sub>, ...,
r<sub>n</sub>};</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - cálculo do índice do percentil
95: o índice para o percentil 95, denotado por i<sub>95</sub>, é calculado pela
fórmula i<sub>95</sub> = 0.95 ∗ n, arredondado para o número inteiro
mais próximo, e onde n representa número de requisições;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - ordenação dos dados: Ordene o
conjunto R em ordem crescente para obter o conjunto ordenado R<sub>ord</sub>={r(1),
r(2), ..., r(n)}, onde r(1) é o menor tempo de resposta e r(n) é o maior; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - obtenção do valor do percentil
95: o valor do percentil 95, denotado por <i>P<sub>95</sub></i>, é o valor no
índice <i>i<sub>95</sub></i> no conjunto ordenado <i>R<sub>ord</sub></i>. Ou
seja, <i>P<sub>95</sub> = r<sub>(i95)</sub>.</i></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Considerando um exemplo em que um <i>endpoint</i>
recebe 10.555 requisições em um dia (ou seja, <i>n </i>= 10.555). Nesse caso, o
índice para o percentil 95 será 10.027 (<i>i<sub>95</sub></i> = [<i>0.95 * n</i>]
= [10.027,25] = 10.027). Após ordenarmos as medições do tempo de resposta em
ordem crescente (formando o conjunto <i>R<sub>ord</sub></i>), o valor do
percentil 95 (<i>P<sub>95</sub></i>) para esse dia será igual ao tempo de
resposta na posição 10.027 no conjunto ordenado <i>R<sub>ord</sub></i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.3.2 <i>Service Level Agreement</i> (SLA)
do desempenho</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Neste contexto, os <i>endpoints</i>
das APIs deverão manter, diariamente, o percentil 95 do tempo de resposta em no
máximo:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - 1.500ms, em <i>endpoints</i> classificados
como de alta e média-alta frequências;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - 2.000ms, em <i>endpoints</i>
classificados como de média frequência; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - 4.000ms, em <i>endpoints</i>
classificados como de baixa frequência.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por exemplo, em um dia que um <i>endpoint</i>
de alta frequência receba 10.000 requisições, o tempo de resposta de pelo menos
9.500 requisições deve ser inferior a 1.500ms.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Informações adicionais:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - as medições de tempo de resposta
devem ser realizadas de maneira independente para cada versão "<i>major</i>"
dos <i>endpoints</i> em produção;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - devem ser consideradas as
requisições com todos os códigos de retorno possíveis, com exceção dos
associados a limites de tráfego e limites operacionais;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - esta subseção não se aplica às
APIs de "<i>Webhook</i>";</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - as instituições provedoras devem gerar
e acompanhar seus indicadores de desempenho, de maneira independente da
Plataforma de Coleta de Métricas (PCM) provida pela Estrutura de Governança do <i>Open
Finance</i>;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V - as instituições consumidoras das
APIs devem registrar os tempos de resposta das APIs que consomem para envio à
PCM. Nelas, a medição do tempo de resposta de cada requisição deve iniciar no
momento antes da requisição ser feita e deve terminar após o último <i>byte</i>
ser recebido, antes de qualquer processamento; </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VI - o valor do tempo de resposta a
ser considerado para uma requisição é o valor reportado pelo consumidor da API;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VII - na falta de informações dos
consumidores, serão utilizadas as informações dos provedores para o cálculo do
SLA de desempenho; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VIII - a Estrutura de Governança do <i>Open
Finance</i> deverá disponibilizar indicadores adicionais para monitoramento e
aprimoramento do ecossistema, que não terão, nesse momento, um SLA mínimo, tais
como: </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">a) percentil 95 do tempo de resposta
somente de requisições com<i> status code</i> 2XX;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">b) percentil 95 do tempo de resposta -
provedor - deve considerar todas as requisições fornecidas pelo provedor das
APIs, mesmo quando houver diferença entre as informações entre provedor e
consumidor;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">c) percentil 95 do tempo de resposta -
consumidor - deve considerar todas as requisições fornecidas pelos consumidores
das APIs, mesmo quando houver diferença entre as informações entre provedor e
consumidor;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">d) índice de paridade - percentual do número
de requisições no <i>status</i> "<i>PAIRED</i>" em relação ao total;
e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">e) média do tempo de resposta até P<sub>95</sub>
- média do tempo de resposta de todas as requisições com tempo de resposta
menores que o valor do P<sub>95</sub>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.3.3 Aferição do desempenho para fins
do processo de monitoramento</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Considerando que o Manual de
Monitoramento do <i>Open Finance</i> estabelece que o período de apuração do
desempenho é mensal, assim que o mês de referência se encerrar, a Estrutura de
Governança do <i>Open Finance</i> deve verificar se os <i>endpoints</i> das
APIs das instituições participantes atenderam aos SLAs do desempenho definidos
na seção anterior deste manual.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Para fins do processo de
monitoramento, considera-se que um <i>endpoint</i> está em conformidade caso
tenha respeitado o SLA do desempenho em pelo menos 90% dos dias do mês de
referência, arredondando-se para o número inteiro mais próximo, desde que o valor
do P<sub>95</sub> dos demais dias não tenha sido superior ao SLA do desempenho
aumentado em 20%.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por exemplo:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - em um mês de 30 dias, em que um <i>endpoint</i>
de alta frequência tenha apresentado valor de P<sub>95</sub> inferior a 1.500ms
em 27 dias e, nos demais dias, tenha apresentado valor de P<sub>95</sub> entre
1.500ms e 1.800ms (1.500ms * 1,2 = 1.800ms), o <i>endpoint</i> está em
conformidade para fins do processo de monitoramento naquele mês; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - em um mês de 31 dias, em que um <i>endpoint</i>
de alta frequência tenha apresentado valor de P<sub>95</sub> inferior a 1.500ms
em 28 dias e, nos demais dias, tenha apresentado, em pelo menos um dos dias,
valor de P<sub>95</sub> superior a 1.800ms (1.500ms * 1,2 = 1.800ms), o <i>endpoint</i>
não está em conformidade para fins do processo de monitoramento naquele mês.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="color:#444444;"><a name="_Toc53687746"></a><a name="_Toc54366399"></a><a name="_Toc54717524"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.4 Disponibilidade</b></a></span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.4.1 Cálculo da disponibilidade</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A disponibilidade dos <i>endpoints</i>
das APIs do <i>Open Finance</i> será calculada empiricamente, baseada na
monitoração de requisições válidas. Serão consideradas "requisições válidas"
as requisições que retornam <i>status code</i> da faixa 2XX, 5XX, igual a 408 ou
igual a 422. As requisições válidas podem ser divididas em "requisições
válidas com sucesso" - com <i>status code</i> na faixa 2XX ou igual a 422
- e "requisições válidas com erro" - com <i>status code</i> na faixa
5XX ou igual a 408.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A disponibilidade pontual (t) será
calculada como a fração do total de requisições válidas que cada <i>endpoint</i>
recebe e as que ele processa com sucesso a cada intervalo de 1 minuto. Os
intervalos de minuto deverão ser calculados do segundo zero (0s:000ms) até o
segundo 59 (59s:999ms).</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><img src="https://www.bcb.gov.br/content/estabilidadefinanceira/buscanormas_especificos/2025/In_Bcb_615/image001.jpg" alt="" style="margin:5px;width:709px;height:48px;" /></span> </p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por exemplo, a disponibilidade pontual
de um <i>endpoint</i> referente ao minuto 11:34, de um determinado dia, no qual
houve um total de requisições válidas com sucesso de 255 e um total de
requisições válidas com erro de 4, é calculada da seguinte forma:</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><img src="https://www.bcb.gov.br/content/estabilidadefinanceira/buscanormas_especificos/2025/In_Bcb_615/image002.jpg" alt="" style="margin:5px;width:482px;height:44px;" /></span> </p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Dessa forma, obtém-se o indicador
percentual para cada janela de tempo de 1 minuto. Cada período de 1 minuto será
classificado como "disponível" ou "indisponível". Se a "disponibilidade
pontual" da janela de tempo ficar abaixo de 95% isso indicará que ela será
considerada como "indisponível", caso contrário será "disponível".</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Períodos que não tenham requisições
válidas são considerados "indefinidos" e são desconsiderados para
cálculo da disponibilidade.</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><img src="https://www.bcb.gov.br/content/estabilidadefinanceira/buscanormas_especificos/2025/In_Bcb_615/image003.jpg" alt="" style="margin:5px;width:477px;height:61px;" /></span> </p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A disponibilidade diária será
calculada baseada nas informações das disponibilidades pontuais.</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><img src="https://www.bcb.gov.br/content/estabilidadefinanceira/buscanormas_especificos/2025/In_Bcb_615/image004.jpg" alt="" style="margin:5px;width:592px;height:49px;" /></span> </p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Por exemplo, considerando um dia em
que houve requisições válidas em 1.390 das 1.440 faixas de 1 minuto possíveis
(1 dia = 24h * 60min = 1.440 faixas de horário) para um <i>endpoint</i>
específico "x" de versão 1, e dos quais 30 períodos tiveram a
disponibilidade menor que o limite de disponibilidade definido (95%), a
Disponibilidade Diária de "x" v1 será igual a:</span></p>
<p class="MsoNormal" align="center" style="margin-bottom:6pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><img src="https://www.bcb.gov.br/content/estabilidadefinanceira/buscanormas_especificos/2025/In_Bcb_615/image005.jpg" alt="" style="margin:5px;width:372px;height:41px;" /></span> </p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A disponibilidade longa deverá ser
calculada diariamente como média móvel das disponibilidades dos últimos noventa
dias corridos, considerando somente os dias em que a disponibilidade diária
pode ser calculada (teve pelo menos uma disponibilidade pontual diferente de "indefinido").
Ou seja, caso nos últimos noventa dias tenhamos dois dias calculados como
indefinidos, a média deve ser calculada considerando somente as 88 disponibilidades
válidas.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A aferição mensal deve considerar a
disponibilidade longa do último dia do mês de referência.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.4.2 SLA da disponibilidade</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Cada um dos <i>endpoints</i> das APIs categorizadas
como "Dados Abertos", "Dados Cadastrais e Transacionais", "Relatórios
e Métricas", por versão, e os <i>endpoints</i> das APIs de "Segurança"
"/<i>register</i>" e "/<i>token</i>", deverão satisfazer os
requisitos mínimos de disponibilidade abaixo: </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - disponibilidade diária
(calendário): 95%; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - disponibilidade longa (média
móvel de 90 dias), medida diariamente: 99,5%.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As APIs classificadas como "Serviços
de Iniciação de Pagamentos" seguem o definido na regulamentação do Pix.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Informações adicionais:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">I - as medições devem ser feitas todos
os dias, em todas as faixas de 1 minuto disponíveis, iniciando na primeira
faixa (00:00:00-00:00:59) e terminando na última faixa (23:59:00-23:59:59),
considerando o horário de Brasília;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">II - as medições de disponibilidade
devem ser feitas para cada versão major dos <i>endpoints</i> em produção. Por
exemplo, em períodos de convivência o <i>endpoint</i> de v1/<i>resources</i>
poderia estar disponível no mesmo período em que o <i>endpoint</i> de v2/<i>resources</i>
estaria também disponível. É importante que suas disponibilidades sejam
calculadas de maneira independente;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">III - as instituições provedoras devem
gerar e acompanhar seus indicadores de disponibilidade, de maneira independente
da Plataforma de Coleta de Métricas (PCM) provida pela Estrutura de Governança
do <i>Open Finance</i>;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IV - o <i>status code</i> a ser
considerado para uma requisição é o valor reportado pelo consumidor da API;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">V - na falta de informações dos
consumidores, serão utilizadas as informações dos provedores para o cálculo do
SLA de disponibilidade; </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VI - a indisponibilidade programada
não exime o cálculo da disponibilidade no período apurado;</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VII - esta subseção não se aplica às
APIs de "<i>Webhook</i>";</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">VIII - a disponibilidade de <i>endpoints</i>
que não tenham requisições válidas no período apurado será considerada "indefinida",
não estando sujeita a um SLA; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">IX - a Estrutura de Governança do <i>Open
Finance</i> deverá disponibilizar indicadores adicionais para monitoramento e
aprimoramento do ecossistema que não terão, nesse momento, um SLA mínimo, tais
como:</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">a) disponibilidade calculada do ponto
de vista do provedor da API - deve considerar as informações fornecidas pelo
provedor das APIs; e</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">b) disponibilidade calculada do ponto
de vista do consumidor da API - deve considerar as informações fornecidas somente
pelos consumidores das APIs, classificadas no PCM como "<i>PAIRED</i>"
ou "<i>SINGLE</i>".</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">5.5 <i>Timeout</i></b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Padronização do <i>timeout</i> de
tempo de resposta do provedor e do tempo de resposta do consumidor em quinze
segundos.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As requisições que excederem o limite
de <i>timeout</i> do provedor deverão ser respondidas com o <i>status code</i> HTTP
504 (<i>Gateway Timeout</i>).</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><b style="font-family:calibri;font-size:17.3333px;color:#444444;">6. Regras transitórias</b></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">As mudanças realizadas na seção 5.1.1
entram em vigor a partir de 1º de setembro de 2025.</span></p>
<p class="MsoNormal" align="right" style="margin-bottom:6pt;text-align:right;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Brasília, 6 de maio de 2025.</span></p><span style="font-family:calibri;font-size:17.3333px;">
</span><span style="font-family:calibri;font-size:17.3333px;"><br clear="all">
</span><span style="font-family:calibri;font-size:17.3333px;">
</span><p class="MsoNormal"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"> </span></p>
<p class="MsoNormal" align="center" style="margin-bottom:18pt;text-align:center;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">NOTA 281/2025-BCB/DENOR, DE 5 DE MAIO DE
2025</span></p>
<p class="MsoNormal" style="margin:0cm 0cm 12pt 212.65pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Fundamenta
proposta de edição de instrução normativa que estabelece a versão 7.0 do Manual
de APIs do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">Senhores Chefes do Denor
e do Deinf,</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">A presente Nota
fundamenta proposta de edição de instrução normativa pelo Departamento de
Regulação do Sistema Financeiro (Denor) e pelo Departamento de Tecnologia da
Informação (Deinf), no uso da atribuição que lhes confere o art. 23, inciso I,
alínea "a", do Regimento Interno do Banco Central do Brasil, anexo à
Resolução BCB nº 340, de 21 de setembro de 2023, com base no art. 51, inciso IX,
da Resolução Conjunta nº 1, de 4 de maio de 2020.</span></p>
<p class="MsoBodyText" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">2.                    A
respeito, a proposta trata de edição de instrução normativa que estabelece a
versão 7.0 do Manual de APIs do <i>Open Finance</i>, revogando a Instrução
Normativa BCB nº 574, de 20 de dezembro de 2025, que divulga a versão 6.0 do
Manual de APIs do <i>Open Finance</i>.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">3.                    Por
fim, cumpre ressaltar que, por força do art. 5º da Lei nº 13.874, de 20 de
setembro de 2019, as propostas de edição e de alteração de atos normativos de
interesse geral de agentes econômicos ou de usuários dos serviços prestados,
editadas por órgão ou entidade da administração pública federal, incluídas as
autarquias e as fundações públicas, serão precedidas da realização de análise
de impacto regulatório (AIR), que conterá informações e dados sobre os
possíveis efeitos do ato normativo para verificar a razoabilidade do seu
impacto econômico.</span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">4.                    Por
sua vez, o Decreto nº 10.411, de 30 de junho de 2020, que regulamenta a
referida lei, em seu art. 4º, estabelece critérios de dispensa para realização
da AIR. Nesse contexto,
vale destacar que, desde a última alteração de limites de tráfego por origem e
de limites operacionais, ocorrida em meados de 2022, o número de consentimentos
de clientes no <i>Open Finance</i> foi triplicado e os casos de uso foram
ampliados e aprofundados. Em consequência, há, atualmente, demanda represada em
razão dos referidos limites, afetando a capacidade de instituições de
oferecerem adequadamente produtos com base no <i>Open Finance</i> ou até mesmo
causando riscos de tomada de decisões com base em dados desatualizados tanto
pelas instituições quanto por seus clientes. </span></p>
<p class="MsoNormal" style="margin-bottom:6pt;text-align:justify;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">5.                    Nesse
sentido, de acordo com o art. 4º, inciso V, alíneas "b" e
"c", do referido Decreto nº 10.411, de 30 de junho de 2020, o ato
normativo ora proposto fica dispensado de elaboração de AIR por visar a
preservação da higidez dos mercados financeiros e dos sistemas de pagamentos.</span></p>
<p class="MsoNormal" style="margin-bottom:36pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">À consideração de V.Sa.</span></p>
<p class="MsoNormal" style="text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">JANAÍNA PIMENTA ATTIE                                              VERUSKA
ROCHA DE ARAGÃO<br></span><span style="font-family:calibri;font-size:17.3333px;text-indent:70.9pt;">                        Consultora do Denor                                                      </span><span style="font-family:calibri;font-size:17.3333px;text-indent:70.9pt;">Chefe Adjunta do Deinf</span></p>
<p class="MsoNormal" style="margin-bottom:36pt;text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;"><br>                        De acordo.</span></p>
<p class="MsoNormal" style="text-align:justify;text-indent:70.9pt;"><span style="font-family:calibri;font-size:17.3333px;color:#444444;">MARDILSON FERNANDES QUEIROZ                             CAIO
MOREIRA FERNANDES<br></span><span style="font-family:calibri;font-size:17.3333px;text-indent:70.9pt;">                        Chefe do Denor                                                                Chefe
do Deinf</span></p>
</span></div>
</div>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Acesso Exclusivo para Assinantes
Cadastre-se ou faça login com sua conta do Radar Finsiders Brasil para visualizar esta regulação na íntegra, fazer download dos arquivos e ter acesso a relatórios exclusivos do mercado financeiro.