rates

Cotizar en todas las paqueterías

Cotiza con todas las paqueterías activas y devuelve tarifas con id (rate_id) listas para POST /shipments. Requiere scope rates:read. Solo rutas domésticas MX (country ≠ MX → 422). Bultos: UN paquete (package) o VARIOS en un mismo envío (packages, 2–10 bultos; mandar ambos → 422). Con packages solo se devuelven ofertas reservables como envío multi-bulto (los servicios que no lo soportan no aparecen) y el peso facturable es la SUMA de los bultos. Códigos postales: deben existir en el catálogo SEPOMEX — un CP inexistente (p. ej. 99999) responde 422 nombrando from.postal_code/to.postal_code ANTES de consultar a las paqueterías (antes se cotizaba por zona a ciegas). Las tarifas de referencia de mostrador (market) NO se incluyen: todo rate_id devuelto es enviable. Seguro: insurance.insured_value (alias obsoleto declared_value) contrata cobertura para el envío: la póliza de la plataforma (prima incluida y firmada dentro de pricing.total_price) o, si esa póliza no está disponible, la cobertura de la propia paquetería — el precio mostrado ya la incluye y cada tarifa lo indica con insurance_included / insurance_not_supported. Insurance: insured_value buys coverage; when the platform policy is unavailable the carrier's own coverage is used and the price shown already includes it. Vista agrupada: ?view=grouped devuelve cada servicio distinto UNA sola vez (paquetería + nivel de servicio) con su rango de precios y sus opciones reservables (ver RatesGroupedResponse); la forma plana por defecto no cambia. La respuesta es la MISMA para toda llave (los costos de proveedor nunca se exponen). Plazo: la cotización responde en un máximo de ~15 s con las tarifas que llegaron a tiempo; si alguna cotización no llegó a tiempo, incomplete es true — las tarifas listadas siguen siendo reservables y una nueva cotización puede mostrar más. Deadline: the quote answers within ~15 s with the rates that arrived; incomplete: true flags that more may exist.

post/rates

Request

Base URL: https://api.enviadores.com.mx/api/v1
URL: https://api.enviadores.com.mx/api/v1/rates
Auth: HTTP bearer

Query parameters

view'grouped'

grouped: colapsa services[] en un elemento por servicio distinto (RatesGroupedResponse, con view: "grouped"). Omitido: la forma plana (RatesResponse).

Headers

X-PDV-IDstring

Solo llaves de cuentas admin: el punto de venta cuyo fondo se carga/consulta. Requiere que la llave tenga una allowlist de PDVs configurada por un administrador (pdv_allowlist); sin allowlist, todo PDV real es denegado por defecto. Validado además contra los PDV activos. Cualquier violación → 403 PDV_NOT_ALLOWED. El valor personal_account equivale a omitir el header.

Request body

from_idstring

Id de un remitente del directorio (GET /senders). Mutuamente excluyente con from.

to_idstring

Id de un destinatario del directorio (GET /recipients). Mutuamente excluyente con to.

Example request

{
  "from": {
    "postal_code": "01000"
  },
  "to": {
    "postal_code": "64000"
  },
  "package": {
    "weight_kg": 1,
    "length_cm": 20,
    "width_cm": 15,
    "height_cm": 10
  }
}

Response

Cotización exitosa (forma autenticada multi-paquetería).

successunknown required

requestIdstring required

Correlación de logs; también en el header X-Request-Id.

Changes

No recorded changes to this operation across all 1 revision of this API.