Lançamento das versões beta das APIs Contas (v2.4.0-beta.2) e Dados cadastrais (v2.1.0-beta.3)Padronização da nomenclatura dos arquivos de coleta de dados de interoperabilidadeGT Arquitetura comunica a identificação de chamadas recorrentes ( loop ) em ...

Lançamento das versões beta das APIs Contas (v2.4.0-beta.2) e Dados cadastrais (v2.1.0-beta.3)

Informamos que, a área do desenvolvedor do Portal do Open Finance Brasil foi atualizada, em 21/06/2024, com a documentação das versões beta das APIs Contas (v2.4.0-beta.2) e Dados cadastrais (v2.1.0-beta.3).

As documentações das APIs passaram pelas seguintes alterações:

API Dados cadastrais:

Ajuste no pattern do campo links;

Ajuste nas descrições dos campos paychecksBankLink e portabilitiesReceived.

API Contas:

Ajuste nas descrições dos campos paychecksBankLink e portabilitiesReceived.

O go live para essas APIs se mantém em 15/08/2024, como descrito no informa #582 (“Divulgação do cronograma de dados do empregador e resolução de problemas conhecidos das APIs de Dados Cadastrais e Contas”, enviado em 22/05/2024).

Para mais detalhes, sugerimos acessar os links de documentação abaixo.

Clique aqui para acessar a página de changelog da API contas

Clique aqui para acessar a v2.4.0-beta.2 da API Contas

Clique aqui para acessar a página de changelog da API Dados cadastrais

Clique aqui para acessar a v2.1.0-beta.3 da API Dados cadastrais

Clique aqui para acessar o Informa #582

Padronização da nomenclatura dos arquivos de coleta de dados de interoperabilidade

Informamos que, a partir dos envios de data-base 28/06/2024, a nomenclatura dos arquivos de coleta de dados semanais de interoperabilidade deve atender aos padrões mencionados no documento de processo de coleta de dados para o Painel de indicadores e publicação no Dashboard do Cidadão da estrutura do Open Finance:

Arquivo de fases 2 e 4B:

“2024MMDD_Interoperabilidade_da_Fase_2_e_4B_RegistrationNumber”;

Regex:^2024(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])_Interoperabilidade_da_Fase_2_e_4B_RegistrationNumber$

Arquivo de fase 3:

“2024MMDD_Interoperabilidade_da_Fase_3_RegistrationNumber”;

Regex:^2024(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])_Interoperabilidade_da_Fase_3_RegistrationNumber$

Arquivo de métricas:

“2024MMDD_Metricas_DA_DC_RegistrationNumber”;

Regex:^2024(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])_Metricas_DA_DC_RegistrationNumber$

Reiteramos que a data deve atender ao padrão AAAAMMDD, sendo a data referenciada a sexta-feira do período contemplado (e.g.: período de aferição: 08/06/2024 a 14/06/2024 – data-base: 20240614). O Registration Number corresponde aos 14 dígitos referentes ao CNPJ da instituição cadastrado em Diretório.

Envios fora do padrão requerido serão automaticamente rejeitados e retornados às instituições para que efetuem as adequações necessárias.

Exemplos de nomenclaturas sujeitas à rejeição (e.g.: período de 08/06/2024 a 14/06/2024; CNPJ:11112222333344):

“20240617_Interoperabilidade_da_Fase_2_e_4B_11112222333344” (data não é a sexta-feira);

“20240614_Interoperabilidade_da_Fase_2_e_4B_111122223333445” (15 dígitos no Registration Number);

“20240614_Interoperabilidade da Fase 2 e 4B 11112222333344” (sem underline);

“20240614_Interoperabilidade_da_Fases_2_e_4B_11112222333344” ("Fase" no plural).

Clique aqui para acessar o documento de processo de coleta de dados para o painel de indicadores e publicação no Dashboard do Cidadão da estrutura do Open Finance

GT Arquitetura comunica a identificação de chamadas recorrentes (loop)  em consentimentos com status expired

Durante as análises de dados de Fase 3 reportados para a Plataforma de Coleta de Métricas (PCM) o GT Arquitetura identificou a existência de situações de consultas recorrentes de consentIds expirados. Reforçamos que tal comportamento não deve ocorrer no Ecossistema uma vez que o status expirado, identificado nessa análise, representa um status final, não havendo sentido consultá-lo novamente.

Recomenda-se que as instituições verifiquem suas implementações de modo a evitar que esse tipo de cenário ocorra. Além disso, o GT recomenda a implementação de Webhooks que auxiliam a evitar tal situação.

Os status finais podem ser consultados na documentação da Máquina de Estados e as orientações para ativação do Webhook podem ser consultadas em “Informações Gerais - Webhook - v1.2.0”.

Clique aqui para acessar a Máquina de Estados para a Fase 3

Clique aqui para acessar as orientações para ativação do Webhook

Renomeação das FVPs

A Ferramenta de Validação em Produção é utilizada pela Estrutura para monitorar o comportamento funcional das instituições em produção e evoluiu ao longo do tempo agregando diferentes escopos. Para cada escopo, convencionou-se diferentes nomenclaturas para a ferramenta (1.0; 2.0; 3.0)

Informamos que os nomes das ferramentas foram atualizadas de acordo com o seu modelo de execução:

FVP Automática (1.0)

- DCR/DCM/Pagamentos

- Cadastral

FVP Manual (2.0/3.0)

- Testes abertos (2.0)

- Testes restritos (3.0)

A documentação completa sobre o escopo de testes e modelos de execução das FVPs pode ser conferida através deste link.

Inclusão de novos testes na FVP Automática

Comunicamos que a partir de 25/06/2024 serão incluídos os seguintes módulos de teste na FVP automática:

Pagamentos automáticos v1.0.0

automatic-payments_api_sweeping-accounts-invalid-creditor_test-module_v1

automatic-payments_api_rejected-consent_test-module_v1

automatic-payments_api_negative-consents_test-module_v1

automatic-payments_api_sweeping-accounts-invalid-cnpj_test-module_v1

Pagamentos v3.0.0

payments_api_dict_test-module_v3

payments_api_manu-fail_test-module_v3

payments_api_pixscheduling-dates-unhappy_test-module_v3

payments_api_qres-code-enforcement_test-module_v3

Pagamentos v4.0.0

payments_api_pixscheduling-dates-unhappy_test-module_v4

payments_api_qres-mismatched-proxy_test-module_v4

payments_api_qres-wrong-amount-proxy_test-module_v4

payments_api_qres-code-enforcement_test-module_v4

payments_api_dict_test-module_v4

payments_api_manu-fail_test-module_v4

payments_api_force-check-signature_test-module_v4

payments_api_consents_negative_test-module_v4

payments_api_json-accept-header-jwt-returned_test-module_v4

payments_api_recurring-payments-consent-limit_test-module_v4

payments_api_recurring-payments-wrong-custom-quantity_test-module_v4

As notificações serão iniciadas em até uma semana após a inclusão dos novos módulos.