> 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/conceptos-clave.md).

# Conceptos clave

Las piezas y los términos que hay que conocer antes de integrar un transporte con Zipnova.

Antes de integrar, conviene tener claro con qué piezas se trabaja y quién llama a quién.

## Las piezas

| Concepto                              | Qué es                                                                                                                                                                                    |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Organization**                      | La cuenta de tu empresa de transporte en Zipnova. Tiene que estar habilitada por Zipnova para crear Carriers.                                                                             |
| **Carrier Hub**                       | El panel donde tu Organization crea y administra sus Carriers.                                                                                                                            |
| **Carrier**                           | Un transporte que opera en Zipnova Envíos. Una Organization puede tener varios, y cada uno tiene sus propias credenciales, tarifarios, integración y configuración.                       |
| **Seller**                            | La cuenta de Zipnova que despacha envíos y contrata transporte.                                                                                                                           |
| **Tarifario**                         | Las reglas de precio y los límites con los que un Carrier cotiza un tipo de servicio. Puede cotizar con una tabla de zonas o con un callback a tu API.                                    |
| **Tipo de servicio** (`service_type`) | `standard_delivery`, `meli_flex`, `meli_turbo` o `express_delivery`. Se define al crear el tarifario y no se puede cambiar. El retiro en punto (`pickup_point`) todavía no es compatible. |
| **Tipo logístico** (`logistic_type`)  | La modalidad logística del envío, por ejemplo `gateway_pickup`. Cada Carrier tiene habilitados algunos: se consultan en `allowed_logistic_types` de `GET /me`.                            |
| **Integración**                       | `custom` (tu propia API) o `zipnova_routes` (opera con Zipnova Rutas).                                                                                                                    |
| **Visibilidad y modalidad de acceso** | Definen qué cuentas pueden usar tu Carrier.                                                                                                                                               |
| **Certificación**                     | La homologación de Zipnova. Se consulta en `certification_status`: `pending`, `certified` o `rejected`.                                                                                   |

Cada concepto tiene su detalle en [Visibilidad y modalidades de acceso](/carriers/visibilidad-y-modalidades-de-acceso.md), [Cómo se cotiza](/carriers/como-se-cotiza.md) e [Integración con Zipnova Rutas](/carriers/integracion-con-zipnova-rutas.md).

## Quién llama a quién

En una integración `custom`, la comunicación va en las dos direcciones.

**Zipnova llama a tu Carrier.** Son los endpoints que tienes que implementar, y todos van [firmados](/carriers/endpoints/validar-la-firma-de-zipnova.md):

* [Cotización](/carriers/endpoints/cotizacion.md): solo si cotizas por API.
* [Notificaciones de envíos](/carriers/endpoints/notificaciones-de-envios.md): `new`, `ready_to_ship`, `cancelled` y `expired`.

**Tu Carrier llama a Zipnova.** Es la API del Carrier, autenticada con tu API key:

* [Autenticación](/carriers/referencia-api/autenticacion.md): `GET /me`.
* [Tarifarios](/carriers/referencia-api/tarifarios.md): crearlos, editarlos y publicar sus zonas.
* [Envíos](/carriers/referencia-api/envios.md): listarlos, consultar el detalle, subir la etiqueta e informar tracking y estados.