---
title: 8.3. Desabilitar Antecipação Automática
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/8.%20Antecipa%C3%A7%C3%A3o%20autom%C3%A1tica%20de%20cart%C3%A3o/8.3.%20Desabilitar%20Antecipa%C3%A7%C3%A3o%20Autom%C3%A1tica/
---
Desliga o ciclo de antecipação automática de um cedente em uma operação.

!!! info "Desabilitar não apaga nada"
    O cedente, o vínculo com a operação, a taxa e os valores configurados **permanecem**. Também permanece a configuração de pesquisa automática comum, se houver. O que para é apenas a geração automática de contratos: nenhum ciclo novo será executado para esse par cedente × operação.

!!! tip "Contratos já gerados seguem seu curso"
    Desabilitar não cancela contratos existentes, nem interrompe a atualização diária das URs já contratadas. Para cancelar um contrato, use [Cancelar contrato](../../VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/5.%20Contrato%20de%20receb%C3%ADveis/v1.1/5.9.%20Cancelar%20contrato.md).

---

## Desabilitar Antecipação Automática

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

### Path Params

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

### Request Body

| Campo        | Tipo   | Obrigatório | Descrição                               |
| ------------ | ------ | ----------- | --------------------------------------- |
| `idOperacao` | Número | Sim         | Operação em que o ciclo será desligado. |

```json title="Request Body"
{
  "idOperacao": 1
}
```

```json title="Response Body — 200 OK"
{
  "idEmpresa": 4821,
  "idOperacao": 1,
  "habilitada": false,
  "desabilitadaEm": "2026-09-22T12:03:11Z"
}
```

### Detalhamento da resposta

| Campo            | Tipo     | Descrição                                                          |
| ---------------- | -------- | ------------------------------------------------------------------ |
| `idEmpresa`      | Número   | Identificador da empresa cedente.                                  |
| `idOperacao`     | Número   | Operação afetada.                                                  |
| `habilitada`     | Booleano | Sempre `false` após a operação.                                    |
| `desabilitadaEm` | Texto    | Data e hora UTC em que o ciclo foi desligado, no formato ISO 8601. |

!!! info "É idempotente"
    Desabilitar um ciclo que já estava desabilitado retorna `200` normalmente, com `habilitada: false`. A chamada pode ser repetida sem efeito colateral.

### Erros

| Status | Quando acontece                                                   |
| ------ | ----------------------------------------------------------------- |
| `400`  | `idOperacao` ausente ou inválido.                                 |
| `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 ou operação não encontrados, ou sem vínculo entre eles.   |