...
Consentimento | |||
---|---|---|---|
Modelo: | Compartilha todos os recursos elegíveis | Período de vigência máximo | 12 meses |
Recursos incluídos no compartilhamento |
| ||
Recursos não incluídos no compartilhamento |
|
Visão da API
...
Resources
...
para os Produtos de Câmbio
O identificador único resourceId de cada recurso das operações de câmbio presentes na lista devolvida pela API Resources, corresponde ao identificador único operationId utilizado pelas API de Câmbio.
...
Código da Regra | Descrição da Regra |
---|---|
RN001 | É obrigatório que todos os recursos do tipo câmbio passíveis de compartilhamento retornem o identificador único independente do status a ser informado. |
RN002 | É obrigatório o retorno de todas as operações passíveis de compartilhamento, independente de seus status. A operação de câmbio que já foi objeto de compartilhamento no Open Finance (que em algum momento teve seu status AVAILABLE) deve ter seu status alterado para UNAVAILABLE na data em que completa 12 meses de sua data de liquidação ou do cancelamento. |
RN003 | Caso a Transmissora ainda esteja preparando a listagem dos recursos autorizados da API Resources, deve ser retornado o código HTTP Status Code 202 - accepted com o body vazio, e a Receptora deverá seguir as recomendações de polling. |
RN004 | É obrigatório que todas todos as operações de câmbio elegíveis sejam compartilhadas, ou seja, tenham seu resourceld resourceId corretamente expostos. Isso vale tanto para operações contratadas, liquidadas ou canceladas nos últimos 12 meses em relação ao inicio início de vigência do consentimento ou operações que venham a ser contratadas, liquidadas ou canceladas após esse momento, desde que o consentimento esteja vigente. |
RN005 | Operações de câmbio que estejam em processo de múltiplas alçadas para aprovação devem retornar o status PENDING_AUTHORISATION. |
RN006 | O método de listagem das APIs API de câmbio Câmbio deve retornar apenas a lista de operações de câmbio que estejam com o status de Resources como AVAILABLE. |
RN007 | Cada recurso (operação) autorizado no consentimento deve ter seu status tratado de forma independente. |
RN008 | No caso em que um cliente tenha consentido a opção “câmbio” no compartilhamento de produtos, mas não possua nenhuma operação, a API Resources deve retornar lista vazia, com HTTP Status Code 200. |
Recomendação do uso de polling
É recomendado que a instituição receptora implemente um retry exponencial (o tempo de espera entre a última chamada e a próxima chamada da API deve crescer exponencialmente), de forma a não sobrecarregar a API Resources.
Diagrama representacional do status da API
...
Resources
...
Produtos encerrados x Período de vigência do consentimento.
Consentimento (ex. 4 meses) | ||||||
---|---|---|---|---|---|---|
Cenários | DIA D | D+1M | D+2M | D+3M | D+4M | D+5M |
Produto encerrado* em D-13M | Não é escopo de compartilhamento | |||||
Produto encerrado* em D-11M | AVAILABLE | AVAILABLE | UNAVAILABLE | UNAVAILABLE | UNAVAILABLE | Acesso a API não autorizado |
Produto encerrado* em D+2M | AVAILABLE | AVAILABLE | AVAILABLE | AVAILABLE | AVAILABLE | Acesso a API não autorizado |
...