> For the complete documentation index, see [llms.txt](https://tafi.gitbook.io/tafi-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tafi.gitbook.io/tafi-api/api-rest/revertir-venta-aprobada.md).

# Revertir venta Aprobada

## Revertir Venta Aprobada

Reversa una venta previamente aprobada en el sistema. Al ejecutar este método, el crédito otorgado al cliente se cancela y el pago al comercio no se realiza, dejando la transacción sin efecto para ambas partes.

### Endpoint

<mark style="color:green;">`POST`</mark> `/creditos-ventas/revertirventa`

### Headers

| Nombre         | Tipo   | Requerido | Descripción                                             |
| -------------- | ------ | --------- | ------------------------------------------------------- |
| `TAFI-API-KEY` | string | Sí        | Clave de autenticación de la API proporcionada por TAFI |
| `Content-Type` | string | Sí        | Debe ser `application/json`                             |

### Body Parameters

| Campo                | Tipo          | Requerido | Descripción                                                             |
| -------------------- | ------------- | --------- | ----------------------------------------------------------------------- |
| `idComercio`         | string (UUID) | Sí        | Identificador único del comercio donde se realizó la venta              |
| `numeroAutorizacion` | string        | No        | Número de autorización generado al momento de aprobar la venta original |
| `motivo`             | string        | Sí        | Razón por la cual se está revirtiendo la venta                          |
| `idTransaccion`      | string        | Sí        | Identificador único de la transacción a revertir                        |

### Ejemplo de Request

```bash
curl --location 'https://api.tafitech.io/dev/creditos-ventas/revertirventa' \
--header 'TAFI-API-KEY: {TU_API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
    "idComercio": "{TU_ID_COMERCIO}",
    "numeroAutorizacion": "000000",
    "motivo": "Motivo de la reversión",
    "idTransaccion": "XX-000-0"
}'
```

### Ejemplo de Body

```json
{
    "idComercio": "{TU_ID_COMERCIO}",
    "numeroAutorizacion": "000000",
    "motivo": "Motivo de la reversión",
    "idTransaccion": "XX-000-0"
}
```

### Reglas de Negocio

**Ventana de tiempo:** La reversión solo puede ejecutarse dentro de las **24 horas posteriores** a la fecha y hora en que se realizó la transacción original. Pasado este plazo, la venta no podrá ser revertida por este método. {% endhint %}

Al revertir una venta aprobada ocurre lo siguiente:

* **Cliente:** El crédito otorgado se **cancela**, eliminando la deuda asociada a esa transacción.
* **Comercio:** **No se realiza el pago** correspondiente a la venta revertida.
* **Transacción:** Queda registrada como revertida y no puede volver a procesarse con el mismo `idTransaccion`.

### Respuesta Exitosa

```json
{
    "idTransaccion": "0000011101",
    "codigoRespuesta": 1,
    "numeroAutorizacion": "951611",
    "descripcionError": ""
}
```