Paqueterías y servicios

Consulta el catálogo de servicios y usa códigos exactos al elegir una cotización.

El catálogo contiene los servicios que SendIt puede mostrar en las cotizaciones. Es de solo lectura: consúltalo para poblar selectores y validar una combinación de paquetería y servicio.

Paqueterías Beta

Paquetería	`carrierCode`	Estado
DHL Express	`DHL`	Beta
FedEx	`FEDEX`	Beta
Estafeta	`ESTAFETA`	Beta
Sendex	`SENDEX`	Beta
AM PM	`AMPM`	Beta
Otra	`OTHER`	Beta

La lista efectiva para una ruta es la que devuelve rates[] al cotizar un envío.

Endpoints

Método	Ruta	Alcance	Descripción
`GET`	`/v1/carrier-services`	`carrier_services:read`	Listar servicios habilitados; acepta `carrierCode`
`GET`	`/v1/carrier-services/:carrierCode/:serviceCode`	`carrier_services:read`	Consultar un servicio exacto

Lista los servicios

curl "https://api.sendit.mx/v1/carrier-services?carrierCode=FEDEX" \
  -H "X-API-Key: sk_test_..."

{
  "success": true,
  "data": [
    {
      "id": "cs_fedex_priority_overnight",
      "carrierCode": "FEDEX",
      "serviceCode": "PRIORITY_OVERNIGHT",
      "serviceName": "FedEx Priority Overnight",
      "serviceLevel": "overnight",
      "isInternational": false,
      "maxWeightKg": "68.00",
      "maxDimensionCm": "274.00",
      "minDays": 1,
      "maxDays": 1,
      "enabled": true,
      "countries": ["MX"]
    }
  ]
}

Consulta un servicio exacto

curl https://api.sendit.mx/v1/carrier-services/FEDEX/PRIORITY_OVERNIGHT \
  -H "X-API-Key: sk_test_..."

La respuesta contiene el mismo objeto de servicio que aparece en el listado.

Elige por código exacto

Cada cotización trae dos campos distintos:

Campo	Uso
`serviceCode`	Identificador exacto y nativo de la paquetería. Úsalo para elegir el servicio de una compra en una sola llamada.
`serviceLevel`	Categoría amplia y normalizada para filtrar o presentar opciones. No identifica un producto exacto.

Envía carrierCode + serviceCode para elegir un servicio exacto al crear y comprar un envío. Si compras una cotización existente con el endpoint de guías, envía su rateId. Los códigos que todavía no están en el catálogo no aparecen en las cotizaciones.

Errores

Código	Cuándo ocurre	Cómo resolverlo
`403 INSUFFICIENT_SCOPE`	La llave no tiene `carrier_services:read`	Emite una llave con ese alcance
`404 RESOURCE_NOT_FOUND`	La combinación de paquetería y código no existe	Consulta el listado y usa un `serviceCode` vigente