> For the complete documentation index, see [llms.txt](https://docs.zipnova.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zipnova.com/carriers/integracion-con-zipnova-rutas.md).

# Integración con Zipnova Rutas

Cómo operar tu Carrier con Zipnova Rutas, sin desarrollar una integración propia.

Si tu transporte ya opera con Zipnova Rutas, puedes usarlo como integración plug & play: eliges `zipnova_routes` para el Carrier y no necesitas desarrollar una integración externa.

## Qué cambia respecto de una integración custom

|                    | Integración `custom`                              | Integración `zipnova_routes`                                |
| ------------------ | ------------------------------------------------- | ----------------------------------------------------------- |
| Cotización         | Tarifario fijo o callback a tu API                | Solo tarifario fijo (`rate_source: table`)                  |
| Creación del envío | Zipnova avisa a tu URL de notificaciones          | Se crea de forma sincrónica en Rutas                        |
| Etiqueta           | La subes tú con `POST /shipments/{id}/documents`  | La genera Zipnova: subirla responde `409`                   |
| Tracking           | Lo informas tú con `PUT /shipments/{id}/tracking` | Lo administra Rutas: informarlo responde `409`              |
| Estados            | Los informas tú con `POST /shipments/{id}/status` | Siguen el flujo existente de Rutas, sin integración externa |

## Configurar los tarifarios

Los tarifarios de un Carrier con Zipnova Rutas cotizan con zonas publicadas. Al crearlos, `settings` es obligatorio y debe incluir `service_type_code`: el código del tipo de servicio de tu organización en Rutas que corresponde a ese tarifario.

```json
{
  "name": "Estándar AMBA",
  "service_type": "standard_delivery",
  "logistic_types": ["gateway_pickup"],
  "rate_source": "table",
  "settings": { "service_type_code": "estandar" }
}
```

El resto del proceso (publicar zonas y activar el tarifario) es el mismo que se describe en [Cómo se cotiza](/carriers/como-se-cotiza.md).