> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unitedpetroleum.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy Topkat

> Endpoint legacy POST /api/fuel-entries/topkat con X-API-Key

# Legacy: Fuel entries Topkat

<Warning>
  Integración **legacy**. Para proyectos nuevos use `POST /api/v1/fuel/entries` con Bearer. Este endpoint permanece por compatibilidad con Topkat.
</Warning>

```http theme={null}
POST /api/fuel-entries/topkat
```

## Autenticación

```bash theme={null}
X-API-Key: your_api_key_here
```

## Body (resumen)

| Campo           | Requerido | Descripción                                    |
| --------------- | --------- | ---------------------------------------------- |
| `license_plate` | Sí        | Placa para matching de vehículo                |
| `quantity`      | Sí        | Galones                                        |
| `ppv`           | Sí        | Precio por galón                               |
| `id`            | Sí        | ID externo de transacción Topkat               |
| `timestamp`     | Sí        | ISO 8601 con zona (ej. `-04:00` Santo Domingo) |
| `stn_id`        | No        | UUID proveedor                                 |
| `product_name`  | No        | Default `Diesel`                               |
| `odometer`      | No        | Odómetro                                       |
| `driver_name`   | No        | Default `Desconocido`                          |

El servidor hace matching inteligente de vehículo y producto contra su organización.