# Endpoint de Tarifas Externo

## 1. Pedido

**Método HTTP**: `GET`
**URL del endpoint**: `https://fmsapi.deltax.la/ratesFree/api/ratesFree`

### 1.1 Autenticación

**Tipo:** Bearer token (`Authorization` header)
**Ejemplo:** `Bearer <token>` (en header `Authorization`)

### 1.2 Parámetros (query params)

- **Tipo de tarifario**: `type` (opciones)
- obligatorio
- Opciones:
- `domestic` (Doméstico)
- `modern` (Moderno)
- `ctme` (Circuitos)
- `ce01` (Circuito CE01)
- **Número de página**: `page` (int como string)
- opcional, default: 0
- **Tamaño de página**: `size` (int como string)
- opcional, default: 7500
- valor máximo: 7500

Ejemplo de URL con parámetros:

https://fmsapi.deltax.la/ratesFree/api/ratesFree/?type=domestic&page=0&size=7500

## 2. Respuesta

### 2.1: Respuesta exitosa

**HTTP status**: 200

Ejemplo:

{
    "message": "Rutas recuperadas exitosamente.",
    "page": 0,
    "size": 7500,
    "totalPage": 8,
    "totalDocs": 56541,
    "rates": [
        {
            "CODE": "443875O410143895",
            "OVAL": 0,
            "GVAL": "Gris",
            "OPTY": "Autoservicios R",
            "RSAP": "443875",
            "ONAM": "Cmr Soriana Mex",
            "OSAP": "3892001549",
            "OI2": "3892001549",
            "OZON": "Tultitlán, Estado de México",
            "DNAM": "VALDER MX",
            "DSAP": "BX14",
            "DI2": "3330910000",
            "DZON": "Tepotzotlán, Estado de México",
            "EXPC": "O4",
            "EXDE": "OW Sencillo Caja Seca",
            "CONF": "Sencillo",
            "FORM": "Regreso",
            "TRCO": "10143895",
            "TRNA": "53 CARGO",
            "VAR": 7120,
            "TOT": 7120,
            "TYPE": "Spot OW 2025",
            "NEGD": "2025-09-09",
            "STD": "2025-01-01",
            "END": "2025-12-31",
            "STAT": "Activa",
            "NEGU": "Javier",
            "GMIN": 7120,
            "MIN": 4000,
            "DIS": 0.78,
            "PE": "Negro",
            "CLPR": 0,
            "CLBE": "Negro",
            "UPD": "2025-10-09",
            "ACST": "active"
        },
        ...
    ]
}

- `page`: Página actual
- `size`: Tamaño de página actual
- `totalPage`: Número total de páginas
- `totalDocs`: Número total de tarifas
- `rates`: Documentos de tarifas

### 2.2: Mapeo de campo

- `CODE`: ID de tarifa
- `OVAL`: Validación de origen
- `GVAL`: Validación gris
- `OPTY`: Tipo de operación
- `RSAP`: ID de ruta
- `ONAM`: Origen
- `OSAP`: SAP Origen
- `OI2`: I2 origen
- `OZON`: Zona origen
- `DNAM`: Destino
- `DSAP`: SAP destino
- `DI2`: I2 destino
- `DZON`: Zona destino
- `EXPC`: Clase de expedición
- `EXDE`: Descripción Cl. Exp.
- `CONF`: Tipo de configuración
- `FORM`: Formato de viaje
- `TRCO`: ID transportista
- `TRNA`: Empresa de transporte
- `VAR`: Tarifa variable
- `FIX`: Fijo ponderado
- `TOT`: Total tarifa
- `TAT`: TAT (días)
- `TYPE`: Tipo de tarifa
- `NEGD`: Fecha de negociación
- `STD`: Inicio de vigencia
- `END`: Expiración
- `STAT`: Estado
- `NEGU`: Usuario negociación
- `GMIN`: Tarifa mínima (gris)
- `MIN`: Tarifa mínima
- `DIS`: Dispersión
- `PE`: Clasificación performance
- `BL`: Base line
- `DIBL`: Dispersión vs Base Line
- `CLPR`: Clasificación price
- `CLBE`: Clasificación BECA
- `UPD`: Fecha de actualización
- `UPUN`: Usuario de actualización
- `ACST`: Vigencia
- `active`: Vigente
- `inactive`: Expirada

### 2.3 Errores:

- Status 403: No autorizado.