Fase 2 - Atualização da planilha de problemas conhecidosERRATA - Atualização da cartilha do processo de onboarding de ITPs

Fase 2 - Atualização da planilha de problemas conhecidos

O Grupo Técnico de Especificações comunica que foram incluídos sete itens à planilha de problemas conhecidos da Fase 2, conforme segue:

BCLOG-F02-208

API/Sessão: Accounts

Endpoints: /transactions e /transactions-current

Campo: /partieCompeCode

Qual o problema: A descrição do campo indica a possibilidade de informar NA porém o pattern não permite

Como deveria ser: A descrição do campo não deveria indicar a possibilidade de informar NA no campo

Orientação: Não informar NA

BCLOG-F02-209

API/Sessão: Accounts

Endpoint: /accounts/{accountId}

Campo: /compeCode

Qual o problema: A descrição do campo indica a possibilidade de informar NA porém o pattern não permite

Como deveria ser: A descrição do campo não deveria indicar a possibilidade de informar NA no campo

Orientação: Não informar NA

BCLOG-F02-210

API/Sessão: Accounts

Endpoints: /accounts/{accountId}, /accounts/{accountId}/balances, /accounts/{accountId}/transactions, /accounts/{accountId}/transactions-current e /accounts/{accountId}/overdraft-limits

Campo: -

Qual o problema: Na tabela descritiva das possibilidades de interação entre API de Recursos (Resources) e API de Contas (Accounts) página 73, do Guia de Implementação das APIs de Dados Cadastrais e Transacionais, não foi definido um código de erro para o cenário: Com consentimento autorizado (conta inexistente)

Como deveria ser: Deveria existir um código de erro padronizado para esta situação

Orientação: Utilizar o Status 403 com o código de erro:

RESOURCE_FORBIDDEN

BCLOG-F02-211

API/Sessão: Credit-card-accounts

Endpoints: /accounts/{creditCardAccountId}, /accounts/{creditCardAccountId}/bills, /accounts/{creditCardAccountId}/bills/{billId}/transactions, /accounts/{creditCardAccountId}/limits, /accounts/{creditCardAccountId}/transactions e /accounts/{creditCardAccountId}/transactions-current

Campo: -

Qual o problema: Na tabela descritiva das possibilidades de interação entre API de Recursos (Resources) e API de Cartões de Crédito (Credit-card-accounts) (Análoga ao caso de Accounts) página 83, do Guia de Implementação das APIs de Dados Cadastrais e Transacionais, foi definido o uso do HTTP Status 404 para o cenário: Com consentimento autorizado (conta inexistente)

Como deveria ser: Deveria ser utilizado o HTTP Status 403 como o código de erro padronizado para esta situação

Orientação: Utilizar o Status 403 com o código de erro: RESOURCE_FORBIDDEN

BCLOG-F02-212

API/Sessão: Todas as APIs de crédito

Endpoints: /contracts/{contractId}, /contracts/{contractId}/warranties, /contracts/{contractId}/scheduled-instalments e /contracts/{contractId}/payments

Campo: -

Qual o problema: Na tabela descritiva das possibilidades de interação entre API de Recursos (Resources) e as APIs de Operações de Crédito na página 105, do Guia de Implementação das APIs de Dados Cadastrais e Transacionais, foi definido o uso do HTTP Status 404 para o cenário: Com consentimento autorizado (recurso inexistente)

Como deveria ser: Deveria ser utilizado o HTTP Status 403 como o código de erro padronizado para esta situação

Orientação: Utilizar o Status 403 com o código de erro: RESOURCE_FORBIDDEN

BCLOG-F02-213

API/Sessão: Todas as APIs de crédito

Endpoints: /contracts/{contractId}, /contracts/{contractId}/warranties, /contracts/{contractId}/scheduled-instalments e /contracts/{contractId}/payments

Campo: -

Qual o problema: Na tabela descritiva das possibilidades de interação entre API de Recursos (Resources) e as APIs de Operações de Crédito na página 103, do Guia de Implementação das APIs de Dados Cadastrais e Transacionais, foi definido o uso do HTTP Status 404 para o cenário: Com consentimento autorizado (aprovado múltipla alçada)

Como deveria ser: Deveria ser utilizado o HTTP Status 403 como o código de erro padronizado para esta situação

Orientação: Utilizar o Status 403 com o código de erro: RESOURCE_FORBIDDEN

BCLOG-F02-214

API/Sessão: Accounts

Endpoint: /accounts/{accountId}/balances

Campo: /data/automaticallyInvestedAmount/amount

Qual o problema: O pattern do campo não permite valores negativos e por regra de negócio será um cenário possível

Como deveria ser: O pattern deveria aceitar valores negativos

Orientação: Instituições Financeiras devem considerar:

string($double)

pattern: ^-?\d{1,15}\.\d{2,4}$

maxLength: 21

minLength: 4

example: 1000.0400

ERRATA - Atualização da cartilha do processo de onboarding de ITPs

Informamos retificação do informa 227 - Atualização da cartilha do processo de onboarding de ITPs – enviado em 14/09/2022:

O ajuste, realizado no 4° pré-requisito da página 2 da Cartilha, reflete a necessidade de obtenção prévia de certificação e publicação de suas APIs Payments, conforme o item V, do artigo 2° da Resolução Conjunta n° 1, de 4 de maio de 2020, caso a instituição que deseja participar do onboarding seja detentora de conta.

Clique aqui para acessar o Guia de Onboarding ITP