---
title: 8.4. Consultar Configuração Vigente
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/8.%20Antecipa%C3%A7%C3%A3o%20autom%C3%A1tica%20de%20cart%C3%A3o/8.4.%20Consultar%20Configura%C3%A7%C3%A3o%20Vigente/
---
Retorna a configuração de antecipação automática de um cedente, por operação, junto com o resultado do último ciclo executado.

Use este endpoint para conferir o que está valendo antes de alterar qualquer coisa, e para descobrir rapidamente se o ciclo do dia rodou e o que ele produziu.

---

## Consultar Configuração Vigente

| Método                                        | URL                                                                         |
| --------------------------------------------- | --------------------------------------------------------------------------- |
| ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/antecipacao-automatica` |

### Path Params

| Campo       | Tipo   | Descrição                         |
| ----------- | ------ | --------------------------------- |
| `idEmpresa` | Número | Identificador da empresa cedente. |

### Query Params

| Campo        | Tipo   | Obrigatório | Descrição                                                                    |
| ------------ | ------ | ----------- | ---------------------------------------------------------------------------- |
| `idOperacao` | Número | Não         | Filtra uma operação. Omitido, retorna todas as operações vinculadas ao cedente. |

```json title="Response Body — 200 OK"
{
  "idEmpresa": 4821,
  "documento": "12345678000199",
  "operacoes": [
    {
      "idOperacao": 1,
      "habilitada": true,
      "taxa": 1.9900,
      "valorMinimo": 500.00,
      "valorMaximo": 250000.00,
      "arranjos": ["MCC", "VCC"],
      "credenciadoras": [
        { "id": 12, "nome": "CREDENCIADORA EXEMPLO", "cnpj": "10293847560102" }
      ],
      "horarioCiclo": "09:00",
      "ultimaExecucao": {
        "data": "2026-09-22T12:01:44Z",
        "origemAgenda": 1,
        "status": 2,
        "valorContratado": 18422.15,
        "motivoNaoContratacao": null
      }
    }
  ]
}
```

### Detalhamento dos Campos

#### 🔹 operacoes

| Campo            | Tipo     | Descrição                                                                                                       |
| ---------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
| `idOperacao`     | Número   | Identificador da operação.                                                                                      |
| `habilitada`     | Booleano | Indica se o ciclo automático está ativo para este par cedente × operação.                                       |
| `taxa`           | Decimal  | Deságio do vínculo. `null` quando ainda não foi definida — nesse caso o cedente não é elegível ao ciclo.         |
| `valorMinimo`    | Decimal  | Piso por ciclo configurado no vínculo. `null` significa sem piso.                                               |
| `valorMaximo`    | Decimal  | Teto por ciclo configurado no vínculo. `null` significa sem teto.                                               |
| `arranjos`       | Lista    | Siglas dos arranjos considerados. Lista vazia significa todos.                                                  |
| `credenciadoras` | Lista    | Credenciadoras consideradas, com `id`, `nome` e `cnpj`. Lista vazia significa todas as habilitadas na operação. |
| `horarioCiclo`   | Texto    | Horário em que o ciclo roda, no formato `HH:mm`. Definido na operação, não editável por esta API.                |
| `ultimaExecucao` | Objeto   | Resultado do último ciclo. `null` quando nenhum ciclo rodou ainda.                                              |

#### 🔹 ultimaExecucao

| Campo                  | Tipo    | Descrição                                                                                     |
| ---------------------- | ------- | --------------------------------------------------------------------------------------------- |
| `data`                 | Texto   | Data e hora UTC do ciclo, no formato ISO 8601.                                                 |
| `origemAgenda`         | Número  | De onde veio a agenda usada. Ver [8.8. Status e Enumerações](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md). |
| `status`               | Número  | Desfecho do ciclo. Ver [8.8. Status e Enumerações](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).           |
| `valorContratado`      | Decimal | Valor efetivamente contratado. `null` quando o ciclo não gerou contrato.                       |
| `motivoNaoContratacao` | Número  | Por que não houve contrato. `null` quando houve. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).    |

!!! tip "Para o histórico completo, não só o último ciclo"
    `ultimaExecucao` mostra apenas o ciclo mais recente. O histórico paginado, com filtros por data e status, está em [8.7. Consultar Execuções do Ciclo](8.7.%20Consultar%20Execu%C3%A7%C3%B5es%20do%20Ciclo.md).

### Erros

| Status | Quando acontece                                                   |
| ------ | ----------------------------------------------------------------- |
| `401`  | Token ausente, expirado ou sem permissão de acesso à API pública. |
| `403`  | Grupo econômico não habilitado para antecipação automática.       |
| `404`  | Cedente não encontrado, ou operação informada sem vínculo com ele. |