Histórico da Página

...

Especificação atualizada de API Rating em padrão Swagger (ultima atualização 2901/09/082024):

View file

name	api-docs-rating.json
height	150

Para visualizar a documentação acessar a URL https://editor-next.swagger.io/, importar o arquivo no menu File>Import File.

...

Ultima atualização 25/10/2024

Informações
Todos os endpoint tem limites de itens a serem enviados por chamada. Descrito melhor em RT - Rating - API Assíncrona

...

Nota
O endpoint de valores provisão ainda está em desenvolvimento e está previsto para uma próxima entrega

...

Consulta Valores Provisão

Endpoint: /valores-provisao/{cd_emp}/{dt_mov} (YYYYMM)

QueryString:

3040
```
flag3040* = (S|N)
```
cdIpoc* = (Código IPOC)

ou (obrigatório se não informado cdIpoc)

...

Expandir

Retornos

200 - OK: Valores consultados com sucesso

Content Type: application/json

Corpo:

Bloco de código

language	js

{
    "vrPrdEsp": 10000.00,
    "vrPerLgdvrPrdAdc": 010000.00,
  // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00)
    "vrPerEsp": 0 "vrPrdInc": 10000.00,
    "cdEstInsFin": 1, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00Código Estágio do Instrumento Financeiro - Valores (1|2|3)
    "cdEstcdCarPrv": 1,"C1" // Estágio - Valores (1|2|3)
    "cdCar": "C1" //Código Carteira Provisão - Valores (C1|C2|C3|C4|C5) 
}

40X - Erro:

Requisição sem dados a serem retornados:

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 0400,
  "errormessage": "string",
  "message": "stringNenhum valor encontrado para consulta"
}

500 - Erro InternoRequisição com parâmetros que não estão dentro do escopo:

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 0400,
  "errormessage": "string",
  "message": "stringOs parâmetros são mutuamente exclusivos. Utilize apenas cdIpoc ou os outros identificadores"
}

Nota
O endpoint de ajustes de valores provisão ainda está em desenvolvimento e está previsto para uma próxima entrega

API - Ajusta Valores Provisão

Endpoint: /valores-provisao/{cd_emp}/{dt_mov} (YYYYMM)

QueryString:

cdIpoc* = (Código IPOC)

ou (obrigatório se não informado cdIpoc)

cdCli* = (Código do cliente)
nrCtr* = (Numero contrato)
sgMod* = (Sigla da modalidade)
nrAdeLib* = (Numero do Adlib)

Método: POST
Content Type: application/json

500 - Erro Interno

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 500,
  "message": "Falha ao consultar Valores Provisão"
}

Bloco de código

language	js

{
  "status": 500,
  "message": "Falha ao consultar Valores Provisão 3040"
}

...

Nota
O endpoint de ajustes de valores provisão ainda está em desenvolvimento e está previsto para uma próxima entrega

Ajusta Valores Provisão

Endpoint: /valores-provisao/{cd_emp}/{dt_mov} (YYYYMM)

QueryString:

cdIpoc* = (Código IPOC)

ou (obrigatório se não informado cdIpoc)

cdCli* = (Código do cliente)
nrCtr* = (Numero contrato)
sgMod* = (Sigla da modalidade)
nrAdeLib* = (Numero do Adlib)

Método: PUT
Content Type: application/json

Expandir

Corpo

Bloco de código

language	js

{
    "vrPrdEsp": 10000.00,
	"vrPerEspRet": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00),
	"vrPerLgdRet": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00),
	"vrPerAdcRet": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00),
	"vrPrdAdcRet": 10000.00,
	"vrPerIncRet": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00),
	"vrPrdIncRet": 10000.00
}

Retornos

200 - OK: Valores de provisão ajustados com sucesso

Content Type: não possui

Corpo: Sem retorno

40X - Erro:

Requisição com parâmetros que não estão dentro do escopo:

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 400,
  "message": "Os parâmetros são mutuamente exclusivos. Utilize apenas cdIpoc ou os outros identificadores"
}

Requisição com o corpo da mensagem enviado de forma incorreta:

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 400,
  "message": "Existem campos obrigatórios que não foram preenchidos. Por favor, verifique e preencha todos os campos necessários."
}

500 - Erro Interno

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 500,
  "message": "Erro ao solicitar ajuste nos valores de provisão"
}

...

Nota
O endpoint de garantia ainda está em desenvolvimento e está previsto para uma próxima entrega

Ajusta Valores Provisão em Lote

A requisição deve ser um array de objetos com os valores a serem ajustados e sua identificação, no qual pode ser o Código Ipoc ou Chaves de identificação. A seguir estão os campos que podem ser passados em cada item do array.

vrPrdEsp: Valor Perda Esperada.
vrPerEspRet: Valor Percentual da Perda Esperada.
vrPerLgdRet: Valor do Percentual LGD.
vrPrdAdcRet: Valor Perda Adicional.
vrPerAdcRet: Valor Percentual Perda Adicional.
vrPerIncRet: Valor Percentual Perda Incorrida.
vrPrdIncRet: Valor Perda Incorrida.
cdIpoc (obrigatório ou alternativo): Código IPOC. Caso não seja informado, deve ser fornecido os seguintes campos alternativos:
- cdCli (obrigatório, se cdIpoc não informado): Código do Cliente.
- nrCtr (obrigatório, se cdIpoc não informado): Número do Contrato.
- sgMod (obrigatório, se cdIpoc não informado): Sigla da Modalidade.
- nrAdeLib (obrigatório, se cdIpoc não informado): Número do Adlib.

Endpoint: /valores-provisao/{cd_emp}/{dt_mov} (YYYYMM)

Método: POST
Content Type: application/json

Exemplo de Estrutura de Requisição e Retorno:

Expandir

Exemplo do Corpo da Requisição (IPOC):

Bloco de código

language	js

//Requisição com chave ipoc
[
	{
    "vrPrdEsp": 10000.00,
    "vrPerEspRet": 0,
    "vrPerLgdRet": 0,
    "vrPrdAdcRet": 0,
    "vrPerAdcRet": 0,
    "vrPerIncRet": 0,
    "vrPrdIncRet": 10000.00,
    "cdIpoc": "0628453102025255200000120230008200" //chave Ipoc
  },
  {
    "vrPrdEsp": 25000.00,
    "vrPerEspRet": 0,
    "vrPerLgdRet": 0,
    "vrPrdAdcRet": 0,
    "vrPerAdcRet": 0,
    "vrPerIncRet": 0,
    "vrPrdIncRet": 25000.00,
    "cdIpoc": "0628453102163683MUER012023000828000" //chave Ipoc
  }, 
  .... //Demais elementos
]

Exemplo do Corpo da Requisição (Chave de identificação):

Bloco de código

language	js

//Requisição com chaves de Identificação
[
	{
    "vrPrdEsp": 10000.00,
    "vrPerEspRet": 0,
    "vrPerLgdRet": 0,
    "vrPrdAdcRet": 0,
    "vrPerAdcRet": 0,
    "vrPerIncRet": 0,
    "vrPrdIncRet": 10000.00,
    "cdCli": 987877440, //chave identificadora
    "nrCtr": "1234567890", //chave identificadora
	"sgMod": "DSAGRFIP", //chave identificadora
	"nrAdeLib": "000" //chave identificadora
  },
  {
    "vrPrdEsp": 25000.00,
    "vrPerEspRet": 0,
    "vrPerLgdRet": 0,
    "vrPrdAdcRet": 0,
    "vrPerAdcRet": 0,
    "vrPerIncRet": 0,
    "vrPrdIncRet": 25000.00,
    "vrPrdIncRet": 10000.00,
    "cdCli": 987873330, //chave identificadora
	"nrCtr": "1134467890", //chave identificadora
	"sgMod": "DSVGYFIP", //chave identificadora
	"nrAdeLib": "111" //chave identificadora
  }, 
  .... //Demais elementos
]

Retornos

202 - Accepted: O retorno será uma identificação da operação afirmando que foi aceita
Content Type: não possui
Corpo:

Bloco de código

language	js

//Um identificador único, como este: 
ceb3fe33-976e-47cd-a410-1ea484890adc

40X - Erro:

Os erros que ocorrerem durante o fluxo serão registrados na tabela de erros e poderão ser consultados usando o identificador gerado após a execução da requisição de ajustes de valores em lote.

Exceções:

Caso a requisição ultrapasse o tamanho máximo permitido para o lote, ou seja, se o tamanho da requisição exceder o limite estabelecido, ocorrerá:

Expandir

Corpo

Bloco de código

language	js

{
    "vrPrdEsp": 10000.00,
    "vrPerLgd": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00)
    "vrPerEsp": 0, // (0.1% = 0.001 / 1% = 0.01 / 100% = 1.00)
    "cdEst": 1, // Estágio - Valores (1|2|3)
    "cdCar": "C1" //Carteira Provisão - Valores (C1|C2|C3|C4|C5) 
}

Retornos

200 - OK: Valores ajustados com sucesso

Content Type: não possui

Corpo: Sem retorno

40X - Erro: Requisição

Content Type: application/json

Corpo:

Bloco de código

language	js

{
  "status": 0400,
  "errormessage": "string",
  "message": "string"Muitos itens enviados ao mesmo tempo"
}

500 - Erro Interno
Content Type: application/json
Corpo:

Bloco de código

language	js

{
  "status": 0500,
  "errormessage": "string",
  "message": "stringErro ao criar processo de ajuste - Valores Provisão em lote"
}

Árvore de páginas

Versões comparadas

Versão antiga 30

Nova versão Atual

Chave

Consulta Valores Provisão

API - Ajusta Valores Provisão

Ajusta Valores Provisão

Ajusta Valores Provisão em Lote