From cd5e034dd4094dd054618902ff46b93cca74a21b Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 10:28:35 -0300 Subject: [PATCH 01/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3003=20-=20Cr?= =?UTF-8?q?iar=20nova=20vers=C3=A3o=20da=20API=20-=20v2.1.0-rc.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/2.1.0-rc.1.yml | 1875 ++++++++++++++++++++++ swagger-apis/credit-cards/index.html | 5 +- 2 files changed, 1878 insertions(+), 2 deletions(-) create mode 100644 swagger-apis/credit-cards/2.1.0-rc.1.yml diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml new file mode 100644 index 000000000..889608037 --- /dev/null +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -0,0 +1,1875 @@ +openapi: 3.0.0 +info: + title: API Credit-cards-accounts - Open Finance Brasil + description: | + API de contas de pagamento pós-pagas do Open Finance Brasil – Fase 2. + API que retorna informações de contas de pagamento pós-paga mantidas nas instituições transmissoras por seus clientes, incluindo dados como denominação, produto, bandeira, limites de crédito, informações sobre transações de pagamento efetuadas e faturas. + + Não possui segregação entre pessoa natural e pessoa jurídica.\ + Requer consentimento do cliente para todos os `endpoints`. + + # Orientações + A `Role` do diretório de participantes relacionada à presente API é a `DADOS`.\ + Para todos os `endpoints` desta API é previsto o envio de um `token` através do header `Authorization`.\ + Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos + dados relacionados ao `consentId` específico relacionado.\ + Os dados serão devolvidos na consulta desde que o `consentId` relacionado corresponda a um consentimento válido e com o status `AUTHORISED`.\ + É também necessário que o recurso em questão (conta, contrato, etc) esteja disponível na instituição transmissora (ou seja, sem boqueios de qualquer natureza e com todas as autorizações/consentimentos já autorizados).\ + Além disso as `permissions` necessárias deverão ter sido solicitadas quando da criação do consentimento relacionado (`consentId`).\ + Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API.\ + ### `/accounts/{creditCardAccountId}/bills` + - description: + - Só deve ser informada uma fatura já fechada. + - Qualquer pagamento deve ser contado para a última fatura fechada. + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + ### `/accounts/{creditCardAccountId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + + ## Permissions necessárias para a API Credit-cards-accounts + + Para cada um dos paths desta API, além dos escopos (`scopes`) indicados existem `permissions` que deverão ser observadas: + + ### `/accounts` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}/bills` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_READ** + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/limits` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_LIMITS_READ** + ### `/accounts/{creditCardAccountId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/transactions-current` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + version: 2.1.0-rc.1 + license: + name: Apache 2.0 + url: 'https://www.apache.org/licenses/LICENSE-2.0' + contact: + name: Governança do Open Finance Brasil – Especificações + email: gt-interfaces@openbankingbr.org + url: 'https://openbanking-brasil.github.io/areadesenvolvedor/' +servers: + - url: 'https://api.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Produção + - url: 'https://apih.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Homologação +tags: + - name: Credit Card + description: Operações para listagem das informações de Cartão de Crédito +paths: + /accounts: + get: + tags: + - Credit Card + summary: Conjunto de informações das Contas de pagamento pós paga + operationId: creditCardsGetAccounts + description: Método para obter a lista de contas de pagamento pós-paga mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsList' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}': + get: + tags: + - Credit Card + summary: Obtém os dados de identificação da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountId + description: Método para obter os dados de identificação da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsIdentification' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills': + get: + tags: + - Credit Card + summary: Obtém a lista de faturas da conta identificada por creditCardAccountId. + description: | + Método para obter a lista de faturas da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora.\ + Só deve ser informada uma fatura já fechada.\ + Qualquer pagamento deve ser contado para a última fatura fechada. + operationId: creditCardsGetAccountsCreditCardAccountIdBills + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromDueDate' + - $ref: '#/components/parameters/toDueDate' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBills' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills/{billId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId e billId. + operationId: creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions + description: | + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId e billId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/billId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBillsTransactions' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/limits': + get: + tags: + - Credit Card + summary: Obtém os limites da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdLimits + description: Método para obter os limites da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactions + description: |- + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions-current': + get: + tags: + - Credit Card + summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent + description: Método para obter a lista de transações recentes (últimos 7 dias) da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDateMaxLimited' + - $ref: '#/components/parameters/toTransactionDateMaxLimited' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts +components: + schemas: + CreditCardAccountsTransactionAmount: + type: object + description: | + Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransactionBrazilianAmount: + type: object + description: | + Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardsAccountsIdentificationData: + type: object + description: Conjunto de informações referentes à identificação da conta de pagamento pós-paga. + required: + - name + - productType + - creditCardNetwork + - paymentMethod + properties: + name: + type: string + pattern: '[\w\W\s]*' + description: | + Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Informações complementares se tipo de Cartão 'OUTROS' + maxLength: 50 + example: OURO_INTERNACIONAL + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'. + maxLength: 50 + example: AURA CARD + paymentMethod: + type: array + description: | + Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. + items: + $ref: '#/components/schemas/CreditCardsAccountPaymentMethod' + minItems: 1 + CreditCardAccountsBillsData: + type: object + description: Conjunto das informações referentes a lista de faturas associadas à conta de pagamento pós-paga + required: + - billId + - dueDate + - billTotalAmount + - billMinimumAmount + - isInstalment + - payments + properties: + billId: + description: Informação que identifica a fatura + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: 3459087XXZTR + dueDate: + description: 'Data de vencimento da Fatura, que aparece para pagamento pelo cliente' + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + billTotalAmount: + $ref: '#/components/schemas/CreditCardsBillTotalAmount' + billMinimumAmount: + $ref: '#/components/schemas/CreditCardAccountsBillMinimumAmount' + isInstalment: + type: boolean + description: Indica se a fatura permite parcelamento (true) ou não (false). + example: false + financeCharges: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsFinanceCharge' + minItems: 1 + description: Lista dos encargos cobrados na fatura + payments: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsPayment' + minItems: 0 + description: Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga + CreditCardAccountsBillsFinanceCharge: + type: object + required: + - type + - amount + - currency + properties: + type: + $ref: '#/components/schemas/EnumCreditCardAccountsFinanceChargeType' + additionalInfo: + type: string + maxLength: 140 + pattern: '[\w\W\s]*' + example: Informações Adicionais + description: 'Campo livre, de preenchimento obrigatório se selecionado tipo de encargo ''OUTROS''' + amount: + type: string + format: double + maxLength: 20 + minLength: 4 + pattern: '^\d{1,15}\.\d{2,4}$' + example: '100000.0400' + description: Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + maxLength: 3 + pattern: '^(\w{3}){1}$' + example: BRL + description: | + Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + CreditCardAccountsBillsPayment: + type: object + required: + - valueType + - paymentDate + - paymentMode + - amount + - currency + properties: + valueType: + $ref: '#/components/schemas/EnumCreditCardAccountsBillingValueType' + paymentDate: + description: Data efetiva de quando o Pagamento da fatura foi realizado + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + paymentMode: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentMode' + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor pagamento segundo o valueType. + Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + O campo não pode assumir valor negativo por se tratar de um pagamento. + currency: + type: string + pattern: '^(\w{3}){1}$' + maxLength: 3 + description: | + Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil + example: BRL + CreditCardAccountsData: + type: object + description: Conjunto de informações das Contas de pagamento pós paga + required: + - brandName + - companyCnpj + - name + - productType + - creditCardNetwork + - creditCardAccountId + properties: + creditCardAccountId: + type: string + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: XXZTR3459087 + brandName: + type: string + description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' + pattern: '[\w\W\s]*' + maxLength: 80 + example: Organização A + companyCnpj: + type: string + description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' + pattern: '^\d{14}$' + maxLength: 14 + example: '21128159000166' + name: + type: string + description: 'Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: ''conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos' + pattern: '[\w\W\s]*' + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + description: Informações complementares se tipo de Cartão 'OUTROS' + pattern: '[\w\W\s]*' + maxLength: 50 + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS' + pattern: '[\w\W\s]*' + maxLength: 50 + example: AURA CARD + CreditCardAccountsLimitsData: + type: object + description: Conjunto de informações referentes aos limites da conta de pagamento pós-paga. + required: + - creditLineLimitType + - consolidationType + - identificationNumber + - isLimitFlexible + - usedAmountCurrency + - usedAmount + properties: + creditLineLimitType: + $ref: '#/components/schemas/EnumCreditCardAccountsLineLimitType' + consolidationType: + $ref: '#/components/schemas/EnumCreditCardAccountsConsolidationType' + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + lineName: + type: string + enum: + - CREDITO_A_VISTA + - CREDITO_PARCELADO + - SAQUE_CREDITO_BRASIL + - SAQUE_CREDITO_EXTERIOR + - EMPRESTIMO_CARTAO_CONSIGNADO + - OUTROS + example: CREDITO_A_VISTA + lineNameAdditionalInfo: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: Informações adicionais e complementares. + description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. + isLimitFlexible: + type: boolean + description: 'Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).' + example: true + limitAmount: + $ref: '#/components/schemas/CreditCardsLimitAmount' + usedAmount: + $ref: '#/components/schemas/CreditCardsUsedAmount' + availableAmount: + $ref: '#/components/schemas/CreditCardsAvailableAmount' + CreditCardsAccountPaymentMethod: + type: object + description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga + required: + - identificationNumber + - isMultipleCreditCard + properties: + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + isMultipleCreditCard: + type: boolean + description: | + Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. + example: true + CreditCardsLimitAmount: + type: object + description: | + Valor total do limite informado. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os limite informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsUsedAmount: + type: object + description: Valor utilizado do limite informado + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAvailableAmount: + type: object + description: | + Valor disponível do limite informado + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: | + Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsBillTotalAmount: + type: object + required: + - amount + - currency + description: | + Valor total da faturas. + O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillMinimumAmount: + type: object + required: + - amount + - currency + description: | + Valor do pagamento minimo da fatura + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor do pagamento minimo da fatura + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransaction: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - chargeIdentificator + - brazilianAmount + - amount + - transactionDate + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 100 + pattern: '[\w\W\s]*' + example: PGTO + description: Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: PARCELA_1 + description: Identificador da parcela que está sendo informada. Campo de livre preenchimento + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + EnumCreditCardAccountFee: + type: string + description: | + Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. + enum: + - ANUIDADE + - SAQUE_CARTAO_BRASIL + - SAQUE_CARTAO_EXTERIOR + - AVALIACAO_EMERGENCIAL_CREDITO + - EMISSAO_SEGUNDA_VIA + - TARIFA_PAGAMENTO_CONTAS + - SMS + - OUTRA + example: ANUIDADE + EnumCreditCardAccountsBillingValueType: + type: string + description: | + Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) + - Valor de pagamento da fatura com parcelamento + - Valor pagamento da fatura realizado + - Outro Valor pago na fatura + + VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura + + VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura + + OUTRO_VALOR_PAGO_FATURA: Demais casos + enum: + - VALOR_PAGAMENTO_FATURA_PARCELADO + - VALOR_PAGAMENTO_FATURA_REALIZADO + - OUTRO_VALOR_PAGO_FATURA + EnumCreditCardAccountsConsolidationType: + type: string + description: | + Indicador que permite informar se o valor do limite é consolidado ou individual. + + CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. + + INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. + enum: + - CONSOLIDADO + - INDIVIDUAL + example: CONSOLIDADO + EnumCreditCardAccountsFinanceChargeType: + type: string + description: | + Traz a denominação dos Encargos que + incidem na fatura da conta de pagamento pós-paga. (Vide Enum) + - Juros remuneratórios por atraso no pagamento da fatura + - Multa por atraso no pagamento da fatura + - Juros de mora por atraso no pagamento da fatura + - IOF + - Sem Encargo + - Outros + enum: + - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA + - MULTA_ATRASO_PAGAMENTO_FATURA + - JUROS_MORA_ATRASO_PAGAMENTO_FATURA + - IOF + - OUTROS + EnumCreditCardAccountsLineLimitType: + type: string + description: | + Indicador do tipo de limite + + LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. + + LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). + enum: + - LIMITE_CREDITO_TOTAL + - LIMITE_CREDITO_MODALIDADE_OPERACAO + example: LIMITE_CREDITO_TOTAL + EnumCreditCardAccountNetwork: + type: string + description: | + Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). + Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. + enum: + - VISA + - MASTERCARD + - AMERICAN_EXPRESS + - DINERS_CLUB + - HIPERCARD + - BANDEIRA_PROPRIA + - CHEQUE_ELETRONICO + - ELO + - OUTRAS + example: VISA + EnumCreditCardAccountsOtherCreditType: + type: string + description: | + Traz outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. + enum: + - CREDITO_ROTATIVO + - PARCELAMENTO_FATURA + - EMPRESTIMO + - OUTROS + example: CREDITO_ROTATIVO + EnumCreditCardAccountsPaymentMode: + type: string + description: | + Traz as formas de efetivação do pagamento realizado: (Vide Enum) + - Débito em conta corrente + - Boleto bancário + - Averbação em folha + - PIX + enum: + - DEBITO_CONTA_CORRENTE + - BOLETO_BANCARIO + - AVERBACAO_FOLHA + - PIX + EnumCreditCardAccountsPaymentType: + type: string + description: | + Traz os tipos de pagamento. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. + enum: + - A_VISTA + - A_PRAZO + example: A_VISTA + EnumCreditCardAccountsProductType: + type: string + description: 'Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.' + enum: + - CLASSIC_NACIONAL + - CLASSIC_INTERNACIONAL + - GOLD + - PLATINUM + - INFINITE + - ELECTRON + - STANDARD_NACIONAL + - STANDARD_INTERNACIONAL + - ELETRONIC + - BLACK + - REDESHOP + - MAESTRO_MASTERCARD_MAESTRO + - GREEN + - BLUE + - BLUEBOX + - PROFISSIONAL_LIBERAL + - CHEQUE_ELETRONICO + - CORPORATIVO + - EMPRESARIAL + - COMPRAS + - BASICO_NACIONAL + - BASICO_INTERNACIONAL + - NANQUIM + - GRAFITE + - MAIS + - OUTROS + example: OUTROS + EnumCreditCardTransactionType: + type: string + description: Traz os tipos de Transação + enum: + - PAGAMENTO + - TARIFA + - OPERACOES_CREDITO_CONTRATADAS_CARTAO + - ESTORNO + - CASHBACK + - OUTROS + example: CASHBACK + EnumCreditDebitIndicator: + type: string + description: | + Indicador do tipo de lançamento: + Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. + Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. + enum: + - CREDITO + - DEBITO + example: DEBITO + Links: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + last: + type: string + format: uri + maxLength: 2000 + description: URI da última página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + Meta: + type: object + description: Meta informações referente à API requisitada. + required: + - totalRecords + - totalPages + - requestDateTime + properties: + totalRecords: + type: integer + format: int32 + description: Número total de registros no resultado + example: 1 + totalPages: + type: integer + format: int32 + description: Número total de páginas no resultado + example: 1 + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + MetaOnlyRequestDateTime: + type: object + description: Meta informações referente à API requisitada. + required: + - requestDateTime + properties: + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + ResponseCreditCardAccountsList: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: Conjunto de informações de conta de pagamento pós-paga + items: + $ref: '#/components/schemas/CreditCardAccountsData' + minItems: 0 + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsBills: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsIdentification: + type: object + required: + - data + - links + - meta + properties: + data: + $ref: '#/components/schemas/CreditCardsAccountsIdentificationData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsLimits: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: | + [Restrição] A lista vazia deve ser interpretada como a ausência da informação. + + Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + + Cenário de "cartão sem limite", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsLimitsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsTransactions: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/TransactionsLinks' + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseErrorMetaSingle: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseError: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/Meta' + TransactionsLinks: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + XFapiInteractionId: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + parameters: + Authorization: + name: Authorization + in: header + description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado + required: true + schema: + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + billId: + name: billId + in: path + description: Identificador da fatura. + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardAccountId: + name: creditCardAccountId + in: path + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade detro da instituição transmissora' + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardPayeeMCC: + name: payeeMCC + description: 'MCC é o Merchant Category Code, ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades' + required: false + in: query + schema: + type: number + maximum: 9999 + example: 8299 + format: int32 + creditCardTransactionType: + name: transactionType + description: Traz os tipos de Transação + required: false + in: query + schema: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + fromDueDate: + name: fromDueDate + description: Data inicial de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDate: + name: fromTransactionDate + description: | + Data inicial de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDateMaxLimited: + name: fromTransactionDate + description: | + Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + page: + name: page + in: query + description: Número da página que está sendo requisitada (o valor da primeira página é 1). + schema: + type: integer + default: 1 + minimum: 1 + maximum: 2147483647 + format: int32 + pageSize: + name: page-size + in: query + description: Quantidade total de registros por páginas. + schema: + type: integer + default: 25 + minimum: 1 + format: int32 + maximum: 1000 + pagination-key: + name: pagination-key + in: query + description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' + schema: + type: string + maxLength: 2048 + pattern: '[\w\W\s]*' + toDueDate: + name: toDueDate + description: Data final de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDate: + name: toTransactionDate + description: | + Data final de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDateMaxLimited: + name: toTransactionDate + description: | + Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + xCustomerUserAgent: + name: x-customer-user-agent + in: header + description: Indica o user-agent que o usuário utiliza. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiAuthDate: + name: x-fapi-auth-date + in: header + description: 'Data em que o usuário logou pela última vez com o receptor. Representada de acordo com a [RFC7231](https://tools.ietf.org/html/rfc7231).Exemplo: Sun, 10 Sep 2017 19:43:31 UTC' + required: false + schema: + type: string + pattern: '^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$' + minLength: 29 + maxLength: 29 + xFapiCustomerIpAddress: + name: x-fapi-customer-ip-address + in: header + description: O endereço IP do usuário se estiver atualmente logado com o receptor. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiInteractionId: + name: x-fapi-interaction-id + in: header + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + required: false + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + minLength: 1 + maxLength: 100 + securitySchemes: + OpenId: + type: openIdConnect + openIdConnectUrl: 'https://auth.mockbank.poc.raidiam.io/.well-known/openid-configuration' + OAuth2Security: + type: oauth2 + description: Fluxo OAuth necessário para que a receptora tenha acesso aos dados na instituição transmissora. Requer o processo de redirecionamento e autenticação do usuário a que se referem os dados. + flows: + authorizationCode: + authorizationUrl: 'https://authserver.example/authorization' + tokenUrl: 'https://authserver.example/token' + scopes: + credit-cards-accounts: Escopo necessário para acesso à API Credit-cards-accounts. O controle dos endpoints específicos é feito via permissions. + responses: + OKResponseCreditCardAccountsList: + description: Conjunto de informações das Contas de pagamento pós paga + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsList' + OKResponseCreditCardAccountsIdentification: + description: Dados de identificação da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsIdentification' + OKResponseCreditCardAccountsBills: + description: Dados referentes à lista de faturas da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsBills' + OKResponseCreditCardAccountsLimits: + description: Dados dos limites da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsLimits' + OKResponseCreditCardAccountsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsTransactions' + OKResponseCreditCardAccountsBillsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + BadRequest: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Forbidden: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + InternalServerError: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + GatewayTimeout: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Locked: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + MethodNotAllowed: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotAcceptable: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotFound: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + TooManyRequests: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + UnprocessableEntity: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Unauthorized: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + SiteIsOverloaded: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Default: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + BadRequestWithAdditionalProperties: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + ForbiddenWithAdditionalProperties: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + GatewayTimeoutWithAdditionalProperties: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + InternalServerErrorWithAdditionalProperties: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + LockedWithAdditionalProperties: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + MethodNotAllowedWithAdditionalProperties: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotAcceptableWithAdditionalProperties: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotFoundWithAdditionalProperties: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + TooManyRequestsWithAdditionalProperties: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnauthorizedWithAdditionalProperties: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnprocessableEntityWithAdditionalProperties: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + DefaultWithAdditionalProperties: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + SiteIsOverloadedWithAdditionalProperties: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' diff --git a/swagger-apis/credit-cards/index.html b/swagger-apis/credit-cards/index.html index 0e2ce4a15..5a6cad397 100644 --- a/swagger-apis/credit-cards/index.html +++ b/swagger-apis/credit-cards/index.html @@ -54,8 +54,9 @@ {"name": "1.0.4", "url": "./1.0.4.yml"}, {"name": "2.0.0-RC1.0", "url": "./2.0.0-RC1.0.yml"}, {"name": "2.0.0", "url": "./2.0.0.yml"}, - {"name": "2.0.1", "url": "./2.0.1.yml"}], - "urls.primaryName": "2.0.1", // default spec + {"name": "2.0.1", "url": "./2.0.1.yml"}, + {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}], + "urls.primaryName": "2.1.0-rc.1", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[], From a2b18b21457b6b0c20f42c6086dd59807873bf6d Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 15:01:01 -0300 Subject: [PATCH 02/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3005=20-=20Al?= =?UTF-8?q?terar=20descri=C3=A7=C3=A3o=20do=20campo=20transactionName?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ardAccountIdBillsBillIdTransactions_v2.csv | 47 +++++++++++++------ ...GetAccountsCreditCardAccountIdBills_v2.csv | 26 ++++++---- ...etAccountsCreditCardAccountIdLimits_v2.csv | 47 ++++++++++++++----- ...ditCardAccountIdTransactionsCurrent_v2.csv | 47 +++++++++++++------ ...untsCreditCardAccountIdTransactions_v2.csv | 47 +++++++++++++------ ...CardsGetAccountsCreditCardAccountId_v2.csv | 15 ++++-- dictionary/creditCardsGetAccounts_v2.csv | 3 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 2 +- 8 files changed, 164 insertions(+), 70 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 6c4e5defc..487e23aa8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -1,12 +1,14 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo -/data;data;"";Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 -/data/identificationNumber;identificationNumber;Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Banking.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. -Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente.";Texto;;Obrigatório;;"CREDITO +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO DEBITO";1;1;"";Não permitido;string;DEBITO; /data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO TARIFA @@ -14,11 +16,17 @@ OPERACOES_CREDITO_CONTRATADAS_CARTAO ESTORNO CASHBACK OUTROS";1;1;"";Não permitido;string;CASHBACK; -/data/transactionalAdditionalInfo;transactionalAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionado tipo de transação OUTROS;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/paymentType;paymentType;Traz os tipos de pagamento.;Texto;;Condicional;;"A_VISTA +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. ";Não permitido;string;A_VISTA; -/data/feeType;feeType;Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA.;Texto;;Condicional;;"ANUIDADE +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE SAQUE_CARTAO_BRASIL SAQUE_CARTAO_EXTERIOR AVALIACAO_EMERGENCIAL_CREDITO @@ -27,23 +35,34 @@ TARIFA_PAGAMENTO_CONTAS SMS OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. ";Não permitido;string;ANUIDADE; -/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa OUTRA;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/otherCreditsType;otherCreditsType;Traz outros tipos de crédito contratados no cartão.;Texto;;Condicional;;"CREDITO_ROTATIVO +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO PARCELAMENTO_FATURA EMPRESTIMO OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. ";Não permitido;string;CREDITO_ROTATIVO; -/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão.;Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; /data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; -/data/chargeNumber;chargeNumber;Quantidade de parcelas.;Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Não permitido;number;12; -/data/brazilianAmount;brazilianAmount;Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional).;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/amount;amount;Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; /data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; -/data/payeeMCC;payeeMCC;O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines).;Número;;Opcional;;;0;1;"";Não permitido;number;5137; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv index 73d716841..cc89fdd8a 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv @@ -1,12 +1,14 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo -/data;data;"";Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/billId;billId;Informação que identifica a fatura;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;3459087XXZTR;1 /data/dueDate;dueDate;Data de vencimento da Fatura, que aparece para pagamento pelo cliente;Data;10;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/billTotalAmount;billTotalAmount;"Valor total da faturas. -O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor.";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/billTotalAmount/amount;amount;Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Obrigatório;^-?\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/billTotalAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/billMinimumAmount;billMinimumAmount;Valor do pagamento minimo da fatura;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/billMinimumAmount;billMinimumAmount;"Valor do pagamento minimo da fatura +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/billMinimumAmount/amount;amount;Valor do pagamento minimo da fatura;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/billMinimumAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; /data/isInstalment;isInstalment;Indica se a fatura permite parcelamento (true) ou não (false).;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;false; @@ -18,7 +20,8 @@ incidem na fatura da conta de pagamento pós-paga. (Vide Enum) - Juros de mora por atraso no pagamento da fatura - IOF - Sem Encargo -- Outros";Texto;;Obrigatório;;"JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA +- Outros +";Texto;;Obrigatório;;"JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA MULTA_ATRASO_PAGAMENTO_FATURA JUROS_MORA_ATRASO_PAGAMENTO_FATURA IOF @@ -26,7 +29,8 @@ OUTROS";1;1;"";Não permitido;string;; /data/financeCharges/additionalInfo;additionalInfo;Campo livre, de preenchimento obrigatório se selecionado tipo de encargo 'OUTROS';Texto;140;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações Adicionais; /data/financeCharges/amount;amount;Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;100000.0400;4 /data/financeCharges/currency;currency;"Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' -Todos os saldos informados estão representados com a moeda vigente do Brasil.";Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; +Todos os saldos informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; /data/payments;payments;Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/payments/valueType;valueType;"Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) - Valor de pagamento da fatura com parcelamento @@ -37,7 +41,8 @@ Todos os saldos informados estão representados com a moeda vigente do Brasil."; VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura - OUTRO_VALOR_PAGO_FATURA: Demais casos";Texto;;Obrigatório;;"VALOR_PAGAMENTO_FATURA_PARCELADO + OUTRO_VALOR_PAGO_FATURA: Demais casos +";Texto;;Obrigatório;;"VALOR_PAGAMENTO_FATURA_PARCELADO VALOR_PAGAMENTO_FATURA_REALIZADO OUTRO_VALOR_PAGO_FATURA";1;1;"";Não permitido;string;; /data/payments/paymentDate;paymentDate;Data efetiva de quando o Pagamento da fatura foi realizado;Data;10;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; @@ -45,11 +50,14 @@ OUTRO_VALOR_PAGO_FATURA";1;1;"";Não permitido;string;; - Débito em conta corrente - Boleto bancário - Averbação em folha -- PIX";Texto;;Obrigatório;;"DEBITO_CONTA_CORRENTE +- PIX +";Texto;;Obrigatório;;"DEBITO_CONTA_CORRENTE BOLETO_BANCARIO AVERBACAO_FOLHA PIX";1;1;"";Não permitido;string;; /data/payments/amount;amount;"Valor pagamento segundo o valueType. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. -O campo não pode assumir valor negativo por se tratar de um pagamento.";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 -/data/payments/currency;currency;Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil;Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; +O campo não pode assumir valor negativo por se tratar de um pagamento. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/payments/currency;currency;"Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil +";Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv index d9303d2ae..a4f14865a 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv @@ -1,5 +1,10 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo -/data;data;"";Lista;;Condicional;;;0;N;" A lista vazia deve ser interpretada como a ausência da informação. +/data;data;"[Restrição] A lista vazia deve ser interpretada como a ausência da informação. + +Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + +Cenário de ""cartão sem limite"", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. +";Lista;;Obrigatório;;;0;N;" A lista vazia deve ser interpretada como a ausência da informação. Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. @@ -9,16 +14,19 @@ Cenário de ""cartão sem limite"", isto é, cartões em que o uso do limite é LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. -LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição).";Texto;;Obrigatório;;"LIMITE_CREDITO_TOTAL +LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). +";Texto;;Obrigatório;;"LIMITE_CREDITO_TOTAL LIMITE_CREDITO_MODALIDADE_OPERACAO";1;1;"";Não permitido;string;LIMITE_CREDITO_TOTAL; /data/consolidationType;consolidationType;"Indicador que permite informar se o valor do limite é consolidado ou individual. CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. -INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado.";Texto;;Obrigatório;;"CONSOLIDADO +INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. +";Texto;;Obrigatório;;"CONSOLIDADO INDIVIDUAL";1;1;"";Não permitido;string;CONSOLIDADO; -/data/identificationNumber;identificationNumber;Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Banking.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/lineName;lineName;"";Texto;;Opcional;;"CREDITO_A_VISTA +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/lineName;lineName;;Texto;;Opcional;;"CREDITO_A_VISTA CREDITO_PARCELADO SAQUE_CREDITO_BRASIL SAQUE_CREDITO_EXTERIOR @@ -26,19 +34,34 @@ EMPRESTIMO_CARTAO_CONSIGNADO OUTROS";0;1;"";Não permitido;string;CREDITO_A_VISTA; /data/lineNameAdditionalInfo;lineNameAdditionalInfo;Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações adicionais e complementares.; /data/isLimitFlexible;isLimitFlexible;Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; -/data/limitAmount;limitAmount;Valor total do limite informado.;Objeto;;Opcional;;;0;1;"";Não permitido;object;; -/data/limitAmount/amount;amount;Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;20;Condicional;^\d{1,15}\.\d{2,4}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +/data/limitAmount;limitAmount;"Valor total do limite informado. +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/limitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;1000.0400;4 /data/limitAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' -Todos os limite informados estão representados com a moeda vigente do Brasil.";Texto;3;Condicional;^[A-Z]{3}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +Todos os limite informados estão representados com a moeda vigente do Brasil. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;BRL; /data/usedAmount;usedAmount;Valor utilizado do limite informado;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/usedAmount/amount;amount;Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Obrigatório;^-?\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/usedAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' -Todos os saldos informados estão representados com a moeda vigente do Brasil.";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/availableAmount;availableAmount;Valor disponível do limite informado;Objeto;;Opcional;;;0;1;"";Não permitido;object;; -/data/availableAmount/amount;amount;Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Condicional;^-?\d{1,15}\.\d{2,4}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +Todos os saldos informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/availableAmount;availableAmount;"Valor disponível do limite informado +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/availableAmount/amount;amount;"Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;21;Condicional;^-?\d{1,15}\.\d{2,4}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;1000.0400;4 /data/availableAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' -Todos os saldos informados estão representados com a moeda vigente do Brasil.";Texto;3;Condicional;^[A-Z]{3}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +Todos os saldos informados estão representados com a moeda vigente do Brasil. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;3;Condicional;^[A-Z]{3}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;BRL; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 6c4e5defc..487e23aa8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -1,12 +1,14 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo -/data;data;"";Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 -/data/identificationNumber;identificationNumber;Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Banking.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. -Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente.";Texto;;Obrigatório;;"CREDITO +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO DEBITO";1;1;"";Não permitido;string;DEBITO; /data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO TARIFA @@ -14,11 +16,17 @@ OPERACOES_CREDITO_CONTRATADAS_CARTAO ESTORNO CASHBACK OUTROS";1;1;"";Não permitido;string;CASHBACK; -/data/transactionalAdditionalInfo;transactionalAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionado tipo de transação OUTROS;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/paymentType;paymentType;Traz os tipos de pagamento.;Texto;;Condicional;;"A_VISTA +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. ";Não permitido;string;A_VISTA; -/data/feeType;feeType;Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA.;Texto;;Condicional;;"ANUIDADE +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE SAQUE_CARTAO_BRASIL SAQUE_CARTAO_EXTERIOR AVALIACAO_EMERGENCIAL_CREDITO @@ -27,23 +35,34 @@ TARIFA_PAGAMENTO_CONTAS SMS OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. ";Não permitido;string;ANUIDADE; -/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa OUTRA;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/otherCreditsType;otherCreditsType;Traz outros tipos de crédito contratados no cartão.;Texto;;Condicional;;"CREDITO_ROTATIVO +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO PARCELAMENTO_FATURA EMPRESTIMO OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. ";Não permitido;string;CREDITO_ROTATIVO; -/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão.;Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; /data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; -/data/chargeNumber;chargeNumber;Quantidade de parcelas.;Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Não permitido;number;12; -/data/brazilianAmount;brazilianAmount;Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional).;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/amount;amount;Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; /data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; -/data/payeeMCC;payeeMCC;O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines).;Número;;Opcional;;;0;1;"";Não permitido;number;5137; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 6c4e5defc..487e23aa8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -1,12 +1,14 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo -/data;data;"";Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 -/data/identificationNumber;identificationNumber;Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Banking.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. -Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente.";Texto;;Obrigatório;;"CREDITO +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO DEBITO";1;1;"";Não permitido;string;DEBITO; /data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO TARIFA @@ -14,11 +16,17 @@ OPERACOES_CREDITO_CONTRATADAS_CARTAO ESTORNO CASHBACK OUTROS";1;1;"";Não permitido;string;CASHBACK; -/data/transactionalAdditionalInfo;transactionalAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionado tipo de transação OUTROS;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/paymentType;paymentType;Traz os tipos de pagamento.;Texto;;Condicional;;"A_VISTA +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. ";Não permitido;string;A_VISTA; -/data/feeType;feeType;Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA.;Texto;;Condicional;;"ANUIDADE +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE SAQUE_CARTAO_BRASIL SAQUE_CARTAO_EXTERIOR AVALIACAO_EMERGENCIAL_CREDITO @@ -27,23 +35,34 @@ TARIFA_PAGAMENTO_CONTAS SMS OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. ";Não permitido;string;ANUIDADE; -/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa OUTRA;Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; -/data/otherCreditsType;otherCreditsType;Traz outros tipos de crédito contratados no cartão.;Texto;;Condicional;;"CREDITO_ROTATIVO +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO PARCELAMENTO_FATURA EMPRESTIMO OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. ";Não permitido;string;CREDITO_ROTATIVO; -/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão.;Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; /data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; -/data/chargeNumber;chargeNumber;Quantidade de parcelas.;Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Não permitido;number;12; -/data/brazilianAmount;brazilianAmount;Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional).;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/amount;amount;Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; /data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; -/data/payeeMCC;payeeMCC;O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines).;Número;;Opcional;;;0;1;"";Não permitido;number;5137; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountId_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountId_v2.csv index be1b467fe..cb4d72660 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountId_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountId_v2.csv @@ -1,6 +1,7 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;Conjunto de informações referentes à identificação da conta de pagamento pós-paga.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; -/data/name;name;Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'.;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Cartão Universitário; +/data/name;name;"Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. +";Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Cartão Universitário; /data/productType;productType;Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.;Texto;;Obrigatório;;"CLASSIC_NACIONAL CLASSIC_INTERNACIONAL GOLD @@ -29,7 +30,8 @@ MAIS OUTROS";1;1;"";Não permitido;string;OUTROS; /data/productAdditionalInfo;productAdditionalInfo;Informações complementares se tipo de Cartão 'OUTROS';Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;OURO_INTERNACIONAL; /data/creditCardNetwork;creditCardNetwork;"Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). -Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores.";Texto;;Obrigatório;;"VISA +Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. +";Texto;;Obrigatório;;"VISA MASTERCARD AMERICAN_EXPRESS DINERS_CLUB @@ -39,6 +41,9 @@ CHEQUE_ELETRONICO ELO OUTRAS";1;1;"";Não permitido;string;VISA; /data/networkAdditionalInfo;networkAdditionalInfo;Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;AURA CARD; -/data/paymentMethod;paymentMethod;Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários.;Lista;;Obrigatório;;;1;N;"";Não permitido;array;; -/data/paymentMethod/identificationNumber;identificationNumber;Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Banking.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/paymentMethod/isMultipleCreditCard;isMultipleCreditCard;Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito.;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; +/data/paymentMethod;paymentMethod;"Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. +";Lista;;Obrigatório;;;1;N;"";Não permitido;array;; +/data/paymentMethod/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/paymentMethod/isMultipleCreditCard;isMultipleCreditCard;"Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. +";Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; diff --git a/dictionary/creditCardsGetAccounts_v2.csv b/dictionary/creditCardsGetAccounts_v2.csv index b5d7be0b4..8a60eea07 100644 --- a/dictionary/creditCardsGetAccounts_v2.csv +++ b/dictionary/creditCardsGetAccounts_v2.csv @@ -32,7 +32,8 @@ MAIS OUTROS";1;1;"";Não permitido;string;OUTROS; /data/productAdditionalInfo;productAdditionalInfo;Informações complementares se tipo de Cartão 'OUTROS';Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;; /data/creditCardNetwork;creditCardNetwork;"Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). -Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores.";Texto;;Obrigatório;;"VISA +Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. +";Texto;;Obrigatório;;"VISA MASTERCARD AMERICAN_EXPRESS DINERS_CLUB diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 889608037..928d31e2a 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -926,7 +926,7 @@ components: maxLength: 100 pattern: '[\w\W\s]*' example: PGTO - description: Campo de livre preenchimento. Literal usada na instituição financeira para identificar a transação + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). billId: type: string maxLength: 100 From 342f8ae4b492a22ca48f2c879e00f0b3da924ab8 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 15:06:06 -0300 Subject: [PATCH 03/26] feat(Credit Cards): ORB-3006 - PA118 - Alterar propriedade do campo transactionName --- ...GetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv | 2 +- ...ardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv | 2 +- ...creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 487e23aa8..6ff38c2f8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -3,7 +3,7 @@ /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 487e23aa8..6ff38c2f8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -3,7 +3,7 @@ /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 487e23aa8..6ff38c2f8 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -3,7 +3,7 @@ /data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 -/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;100;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; /data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 928d31e2a..dcdf6fa81 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -923,7 +923,7 @@ components: Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. transactionName: type: string - maxLength: 100 + maxLength: 200 pattern: '[\w\W\s]*' example: PGTO description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). From 3e82c62dba6d4ef9c903032beee394cb0ec19660 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 18 Jul 2023 15:41:41 -0300 Subject: [PATCH 04/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3007=20-=20PA?= =?UTF-8?q?123=20-=20Incluir=20campo=20nos=20tr=C3=AAs=20endpints=20de=20t?= =?UTF-8?q?ransa=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...tCardAccountIdBillsBillIdTransactions_v2.csv | 5 ++++- ...reditCardAccountIdTransactionsCurrent_v2.csv | 5 ++++- ...countsCreditCardAccountIdTransactions_v2.csv | 5 ++++- swagger-apis/credit-cards/2.1.0-rc.1.yml | 17 ++++++++++------- 4 files changed, 22 insertions(+), 10 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 6ff38c2f8..0f7004d04 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -62,7 +62,10 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). ";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 6ff38c2f8..0f7004d04 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -62,7 +62,10 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). ";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 6ff38c2f8..0f7004d04 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -62,7 +62,10 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; -/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; /data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). ";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index dcdf6fa81..4116556b7 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -903,7 +903,7 @@ components: - chargeIdentificator - brazilianAmount - amount - - transactionDate + - transactionDateTime - billPostDate properties: transactionId: @@ -980,13 +980,16 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' - transactionDate: + transactionDateTime: type: string - format: date - maxLength: 20 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - description: Data original da transação + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. billPostDate: type: string format: date From ca7b2d725a3e7eee8b0a1b4770e9afed255bf9c3 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 25 Jul 2023 11:08:38 -0300 Subject: [PATCH 05/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3059=20-=20PA?= =?UTF-8?q?126=20-=20isLimitFlexible=20-=20alterar=20descri=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv index a4f14865a..b5f6dea86 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv @@ -33,7 +33,7 @@ SAQUE_CREDITO_EXTERIOR EMPRESTIMO_CARTAO_CONSIGNADO OUTROS";0;1;"";Não permitido;string;CREDITO_A_VISTA; /data/lineNameAdditionalInfo;lineNameAdditionalInfo;Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações adicionais e complementares.; -/data/isLimitFlexible;isLimitFlexible;Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; +/data/isLimitFlexible;isLimitFlexible;True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente.;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; /data/limitAmount;limitAmount;"Valor total do limite informado. ";Objeto;;Opcional;;;0;1;"";Não permitido;object;; /data/limitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 4116556b7..43d1c777b 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -741,7 +741,7 @@ components: description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. isLimitFlexible: type: boolean - description: 'Indica se a operação de crédito é: com limite flexível (true) ou com limite (false).' + description: True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente. example: true limitAmount: $ref: '#/components/schemas/CreditCardsLimitAmount' From 6f9e2826fd8bc93254d7e909f57392c08c269af5 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 25 Jul 2023 11:16:26 -0300 Subject: [PATCH 06/26] feat(Credit Cards): ORB-3060 - PA127 - Novo campo --- ...reditCardsGetAccountsCreditCardAccountIdLimits_v2.csv | 5 +++++ swagger-apis/credit-cards/2.1.0-rc.1.yml | 9 +++++++++ 2 files changed, 14 insertions(+) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv index b5f6dea86..14fff39f3 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv @@ -47,6 +47,11 @@ Todos os limite informados estão representados com a moeda vigente do Brasil. [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. ";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;BRL; +/data/limitAmount/limitAmountReason;limitAmountReason;"Razão pela qual o valor total do limite informado está igual a zero. + +[Restrição] Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. +";Texto;200;Condicional;[\w\W\s]*;;0;1;" Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. +";Não permitido;string;O perfil do cliente passou por uma análise e o limite precisou ser zerado; /data/usedAmount;usedAmount;Valor utilizado do limite informado;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/usedAmount/amount;amount;Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Obrigatório;^-?\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/usedAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 43d1c777b..835bf7d37 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -798,6 +798,15 @@ components: [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. example: BRL + limitAmountReason: + type: string + pattern: '[\w\W\s]*' + maxLength: 200 + description: | + Razão pela qual o valor total do limite informado está igual a zero. + + [Restrição] Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. + example: O perfil do cliente passou por uma análise e o limite precisou ser zerado CreditCardsUsedAmount: type: object description: Valor utilizado do limite informado From f5a8d8f609c52fcdcddb2c6a1343c8ffb6e4ac04 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 25 Jul 2023 11:20:58 -0300 Subject: [PATCH 07/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3062=20-=20PA?= =?UTF-8?q?128=20-=20chargeIdentificator=20-=20altera=C3=A7=C3=B5es?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...sCreditCardAccountIdBillsBillIdTransactions_v2.csv | 2 +- ...ountsCreditCardAccountIdTransactionsCurrent_v2.csv | 2 +- ...sGetAccountsCreditCardAccountIdTransactions_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 11 ++++++----- 4 files changed, 9 insertions(+), 8 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 0f7004d04..7bf84214d 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -49,7 +49,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; +/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 0f7004d04..7bf84214d 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -49,7 +49,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; +/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 0f7004d04..7bf84214d 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -49,7 +49,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Identificador da parcela que está sendo informada. Campo de livre preenchimento;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PARCELA_1; +/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 835bf7d37..17a422334 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -972,11 +972,12 @@ components: [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". chargeIdentificator: - type: string - maxLength: 50 - pattern: '[\w\W\s]*' - example: PARCELA_1 - description: Identificador da parcela que está sendo informada. Campo de livre preenchimento + type: number + format: integer + description: Número da parcela que está sendo informada. + minimum: 1 + maximum: 999 + example: 12 chargeNumber: type: number format: integer From 6b58c939b21d8f0949e83e5ad13a3414a610a90d Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Thu, 27 Jul 2023 09:03:22 -0300 Subject: [PATCH 08/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3073=20-=20PA?= =?UTF-8?q?132=20-=20limitAmount=20-=20Alterar=20descri=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv index 14fff39f3..32c0e6f1b 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv @@ -34,7 +34,7 @@ EMPRESTIMO_CARTAO_CONSIGNADO OUTROS";0;1;"";Não permitido;string;CREDITO_A_VISTA; /data/lineNameAdditionalInfo;lineNameAdditionalInfo;Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações adicionais e complementares.; /data/isLimitFlexible;isLimitFlexible;True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente.;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; -/data/limitAmount;limitAmount;"Valor total do limite informado. +/data/limitAmount;limitAmount;"Valor total do limite concedido. ";Objeto;;Opcional;;;0;1;"";Não permitido;object;; /data/limitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 17a422334..e5247abc6 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -772,7 +772,7 @@ components: CreditCardsLimitAmount: type: object description: | - Valor total do limite informado. + Valor total do limite concedido. required: - amount - currency From f91d965b396be1f0ee0c2a86a8dfd3829286ec0f Mon Sep 17 00:00:00 2001 From: Cecilia Fernandes <115801960+CeciliaFFernandes@users.noreply.github.com> Date: Mon, 31 Jul 2023 16:49:31 +0000 Subject: [PATCH 09/26] feat(Credit Cards): ORB-3074 - PA133 - customizedLimitAmount - criar objeto --- ...etAccountsCreditCardAccountIdLimits_v2.csv | 6 +++++ swagger-apis/credit-cards/2.1.0-rc.1.yml | 24 +++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv index 32c0e6f1b..c28840e74 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v2.csv @@ -70,3 +70,9 @@ Todos os saldos informados estão representados com a moeda vigente do Brasil. [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. ";Texto;3;Condicional;^[A-Z]{3}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. ";Não permitido;string;BRL; +/data/customizedLimitAmount;customizedLimitAmount;"Valor total do limite customizado pelo cliente nos canais eletrônicos da instituição. Esse objeto é de envio obrigatório nos casos em que a instituição permita ao cliente alterar o seu limite. +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/customizedLimitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/customizedLimitAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' Todos os limite informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index e5247abc6..d72e18f1f 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -749,6 +749,30 @@ components: $ref: '#/components/schemas/CreditCardsUsedAmount' availableAmount: $ref: '#/components/schemas/CreditCardsAvailableAmount' + customizedLimitAmount: + type: object + description: | + Valor total do limite customizado pelo cliente nos canais eletrônicos da instituição. Esse objeto é de envio obrigatório nos casos em que a instituição permita ao cliente alterar o seu limite. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' Todos os limite informados estão representados com a moeda vigente do Brasil. + example: BRL CreditCardsAccountPaymentMethod: type: object description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga From 85ed78a7ebbd2f323f9f7758e660592a130aeb9b Mon Sep 17 00:00:00 2001 From: Cecilia Fernandes <115801960+CeciliaFFernandes@users.noreply.github.com> Date: Mon, 31 Jul 2023 16:52:32 +0000 Subject: [PATCH 10/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3075=20-=20PA?= =?UTF-8?q?134=20-=20Resqu=C3=ADcio=20-=20usedAmountCurrency?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/2.1.0-rc.1.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index d72e18f1f..4b8d0f169 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -708,7 +708,6 @@ components: - consolidationType - identificationNumber - isLimitFlexible - - usedAmountCurrency - usedAmount properties: creditLineLimitType: From 70942a1ba0086dfd61729c6b0978d700b3693bb3 Mon Sep 17 00:00:00 2001 From: Cecilia Fernandes <115801960+CeciliaFFernandes@users.noreply.github.com> Date: Mon, 31 Jul 2023 17:37:14 +0000 Subject: [PATCH 11/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3096=20-=20PA?= =?UTF-8?q?138=20-=20=20Ajuste=20da=20descri=C3=A7=C3=A3o=20do=20campo?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv | 1 - swagger-apis/credit-cards/2.1.0-rc.1.yml | 1 - 2 files changed, 2 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv index cc89fdd8a..7c31109fc 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v2.csv @@ -19,7 +19,6 @@ incidem na fatura da conta de pagamento pós-paga. (Vide Enum) - Multa por atraso no pagamento da fatura - Juros de mora por atraso no pagamento da fatura - IOF -- Sem Encargo - Outros ";Texto;;Obrigatório;;"JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA MULTA_ATRASO_PAGAMENTO_FATURA diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 4b8d0f169..7250316cf 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -1091,7 +1091,6 @@ components: - Multa por atraso no pagamento da fatura - Juros de mora por atraso no pagamento da fatura - IOF - - Sem Encargo - Outros enum: - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA From 5bfed6f43dc13e9f8657f9b35c4fb59e750bca9f Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 14:16:23 -0300 Subject: [PATCH 12/26] feat(Credit Cards): ORB-3188 - PA150 - transactionId - mandatoriedade --- ...ditCardAccountIdTransactionsCurrent_v2.csv | 2 +- ...untsCreditCardAccountIdTransactions_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 116 +++++++++++++++++- 3 files changed, 117 insertions(+), 3 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 7bf84214d..260939b4d 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -1,6 +1,6 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 7bf84214d..260939b4d 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -1,6 +1,6 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 7250316cf..ed03286d5 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -924,10 +924,124 @@ components: maxLength: 3 description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' example: BRL + CreditCardAccountsBillsTransactions: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - chargeIdentificator + - brazilianAmount + - amount + - transactionDateTime + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: number + format: integer + description: Número da parcela que está sendo informada. + minimum: 1 + maximum: 999 + example: 12 + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDateTime: + type: string + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). CreditCardAccountsTransaction: type: object description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga required: + - transactionId - identificationNumber - transactionName - creditDebitType @@ -1747,7 +1861,7 @@ components: type: array minItems: 0 items: - $ref: '#/components/schemas/CreditCardAccountsTransaction' + $ref: '#/components/schemas/CreditCardAccountsBillsTransactions' links: $ref: '#/components/schemas/Links' meta: From 4b5900b4852bfc7a7b2519a1954fbe4ddac257c0 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 14:19:58 -0300 Subject: [PATCH 13/26] feat(Credit Cards): ORB-3190 - PA151 - faturas - transactionId --- ...tAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv | 4 +++- swagger-apis/credit-cards/2.1.0-rc.1.yml | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 7bf84214d..a37134a98 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -1,6 +1,8 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +É esperado que o `transactionId` seja único, imutável e estável. +";Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index ed03286d5..45a042772 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -944,7 +944,9 @@ components: minLength: 1 pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl - description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + description: | + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + É esperado que o `transactionId` seja único, imutável e estável. identificationNumber: type: string maxLength: 100 From 7faed9aa4ad73ae2e737d1df98c4040f63cffca4 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 14:21:51 -0300 Subject: [PATCH 14/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3201=20-=20PA?= =?UTF-8?q?156=20-=20Transa=C3=A7=C3=B5es=20-=20billId=20-=20Descri=C3=A7?= =?UTF-8?q?=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv | 2 +- ...creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 260939b4d..76dfc40d0 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -4,7 +4,7 @@ /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; -/data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 +/data/billId;billId;Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 260939b4d..76dfc40d0 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -4,7 +4,7 @@ /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; -/data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 +/data/billId;billId;Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 /data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 45a042772..4179ee943 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -1081,7 +1081,7 @@ components: minLength: 1 pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM - description: Informação que identifica a fatura onde consta a transação informada. + description: Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta. creditDebitType: $ref: '#/components/schemas/EnumCreditDebitIndicator' transactionType: From 13e48878f32137cecbde36fa0b0afdc7ab45fb59 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 15:12:19 -0300 Subject: [PATCH 15/26] feat(Credit Cards): ORB-3190 - PA151 - faturas - transactionId --- ...GetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv | 2 +- swagger-apis/credit-cards/2.1.0-rc.1.yml | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index a37134a98..ef28f424c 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -2,7 +2,7 @@ /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. É esperado que o `transactionId` seja único, imutável e estável. -";Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 4179ee943..7a668b21c 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -928,6 +928,7 @@ components: type: object description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga required: + - transactionId - identificationNumber - transactionName - creditDebitType From 33bc087205aab65563f2ddb241498eee49e5dcdc Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 16:10:20 -0300 Subject: [PATCH 16/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3187=20-=20PA?= =?UTF-8?q?150=20-=20transactionId=20-=20Altera=C3=A7=C3=B5es=20-=20descri?= =?UTF-8?q?=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...sGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv | 5 ++++- ...ditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv | 5 ++++- swagger-apis/credit-cards/2.1.0-rc.1.yml | 5 ++++- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 76dfc40d0..428ead994 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -1,6 +1,9 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: + +- Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 76dfc40d0..428ead994 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -1,6 +1,9 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: + +- Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 /data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 7a668b21c..79c848154 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -1061,7 +1061,10 @@ components: minLength: 1 pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl - description: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + description: | + - Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: + + - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API identificationNumber: type: string maxLength: 100 From e495899e001f0e2200a511b503e2e1d99bb137aa Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 8 Aug 2023 16:19:30 -0300 Subject: [PATCH 17/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3189=20-=20PA?= =?UTF-8?q?150=20-=20transactionId=20-=20Altera=C3=A7=C3=B5es=20-=20tabela?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ditCardAccountIdTransactionsCurrent_v2.csv | 15 +++++++++ ...untsCreditCardAccountIdTransactions_v2.csv | 15 +++++++++ swagger-apis/credit-cards/2.1.0-rc.1.yml | 31 +++++++++++++++++++ 3 files changed, 61 insertions(+) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 428ead994..a43fed513 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -1,6 +1,21 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: +``` +|-------------------|-------------------------|-----------------------| +| Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | +|-------------------|-------------------------|-----------------------| +| PAGAMENTO | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| TARIFA | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| OPERACOES_CRED | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| ESTORNO | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| CASHBACK | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 428ead994..a43fed513 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -1,6 +1,21 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; /data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: +``` +|-------------------|-------------------------|-----------------------| +| Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | +|-------------------|-------------------------|-----------------------| +| PAGAMENTO | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| TARIFA | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| OPERACOES_CRED | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| ESTORNO | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +| CASHBACK | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| +``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 79c848154..eb8a09258 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -53,6 +53,22 @@ info: ### `/accounts/{creditCardAccountId}/transactions-current` - permissions: - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + + ``` + |-------------------|-------------------------|-----------------------| + | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | + |-------------------|-------------------------|-----------------------| + | PAGAMENTO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | TARIFA | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OPERACOES_CRED | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | ESTORNO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | CASHBACK | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + ``` version: 2.1.0-rc.1 license: name: Apache 2.0 @@ -1063,6 +1079,21 @@ components: example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl description: | - Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: + ``` + |-------------------|-------------------------|-----------------------| + | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | + |-------------------|-------------------------|-----------------------| + | PAGAMENTO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | TARIFA | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OPERACOES_CRED | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | ESTORNO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | CASHBACK | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + ``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API identificationNumber: From c55b393cd7e9acc4db19f8c3fd00e079639364b8 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Wed, 9 Aug 2023 11:33:12 -0300 Subject: [PATCH 18/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3189=20-=20PA?= =?UTF-8?q?150=20-=20transactionId=20-=20Altera=C3=A7=C3=B5es=20-=20tabela?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/2.1.0-rc.1.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index eb8a09258..35a2d393b 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -54,7 +54,8 @@ info: - permissions: - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** - ``` + ## Tabela: Data de imutabilidade por tipo de transação + ``` |-------------------|-------------------------|-----------------------| | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | |-------------------|-------------------------|-----------------------| From 93660b1f7617973a7e7e13dde4a7be6592b03b06 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Wed, 9 Aug 2023 13:31:49 -0300 Subject: [PATCH 19/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3189=20-=20PA?= =?UTF-8?q?150=20-=20transactionId=20-=20Altera=C3=A7=C3=B5es=20-=20tabela?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...dsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv | 2 ++ ...editCardsGetAccountsCreditCardAccountIdTransactions_v2.csv | 2 ++ swagger-apis/credit-cards/2.1.0-rc.1.yml | 4 ++++ 3 files changed, 8 insertions(+) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index a43fed513..9255b024b 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -15,6 +15,8 @@ |-------------------|-------------------------|-----------------------| | CASHBACK | DO | Fatura fechada | |-------------------|-------------------------|-----------------------| +| OUTROS | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| ``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index a43fed513..9255b024b 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -15,6 +15,8 @@ |-------------------|-------------------------|-----------------------| | CASHBACK | DO | Fatura fechada | |-------------------|-------------------------|-----------------------| +| OUTROS | DO | Fatura fechada | +|-------------------|-------------------------|-----------------------| ``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 35a2d393b..e144d9551 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -69,6 +69,8 @@ info: |-------------------|-------------------------|-----------------------| | CASHBACK | DO | Fatura fechada | |-------------------|-------------------------|-----------------------| + | OUTROS | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| ``` version: 2.1.0-rc.1 license: @@ -1094,6 +1096,8 @@ components: |-------------------|-------------------------|-----------------------| | CASHBACK | DO | Fatura fechada | |-------------------|-------------------------|-----------------------| + | OUTROS | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| ``` - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API From c658fba2c1795721cf31fee5f2416bebfb0409b8 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Fri, 11 Aug 2023 15:17:50 -0300 Subject: [PATCH 20/26] feat(Credit Cards): ORB-3288 - PA150 - transactionId - Remover tabela campo --- ...ditCardAccountIdTransactionsCurrent_v2.csv | 25 ++++--------------- ...untsCreditCardAccountIdTransactions_v2.csv | 25 ++++--------------- swagger-apis/credit-cards/2.1.0-rc.1.yml | 25 ++++--------------- 3 files changed, 15 insertions(+), 60 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 9255b024b..d8b5c457f 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -1,25 +1,10 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: -``` -|-------------------|-------------------------|-----------------------| -| Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | -|-------------------|-------------------------|-----------------------| -| PAGAMENTO | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| TARIFA | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| OPERACOES_CRED | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| ESTORNO | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| CASHBACK | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| OUTROS | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -``` - -- Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +O ideal é que o `transactionId` seja imutável. +No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. +Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. +O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 9255b024b..d8b5c457f 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -1,25 +1,10 @@ Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo /data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; -/data/transactionId;transactionId;"- Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: -``` -|-------------------|-------------------------|-----------------------| -| Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | -|-------------------|-------------------------|-----------------------| -| PAGAMENTO | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| TARIFA | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| OPERACOES_CRED | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| ESTORNO | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| CASHBACK | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -| OUTROS | DO | Fatura fechada | -|-------------------|-------------------------|-----------------------| -``` - -- Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +O ideal é que o `transactionId` seja imutável. +No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. +Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. +O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 /data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. ";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index e144d9551..6fe92debd 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -1081,26 +1081,11 @@ components: pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl description: | - - Caso a tabela fique na descrição do campo: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas na tabela a seguir: - ``` - |-------------------|-------------------------|-----------------------| - | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | - |-------------------|-------------------------|-----------------------| - | PAGAMENTO | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - | TARIFA | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - | OPERACOES_CRED | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - | ESTORNO | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - | CASHBACK | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - | OUTROS | DO | Fatura fechada | - |-------------------|-------------------------|-----------------------| - ``` - - - Caso a tabela fique nas orientações da API: Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. O ideal é que o `transactionId` seja imutável. No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + O ideal é que o `transactionId` seja imutável. + No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. + Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. + O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API identificationNumber: type: string maxLength: 100 From c29cbdfd6ca2d205aac51c27a7e7ed0b26a1598a Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Wed, 16 Aug 2023 14:54:47 -0300 Subject: [PATCH 21/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3367=20-=20Cr?= =?UTF-8?q?iar=20nova=20vers=C3=A3o=20da=20API?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/2.1.0-rc.2.yml | 2051 ++++++++++++++++++++++ swagger-apis/credit-cards/index.html | 5 +- 2 files changed, 2054 insertions(+), 2 deletions(-) create mode 100644 swagger-apis/credit-cards/2.1.0-rc.2.yml diff --git a/swagger-apis/credit-cards/2.1.0-rc.2.yml b/swagger-apis/credit-cards/2.1.0-rc.2.yml new file mode 100644 index 000000000..b12580701 --- /dev/null +++ b/swagger-apis/credit-cards/2.1.0-rc.2.yml @@ -0,0 +1,2051 @@ +openapi: 3.0.0 +info: + title: API Credit-cards-accounts - Open Finance Brasil + description: | + API de contas de pagamento pós-pagas do Open Finance Brasil – Fase 2. + API que retorna informações de contas de pagamento pós-paga mantidas nas instituições transmissoras por seus clientes, incluindo dados como denominação, produto, bandeira, limites de crédito, informações sobre transações de pagamento efetuadas e faturas. + + Não possui segregação entre pessoa natural e pessoa jurídica.\ + Requer consentimento do cliente para todos os `endpoints`. + + # Orientações + A `Role` do diretório de participantes relacionada à presente API é a `DADOS`.\ + Para todos os `endpoints` desta API é previsto o envio de um `token` através do header `Authorization`.\ + Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos + dados relacionados ao `consentId` específico relacionado.\ + Os dados serão devolvidos na consulta desde que o `consentId` relacionado corresponda a um consentimento válido e com o status `AUTHORISED`.\ + É também necessário que o recurso em questão (conta, contrato, etc) esteja disponível na instituição transmissora (ou seja, sem boqueios de qualquer natureza e com todas as autorizações/consentimentos já autorizados).\ + Além disso as `permissions` necessárias deverão ter sido solicitadas quando da criação do consentimento relacionado (`consentId`).\ + Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API.\ + ### `/accounts/{creditCardAccountId}/bills` + - description: + - Só deve ser informada uma fatura já fechada. + - Qualquer pagamento deve ser contado para a última fatura fechada. + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + ### `/accounts/{creditCardAccountId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + + ## Permissions necessárias para a API Credit-cards-accounts + + Para cada um dos paths desta API, além dos escopos (`scopes`) indicados existem `permissions` que deverão ser observadas: + + ### `/accounts` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}/bills` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_READ** + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/limits` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_LIMITS_READ** + ### `/accounts/{creditCardAccountId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/transactions-current` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + + ## Tabela: Data de imutabilidade por tipo de transação + ``` + |-------------------|-------------------------|-----------------------| + | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | + |-------------------|-------------------------|-----------------------| + | PAGAMENTO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | TARIFA | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OPERACOES_CRED | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | ESTORNO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | CASHBACK | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OUTROS | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + ``` + version: 2.1.0-rc.2 + license: + name: Apache 2.0 + url: 'https://www.apache.org/licenses/LICENSE-2.0' + contact: + name: Governança do Open Finance Brasil – Especificações + email: gt-interfaces@openbankingbr.org + url: 'https://openbanking-brasil.github.io/areadesenvolvedor/' +servers: + - url: 'https://api.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Produção + - url: 'https://apih.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Homologação +tags: + - name: Credit Card + description: Operações para listagem das informações de Cartão de Crédito +paths: + /accounts: + get: + tags: + - Credit Card + summary: Conjunto de informações das Contas de pagamento pós paga + operationId: creditCardsGetAccounts + description: Método para obter a lista de contas de pagamento pós-paga mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsList' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}': + get: + tags: + - Credit Card + summary: Obtém os dados de identificação da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountId + description: Método para obter os dados de identificação da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsIdentification' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills': + get: + tags: + - Credit Card + summary: Obtém a lista de faturas da conta identificada por creditCardAccountId. + description: | + Método para obter a lista de faturas da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora.\ + Só deve ser informada uma fatura já fechada.\ + Qualquer pagamento deve ser contado para a última fatura fechada. + operationId: creditCardsGetAccountsCreditCardAccountIdBills + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromDueDate' + - $ref: '#/components/parameters/toDueDate' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBills' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills/{billId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId e billId. + operationId: creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions + description: | + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId e billId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/billId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBillsTransactions' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/limits': + get: + tags: + - Credit Card + summary: Obtém os limites da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdLimits + description: Método para obter os limites da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactions + description: |- + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions-current': + get: + tags: + - Credit Card + summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent + description: Método para obter a lista de transações recentes (últimos 7 dias) da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDateMaxLimited' + - $ref: '#/components/parameters/toTransactionDateMaxLimited' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts +components: + schemas: + CreditCardAccountsTransactionAmount: + type: object + description: | + Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransactionBrazilianAmount: + type: object + description: | + Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardsAccountsIdentificationData: + type: object + description: Conjunto de informações referentes à identificação da conta de pagamento pós-paga. + required: + - name + - productType + - creditCardNetwork + - paymentMethod + properties: + name: + type: string + pattern: '[\w\W\s]*' + description: | + Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Informações complementares se tipo de Cartão 'OUTROS' + maxLength: 50 + example: OURO_INTERNACIONAL + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'. + maxLength: 50 + example: AURA CARD + paymentMethod: + type: array + description: | + Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. + items: + $ref: '#/components/schemas/CreditCardsAccountPaymentMethod' + minItems: 1 + CreditCardAccountsBillsData: + type: object + description: Conjunto das informações referentes a lista de faturas associadas à conta de pagamento pós-paga + required: + - billId + - dueDate + - billTotalAmount + - billMinimumAmount + - isInstalment + - payments + properties: + billId: + description: Informação que identifica a fatura + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: 3459087XXZTR + dueDate: + description: 'Data de vencimento da Fatura, que aparece para pagamento pelo cliente' + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + billTotalAmount: + $ref: '#/components/schemas/CreditCardsBillTotalAmount' + billMinimumAmount: + $ref: '#/components/schemas/CreditCardAccountsBillMinimumAmount' + isInstalment: + type: boolean + description: Indica se a fatura permite parcelamento (true) ou não (false). + example: false + financeCharges: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsFinanceCharge' + minItems: 1 + description: Lista dos encargos cobrados na fatura + payments: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsPayment' + minItems: 0 + description: Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga + CreditCardAccountsBillsFinanceCharge: + type: object + required: + - type + - amount + - currency + properties: + type: + $ref: '#/components/schemas/EnumCreditCardAccountsFinanceChargeType' + additionalInfo: + type: string + maxLength: 140 + pattern: '[\w\W\s]*' + example: Informações Adicionais + description: 'Campo livre, de preenchimento obrigatório se selecionado tipo de encargo ''OUTROS''' + amount: + type: string + format: double + maxLength: 20 + minLength: 4 + pattern: '^\d{1,15}\.\d{2,4}$' + example: '100000.0400' + description: Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + maxLength: 3 + pattern: '^(\w{3}){1}$' + example: BRL + description: | + Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + CreditCardAccountsBillsPayment: + type: object + required: + - valueType + - paymentDate + - paymentMode + - amount + - currency + properties: + valueType: + $ref: '#/components/schemas/EnumCreditCardAccountsBillingValueType' + paymentDate: + description: Data efetiva de quando o Pagamento da fatura foi realizado + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + paymentMode: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentMode' + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor pagamento segundo o valueType. + Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + O campo não pode assumir valor negativo por se tratar de um pagamento. + currency: + type: string + pattern: '^(\w{3}){1}$' + maxLength: 3 + description: | + Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil + example: BRL + CreditCardAccountsData: + type: object + description: Conjunto de informações das Contas de pagamento pós paga + required: + - brandName + - companyCnpj + - name + - productType + - creditCardNetwork + - creditCardAccountId + properties: + creditCardAccountId: + type: string + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: XXZTR3459087 + brandName: + type: string + description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' + pattern: '[\w\W\s]*' + maxLength: 80 + example: Organização A + companyCnpj: + type: string + description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' + pattern: '^\d{14}$' + maxLength: 14 + example: '21128159000166' + name: + type: string + description: 'Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: ''conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos' + pattern: '[\w\W\s]*' + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + description: Informações complementares se tipo de Cartão 'OUTROS' + pattern: '[\w\W\s]*' + maxLength: 50 + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS' + pattern: '[\w\W\s]*' + maxLength: 50 + example: AURA CARD + CreditCardAccountsLimitsData: + type: object + description: Conjunto de informações referentes aos limites da conta de pagamento pós-paga. + required: + - creditLineLimitType + - consolidationType + - identificationNumber + - isLimitFlexible + - usedAmount + properties: + creditLineLimitType: + $ref: '#/components/schemas/EnumCreditCardAccountsLineLimitType' + consolidationType: + $ref: '#/components/schemas/EnumCreditCardAccountsConsolidationType' + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + lineName: + type: string + enum: + - CREDITO_A_VISTA + - CREDITO_PARCELADO + - SAQUE_CREDITO_BRASIL + - SAQUE_CREDITO_EXTERIOR + - EMPRESTIMO_CARTAO_CONSIGNADO + - OUTROS + example: CREDITO_A_VISTA + lineNameAdditionalInfo: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: Informações adicionais e complementares. + description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. + isLimitFlexible: + type: boolean + description: True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente. + example: true + limitAmount: + $ref: '#/components/schemas/CreditCardsLimitAmount' + usedAmount: + $ref: '#/components/schemas/CreditCardsUsedAmount' + availableAmount: + $ref: '#/components/schemas/CreditCardsAvailableAmount' + customizedLimitAmount: + type: object + description: | + Valor total do limite customizado pelo cliente nos canais eletrônicos da instituição. Esse objeto é de envio obrigatório nos casos em que a instituição permita ao cliente alterar o seu limite. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' Todos os limite informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAccountPaymentMethod: + type: object + description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga + required: + - identificationNumber + - isMultipleCreditCard + properties: + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + isMultipleCreditCard: + type: boolean + description: | + Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. + example: true + CreditCardsLimitAmount: + type: object + description: | + Valor total do limite concedido. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os limite informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + limitAmountReason: + type: string + pattern: '[\w\W\s]*' + maxLength: 200 + description: | + Razão pela qual o valor total do limite informado está igual a zero. + + [Restrição] Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. + example: O perfil do cliente passou por uma análise e o limite precisou ser zerado + CreditCardsUsedAmount: + type: object + description: Valor utilizado do limite informado + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAvailableAmount: + type: object + description: | + Valor disponível do limite informado + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: | + Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsBillTotalAmount: + type: object + required: + - amount + - currency + description: | + Valor total da faturas. + O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillMinimumAmount: + type: object + required: + - amount + - currency + description: | + Valor do pagamento minimo da fatura + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor do pagamento minimo da fatura + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillsTransactions: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - transactionId + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - chargeIdentificator + - brazilianAmount + - amount + - transactionDateTime + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: | + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + É esperado que o `transactionId` seja único, imutável e estável. + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: number + format: integer + description: Número da parcela que está sendo informada. + minimum: 1 + maximum: 999 + example: 12 + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDateTime: + type: string + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + CreditCardAccountsTransaction: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - transactionId + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - chargeIdentificator + - brazilianAmount + - amount + - transactionDateTime + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: | + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + O ideal é que o `transactionId` seja imutável. + No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. + Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. + O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: number + format: integer + description: Número da parcela que está sendo informada. + minimum: 1 + maximum: 999 + example: 12 + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDateTime: + type: string + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + EnumCreditCardAccountFee: + type: string + description: | + Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. + enum: + - ANUIDADE + - SAQUE_CARTAO_BRASIL + - SAQUE_CARTAO_EXTERIOR + - AVALIACAO_EMERGENCIAL_CREDITO + - EMISSAO_SEGUNDA_VIA + - TARIFA_PAGAMENTO_CONTAS + - SMS + - OUTRA + example: ANUIDADE + EnumCreditCardAccountsBillingValueType: + type: string + description: | + Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) + - Valor de pagamento da fatura com parcelamento + - Valor pagamento da fatura realizado + - Outro Valor pago na fatura + + VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura + + VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura + + OUTRO_VALOR_PAGO_FATURA: Demais casos + enum: + - VALOR_PAGAMENTO_FATURA_PARCELADO + - VALOR_PAGAMENTO_FATURA_REALIZADO + - OUTRO_VALOR_PAGO_FATURA + EnumCreditCardAccountsConsolidationType: + type: string + description: | + Indicador que permite informar se o valor do limite é consolidado ou individual. + + CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. + + INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. + enum: + - CONSOLIDADO + - INDIVIDUAL + example: CONSOLIDADO + EnumCreditCardAccountsFinanceChargeType: + type: string + description: | + Traz a denominação dos Encargos que + incidem na fatura da conta de pagamento pós-paga. (Vide Enum) + - Juros remuneratórios por atraso no pagamento da fatura + - Multa por atraso no pagamento da fatura + - Juros de mora por atraso no pagamento da fatura + - IOF + - Outros + enum: + - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA + - MULTA_ATRASO_PAGAMENTO_FATURA + - JUROS_MORA_ATRASO_PAGAMENTO_FATURA + - IOF + - OUTROS + EnumCreditCardAccountsLineLimitType: + type: string + description: | + Indicador do tipo de limite + + LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. + + LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). + enum: + - LIMITE_CREDITO_TOTAL + - LIMITE_CREDITO_MODALIDADE_OPERACAO + example: LIMITE_CREDITO_TOTAL + EnumCreditCardAccountNetwork: + type: string + description: | + Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). + Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. + enum: + - VISA + - MASTERCARD + - AMERICAN_EXPRESS + - DINERS_CLUB + - HIPERCARD + - BANDEIRA_PROPRIA + - CHEQUE_ELETRONICO + - ELO + - OUTRAS + example: VISA + EnumCreditCardAccountsOtherCreditType: + type: string + description: | + Traz outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. + enum: + - CREDITO_ROTATIVO + - PARCELAMENTO_FATURA + - EMPRESTIMO + - OUTROS + example: CREDITO_ROTATIVO + EnumCreditCardAccountsPaymentMode: + type: string + description: | + Traz as formas de efetivação do pagamento realizado: (Vide Enum) + - Débito em conta corrente + - Boleto bancário + - Averbação em folha + - PIX + enum: + - DEBITO_CONTA_CORRENTE + - BOLETO_BANCARIO + - AVERBACAO_FOLHA + - PIX + EnumCreditCardAccountsPaymentType: + type: string + description: | + Traz os tipos de pagamento. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. + enum: + - A_VISTA + - A_PRAZO + example: A_VISTA + EnumCreditCardAccountsProductType: + type: string + description: 'Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.' + enum: + - CLASSIC_NACIONAL + - CLASSIC_INTERNACIONAL + - GOLD + - PLATINUM + - INFINITE + - ELECTRON + - STANDARD_NACIONAL + - STANDARD_INTERNACIONAL + - ELETRONIC + - BLACK + - REDESHOP + - MAESTRO_MASTERCARD_MAESTRO + - GREEN + - BLUE + - BLUEBOX + - PROFISSIONAL_LIBERAL + - CHEQUE_ELETRONICO + - CORPORATIVO + - EMPRESARIAL + - COMPRAS + - BASICO_NACIONAL + - BASICO_INTERNACIONAL + - NANQUIM + - GRAFITE + - MAIS + - OUTROS + example: OUTROS + EnumCreditCardTransactionType: + type: string + description: Traz os tipos de Transação + enum: + - PAGAMENTO + - TARIFA + - OPERACOES_CREDITO_CONTRATADAS_CARTAO + - ESTORNO + - CASHBACK + - OUTROS + example: CASHBACK + EnumCreditDebitIndicator: + type: string + description: | + Indicador do tipo de lançamento: + Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. + Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. + enum: + - CREDITO + - DEBITO + example: DEBITO + Links: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + last: + type: string + format: uri + maxLength: 2000 + description: URI da última página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + Meta: + type: object + description: Meta informações referente à API requisitada. + required: + - totalRecords + - totalPages + - requestDateTime + properties: + totalRecords: + type: integer + format: int32 + description: Número total de registros no resultado + example: 1 + totalPages: + type: integer + format: int32 + description: Número total de páginas no resultado + example: 1 + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + MetaOnlyRequestDateTime: + type: object + description: Meta informações referente à API requisitada. + required: + - requestDateTime + properties: + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + ResponseCreditCardAccountsList: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: Conjunto de informações de conta de pagamento pós-paga + items: + $ref: '#/components/schemas/CreditCardAccountsData' + minItems: 0 + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsBills: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsIdentification: + type: object + required: + - data + - links + - meta + properties: + data: + $ref: '#/components/schemas/CreditCardsAccountsIdentificationData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsLimits: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: | + [Restrição] A lista vazia deve ser interpretada como a ausência da informação. + + Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + + Cenário de "cartão sem limite", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsLimitsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsTransactions: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/TransactionsLinks' + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseErrorMetaSingle: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseError: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/Meta' + TransactionsLinks: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + XFapiInteractionId: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + parameters: + Authorization: + name: Authorization + in: header + description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado + required: true + schema: + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + billId: + name: billId + in: path + description: Identificador da fatura. + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardAccountId: + name: creditCardAccountId + in: path + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade detro da instituição transmissora' + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardPayeeMCC: + name: payeeMCC + description: 'MCC é o Merchant Category Code, ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades' + required: false + in: query + schema: + type: number + maximum: 9999 + example: 8299 + format: int32 + creditCardTransactionType: + name: transactionType + description: Traz os tipos de Transação + required: false + in: query + schema: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + fromDueDate: + name: fromDueDate + description: Data inicial de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDate: + name: fromTransactionDate + description: | + Data inicial de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDateMaxLimited: + name: fromTransactionDate + description: | + Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + page: + name: page + in: query + description: Número da página que está sendo requisitada (o valor da primeira página é 1). + schema: + type: integer + default: 1 + minimum: 1 + maximum: 2147483647 + format: int32 + pageSize: + name: page-size + in: query + description: Quantidade total de registros por páginas. + schema: + type: integer + default: 25 + minimum: 1 + format: int32 + maximum: 1000 + pagination-key: + name: pagination-key + in: query + description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' + schema: + type: string + maxLength: 2048 + pattern: '[\w\W\s]*' + toDueDate: + name: toDueDate + description: Data final de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDate: + name: toTransactionDate + description: | + Data final de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDateMaxLimited: + name: toTransactionDate + description: | + Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + xCustomerUserAgent: + name: x-customer-user-agent + in: header + description: Indica o user-agent que o usuário utiliza. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiAuthDate: + name: x-fapi-auth-date + in: header + description: 'Data em que o usuário logou pela última vez com o receptor. Representada de acordo com a [RFC7231](https://tools.ietf.org/html/rfc7231).Exemplo: Sun, 10 Sep 2017 19:43:31 UTC' + required: false + schema: + type: string + pattern: '^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$' + minLength: 29 + maxLength: 29 + xFapiCustomerIpAddress: + name: x-fapi-customer-ip-address + in: header + description: O endereço IP do usuário se estiver atualmente logado com o receptor. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiInteractionId: + name: x-fapi-interaction-id + in: header + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + required: false + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + minLength: 1 + maxLength: 100 + securitySchemes: + OpenId: + type: openIdConnect + openIdConnectUrl: 'https://auth.mockbank.poc.raidiam.io/.well-known/openid-configuration' + OAuth2Security: + type: oauth2 + description: Fluxo OAuth necessário para que a receptora tenha acesso aos dados na instituição transmissora. Requer o processo de redirecionamento e autenticação do usuário a que se referem os dados. + flows: + authorizationCode: + authorizationUrl: 'https://authserver.example/authorization' + tokenUrl: 'https://authserver.example/token' + scopes: + credit-cards-accounts: Escopo necessário para acesso à API Credit-cards-accounts. O controle dos endpoints específicos é feito via permissions. + responses: + OKResponseCreditCardAccountsList: + description: Conjunto de informações das Contas de pagamento pós paga + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsList' + OKResponseCreditCardAccountsIdentification: + description: Dados de identificação da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsIdentification' + OKResponseCreditCardAccountsBills: + description: Dados referentes à lista de faturas da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsBills' + OKResponseCreditCardAccountsLimits: + description: Dados dos limites da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsLimits' + OKResponseCreditCardAccountsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsTransactions' + OKResponseCreditCardAccountsBillsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsTransactions' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + BadRequest: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Forbidden: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + InternalServerError: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + GatewayTimeout: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Locked: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + MethodNotAllowed: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotAcceptable: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotFound: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + TooManyRequests: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + UnprocessableEntity: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Unauthorized: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + SiteIsOverloaded: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Default: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + BadRequestWithAdditionalProperties: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + ForbiddenWithAdditionalProperties: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + GatewayTimeoutWithAdditionalProperties: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + InternalServerErrorWithAdditionalProperties: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + LockedWithAdditionalProperties: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + MethodNotAllowedWithAdditionalProperties: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotAcceptableWithAdditionalProperties: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotFoundWithAdditionalProperties: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + TooManyRequestsWithAdditionalProperties: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnauthorizedWithAdditionalProperties: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnprocessableEntityWithAdditionalProperties: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + DefaultWithAdditionalProperties: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + SiteIsOverloadedWithAdditionalProperties: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' diff --git a/swagger-apis/credit-cards/index.html b/swagger-apis/credit-cards/index.html index 5a6cad397..0ac86e864 100644 --- a/swagger-apis/credit-cards/index.html +++ b/swagger-apis/credit-cards/index.html @@ -55,8 +55,9 @@ {"name": "2.0.0-RC1.0", "url": "./2.0.0-RC1.0.yml"}, {"name": "2.0.0", "url": "./2.0.0.yml"}, {"name": "2.0.1", "url": "./2.0.1.yml"}, - {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}], - "urls.primaryName": "2.1.0-rc.1", // default spec + {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}, + {"name": "2.1.0-rc.2", "url": "./2.1.0-rc.2.yml"}], + "urls.primaryName": "2.1.0-rc.2", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[], From 0bccdce16e3b882be2f1b49cec1db2ad46d4f814 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Wed, 16 Aug 2023 15:02:07 -0300 Subject: [PATCH 22/26] feat(Credit Cards): ORB-3369 - PA07 - Ajustar propriedades do campo chargeIdentificator --- ...CreditCardAccountIdBillsBillIdTransactions_v2.csv | 6 +++++- ...untsCreditCardAccountIdTransactionsCurrent_v2.csv | 6 +++++- ...GetAccountsCreditCardAccountIdTransactions_v2.csv | 6 +++++- swagger-apis/credit-cards/2.1.0-rc.2.yml | 12 ++++++++---- 4 files changed, 23 insertions(+), 7 deletions(-) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index ef28f424c..0988f1195 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -51,7 +51,11 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index d8b5c457f..989f133f6 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -54,7 +54,11 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index d8b5c457f..989f133f6 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -54,7 +54,11 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". ";Não permitido;string;; -/data/chargeIdentificator;chargeIdentificator;Número da parcela que está sendo informada.;Número;;Obrigatório;;;1;1;"";Não permitido;number;12; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; /data/chargeNumber;chargeNumber;"Quantidade de parcelas. [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. ";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. diff --git a/swagger-apis/credit-cards/2.1.0-rc.2.yml b/swagger-apis/credit-cards/2.1.0-rc.2.yml index b12580701..2ae92f3d5 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.2.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.2.yml @@ -952,7 +952,6 @@ components: - transactionName - creditDebitType - transactionType - - chargeIdentificator - brazilianAmount - amount - transactionDateTime @@ -1019,7 +1018,10 @@ components: chargeIdentificator: type: number format: integer - description: Número da parcela que está sendo informada. + description: | + Número da parcela que está sendo informada. + + [Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. minimum: 1 maximum: 999 example: 12 @@ -1068,7 +1070,6 @@ components: - transactionName - creditDebitType - transactionType - - chargeIdentificator - brazilianAmount - amount - transactionDateTime @@ -1138,7 +1139,10 @@ components: chargeIdentificator: type: number format: integer - description: Número da parcela que está sendo informada. + description: | + Número da parcela que está sendo informada. + + [Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. minimum: 1 maximum: 999 example: 12 From 8f519cdf5cb9bdb4cabaa8153dc2d8d998c98fe0 Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 22 Aug 2023 10:59:36 -0300 Subject: [PATCH 23/26] =?UTF-8?q?fix(Credit=20Cards):=20ORB-3428=20-=20PA1?= =?UTF-8?q?23=20-=20Incluir=20campo=20transactionDate=20nos=20tr=C3=AAs=20?= =?UTF-8?q?endpoints=20de=20transa=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...itCardAccountIdBillsBillIdTransactions_v2.csv | 1 + ...CreditCardAccountIdTransactionsCurrent_v2.csv | 1 + ...ccountsCreditCardAccountIdTransactions_v2.csv | 1 + swagger-apis/credit-cards/2.1.0-rc.1.yml | 16 ++++++++++++++++ swagger-apis/credit-cards/2.1.0-rc.2.yml | 16 ++++++++++++++++ 5 files changed, 35 insertions(+) diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv index 0988f1195..b25c430b5 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v2.csv @@ -68,6 +68,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/transactionDateTime;transactionDateTime;"Data e hora original da transação. No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv index 989f133f6..f415f5d00 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v2.csv @@ -71,6 +71,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/transactionDateTime;transactionDateTime;"Data e hora original da transação. No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv index 989f133f6..f415f5d00 100644 --- a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v2.csv @@ -71,6 +71,7 @@ OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for ' ";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; /data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 /data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; /data/transactionDateTime;transactionDateTime;"Data e hora original da transação. No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index 6fe92debd..dc74dc124 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -955,6 +955,7 @@ components: - chargeIdentificator - brazilianAmount - amount + - transactionDate - transactionDateTime - billPostDate properties: @@ -1035,6 +1036,13 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação transactionDateTime: type: string format: date-time @@ -1071,6 +1079,7 @@ components: - chargeIdentificator - brazilianAmount - amount + - transactionDate - transactionDateTime - billPostDate properties: @@ -1154,6 +1163,13 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação transactionDateTime: type: string format: date-time diff --git a/swagger-apis/credit-cards/2.1.0-rc.2.yml b/swagger-apis/credit-cards/2.1.0-rc.2.yml index 2ae92f3d5..7b7efdb33 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.2.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.2.yml @@ -954,6 +954,7 @@ components: - transactionType - brazilianAmount - amount + - transactionDate - transactionDateTime - billPostDate properties: @@ -1037,6 +1038,13 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação transactionDateTime: type: string format: date-time @@ -1072,6 +1080,7 @@ components: - transactionType - brazilianAmount - amount + - transactionDate - transactionDateTime - billPostDate properties: @@ -1158,6 +1167,13 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação transactionDateTime: type: string format: date-time From 391ab43fd513d6222532821aa70dfb8d215ece8a Mon Sep 17 00:00:00 2001 From: FelipeBaumgartel Date: Tue, 22 Aug 2023 11:28:03 -0300 Subject: [PATCH 24/26] =?UTF-8?q?fix(Credit=20Cards):=20ORB-3428=20-=20PA1?= =?UTF-8?q?23=20-=20Incluir=20campo=20transactionDate=20nos=20tr=C3=AAs=20?= =?UTF-8?q?endpoints=20de=20transa=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/2.1.0-rc.1.yml | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/swagger-apis/credit-cards/2.1.0-rc.1.yml b/swagger-apis/credit-cards/2.1.0-rc.1.yml index dc74dc124..6fe92debd 100644 --- a/swagger-apis/credit-cards/2.1.0-rc.1.yml +++ b/swagger-apis/credit-cards/2.1.0-rc.1.yml @@ -955,7 +955,6 @@ components: - chargeIdentificator - brazilianAmount - amount - - transactionDate - transactionDateTime - billPostDate properties: @@ -1036,13 +1035,6 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' - transactionDate: - type: string - format: date - maxLength: 20 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - description: Data original da transação transactionDateTime: type: string format: date-time @@ -1079,7 +1071,6 @@ components: - chargeIdentificator - brazilianAmount - amount - - transactionDate - transactionDateTime - billPostDate properties: @@ -1163,13 +1154,6 @@ components: $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' amount: $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' - transactionDate: - type: string - format: date - maxLength: 20 - pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' - example: '2021-05-21' - description: Data original da transação transactionDateTime: type: string format: date-time From b5b40de7ffeae7a7a123d7ba4010a76c97c04ee5 Mon Sep 17 00:00:00 2001 From: Cecilia Fernandes <115801960+CeciliaFFernandes@users.noreply.github.com> Date: Mon, 28 Aug 2023 17:05:44 +0000 Subject: [PATCH 25/26] =?UTF-8?q?feat(Credit=20Cards):=20ORB-3490=20-=20Cr?= =?UTF-8?q?iar=20nova=20vers=C3=A3o=20da=20API=20-=20v3.0.0-beta.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- swagger-apis/credit-cards/3.0.0-beta.1.yml | 2071 ++++++++++++++++++++ swagger-apis/credit-cards/index.html | 5 +- 2 files changed, 2074 insertions(+), 2 deletions(-) create mode 100644 swagger-apis/credit-cards/3.0.0-beta.1.yml diff --git a/swagger-apis/credit-cards/3.0.0-beta.1.yml b/swagger-apis/credit-cards/3.0.0-beta.1.yml new file mode 100644 index 000000000..48a922391 --- /dev/null +++ b/swagger-apis/credit-cards/3.0.0-beta.1.yml @@ -0,0 +1,2071 @@ +openapi: 3.0.0 +info: + title: API Credit-cards-accounts - Open Finance Brasil + description: | + API de contas de pagamento pós-pagas do Open Finance Brasil – Fase 2. + API que retorna informações de contas de pagamento pós-paga mantidas nas instituições transmissoras por seus clientes, incluindo dados como denominação, produto, bandeira, limites de crédito, informações sobre transações de pagamento efetuadas e faturas. + + Não possui segregação entre pessoa natural e pessoa jurídica.\ + Requer consentimento do cliente para todos os `endpoints`. + + # Orientações + A `Role` do diretório de participantes relacionada à presente API é a `DADOS`.\ + Para todos os `endpoints` desta API é previsto o envio de um `token` através do header `Authorization`.\ + Este token deverá estar relacionado ao consentimento (`consentId`) mantido na instituição transmissora dos dados, o qual permitirá a pesquisa e retorno, na API em questão, dos + dados relacionados ao `consentId` específico relacionado.\ + Os dados serão devolvidos na consulta desde que o `consentId` relacionado corresponda a um consentimento válido e com o status `AUTHORISED`.\ + É também necessário que o recurso em questão (conta, contrato, etc) esteja disponível na instituição transmissora (ou seja, sem boqueios de qualquer natureza e com todas as autorizações/consentimentos já autorizados).\ + Além disso as `permissions` necessárias deverão ter sido solicitadas quando da criação do consentimento relacionado (`consentId`).\ + Relacionamos a seguir as `permissions` necessárias para a consulta de dados em cada `endpoint` da presente API.\ + ### `/accounts/{creditCardAccountId}/bills` + - description: + - Só deve ser informada uma fatura já fechada. + - Qualquer pagamento deve ser contado para a última fatura fechada. + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + ### `/accounts/{creditCardAccountId}/transactions` + - description: + - A lista a retornar se refere a transações após base 2/clearing/conciliado + + ## Permissions necessárias para a API Credit-cards-accounts + + Para cada um dos paths desta API, além dos escopos (`scopes`) indicados existem `permissions` que deverão ser observadas: + + ### `/accounts` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_READ** + ### `/accounts/{creditCardAccountId}/bills` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_READ** + ### `/accounts/{creditCardAccountId}/bills/{billId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_BILLS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/limits` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_LIMITS_READ** + ### `/accounts/{creditCardAccountId}/transactions` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + ### `/accounts/{creditCardAccountId}/transactions-current` + - permissions: + - GET: **CREDIT_CARDS_ACCOUNTS_TRANSACTIONS_READ** + + ## Tabela: Data de imutabilidade por tipo de transação + ``` + |-------------------|-------------------------|-----------------------| + | Tipo de Transação | Data da Obrigatoriedade | Data da Imutabilidade | + |-------------------|-------------------------|-----------------------| + | PAGAMENTO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | TARIFA | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OPERACOES_CRED | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | ESTORNO | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | CASHBACK | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + | OUTROS | DO | Fatura fechada | + |-------------------|-------------------------|-----------------------| + ``` + version: 3.0.0-beta.1 + license: + name: Apache 2.0 + url: 'https://www.apache.org/licenses/LICENSE-2.0' + contact: + name: Governança do Open Finance Brasil – Especificações + email: gt-interfaces@openbankingbr.org + url: 'https://openbanking-brasil.github.io/areadesenvolvedor/' +servers: + - url: 'https://api.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Produção + - url: 'https://apih.banco.com.br/open-banking/credit-cards-accounts/v2' + description: Servidor de Homologação +tags: + - name: Credit Card + description: Operações para listagem das informações de Cartão de Crédito +paths: + /accounts: + get: + tags: + - Credit Card + summary: Conjunto de informações das Contas de pagamento pós paga + operationId: creditCardsGetAccounts + description: Método para obter a lista de contas de pagamento pós-paga mantidas pelo cliente na instituição transmissora e para as quais ele tenha fornecido consentimento + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsList' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}': + get: + tags: + - Credit Card + summary: Obtém os dados de identificação da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountId + description: Método para obter os dados de identificação da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsIdentification' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills': + get: + tags: + - Credit Card + summary: Obtém a lista de faturas da conta identificada por creditCardAccountId. + description: | + Método para obter a lista de faturas da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora.\ + Só deve ser informada uma fatura já fechada.\ + Qualquer pagamento deve ser contado para a última fatura fechada. + operationId: creditCardsGetAccountsCreditCardAccountIdBills + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromDueDate' + - $ref: '#/components/parameters/toDueDate' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBills' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/bills/{billId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId e billId. + operationId: creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions + description: | + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId e billId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/billId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsBillsTransactions' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/limits': + get: + tags: + - Credit Card + summary: Obtém os limites da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdLimits + description: Método para obter os limites da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/pagination-key' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' + '400': + $ref: '#/components/responses/BadRequestWithAdditionalProperties' + '401': + $ref: '#/components/responses/UnauthorizedWithAdditionalProperties' + '403': + $ref: '#/components/responses/ForbiddenWithAdditionalProperties' + '404': + $ref: '#/components/responses/NotFoundWithAdditionalProperties' + '405': + $ref: '#/components/responses/MethodNotAllowedWithAdditionalProperties' + '406': + $ref: '#/components/responses/NotAcceptableWithAdditionalProperties' + '422': + $ref: '#/components/responses/UnprocessableEntityWithAdditionalProperties' + '423': + $ref: '#/components/responses/LockedWithAdditionalProperties' + '429': + $ref: '#/components/responses/TooManyRequestsWithAdditionalProperties' + '500': + $ref: '#/components/responses/InternalServerErrorWithAdditionalProperties' + '504': + $ref: '#/components/responses/GatewayTimeoutWithAdditionalProperties' + '529': + $ref: '#/components/responses/SiteIsOverloadedWithAdditionalProperties' + default: + $ref: '#/components/responses/DefaultWithAdditionalProperties' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions': + get: + tags: + - Credit Card + summary: Obtém a lista de transações da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactions + description: |- + Método para obter a lista de transações da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + A lista a retornar se refere a transações após base 2/clearing/conciliado + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDate' + - $ref: '#/components/parameters/toTransactionDate' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts + '/accounts/{creditCardAccountId}/transactions-current': + get: + tags: + - Credit Card + summary: Obtém a lista de transações recentes (últimos 7 dias) da conta identificada por creditCardAccountId. + operationId: creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent + description: Método para obter a lista de transações recentes (últimos 7 dias) da conta de pagamento pós-paga identificada por creditCardAccountId mantida pelo cliente na instituição transmissora. + parameters: + - $ref: '#/components/parameters/Authorization' + - $ref: '#/components/parameters/xFapiAuthDate' + - $ref: '#/components/parameters/xFapiCustomerIpAddress' + - $ref: '#/components/parameters/xFapiInteractionId' + - $ref: '#/components/parameters/xCustomerUserAgent' + - $ref: '#/components/parameters/creditCardAccountId' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/fromTransactionDateMaxLimited' + - $ref: '#/components/parameters/toTransactionDateMaxLimited' + - $ref: '#/components/parameters/creditCardTransactionType' + - $ref: '#/components/parameters/creditCardPayeeMCC' + responses: + '200': + $ref: '#/components/responses/OKResponseCreditCardAccountsTransactions' + '400': + $ref: '#/components/responses/BadRequest' + '401': + $ref: '#/components/responses/Unauthorized' + '403': + $ref: '#/components/responses/Forbidden' + '404': + $ref: '#/components/responses/NotFound' + '405': + $ref: '#/components/responses/MethodNotAllowed' + '406': + $ref: '#/components/responses/NotAcceptable' + '422': + $ref: '#/components/responses/UnprocessableEntity' + '423': + $ref: '#/components/responses/Locked' + '429': + $ref: '#/components/responses/TooManyRequests' + '500': + $ref: '#/components/responses/InternalServerError' + '504': + $ref: '#/components/responses/GatewayTimeout' + '529': + $ref: '#/components/responses/SiteIsOverloaded' + default: + $ref: '#/components/responses/Default' + security: + - OpenId: + - openid + OAuth2Security: + - 'consent:consentId' + - credit-cards-accounts +components: + schemas: + CreditCardAccountsTransactionAmount: + type: object + description: | + Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsTransactionBrazilianAmount: + type: object + description: | + Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor relacionado ao objeto. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardsAccountsIdentificationData: + type: object + description: Conjunto de informações referentes à identificação da conta de pagamento pós-paga. + required: + - name + - productType + - creditCardNetwork + - paymentMethod + properties: + name: + type: string + pattern: '[\w\W\s]*' + description: | + Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Informações complementares se tipo de Cartão 'OUTROS' + maxLength: 50 + example: OURO_INTERNACIONAL + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + pattern: '[\w\W\s]*' + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'. + maxLength: 50 + example: AURA CARD + paymentMethod: + type: array + description: | + Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. + items: + $ref: '#/components/schemas/CreditCardsAccountPaymentMethod' + minItems: 1 + CreditCardAccountsBillsData: + type: object + description: Conjunto das informações referentes a lista de faturas associadas à conta de pagamento pós-paga + required: + - billId + - dueDate + - billTotalAmount + - billMinimumAmount + - isInstalment + - payments + properties: + billId: + description: Informação que identifica a fatura + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: 3459087XXZTR + dueDate: + description: 'Data de vencimento da Fatura, que aparece para pagamento pelo cliente' + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + billTotalAmount: + $ref: '#/components/schemas/CreditCardsBillTotalAmount' + billMinimumAmount: + $ref: '#/components/schemas/CreditCardAccountsBillMinimumAmount' + isInstalment: + type: boolean + description: Indica se a fatura permite parcelamento (true) ou não (false). + example: false + financeCharges: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsFinanceCharge' + minItems: 1 + description: Lista dos encargos cobrados na fatura + payments: + type: array + items: + $ref: '#/components/schemas/CreditCardAccountsBillsPayment' + minItems: 0 + description: Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga + CreditCardAccountsBillsFinanceCharge: + type: object + required: + - type + - amount + - currency + properties: + type: + $ref: '#/components/schemas/EnumCreditCardAccountsFinanceChargeType' + additionalInfo: + type: string + maxLength: 140 + pattern: '[\w\W\s]*' + example: Informações Adicionais + description: 'Campo livre, de preenchimento obrigatório se selecionado tipo de encargo ''OUTROS''' + amount: + type: string + format: double + maxLength: 20 + minLength: 4 + pattern: '^\d{1,15}\.\d{2,4}$' + example: '100000.0400' + description: Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + maxLength: 3 + pattern: '^(\w{3}){1}$' + example: BRL + description: | + Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + CreditCardAccountsBillsPayment: + type: object + required: + - valueType + - paymentDate + - paymentMode + - amount + - currency + properties: + valueType: + $ref: '#/components/schemas/EnumCreditCardAccountsBillingValueType' + paymentDate: + description: Data efetiva de quando o Pagamento da fatura foi realizado + type: string + format: date + maxLength: 10 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + paymentMode: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentMode' + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor pagamento segundo o valueType. + Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + O campo não pode assumir valor negativo por se tratar de um pagamento. + currency: + type: string + pattern: '^(\w{3}){1}$' + maxLength: 3 + description: | + Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil + example: BRL + CreditCardAccountsData: + type: object + description: Conjunto de informações das Contas de pagamento pós paga + required: + - brandName + - companyCnpj + - name + - productType + - creditCardNetwork + - creditCardAccountId + properties: + creditCardAccountId: + type: string + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.' + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: XXZTR3459087 + brandName: + type: string + description: 'Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).' + pattern: '[\w\W\s]*' + maxLength: 80 + example: Organização A + companyCnpj: + type: string + description: 'Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara' + pattern: '^\d{14}$' + maxLength: 14 + example: '21128159000166' + name: + type: string + description: 'Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: ''conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos' + pattern: '[\w\W\s]*' + maxLength: 50 + example: Cartão Universitário + productType: + $ref: '#/components/schemas/EnumCreditCardAccountsProductType' + productAdditionalInfo: + type: string + description: Informações complementares se tipo de Cartão 'OUTROS' + pattern: '[\w\W\s]*' + maxLength: 50 + creditCardNetwork: + $ref: '#/components/schemas/EnumCreditCardAccountNetwork' + networkAdditionalInfo: + type: string + description: Texto livre para especificar categoria de bandeira marcada como 'OUTRAS' + pattern: '[\w\W\s]*' + maxLength: 50 + example: AURA CARD + CreditCardAccountsLimitsData: + type: object + description: Conjunto de informações referentes aos limites da conta de pagamento pós-paga. + required: + - creditLineLimitType + - consolidationType + - identificationNumber + - isLimitFlexible + - usedAmount + properties: + creditLineLimitType: + $ref: '#/components/schemas/EnumCreditCardAccountsLineLimitType' + consolidationType: + $ref: '#/components/schemas/EnumCreditCardAccountsConsolidationType' + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + lineName: + type: string + enum: + - CREDITO_A_VISTA + - CREDITO_PARCELADO + - SAQUE_CREDITO_BRASIL + - SAQUE_CREDITO_EXTERIOR + - EMPRESTIMO_CARTAO_CONSIGNADO + - OUTROS + example: CREDITO_A_VISTA + lineNameAdditionalInfo: + type: string + maxLength: 50 + pattern: '[\w\W\s]*' + example: Informações adicionais e complementares. + description: Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName. + isLimitFlexible: + type: boolean + description: True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente. + example: true + limitAmount: + $ref: '#/components/schemas/CreditCardsLimitAmount' + usedAmount: + $ref: '#/components/schemas/CreditCardsUsedAmount' + availableAmount: + $ref: '#/components/schemas/CreditCardsAvailableAmount' + customizedLimitAmount: + type: object + description: | + Valor total do limite customizado pelo cliente nos canais eletrônicos da instituição. Esse objeto é de envio obrigatório nos casos em que a instituição permita ao cliente alterar o seu limite. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' Todos os limite informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAccountPaymentMethod: + type: object + description: Conjunto de informações relativas aos Meios de Pagamento da Conta de pagamento pós-paga + required: + - identificationNumber + - isMultipleCreditCard + properties: + identificationNumber: + type: string + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + isMultipleCreditCard: + type: boolean + description: | + Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. + example: true + CreditCardsLimitAmount: + type: object + description: | + Valor total do limite concedido. + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: | + Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os limite informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + limitAmountReason: + type: string + pattern: '[\w\W\s]*' + maxLength: 200 + description: | + Razão pela qual o valor total do limite informado está igual a zero. + + [Restrição] Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. + example: O perfil do cliente passou por uma análise e o limite precisou ser zerado + CreditCardsUsedAmount: + type: object + description: Valor utilizado do limite informado + required: + - amount + - currency + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + example: BRL + CreditCardsAvailableAmount: + type: object + description: | + Valor disponível do limite informado + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: | + Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: | + Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' + Todos os saldos informados estão representados com a moeda vigente do Brasil. + + [Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. + example: BRL + CreditCardsBillTotalAmount: + type: object + required: + - amount + - currency + description: | + Valor total da faturas. + O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. + properties: + amount: + type: string + format: double + pattern: '^-?\d{1,15}\.\d{2,4}$' + maxLength: 21 + minLength: 4 + example: '1000.0400' + description: Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillMinimumAmount: + type: object + required: + - amount + - currency + description: | + Valor do pagamento minimo da fatura + properties: + amount: + type: string + format: double + pattern: '^\d{1,15}\.\d{2,4}$' + maxLength: 20 + minLength: 4 + example: '1000.0400' + description: Valor do pagamento minimo da fatura + currency: + type: string + pattern: '^[A-Z]{3}$' + maxLength: 3 + description: 'Moeda referente ao valor monetário, seguindo o modelo ISO-4217.' + example: BRL + CreditCardAccountsBillsTransactions: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - transactionId + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - brazilianAmount + - amount + - transactionDate + - transactionDateTime + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: | + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + É esperado que o `transactionId` seja único, imutável e estável. + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: number + format: integer + description: | + Número da parcela que está sendo informada. + + [Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. + minimum: 1 + maximum: 999 + example: 12 + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação + transactionDateTime: + type: string + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + CreditCardAccountsTransaction: + type: object + description: Lista que traz os valores relativos aos saldos do Limite de crédito total da conta de pagamento pós-paga + required: + - transactionId + - identificationNumber + - transactionName + - creditDebitType + - transactionType + - brazilianAmount + - amount + - transactionDate + - transactionDateTime + - billPostDate + properties: + transactionId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: TXpRMU9UQTROMWhZV2xSU1FUazJSMDl + description: | + Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. + O ideal é que o `transactionId` seja imutável. + No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. + Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. + O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API + identificationNumber: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: '4453' + description: | + Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. + transactionName: + type: string + maxLength: 200 + pattern: '[\w\W\s]*' + example: PGTO + description: Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura). + billId: + type: string + maxLength: 100 + minLength: 1 + pattern: '^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$' + example: MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM + description: Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta. + creditDebitType: + $ref: '#/components/schemas/EnumCreditDebitIndicator' + transactionType: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + transactionalAdditionalInfo: + type: string + maxLength: 140 + pattern: '^\S[\s\S]*$' + description: 'Campo livre, de preenchimento obrigatório quando selecionado tipo de transação "OUTROS"' + paymentType: + $ref: '#/components/schemas/EnumCreditCardAccountsPaymentType' + feeType: + $ref: '#/components/schemas/EnumCreditCardAccountFee' + feeTypeAdditionalInfo: + type: string + pattern: '^\S[\s\S]*$' + maxLength: 140 + description: 'Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa "OUTRA"' + otherCreditsType: + $ref: '#/components/schemas/EnumCreditCardAccountsOtherCreditType' + otherCreditsAdditionalInfo: + type: string + maxLength: 50 + pattern: '^\S[\s\S]*$' + description: | + Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito "OUTROS". + chargeIdentificator: + type: number + format: integer + description: | + Número da parcela que está sendo informada. + + [Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. + minimum: 1 + maximum: 999 + example: 12 + chargeNumber: + type: number + format: integer + maximum: 999 + example: 12 + description: | + Quantidade de parcelas. + [Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. + brazilianAmount: + $ref: '#/components/schemas/CreditCardAccountsTransactionBrazilianAmount' + amount: + $ref: '#/components/schemas/CreditCardAccountsTransactionAmount' + transactionDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data original da transação + transactionDateTime: + type: string + format: date-time + maxLength: 24 + pattern: '(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$)' + example: '2016-01-29T12:29:03.374Z' + description: | + Data e hora original da transação. + No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) + A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. + billPostDate: + type: string + format: date + maxLength: 20 + pattern: '^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$' + example: '2021-05-21' + description: Data em que a transação foi inserida na fatura + payeeMCC: + type: number + format: integer + maximum: 2147483647 + example: 5137 + description: | + O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). + EnumCreditCardAccountFee: + type: string + description: | + Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. + enum: + - ANUIDADE + - SAQUE_CARTAO_BRASIL + - SAQUE_CARTAO_EXTERIOR + - AVALIACAO_EMERGENCIAL_CREDITO + - EMISSAO_SEGUNDA_VIA + - TARIFA_PAGAMENTO_CONTAS + - SMS + - OUTRA + example: ANUIDADE + EnumCreditCardAccountsBillingValueType: + type: string + description: | + Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) + - Valor de pagamento da fatura com parcelamento + - Valor pagamento da fatura realizado + - Outro Valor pago na fatura + + VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura + + VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura + + OUTRO_VALOR_PAGO_FATURA: Demais casos + enum: + - VALOR_PAGAMENTO_FATURA_PARCELADO + - VALOR_PAGAMENTO_FATURA_REALIZADO + - OUTRO_VALOR_PAGO_FATURA + EnumCreditCardAccountsConsolidationType: + type: string + description: | + Indicador que permite informar se o valor do limite é consolidado ou individual. + + CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. + + INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. + enum: + - CONSOLIDADO + - INDIVIDUAL + example: CONSOLIDADO + EnumCreditCardAccountsFinanceChargeType: + type: string + description: | + Traz a denominação dos Encargos que + incidem na fatura da conta de pagamento pós-paga. (Vide Enum) + - Juros remuneratórios por atraso no pagamento da fatura + - Multa por atraso no pagamento da fatura + - Juros de mora por atraso no pagamento da fatura + - IOF + - Outros + enum: + - JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA + - MULTA_ATRASO_PAGAMENTO_FATURA + - JUROS_MORA_ATRASO_PAGAMENTO_FATURA + - IOF + - OUTROS + EnumCreditCardAccountsLineLimitType: + type: string + description: | + Indicador do tipo de limite + + LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. + + LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). + enum: + - LIMITE_CREDITO_TOTAL + - LIMITE_CREDITO_MODALIDADE_OPERACAO + example: LIMITE_CREDITO_TOTAL + EnumCreditCardAccountNetwork: + type: string + description: | + Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). + Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. + enum: + - VISA + - MASTERCARD + - AMERICAN_EXPRESS + - DINERS_CLUB + - HIPERCARD + - BANDEIRA_PROPRIA + - CHEQUE_ELETRONICO + - ELO + - OUTRAS + example: VISA + EnumCreditCardAccountsOtherCreditType: + type: string + description: | + Traz outros tipos de crédito contratados no cartão. + + [Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. + enum: + - CREDITO_ROTATIVO + - PARCELAMENTO_FATURA + - EMPRESTIMO + - OUTROS + example: CREDITO_ROTATIVO + EnumCreditCardAccountsPaymentMode: + type: string + description: | + Traz as formas de efetivação do pagamento realizado: (Vide Enum) + - Débito em conta corrente + - Boleto bancário + - Averbação em folha + - PIX + enum: + - DEBITO_CONTA_CORRENTE + - BOLETO_BANCARIO + - AVERBACAO_FOLHA + - PIX + EnumCreditCardAccountsPaymentType: + type: string + description: | + Traz os tipos de pagamento. + + [Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. + enum: + - A_VISTA + - A_PRAZO + example: A_VISTA + EnumCreditCardAccountsProductType: + type: string + description: 'Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.' + enum: + - CLASSIC_NACIONAL + - CLASSIC_INTERNACIONAL + - GOLD + - PLATINUM + - INFINITE + - ELECTRON + - STANDARD_NACIONAL + - STANDARD_INTERNACIONAL + - ELETRONIC + - BLACK + - REDESHOP + - MAESTRO_MASTERCARD_MAESTRO + - GREEN + - BLUE + - BLUEBOX + - PROFISSIONAL_LIBERAL + - CHEQUE_ELETRONICO + - CORPORATIVO + - EMPRESARIAL + - COMPRAS + - BASICO_NACIONAL + - BASICO_INTERNACIONAL + - NANQUIM + - GRAFITE + - MAIS + - OUTROS + example: OUTROS + EnumCreditCardTransactionType: + type: string + description: Traz os tipos de Transação + enum: + - PAGAMENTO + - TARIFA + - OPERACOES_CREDITO_CONTRATADAS_CARTAO + - ESTORNO + - CASHBACK + - OUTROS + example: CASHBACK + EnumCreditDebitIndicator: + type: string + description: | + Indicador do tipo de lançamento: + Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. + Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. + enum: + - CREDITO + - DEBITO + example: DEBITO + Links: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + last: + type: string + format: uri + maxLength: 2000 + description: URI da última página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + Meta: + type: object + description: Meta informações referente à API requisitada. + required: + - totalRecords + - totalPages + - requestDateTime + properties: + totalRecords: + type: integer + format: int32 + description: Número total de registros no resultado + example: 1 + totalPages: + type: integer + format: int32 + description: Número total de páginas no resultado + example: 1 + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + MetaOnlyRequestDateTime: + type: object + description: Meta informações referente à API requisitada. + required: + - requestDateTime + properties: + requestDateTime: + description: 'Data e hora da consulta, conforme especificação RFC-3339, formato UTC.' + type: string + maxLength: 20 + format: date-time + example: '2021-05-21T08:30:00Z' + ResponseCreditCardAccountsList: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: Conjunto de informações de conta de pagamento pós-paga + items: + $ref: '#/components/schemas/CreditCardAccountsData' + minItems: 0 + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsBills: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsIdentification: + type: object + required: + - data + - links + - meta + properties: + data: + $ref: '#/components/schemas/CreditCardsAccountsIdentificationData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsLimits: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + description: | + [Restrição] A lista vazia deve ser interpretada como a ausência da informação. + + Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + + Cenário de "cartão sem limite", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsLimitsData' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + ResponseCreditCardAccountsTransactions: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsTransaction' + links: + $ref: '#/components/schemas/TransactionsLinks' + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseErrorMetaSingle: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/MetaOnlyRequestDateTime' + ResponseError: + type: object + required: + - errors + properties: + errors: + type: array + minItems: 1 + maxItems: 13 + items: + type: object + required: + - code + - title + - detail + properties: + code: + description: Código de erro específico do endpoint + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + title: + description: Título legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 255 + detail: + description: Descrição legível por humanos deste erro específico + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + meta: + $ref: '#/components/schemas/Meta' + TransactionsLinks: + type: object + description: Referências para outros recusos da API requisitada. + required: + - self + properties: + self: + type: string + format: uri + maxLength: 2000 + description: URI completo que gerou a resposta atual. + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + first: + type: string + format: uri + maxLength: 2000 + description: URI da primeira página que originou essa lista de resultados. Restrição - Obrigatório quando não for a primeira página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + prev: + type: string + format: uri + maxLength: 2000 + description: "URI da página anterior dessa lista de resultados. Restrição - \tObrigatório quando não for a primeira página da resposta" + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + next: + type: string + format: uri + maxLength: 2000 + description: URI da próxima página dessa lista de resultados. Restrição - Obrigatório quando não for a última página da resposta + example: 'https://api.banco.com.br/open-banking/api/v1/resource' + pattern: '^(https:\/\/)?(www\.)?[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&\/\/=]*)$' + XFapiInteractionId: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + parameters: + Authorization: + name: Authorization + in: header + description: Cabeçalho HTTP padrão. Permite que as credenciais sejam fornecidas dependendo do tipo de recurso solicitado + required: true + schema: + type: string + pattern: '[\w\W\s]*' + maxLength: 2048 + billId: + name: billId + in: path + description: Identificador da fatura. + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardAccountId: + name: creditCardAccountId + in: path + description: 'Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade detro da instituição transmissora' + required: true + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + maxLength: 100 + creditCardPayeeMCC: + name: payeeMCC + description: 'MCC é o Merchant Category Code, ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades' + required: false + in: query + schema: + type: number + maximum: 9999 + example: 8299 + format: int32 + creditCardTransactionType: + name: transactionType + description: Traz os tipos de Transação + required: false + in: query + schema: + $ref: '#/components/schemas/EnumCreditCardTransactionType' + fromDueDate: + name: fromDueDate + description: Data inicial de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDate: + name: fromTransactionDate + description: | + Data inicial de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + fromTransactionDateMaxLimited: + name: fromTransactionDate + description: | + Data inicial de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo toTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + page: + name: page + in: query + description: Número da página que está sendo requisitada (o valor da primeira página é 1). + schema: + type: integer + default: 1 + minimum: 1 + maximum: 2147483647 + format: int32 + pageSize: + name: page-size + in: query + description: Quantidade total de registros por páginas. + schema: + type: integer + default: 25 + minimum: 1 + format: int32 + maximum: 1000 + pagination-key: + name: pagination-key + in: query + description: 'Identificador de rechamada, utilizado para evitar a contagem de chamadas ao endpoint durante a paginação.' + schema: + type: string + maxLength: 2048 + pattern: '[\w\W\s]*' + toDueDate: + name: toDueDate + description: Data final de filtragem. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDate: + name: toTransactionDate + description: | + Data final de filtragem. + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + toTransactionDateMaxLimited: + name: toTransactionDate + description: | + Data final de filtragem. O período máximo utilizado no filtro é de 7 dias inclusive (D-6). + + [Restrição] Deve obrigatoriamente ser enviado caso o campo fromTransactionDate seja informado. Caso não seja informado, deve ser assumido o dia atual. + required: false + in: query + schema: + type: string + maxLength: 10 + format: date + example: '2021-05-21' + xCustomerUserAgent: + name: x-customer-user-agent + in: header + description: Indica o user-agent que o usuário utiliza. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiAuthDate: + name: x-fapi-auth-date + in: header + description: 'Data em que o usuário logou pela última vez com o receptor. Representada de acordo com a [RFC7231](https://tools.ietf.org/html/rfc7231).Exemplo: Sun, 10 Sep 2017 19:43:31 UTC' + required: false + schema: + type: string + pattern: '^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$' + minLength: 29 + maxLength: 29 + xFapiCustomerIpAddress: + name: x-fapi-customer-ip-address + in: header + description: O endereço IP do usuário se estiver atualmente logado com o receptor. + required: false + schema: + type: string + pattern: '[\w\W\s]*' + minLength: 1 + maxLength: 100 + xFapiInteractionId: + name: x-fapi-interaction-id + in: header + description: 'Um UID [RFC4122](https://tools.ietf.org/html/rfc4122) usado como um ID de correlação. Se fornecido, o transmissor deve "reproduzir" esse valor no cabeçalho de resposta.' + required: false + schema: + type: string + pattern: '^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$' + minLength: 1 + maxLength: 100 + securitySchemes: + OpenId: + type: openIdConnect + openIdConnectUrl: 'https://auth.mockbank.poc.raidiam.io/.well-known/openid-configuration' + OAuth2Security: + type: oauth2 + description: Fluxo OAuth necessário para que a receptora tenha acesso aos dados na instituição transmissora. Requer o processo de redirecionamento e autenticação do usuário a que se referem os dados. + flows: + authorizationCode: + authorizationUrl: 'https://authserver.example/authorization' + tokenUrl: 'https://authserver.example/token' + scopes: + credit-cards-accounts: Escopo necessário para acesso à API Credit-cards-accounts. O controle dos endpoints específicos é feito via permissions. + responses: + OKResponseCreditCardAccountsList: + description: Conjunto de informações das Contas de pagamento pós paga + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsList' + OKResponseCreditCardAccountsIdentification: + description: Dados de identificação da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsIdentification' + OKResponseCreditCardAccountsBills: + description: Dados referentes à lista de faturas da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsBills' + OKResponseCreditCardAccountsLimits: + description: Dados dos limites da conta identificada por creditCardAccountId obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsLimits' + OKResponseCreditCardAccountsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + $ref: '#/components/schemas/ResponseCreditCardAccountsTransactions' + OKResponseCreditCardAccountsBillsTransactions: + description: Dados das lista de transações da conta identificada obtidos com sucesso. + headers: + x-fapi-interaction-id: + schema: + $ref: '#/components/schemas/XFapiInteractionId' + content: + application/json: + schema: + type: object + required: + - data + - links + - meta + properties: + data: + type: array + minItems: 0 + items: + $ref: '#/components/schemas/CreditCardAccountsBillsTransactions' + links: + $ref: '#/components/schemas/Links' + meta: + $ref: '#/components/schemas/Meta' + BadRequest: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Forbidden: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + InternalServerError: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + GatewayTimeout: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Locked: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + MethodNotAllowed: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotAcceptable: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + NotFound: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + TooManyRequests: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + UnprocessableEntity: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Unauthorized: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + SiteIsOverloaded: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + Default: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseErrorMetaSingle' + BadRequestWithAdditionalProperties: + description: 'A requisição foi malformada, omitindo atributos obrigatórios, seja no payload ou através de atributos na URL.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + ForbiddenWithAdditionalProperties: + description: O token tem escopo incorreto ou uma política de segurança foi violada + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + GatewayTimeoutWithAdditionalProperties: + description: GATEWAY TIMEOUT - A requisição não foi atendida dentro do tempo limite estabelecido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + InternalServerErrorWithAdditionalProperties: + description: Ocorreu um erro no gateway da API ou no microsserviço + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + LockedWithAdditionalProperties: + description: Locked + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + MethodNotAllowedWithAdditionalProperties: + description: O consumidor tentou acessar o recurso com um método não suportado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotAcceptableWithAdditionalProperties: + description: A solicitação continha um cabeçalho Accept diferente dos tipos de mídia permitidos ou um conjunto de caracteres diferente de UTF-8 + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + NotFoundWithAdditionalProperties: + description: O recurso solicitado não existe ou não foi implementado + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + TooManyRequestsWithAdditionalProperties: + description: 'A operação foi recusada, pois muitas solicitações foram feitas dentro de um determinado período ou o limite global de requisições concorrentes foi atingido' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnauthorizedWithAdditionalProperties: + description: Cabeçalho de autenticação ausente/inválido ou token inválido + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + UnprocessableEntityWithAdditionalProperties: + description: 'A sintaxe da requisição esta correta, mas não foi possível processar as instruções presentes.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + DefaultWithAdditionalProperties: + description: Erro inesperado. + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' + SiteIsOverloadedWithAdditionalProperties: + description: 'O site está sobrecarregado e a operação foi recusada, pois foi atingido o limite máximo de TPS global, neste momento.' + content: + application/json; charset=utf-8: + schema: + $ref: '#/components/schemas/ResponseError' diff --git a/swagger-apis/credit-cards/index.html b/swagger-apis/credit-cards/index.html index 0ac86e864..477e74cca 100644 --- a/swagger-apis/credit-cards/index.html +++ b/swagger-apis/credit-cards/index.html @@ -56,8 +56,9 @@ {"name": "2.0.0", "url": "./2.0.0.yml"}, {"name": "2.0.1", "url": "./2.0.1.yml"}, {"name": "2.1.0-rc.1", "url": "./2.1.0-rc.1.yml"}, - {"name": "2.1.0-rc.2", "url": "./2.1.0-rc.2.yml"}], - "urls.primaryName": "2.1.0-rc.2", // default spec + {"name": "2.1.0-rc.2", "url": "./2.1.0-rc.2.yml"}, + {"name": "3.0.0-beta.1", "url": "./3.0.0-beta.1.yml"}], + "urls.primaryName": "3.0.0-beta.1", // default spec dom_id: '#swagger-ui', deepLinking: true, supportedSubmitMethods:[], From 7a06e1766f9f6d3859da89f9b3f58be3a7e1bc3d Mon Sep 17 00:00:00 2001 From: Cecilia Fernandes <115801960+CeciliaFFernandes@users.noreply.github.com> Date: Mon, 28 Aug 2023 17:51:22 +0000 Subject: [PATCH 26/26] feat(Credit Cards): ORB-3493 - PDC161 - Incluir query params e alterar propriedades de campo --- ...ardAccountIdBillsBillIdTransactions_v3.csv | 78 ++++++++++++++++++ ...GetAccountsCreditCardAccountIdBills_v3.csv | 62 ++++++++++++++ ...etAccountsCreditCardAccountIdLimits_v3.csv | 78 ++++++++++++++++++ ...ditCardAccountIdTransactionsCurrent_v3.csv | 81 +++++++++++++++++++ ...untsCreditCardAccountIdTransactions_v3.csv | 81 +++++++++++++++++++ ...CardsGetAccountsCreditCardAccountId_v3.csv | 49 +++++++++++ dictionary/creditCardsGetAccounts_v3.csv | 45 +++++++++++ swagger-apis/credit-cards/3.0.0-beta.1.yml | 3 +- 8 files changed, 476 insertions(+), 1 deletion(-) create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v3.csv create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v3.csv create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v3.csv create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v3.csv create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v3.csv create mode 100644 dictionary/creditCardsGetAccountsCreditCardAccountId_v3.csv create mode 100644 dictionary/creditCardsGetAccounts_v3.csv diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v3.csv new file mode 100644 index 000000000..b25c430b5 --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBillsBillIdTransactions_v3.csv @@ -0,0 +1,78 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +É esperado que o `transactionId` seja único, imutável e estável. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/billId;billId;Informação que identifica a fatura onde consta a transação informada.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 +/data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: +Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO +DEBITO";1;1;"";Não permitido;string;DEBITO; +/data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO +TARIFA +OPERACOES_CREDITO_CONTRATADAS_CARTAO +ESTORNO +CASHBACK +OUTROS";1;1;"";Não permitido;string;CASHBACK; +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA +A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Não permitido;string;A_VISTA; +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE +SAQUE_CARTAO_BRASIL +SAQUE_CARTAO_EXTERIOR +AVALIACAO_EMERGENCIAL_CREDITO +EMISSAO_SEGUNDA_VIA +TARIFA_PAGAMENTO_CONTAS +SMS +OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Não permitido;string;ANUIDADE; +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO +PARCELAMENTO_FATURA +EMPRESTIMO +OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Não permitido;string;CREDITO_ROTATIVO; +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Não permitido;string;; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Não permitido;number;12; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; +/data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v3.csv new file mode 100644 index 000000000..7c31109fc --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdBills_v3.csv @@ -0,0 +1,62 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/billId;billId;Informação que identifica a fatura;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;3459087XXZTR;1 +/data/dueDate;dueDate;Data de vencimento da Fatura, que aparece para pagamento pelo cliente;Data;10;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/billTotalAmount;billTotalAmount;"Valor total da faturas. +O campo deve assumir valor positivo para saldo devedor e negativo para saldo credor. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/billTotalAmount/amount;amount;Valor total da faturas. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Obrigatório;^-?\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/billTotalAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/billMinimumAmount;billMinimumAmount;"Valor do pagamento minimo da fatura +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/billMinimumAmount/amount;amount;Valor do pagamento minimo da fatura;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/billMinimumAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/isInstalment;isInstalment;Indica se a fatura permite parcelamento (true) ou não (false).;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;false; +/data/financeCharges;financeCharges;Lista dos encargos cobrados na fatura;Lista;;Opcional;;;1;N;"";Não permitido;array;; +/data/financeCharges/type;type;"Traz a denominação dos Encargos que +incidem na fatura da conta de pagamento pós-paga. (Vide Enum) +- Juros remuneratórios por atraso no pagamento da fatura +- Multa por atraso no pagamento da fatura +- Juros de mora por atraso no pagamento da fatura +- IOF +- Outros +";Texto;;Obrigatório;;"JUROS_REMUNERATORIOS_ATRASO_PAGAMENTO_FATURA +MULTA_ATRASO_PAGAMENTO_FATURA +JUROS_MORA_ATRASO_PAGAMENTO_FATURA +IOF +OUTROS";1;1;"";Não permitido;string;; +/data/financeCharges/additionalInfo;additionalInfo;Campo livre, de preenchimento obrigatório se selecionado tipo de encargo 'OUTROS';Texto;140;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações Adicionais; +/data/financeCharges/amount;amount;Valor cobrado pelo encargo. Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;100000.0400;4 +/data/financeCharges/currency;currency;"Moeda referente ao valor cobrado pelo encargo, segundo modelo ISO-4217. p.ex. 'BRL' +Todos os saldos informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; +/data/payments;payments;Lista que traz os valores relativos aos pagamentos da Fatura da conta de pagamento pós-paga;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/payments/valueType;valueType;"Traz os tipos dos valores relativos aos pagamentos da fatura da conta de pagamento pós-paga: (Vide Enum) + - Valor de pagamento da fatura com parcelamento + - Valor pagamento da fatura realizado + - Outro Valor pago na fatura + + VALOR_PAGAMENTO_FATURA_PARCELADO: Quando o pagamento corresponde ao fato gerador para abertura do plano de parcelamento da fatura + + VALOR_PAGAMENTO_FATURA_REALIZADO: Quando o pagamento corresponde ao valor total da fatura + + OUTRO_VALOR_PAGO_FATURA: Demais casos +";Texto;;Obrigatório;;"VALOR_PAGAMENTO_FATURA_PARCELADO +VALOR_PAGAMENTO_FATURA_REALIZADO +OUTRO_VALOR_PAGO_FATURA";1;1;"";Não permitido;string;; +/data/payments/paymentDate;paymentDate;Data efetiva de quando o Pagamento da fatura foi realizado;Data;10;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/payments/paymentMode;paymentMode;"Traz as formas de efetivação do pagamento realizado: (Vide Enum) +- Débito em conta corrente +- Boleto bancário +- Averbação em folha +- PIX +";Texto;;Obrigatório;;"DEBITO_CONTA_CORRENTE +BOLETO_BANCARIO +AVERBACAO_FOLHA +PIX";1;1;"";Não permitido;string;; +/data/payments/amount;amount;"Valor pagamento segundo o valueType. +Expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. +O campo não pode assumir valor negativo por se tratar de um pagamento. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/payments/currency;currency;"Moeda referente ao valor de pagamento da fatura, segundo modelo ISO-4217. p.ex. 'BRL' Todos os valores informados estão representados com a moeda vigente do Brasil +";Texto;3;Obrigatório;^(\w{3}){1}$;;1;1;"";Não permitido;string;BRL; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v3.csv new file mode 100644 index 000000000..c28840e74 --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdLimits_v3.csv @@ -0,0 +1,78 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;"[Restrição] A lista vazia deve ser interpretada como a ausência da informação. + +Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + +Cenário de ""cartão sem limite"", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. +";Lista;;Obrigatório;;;0;N;" A lista vazia deve ser interpretada como a ausência da informação. + +Cenário de limite com valor zerado, deve ter um registro explícito informando o valor como zero. + +Cenário de ""cartão sem limite"", isto é, cartões em que o uso do limite é ilimitado, deve ser informado em um registro explícito com isLimitFlexible como true. +";Não permitido;array;; +/data/creditLineLimitType;creditLineLimitType;"Indicador do tipo de limite + +LIMITE_CREDITO_TOTAL: Limite de crédito total aplicado a conta cartão. + +LIMITE_CREDITO_MODALIDADE_OPERACAO: Limite de crédito por modalidade desse conta cartão (observar lineName e listar os aplicáveis da instituição). +";Texto;;Obrigatório;;"LIMITE_CREDITO_TOTAL +LIMITE_CREDITO_MODALIDADE_OPERACAO";1;1;"";Não permitido;string;LIMITE_CREDITO_TOTAL; +/data/consolidationType;consolidationType;"Indicador que permite informar se o valor do limite é consolidado ou individual. + +CONSOLIDADO: utilizado quando o limite da conta cartão é compartilhado entre todos os métodos de pagamento (paymentMethod) atrelados a conta. + +INDIVIDUAL: Utilizado quando cada método de pagamento (paymentMethod) possui seu limite segregado. +";Texto;;Obrigatório;;"CONSOLIDADO +INDIVIDUAL";1;1;"";Não permitido;string;CONSOLIDADO; +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/lineName;lineName;;Texto;;Opcional;;"CREDITO_A_VISTA +CREDITO_PARCELADO +SAQUE_CREDITO_BRASIL +SAQUE_CREDITO_EXTERIOR +EMPRESTIMO_CARTAO_CONSIGNADO +OUTROS";0;1;"";Não permitido;string;CREDITO_A_VISTA; +/data/lineNameAdditionalInfo;lineNameAdditionalInfo;Campo de preenchimento obrigatório se selecionada a opção 'OUTRAS' em lineName.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;Informações adicionais e complementares.; +/data/isLimitFlexible;isLimitFlexible;True= Indica que a conta cartão possui limite total flexível ou “sem limite”. False = Indica que a conta cartão possui limite predeterminado exibido no canal para o cliente.;Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; +/data/limitAmount;limitAmount;"Valor total do limite concedido. +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/limitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +";Não permitido;string;1000.0400;4 +/data/limitAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' +Todos os limite informados estão representados com a moeda vigente do Brasil. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +";Não permitido;string;BRL; +/data/limitAmount/limitAmountReason;limitAmountReason;"Razão pela qual o valor total do limite informado está igual a zero. + +[Restrição] Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. +";Texto;200;Condicional;[\w\W\s]*;;0;1;" Campo de preenchimento obrigatório quando limitAmount for igual a 0.00. +";Não permitido;string;O perfil do cliente passou por uma análise e o limite precisou ser zerado; +/data/usedAmount;usedAmount;Valor utilizado do limite informado;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/usedAmount/amount;amount;Valor utilizado do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais.;Texto;21;Obrigatório;^-?\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/usedAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' +Todos os saldos informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/availableAmount;availableAmount;"Valor disponível do limite informado +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/availableAmount/amount;amount;"Valor disponível do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;21;Condicional;^-?\d{1,15}\.\d{2,4}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +";Não permitido;string;1000.0400;4 +/data/availableAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' +Todos os saldos informados estão representados com a moeda vigente do Brasil. + +[Restrição] O campo é obrigatório caso isLimitFlexible for igual a false. +";Texto;3;Condicional;^[A-Z]{3}$;;0;1;" O campo é obrigatório caso isLimitFlexible for igual a false. +";Não permitido;string;BRL; +/data/customizedLimitAmount;customizedLimitAmount;"Valor total do limite customizado pelo cliente nos canais eletrônicos da instituição. Esse objeto é de envio obrigatório nos casos em que a instituição permita ao cliente alterar o seu limite. +";Objeto;;Opcional;;;0;1;"";Não permitido;object;; +/data/customizedLimitAmount/amount;amount;"Valor total do limite informado expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais. +";Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/customizedLimitAmount/currency;currency;"Moeda referente ao limite informado, segundo modelo ISO-4217. p.ex. 'BRL.' Todos os limite informados estão representados com a moeda vigente do Brasil. +";Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v3.csv new file mode 100644 index 000000000..a3b5f67db --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactionsCurrent_v3.csv @@ -0,0 +1,81 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +O ideal é que o `transactionId` seja imutável. +No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. +Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. +O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/billId;billId;Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 +/data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: +Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO +DEBITO";1;1;"";Não permitido;string;DEBITO; +/data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO +TARIFA +OPERACOES_CREDITO_CONTRATADAS_CARTAO +ESTORNO +CASHBACK +OUTROS";1;1;"";Não permitido;string;CASHBACK; +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA +A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Não permitido;string;A_VISTA; +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE +SAQUE_CARTAO_BRASIL +SAQUE_CARTAO_EXTERIOR +AVALIACAO_EMERGENCIAL_CREDITO +EMISSAO_SEGUNDA_VIA +TARIFA_PAGAMENTO_CONTAS +SMS +OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Não permitido;string;ANUIDADE; +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO +PARCELAMENTO_FATURA +EMPRESTIMO +OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Não permitido;string;CREDITO_ROTATIVO; +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Não permitido;string;; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Não permitido;number;12; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; +/data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Opcional;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;0;1;"";Não permitido;string;2021-05-21; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v3.csv new file mode 100644 index 000000000..a3b5f67db --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountIdTransactions_v3.csv @@ -0,0 +1,81 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/transactionId;transactionId;"Código ou identificador único prestado pela instituição que mantém a conta para representar a transação individual. +O ideal é que o `transactionId` seja imutável. +No entanto, para casos em que a transação ainda está em processamento, é esperado que o `transactionId` intermediário seja estável, mudando apenas quando a transação sofrer uma mudança em seu estado. +Para transações processadas, é esperado que o `transactionld` e demais dados da transação sejam imutáveis. +O `transactionId` deve obedecer, no mínimo, as regras de imutabilidade propostas conforme a tabela “Data de imutabilidade por tipo de transação” presente nas orientações desta API +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;TXpRMU9UQTROMWhZV2xSU1FUazJSMDl;1 +/data/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para PF, ou então, preencher com um identificador para PJ, com as caracteristicas definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/transactionName;transactionName;Literal usada na instituição financeira para identificar a transação. A informação apresentada precisa ser a mesma utilizada nos canais eletrônicos da instituição (extrato e fatura).;Texto;200;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;PGTO; +/data/billId;billId;Informação que identifica a fatura onde consta a transação informada. Preencher apenas para casos de transação em fatura fechada, ou seja, este campo não é esperado em casos de transação em fatura aberta.;Texto;100;Opcional;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;0;1;"";Não permitido;string;MTU0OTU1NjI2NTk4OTRmc2ZhZDRmc2Q1NmZkM;1 +/data/creditDebitType;creditDebitType;"Indicador do tipo de lançamento: +Débito (no extrato) Em um extrato bancário, os débitos, marcados com a letra “D” ao lado do valor registrado, informam as saídas de dinheiro na conta-corrente. +Crédito (no extrato) Em um extrato bancário, os créditos, marcados com a letra “C” ao lado do valor registrado, informam as entradas de dinheiro na conta-corrente. +";Texto;;Obrigatório;;"CREDITO +DEBITO";1;1;"";Não permitido;string;DEBITO; +/data/transactionType;transactionType;Traz os tipos de Transação;Texto;;Obrigatório;;"PAGAMENTO +TARIFA +OPERACOES_CREDITO_CONTRATADAS_CARTAO +ESTORNO +CASHBACK +OUTROS";1;1;"";Não permitido;string;CASHBACK; +/data/transactionalAdditionalInfo;transactionalAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionado tipo de transação ""OUTROS""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/paymentType;paymentType;"Traz os tipos de pagamento. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Texto;;Condicional;;"A_VISTA +A_PRAZO";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'PAGAMENTO'. +";Não permitido;string;A_VISTA; +/data/feeType;feeType;"Traz os tipos de Tarifas: (Vide Enum) Anuidade, Saque com cartão no Brasil, Saque com cartão no exterior, Avaliação emergencial de crédito, Emissão segunda via, Tarifa pagamento de contas, SMS, OUTRA. + +[Restrição] Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Texto;;Condicional;;"ANUIDADE +SAQUE_CARTAO_BRASIL +SAQUE_CARTAO_EXTERIOR +AVALIACAO_EMERGENCIAL_CREDITO +EMISSAO_SEGUNDA_VIA +TARIFA_PAGAMENTO_CONTAS +SMS +OUTRA";0;1;" Preenchimento obrigatório se Tipo de Transação selecionada for 'TARIFA'. +";Não permitido;string;ANUIDADE; +/data/feeTypeAdditionalInfo;feeTypeAdditionalInfo;"Campo livre, de preenchimento obrigatório quando selecionada tipo de tarifa ""OUTRA""";Texto;140;Opcional;^\S[\s\S]*$;;0;1;"";Não permitido;string;; +/data/otherCreditsType;otherCreditsType;"Traz outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Texto;;Condicional;;"CREDITO_ROTATIVO +PARCELAMENTO_FATURA +EMPRESTIMO +OUTROS";0;1;" Preenchimento obrigatório se o tipo transação selecionado for 'OPERACOES_CREDITO_CONTRATADAS_CARTAO'. +";Não permitido;string;CREDITO_ROTATIVO; +/data/otherCreditsAdditionalInfo;otherCreditsAdditionalInfo;"Campo livre para preenchimento de dados adicionais de outros tipos de crédito contratados no cartão. + +[Restrição] Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Texto;50;Condicional;^\S[\s\S]*$;;0;1;" Preenchimento obrigatório quando selecionado no campo outros tipos de crédito ""OUTROS"". +";Não permitido;string;; +/data/chargeIdentificator;chargeIdentificator;"Número da parcela que está sendo informada. + +[Restrição] Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Número;;Condicional;;;0;1;" Preenchimento obrigatório se Tipo de Pagamento (paymentType) selecionada for 'A_PRAZO'. +";Não permitido;number;12; +/data/chargeNumber;chargeNumber;"Quantidade de parcelas. +[Restrição] O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Número;;Condicional;;;0;1;" O campo deve ser preenchido quando houverem parcelas relacionadas a transação. +";Não permitido;number;12; +/data/brazilianAmount;brazilianAmount;"Valor da transação expresso em valor monetário com no mínimo 2 casas e no máximo 4 casas decimais, em moeda corrente do Brasil. Deve ser o valor de amount convertido para BRL (em caso de compra internacional) ou o mesmo valor de amount (em caso de compra nacional). +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/brazilianAmount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/brazilianAmount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/amount;amount;"Valor original da transação. Expresso em valor monetário com no mínimo 2 casas decimais e no máximo 4 casas decimais. Deve ser sempre preenchido com o valor original da transação independente da nacionalidade, sem convertê-lo. +";Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/amount/amount;amount;Valor relacionado ao objeto.;Texto;20;Obrigatório;^\d{1,15}\.\d{2,4}$;;1;1;"";Não permitido;string;1000.0400;4 +/data/amount/currency;currency;Moeda referente ao valor monetário, seguindo o modelo ISO-4217.;Texto;3;Obrigatório;^[A-Z]{3}$;;1;1;"";Não permitido;string;BRL; +/data/transactionDate;transactionDate;Data original da transação;Data;20;Obrigatório;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;1;1;"";Não permitido;string;2021-05-21; +/data/transactionDateTime;transactionDateTime;"Data e hora original da transação. +No primeiro momento, as instituições poderão complementar informações faltantes com 0 (Por exemplo: 2016-01-29T00:00:00.000Z) +A partir de 31/01/2024 é esperado que o campo seja preenchido com informações reais. +";Date Hora;24;Obrigatório;(^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])T(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)\.(?:[0-9]){3}Z$);;1;1;"";Não permitido;string;2016-01-29T12:29:03.374Z; +/data/billPostDate;billPostDate;Data em que a transação foi inserida na fatura;Data;20;Opcional;^(\d{4})-(1[0-2]|0?[1-9])-(3[01]|[12][0-9]|0?[1-9])$;;0;1;"";Não permitido;string;2021-05-21; +/data/payeeMCC;payeeMCC;"O MCC ou o código da categoria do estabelecimento comercial. Os MCCs são agrupados segundo suas similaridades. O MCC é usado para classificar o negócio pelo tipo fornecido de bens ou serviços. Os MCCs são atribuídos por tipo de comerciante (por exemplo, um para hotéis, um para lojas de materiais de escritório, etc.) ou por nome de comerciante (por exemplo, 3000 para a United Airlines). +";Número;;Opcional;;;0;1;"";Não permitido;number;5137; diff --git a/dictionary/creditCardsGetAccountsCreditCardAccountId_v3.csv b/dictionary/creditCardsGetAccountsCreditCardAccountId_v3.csv new file mode 100644 index 000000000..cb4d72660 --- /dev/null +++ b/dictionary/creditCardsGetAccountsCreditCardAccountId_v3.csv @@ -0,0 +1,49 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;Conjunto de informações referentes à identificação da conta de pagamento pós-paga.;Objeto;;Obrigatório;;;1;1;"";Não permitido;object;; +/data/name;name;"Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos'. +";Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Cartão Universitário; +/data/productType;productType;Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.;Texto;;Obrigatório;;"CLASSIC_NACIONAL +CLASSIC_INTERNACIONAL +GOLD +PLATINUM +INFINITE +ELECTRON +STANDARD_NACIONAL +STANDARD_INTERNACIONAL +ELETRONIC +BLACK +REDESHOP +MAESTRO_MASTERCARD_MAESTRO +GREEN +BLUE +BLUEBOX +PROFISSIONAL_LIBERAL +CHEQUE_ELETRONICO +CORPORATIVO +EMPRESARIAL +COMPRAS +BASICO_NACIONAL +BASICO_INTERNACIONAL +NANQUIM +GRAFITE +MAIS +OUTROS";1;1;"";Não permitido;string;OUTROS; +/data/productAdditionalInfo;productAdditionalInfo;Informações complementares se tipo de Cartão 'OUTROS';Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;OURO_INTERNACIONAL; +/data/creditCardNetwork;creditCardNetwork;"Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). +Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. +";Texto;;Obrigatório;;"VISA +MASTERCARD +AMERICAN_EXPRESS +DINERS_CLUB +HIPERCARD +BANDEIRA_PROPRIA +CHEQUE_ELETRONICO +ELO +OUTRAS";1;1;"";Não permitido;string;VISA; +/data/networkAdditionalInfo;networkAdditionalInfo;Texto livre para especificar categoria de bandeira marcada como 'OUTRAS'.;Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;AURA CARD; +/data/paymentMethod;paymentMethod;"Listagem dos cartões (ex.: virtual/adicional/titular) associados a conta cartão consentida, conforme disponíveis ao usuário nos canais proprietários. +";Lista;;Obrigatório;;;1;N;"";Não permitido;array;; +/data/paymentMethod/identificationNumber;identificationNumber;"Número de identificação do cartão: corresponde aos 4 últimos dígitos do cartão para pessoa natural, ou então, preencher com um identificador para pessoa jurídica, com as características definidas para os IDs no Open Finance. +";Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;4453;1 +/data/paymentMethod/isMultipleCreditCard;isMultipleCreditCard;"Indica se o Cartão de crédito associado à conta pagamento pós-paga é múltiplo ou não. Cartões denominados múltiplos possuem tanto a função crédito quanto a função débito, devendo o proprietário do cartão, no momento de sua utilização, informar se o pagamento é na função crédito (que leva a um pagamento futuro, por meio de uma fatura do cartão de crédito) ou na função débito. +";Booleano;;Obrigatório;;;1;1;"";Não permitido;boolean;true; diff --git a/dictionary/creditCardsGetAccounts_v3.csv b/dictionary/creditCardsGetAccounts_v3.csv new file mode 100644 index 000000000..8a60eea07 --- /dev/null +++ b/dictionary/creditCardsGetAccounts_v3.csv @@ -0,0 +1,45 @@ +Xpath;Nome;Definição;Tipo de Dado;Tamanho;Mandatoriedade;Formato;Domínio;Mínimo de Ocorrências;Máximo de Ocorrências;Restrições;Nulidade;Tipo de Dado Json;Exemplo;Tamanho mínimo +/data;data;Conjunto de informações de conta de pagamento pós-paga;Lista;;Obrigatório;;;0;N;"";Não permitido;array;; +/data/creditCardAccountId;creditCardAccountId;Identifica de forma única a conta pagamento pós-paga do cliente, mantendo as regras de imutabilidade dentro da instituição transmissora.;Texto;100;Obrigatório;^[a-zA-Z0-9][a-zA-Z0-9-]{0,99}$;;1;1;"";Não permitido;string;XXZTR3459087;1 +/data/brandName;brandName;Nome da Marca reportada pelo participante no Open Finance. Recomenda-se utilizar, sempre que possível, o mesmo nome de marca atribuído no campo do diretório Customer Friendly Server Name (Authorisation Server).;Texto;80;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Organização A; +/data/companyCnpj;companyCnpj;Número completo do CNPJ da instituição responsável pelo Cadastro - o CNPJ corresponde ao número de inscrição no Cadastro de Pessoa Jurídica. Deve-se ter apenas os números do CNPJ, sem máscara;Texto;14;Obrigatório;^\d{14}$;;1;1;"";Não permitido;string;21128159000166; +/data/name;name;Denominação/Identificação do nome da conta de pagamento pós-paga (cartão). Conforme CIRCULAR Nº 3.680,BCB, 2013: 'conta de pagamento pós-paga: destinada à execução de transações de pagamento que independem do aporte prévio de recursos;Texto;50;Obrigatório;[\w\W\s]*;;1;1;"";Não permitido;string;Cartão Universitário; +/data/productType;productType;Categoria atribuída a um cartão de pagamento, sob uma certa denominação, que lhe agrega um conjunto de vantagens, diferenciando-o de acordo com o perfil do portador.;Texto;;Obrigatório;;"CLASSIC_NACIONAL +CLASSIC_INTERNACIONAL +GOLD +PLATINUM +INFINITE +ELECTRON +STANDARD_NACIONAL +STANDARD_INTERNACIONAL +ELETRONIC +BLACK +REDESHOP +MAESTRO_MASTERCARD_MAESTRO +GREEN +BLUE +BLUEBOX +PROFISSIONAL_LIBERAL +CHEQUE_ELETRONICO +CORPORATIVO +EMPRESARIAL +COMPRAS +BASICO_NACIONAL +BASICO_INTERNACIONAL +NANQUIM +GRAFITE +MAIS +OUTROS";1;1;"";Não permitido;string;OUTROS; +/data/productAdditionalInfo;productAdditionalInfo;Informações complementares se tipo de Cartão 'OUTROS';Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;; +/data/creditCardNetwork;creditCardNetwork;"Categoria de Bandeiras de Cartões de Crédito (Instituidor do arranjo de pagamento). +Bandeira é a detentora de todos os direitos e deveres da utilização da marca estampada no cartão, inclusive as bandeiras pertencentes aos emissores. +";Texto;;Obrigatório;;"VISA +MASTERCARD +AMERICAN_EXPRESS +DINERS_CLUB +HIPERCARD +BANDEIRA_PROPRIA +CHEQUE_ELETRONICO +ELO +OUTRAS";1;1;"";Não permitido;string;VISA; +/data/networkAdditionalInfo;networkAdditionalInfo;Texto livre para especificar categoria de bandeira marcada como 'OUTRAS';Texto;50;Opcional;[\w\W\s]*;;0;1;"";Não permitido;string;AURA CARD; diff --git a/swagger-apis/credit-cards/3.0.0-beta.1.yml b/swagger-apis/credit-cards/3.0.0-beta.1.yml index 48a922391..20e447571 100644 --- a/swagger-apis/credit-cards/3.0.0-beta.1.yml +++ b/swagger-apis/credit-cards/3.0.0-beta.1.yml @@ -320,6 +320,8 @@ paths: - $ref: '#/components/parameters/xCustomerUserAgent' - $ref: '#/components/parameters/creditCardAccountId' - $ref: '#/components/parameters/pagination-key' + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' responses: '200': $ref: '#/components/responses/OKResponseCreditCardAccountsLimits' @@ -1082,7 +1084,6 @@ components: - amount - transactionDate - transactionDateTime - - billPostDate properties: transactionId: type: string