# Busca de Avaliações de Duplicatas Mercantis

## Conjunto de serviços para a consulta de dados do documento fiscal e das partes envolvidas na operação que originou o Direito Creditório.

> &#x20; Serviço para consultar o status de processamento das Avaliações. O resultado é uma lista com resumos das Avaliações consultadas. Este pode ser filtrado através dos atributos passados no corpo da requisição. O serviço retorna uma lista com as Avaliações filtradas pelos parâmetros enviados na requisição. O campo id da Avaliação só será adicionado quando a situação do status da Avaliação for concluido. A presença do campo lote\_id indicará que a Avaliação foi solicitada através de uma requisição de avaliação em lote. Uma Avaliação também pode ser feita avulsa por meio do Portal CERC.

```json
{"openapi":"3.0.3","info":{"title":"API Duplicata Escritural","version":"1.0"},"tags":[{"name":"Validações","description":"Conjunto de serviços que compreende solicitação de Avaliação de um lote de Duplicatas e de suas Partes (Originador e Pagador).   \n\nA Avaliação é o processo por meio do qual o Sistema CERC efetua consultas a Bases de Dados Externas e Internas e por meio de algoritmos \nproprietários gera Indicadores de Consistência e evidências da Situação do Direito Creditório. O conjunto de informações coletadas compreende \nos dados disponibilizados pelo serviço de consulta de notas fiscais eletrônicas das Secretarias de Fazenda Estaduais e pelo serviço de consulta \nde CPF e CNPJ da Receita Federal.  \n\nSobre os dados encontrados nessas fontes, são aplicados algoritmos proprietários para verificar a Situação das Duplicatas e os Indicadores de \nConsistência.Os Indícios de Consistência resultantes das análises dos algoritmos, bem como os dados coletados nas Bases de Dados Externas, \npodem ser consultados através do conjunto de serviços de consulta de dados das Avaliações.\n"}],"servers":[{"url":"https://api.int.cerc.com"},{"url":"https://api.stg.cerc.com"},{"url":"https://api.cerc.com"}],"security":[{"stgAuthServer":["transaction-io-tio-mapper-operations:rw","transaction-io-tio-mapper-operations:v1:rw"],"intAuthServer":["transaction-io-tio-mapper-operations:rw","transaction-io-tio-mapper-operations:v1:rw"],"prdAuthServer":["transaction-io-tio-mapper-operations:rw","transaction-io-tio-mapper-operations:v1:rw"]}],"paths":{"/transaction-io/tio-mapper/v1/operations/validacoes/busca-de-validacoes-duplicata-mercantil":{"post":{"description":"  Serviço para consultar o status de processamento das Avaliações. O resultado é uma lista com resumos das Avaliações consultadas. Este pode ser filtrado através dos atributos passados no corpo da requisição. O serviço retorna uma lista com as Avaliações filtradas pelos parâmetros enviados na requisição. O campo id da Avaliação só será adicionado quando a situação do status da Avaliação for concluido. A presença do campo lote_id indicará que a Avaliação foi solicitada através de uma requisição de avaliação em lote. Uma Avaliação também pode ser feita avulsa por meio do Portal CERC.","summary":"Conjunto de serviços para a consulta de dados do documento fiscal e das partes envolvidas na operação que originou o Direito Creditório.","tags":["Validações"],"parameters":[{"in":"header","name":"authorization","schema":{"type":"string"},"required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"veiculo":{"type":"object","properties":{"id":{"description":"Identificador único do veículo","type":"string"}},"required":["id"],"description":"Objeto contendo informações sobre o veículo"},"lote_ids":{"type":"array","items":{"type":"string"},"description":"Lista de identificadores únicos de lotes associados ao veículo"},"chaves_nfe":{"type":"array","items":{"type":"string"},"description":"Lista de chaves NFE associadas ao veículo"},"referencias_externas":{"type":"array","items":{"type":"string"},"description":"Lista de referências externas associadas ao veículo"},"status_de_processamento":{"type":"string","description":"Status de processamento do veículo"},"paginacao":{"type":"object","properties":{"por_pagina":{"description":"Quantidade de itens por página","type":"integer"},"pagina":{"description":"Número da página","type":"integer"}},"required":["por_pagina","pagina"],"description":"Objeto contendo informações de paginação"}}}}},"required":false},"responses":{"200":{"description":"Em caso de sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"busca_validacao_duplicata_mercantil":{"type":"object","properties":{"veiculo":{"type":"object","properties":{"id":{"type":"string"}}},"lote_ids":{"type":"array","items":{"type":"string"}},"chaves_nfe":{"type":"array","items":{"type":"string"}},"referencias_externas":{"type":"array","items":{"type":"string"}},"status_de_processamento":{"anyOf":[{"type":"string"},{"enum":["pendente","processando","concluido","com_erro"]}]},"paginacao":{"type":"object","properties":{"por_pagina":{"type":"number"},"pagina":{"type":"number"}}}}}}}}}},"400":{"description":"Requisição Inválida"},"401":{"description":"Falha de autenticação"},"422":{"description":"Parâmetros inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidRequestResponse"}}}}}}}},"components":{"schemas":{"InvalidRequestResponse":{"type":"object","properties":{"erros":{"type":"array","items":{"type":"string"}}}}}}}
```

***

### Path Parameters:

<table><thead><tr><th width="179">Campo</th><th width="178">Obrigatório</th><th width="99">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>validacao_id</code></td><td>Obrigatório</td><td>String</td><td>Identificador da Avaliação.</td></tr></tbody></table>

***

### Header Parameters:

<table><thead><tr><th width="278">Campo</th><th width="127">Obrigatório</th><th width="126">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>id</code></td><td>Obrigatório</td><td>String</td><td>Identificador único do veículo.</td></tr><tr><td><code>lote_ids</code></td><td>Opcional</td><td>Array</td><td>Lista de identificadores únicos de lotes associados ao veículo</td></tr><tr><td><code>chaves_nfe</code></td><td>Opcional</td><td>Array</td><td>Lista de chaves NFE associadas ao veículo</td></tr><tr><td><code>referencias_externas</code></td><td>Opcional</td><td>Array</td><td>Lista de referências externas associadas ao veículo.</td></tr><tr><td><code>status_de_processamento</code></td><td>Opcional</td><td>String</td><td>Status de processamento do veículo. Os valores permitidos são "pendente", "processando", "concluido" e "com_erro".</td></tr><tr><td><code>paginacao</code></td><td>Opcional</td><td>Object</td><td>Objeto contendo informações de paginação</td></tr><tr><td><code>paginacao.por_pagina</code></td><td>Obrigatório</td><td>Integer</td><td>Quantidade de itens por página.</td></tr><tr><td>paginacao_pagina</td><td>Obrigatório</td><td>Integer</td><td>Número da página</td></tr></tbody></table>

***
