Especificações da Fase 2 do Open Banking Brasil
Apresentamos neste item orientações para problemas conhecidos da fase 2 do Open Banking Brasil.
Disponibilizamos abaixo a lista inicial de problemas conhecidos das especificações das APIs da fase 2, contendo orientações às instituições participantes até que se publiquem as correções.
Este arquivo poderá ser atualizado conforme novos itens sejam identificados.
Sua eventual atualização será previamente comunicada através dos informes do Open Banking Brasil.
ID | Crítico | API / Sessão | Endpoint | Campo | Como está? Qual o problema? | Como deveria ser? | Orientação até publicação do ajuste |
BCLOG-F02-003 | Não | Accounts | GET /accounts/{accountId}/overdraft-limits | overdraftUsedLimitCurrency | Definição errada: Moeda referente ao valor utilizado total do limite do cheque especial e o adiantamento a depositante, segundo modelo ISO-4217. p.ex. 'BRL'. | Atualizar a definição por: Moeda referente ao valor utilizado total do limite do cheque especial, segundo modelo ISO-4217. p.ex. 'BRL'. | NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |
BCLOG-F02-004 | Não | Accounts | GET /accounts/{accountId}/overdraft-limits | overdraftUsedLimit | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger Definição errada: Valor utilizado total do limite do cheque especial e o adiantamento a depositante. | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) Atualizar a definição por: Valor utilizado total do limite do cheque especial | NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |
BCLOG-F02-005 | Sim | Credit-cards-accounts | GET /accounts/{creditCardAccountId}/transactions | lineName | é um atributo de limites e não de transações | Excluir o campo | Até a publicação do ajuste orientamos reportar o campo, atentando para o uso de "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-007 | Sim | Credit-cards-accounts | GET /accounts/{creditCardAccountId}/bills | payments | está como obrigatorio ter sempre um pagamento | A Lista deveria ser opcional e minimo de ocorrencias deve ser 0 | Até a publicação do ajuste orientamos reportar o campo, usando por exemplo "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-008 | Sim | Unarranged-accounts-overdraft | GET /contracts/{contractId}/scheduled-instalments | /data/balloonPayments | A mandatoriedade está errada "obrigatório e com Minimo de ocorrência: 0" | Atualizar a mandatoriedade por: | Até a publicação do ajuste orientamos reportar o campo, usando por exemplo "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-009 | Sim | Invoice-financings | GET /contracts/{contractId}/scheduled-instalments | /data/balloonPayments | A mandatoriedade está errada "obrigatório e com Minimo de ocorrência: 0" | Atualizar a mandatoriedade por: | Até a publicação do ajuste orientamos reportar o campo, usando por exemplo "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-010 | Sim | Loans | GET /contracts/{contractId}/scheduled-instalments | /data/balloonPayments | A mandatoriedade está errada "obrigatório e com Minimo de ocorrência: 0" | Atualizar a mandatoriedade por: | Até a publicação do ajuste orientamos reportar o campo, usando por exemplo "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-011 | Sim | Financings | GET /contracts/{contractId}/scheduled-instalments | /data/balloonPayments | A mandatoriedade está errada "obrigatório e com Minimo de ocorrência: 0" | Atualizar a mandatoriedade por: | Até a publicação do ajuste orientamos reportar o campo, usando por exemplo "NA" quando aplicável e para eventuais campos de data que não permitam "NA", usar "0000-01-01". |
BCLOG-F02-012 | Sim | Customers | GET /business/identifications | data/contacts/postalAddresses/countryCode | Campo opcional e deve ser obrigatório | Atualizar mandatoriedade por: | Informação deve ser enviada de forma mandatória apesar do erro na especificação. |
BCLOG-F02-013 | Sim | Invoice-financings | GET /contracts/{contractId}/warranties | /data/warrantySubType | Incluir o valor permitido (dominio): "SEM_SUB_TIPO_GARANTIA" | Mateus | Utilizar opção OUTROS até correção da especificação. |
BCLOG-F02-014 | Sim | Loans | GET /contracts/{contractId}/warranties | /data/warrantySubType | Incluir o valor permitido (dominio): "SEM_SUB_TIPO_GARANTIA" | ACOES_DEBENTURES | Utilizar opção OUTROS até correção da especificação. |
BCLOG-F02-015 | Sim | Financings | GET /contracts/{contractId}/warranties | /data/warrantySubType | Incluir o valor permitido (dominio): "SEM_SUB_TIPO_GARANTIA" | ACOES_DEBENTURES | Utilizar opção OUTROS até correção da especificação. |
BCLOG-F02-016 | Sim | Unarranged-accounts-overdraft | GET /contracts/{contractId}/warranties | /data/warrantySubType | Incluir o valor permitido (dominio): "SEM_SUB_TIPO_GARANTIA" | ACOES_DEBENTURES | Utilizar opção OUTROS até correção da especificação. |
BCLOG-F02-017 | Sim | Customers | GET /business/identifications | data/tradeName | Está como obrigatório e o campo é condicional pelas restrições | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-018 | Sim | Customers | GET /business/identifications | data/parties/documentExpirationDate | Está como obrigatório e o campo é condicional pelas restrições | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-019 | Não | Customers | GET /business/identifications | data/contacts/postalAddresses/districtName | Está como obrigatório e o campo é condicional pelas restrições Formato redundante: \w*\W*|^NA$ | Atualizar a mandatoriedade por: Condicional Incluir a restrição:De preenchimento obrigatório, se houver Atualizar formato por: | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-020 | Sim | Customers | GET /personal/identifications | data/contacts/postalAddresses/districtName | Está como obrigatório e o campo é condicional pelas restrições Formato redundante: \w*\W*|^NA$ | Atualizar a mandatoriedade por: Condicional Incluir a restrição:De preenchimento obrigatório, se houver | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-021 | Sim | Customers | GET /business/identifications | data/parties/socialName | Está como obrigatório e o campo é condicional pelas restrições | Incluir a restrição:De preenchimento obrigatório, se houver. Atualizar mandatoriedade por: condicional Minimo de Ocorrências: 0 | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-022 | Sim | Customers | GET /business/identifications | data/parties/documentCountry | Está como obrigatório e o campo é condicional pelas restrições. | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-023 | Sim | Customers | GET /business/identifications | data/otherDocuments/number | Está como obrigatório mas é condicional, pelas restrições | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-024 | Sim | Customers | GET /business/identifications | data/otherDocuments/country | Está como obrigatório mas é condicional, pelas restrições. | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-025 | Sim | Customers | GET /personal/financial-relations | data/procurators/socialName | Campo deve ser condicional e está como obrigatório | Atualizar mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-026 | Sim | Customers | GET /personal/financial-relations | data/procurators/ | Campo está como opcional e é condicional, além de estar faltando informações na restrição. Como o campo é condicional, o minimo de ocorrências é 0 | Atualizar a mandatoriedade por: Condicional | Informação deve ser enviada de forma mandatória quando existente, apesar do erro na especificação. |
BCLOG-F02-027 | Sim | Customers | GET /personal/financial-relations | productsServicesTypeAddionalInfo | Campo tem restrições "Campo obrigatório quando productsServicesType for 'OUTROS'." e está com opcional. | Atualizar a mandatoriedade por: Condicional | Informação deve ser enviada de forma mandatória quando existente, apesar do erro na especificação e caso a transmissora não a possua deve informar "NA". |
BCLOG-F02-028 | Sim | Customers | GET /personal/identifications | data/otherDocuments/additionalInfo | Campo tem restrições "Obrigatório quando o Local de Emissão do Documento for relevante." e está com opcional | Atualizar a mandatoriedade por: Condicional | Caso a transmissora não possua a informação deverá devolver "NA" até o ajuste na especificação. |
BCLOG-F02-029 | Sim | Customers | GET /business/qualifications | data/informedRevenue/frequencyAdditionalInfo | É um campo condicional, atualmente está como opcional, deve ter minimo de ocorrências 0 | Atualizar o minimo de Ocorrências: 0 | NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |
BCLOG-F02-030 | Sim | Unarranged-accounts-overdraft | GET /contracts/{contractId} | firstInstalmentDueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-031 | Sim | Unarranged-accounts-overdraft | GET /contracts/{contractId} | DueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-032 | Sim | Invoice-financings | GET /contracts/{contractId} | firstInstalmentDueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-033 | Sim | Invoice-financings | GET /contracts/{contractId} | DueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-034 | Sim | Loans | GET /contracts/{contractId} | firstInstalmentDueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-035 | Sim | Loans | GET /contracts/{contractId} | DueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-036 | Sim | Financings | GET /contracts/{contractId} | firstInstalmentDueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-037 | Sim | Financings | GET /contracts/{contractId} | DueDate | Não está permitindo no formato/pattern o NA, incluir restrição | incluir na restrição e na definição: "Caso a instituição não possua a informação para compartilhamento, informar NA" Incluir no formato/pattern o NA | Retornar a data "0000-01-01" até o ajuste na especificação caso o campo seja de preenchimento obrigatório. |
BCLOG-F02-038 | Não | Credit-cards-accounts | GET /accounts/{creditCardAccountId}/bills | billTotalAmount | É um atributo tipo number e tem formato/pattern preenchido | Excluir o formato/ pattern preenchido, por ser um atributo number | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-039 | Não | Loans | GET /contracts/{contractId} | calculation | não foi corrigida a definição, está apenas como "Base de cálculo" e não especifica os valores solicitados. | Atualizar definição por: Base de cálculo (Vide Domínio)
| NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |
BCLOG-F02-040 | Não | Loans | GET /contracts/{contractId}/scheduled-instalments | balloonPayments/amount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-041 | Não | Loans | GET /contracts/{contractId}/payments | contractOutstandingBalance | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-042 | Não | Loans | GET /contracts/{contractId}/payments | feeAmount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-043 | Não | Loans | GET /contracts/{contractId}/payments | chargeAmount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-044 | Não | Unarranged-accounts-overdraft | GET /contracts/{contractId} | calculation | não foi corrigida a definição, está apenas como "Base de cálculo" e não especifica os valores solicitados. | Atualizar definição por: Base de cálculo (Vide Domínio)
| NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |
BCLOG-F02-045 | Não | Unarranged-accounts-overdraft | GET /contracts/{contractId}/scheduled-instalments | balloonPayments/amount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-046 | Não | Unarranged-accounts-overdraft | GET /contracts/{contractId}/payments | contractOutstandingBalance | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-047 | Não | Unarranged-accounts-overdraft | GET /contracts/{contractId}/payments | feeAmount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-048 | Não | Unarranged-accounts-overdraft | GET /contracts/{contractId}/payments | chargeAmount | não foi excluída a expressão regular o formato no dicionario e o pattern no Swagger | excluir o pattern (pattern: (-?\d{15}(.\d{4}?))$) | O validador do API security usado para avaliar as especificações exige pattern mesmo para atributos numéricos, por isso será mantido. |
BCLOG-F02-049 | Não | Financings | GET /contracts/{contractId} | calculation | não foi corrigida a definição, está apenas como "Base de cálculo" e não especifica os valores solicitados. | Atualizar definição por: Base de cálculo (Vide Domínio)
| NÃO HÁ NECESSIDADE DE ORIENTAÇÃO ADICIONAL ATÉ O AJUSTE. |