genei
Integración por API · Tienda online

Envíos de Magento con la API de Genei

Puedes conectar tu tienda Magento con Genei a través de la API de Genei. Tu tienda crea los envíos con los datos de cada pedido, eliges entre más de 25 transportistas y descargas las etiquetas. El número de seguimiento te llega por webhook, listo para guardarlo en el pedido y que tu cliente lo tenga.

Actualizado: octubre de 2026

Del pedido en Magento al paquete en camino, por la API

Avanza paso a paso o pulsa reproducir para ver qué hace tu sistema con un pedido de ejemplo.

  1. 1. Llega un pedido a Magento

    Tu cliente compra como siempre. El pedido tiene todos los datos que necesita el envío.

  2. 2. Tu sistema consulta los transportistas

    Con los datos del pedido, tu tienda pide a la API de Genei los transportistas y servicios disponibles para ese envío y elige uno.

  3. 3. Crea el envío en Genei

    Tu tienda crea el envío con la API y guarda el número de pedido de Magento en externalShippingCode para relacionarlos.

  4. 4. Confirmas y descargas la etiqueta

    Al confirmar el envío con paymentUrl, Genei lo notifica al transportista. Después descargas la etiqueta en PDF.

  5. 5. Recibes el seguimiento por webhook

    Genei avisa a tu sistema cuando el envío se tramita, con el número de seguimiento y el enlace de seguimiento, y tú lo informas en Magento.

  6. 6. El paquete va en camino

    Cada cambio de estado llega por webhook, y al entregarse recibes también el justificante de entrega si está disponible.

Paso 1

Llega un pedido a Magento

Tu cliente compra como siempre. El pedido tiene todos los datos que necesita el envío.

MagentoNuevo
PedidoORDER-1042
ClienteAna Ejemplo
DirecciónCalle Ejemplo 1, 28001 Madrid

Paso 2

Tu sistema consulta los transportistas

Con los datos del pedido, tu tienda pide a la API de Genei los transportistas y servicios disponibles para ese envío y elige uno.

API de Genei · Servicios para ORDER-1042
Correos
Correos Express
GLS

Paso 3

Crea el envío en Genei

Tu tienda crea el envío con la API y guarda el número de pedido de Magento en externalShippingCode para relacionarlos.

POST /api/v2/shipments
{
  "externalShippingCode": "ORDER-1042",
  "agencyId": 106,
  "notificationUrl": "https://tu-sistema.example/webhooks/genei",
  …
}

Paso 4

Confirmas y descargas la etiqueta

Al confirmar el envío con paymentUrl, Genei lo notifica al transportista. Después descargas la etiqueta en PDF.

Destinatario
Ana Ejemplo
Calle Ejemplo 1
28001 Madrid
Ref.
ORDER-1042

Paso 5

Recibes el seguimiento por webhook

Genei avisa a tu sistema cuando el envío se tramita, con el número de seguimiento y el enlace de seguimiento, y tú lo informas en Magento.

"message": "Shipment processed"
"codigo_envio_externo": "ORDER-1042"
"codigo_seguimiento": "PKAEX0000…"
"trackingUrl": "https://www.genei.es/seguimiento/…"

Paso 6

El paquete va en camino

Cada cambio de estado llega por webhook, y al entregarse recibes también el justificante de entrega si está disponible.

ORDER-1042En reparto

El enlace abre el flujo en el paso que estás viendo: útil para explicárselo a tu equipo por email. Los datos del ejemplo son ficticios.

Cómo funciona la integración de Magento por la API

Magento no se conecta desde el panel de Genei: la conexión la hace tu sistema con la API de Genei. Tu sistema lee los pedidos de Magento, crea los envíos en Genei y recibe el seguimiento por webhook para informarlo en Magento. Lo que conecta Magento con cada transportista es Genei.

  1. Crea tu cuenta y entra en la API

    Regístrate en Genei y abre la documentación de la API en tu área de cliente, en Mi cuenta → Perfil → API.

  2. Conecta tu sistema

    Tu desarrollador obtiene el token de acceso con POST /api/v2/login y conecta tu sistema, que es el que lee los pedidos de Magento.

  3. Crea el envío de cada pedido

    Consulta los transportistas disponibles, elige el servicio y crea el envío con el número de pedido de Magento en externalShippingCode.

  4. Confirma y descarga la etiqueta

    Confirma el envío con paymentUrl para que Genei lo notifique al transportista, y descarga la etiqueta en PDF.

  5. Informa el seguimiento en Magento

    Recibe el número y el enlace de seguimiento por webhook en tu notificationUrl e infórmalos en Magento.

¿Qué necesitas para conectar Magento con la API?

Marca lo que ya tienes y manda el enlace a tu desarrollador: así sabe por dónde empezar.

Tu preparación

0 de 6

Marca los puntos que ya tienes resueltos.

Regístrate y accede a la API

El enlace guarda lo que has marcado. No se envía a ningún sitio.

Los estados del envío que recibes por webhook

Elige un recorrido de ejemplo y pulsa cada estado: verás qué significa, qué aviso manda Genei a tu notificationUrl y qué puedes hacer en Magento.

Estados frecuentes de un envío en la API de Genei
EstadoSignificadoWebhook
7Pendiente de pagoSin webhook
6Pendiente de tramitarSin webhook
1TramitadoShipment processed
5Recogida efectuada / en tránsitoShipment tracking data updated
80En repartoShipment tracking data updated
85Disponible en oficinaShipment tracking data updated
3EntregadoShipment tracking data updated
9Recogida fallidaShipment tracking data updated
10En tránsito con incidenciaShipment tracking data updated
14DevueltoShipment tracking data updated

    Estado

    —

    
          

    Los recorridos son ejemplos y los datos son ficticios. Los estados reales de cada envío te llegan en historico_estados.

    ¿Cuánto tiempo ahorras?

    Pon tus datos: cuántos envíos haces al día y cuánto tardas en crear cada envío a mano. Con la API, tu sistema crea los envíos con los datos de cada pedido: ese tecleo desaparece y solo te queda revisar.

    Mide cuánto tardas hoy en copiar los datos de un pedido y crear el envío. Los ejemplos son orientativos: cámbialos por tus cifras.

    Tu resultado

    Rellena los tres primeros datos o pulsa un ejemplo para ver cuánto tiempo recuperas al mes.

    Son tus datos: el cálculo se hace en tu navegador y no se envía a ningún sitio. El enlace guarda las cifras para que puedas mandarlo por email.

    Ventajas de enviar los pedidos de Magento con la API de Genei

    • Sin teclear envíos. Tu sistema crea cada envío con los datos del pedido de Magento.
    • Seguimiento al momento. El número y el enlace de seguimiento te llegan por webhook, listos para informarlos en Magento.
    • Estados en tiempo real. Cada cambio de estado llega a tu sistema, y al entregarse, el justificante de entrega si está disponible.
    • Más de 25 transportistas. Una sola API para consultar y contratar servicios de todos ellos.
    • Pruebas sin riesgo. Hasta que confirmas un envío, no se notifica al transportista.
    • Ahorra hasta un 70 %. Envía con las condiciones negociadas por Genei, sin contrato con cada transportista.

    Tu tienda Magento y tus envíos

    Con la API, los envíos se crean desde tu propia tienda: tu equipo decide en qué momento se crea cada envío, qué transportista se elige y dónde se guarda el número de seguimiento.

    Magento es una plataforma muy personalizable y muchas tiendas tienen su propio equipo de desarrollo. Con la API, ese equipo lleva a la tienda las funciones de Genei: crear envíos, elegir transportista, descargar etiquetas y recibir el seguimiento.

    ¿Tienes Shopify, WooCommerce, PrestaShop o Jumpseller?

    Esas tiendas se conectan desde el panel de Genei, sin desarrollo: mira las integraciones de Genei.

    Para tu desarrollador: la API de Genei en cinco pasos

    La API v2 de Genei usa JSON en UTF-8 y autenticación con token Bearer, sobre https://apiv2.genei.es. La documentación interactiva, con todos los endpoints, parámetros y respuestas, está en tu área de cliente, en Mi cuenta → Perfil → API, y se abre con tu sesión de Genei.

    1. 1. Autenticación

      Obtén el token y envíalo en la cabecera Authorization: Bearer.

      POST /api/v2/login
    2. 2. Transportistas y servicios

      Consulta los servicios disponibles para el envío y guarda el agencyId del elegido.

      GET /api/v2/agencies/prices
    3. 3. Crear el envío

      Con externalShippingCode (tu pedido de Magento), notificationUrl, origen, destino y bultos. Devuelve la referencia y paymentUrl.

      POST /api/v2/shipments
    4. 4. Confirmar

      Llama a paymentUrl y espera un HTTP 200: a partir de ahí se notifica al transportista.

      GET {paymentUrl}
    5. 5. Etiqueta y seguimiento

      Descarga la etiqueta, consulta el envío o el justificante de entrega, o cancélalo.

      GET  /api/v2/shipments/{código}/label?forceBase64=true&format=PDF
      GET  /api/v2/shipments/{código}
      GET  /api/v2/shipments/{código}/pod
      POST /api/v2/shipments/cancel

    Los webhooks llegan por POST a tu notificationUrl con dos eventos: Shipment processed, cuando el envío se tramita, y Shipment tracking data updated, cuando cambia el seguimiento. Si configuras un token para los webhooks de tu cuenta, Genei lo envía en la cabecera Authorization. Tu endpoint debe responder con un código HTTP 2xx.

    Integraciones y API de Genei

    Todo lo que puedes hacer con la API, en su propia página.

    Ver la API de Genei
    Transportistas

    Transportistas disponibles para tus pedidos de Magento

    Envía los pedidos de tu tienda Magento con Correos, Correos Express, GLS o SEUR desde la misma cuenta de Genei. No conectas cada transportista a tu tienda: los conecta Genei.

    Lo que conecta Magento con cada transportista es Genei: no hay una integración directa entre Magento y el transportista.

    ¿Ya tienes contrato con tu transportista?

    Si ya trabajas con un transportista con tu propio contrato, puedes conectarlo a Genei con Genei SaaS. Así creas los envíos por la API y generas las etiquetas con tu contrato, gestionándolo todo desde Genei aunque el envío lo contrates directamente con tu transportista. Ganas agilidad sin cambiar de proveedor.

    Transportistas que puedes conectar con contrato propio:

    • Celeritas
    • GLS
    • DHL
    • Correos Express
    • UPS
    • FedEx
    • Correos
    • CTT
    • SEUR
    • TDN

    Hay más transportistas pendientes de confirmar. El contrato propio se conecta en tu área de cliente, en Integraciones → Agencias de transporte.

    Genei SaaS: tus contratos, en el panel de Genei

    Conecta tus cuentas de transportista y gestiona tus envíos y los de tus integraciones en un mismo sitio.

    Conoce Genei SaaS

    Conecta tus pedidos de Magento con la API de Genei

    Crea tu cuenta, abre la documentación de la API y conecta tu sistema para enviar cada pedido con más de 25 transportistas.

    Regístrate y accede a la API

    Crea tu cuenta gratis. La documentación está en Mi cuenta → Perfil → API

    +25 transportistasAhorra hasta un 70 %Seguimiento por webhook
    Preguntas frecuentes

    Preguntas frecuentes sobre enviar los pedidos de Magento con Genei

    ¿Cómo conecto Magento con Genei?

    A través de la API de Genei. Crea tu cuenta gratis, abre la documentación en Mi cuenta → Perfil → API y conecta tu sistema: con la API creas los envíos de tus pedidos de Magento, descargas las etiquetas y recibes el seguimiento.

    ¿Necesito un desarrollador?

    Sí. La conexión vía API la hace un desarrollador o un integrador: es quien conecta tu sistema, que lee los pedidos de Magento, con la API de Genei y quien informa el seguimiento en Magento.

    ¿Cómo recibe mi cliente el número de seguimiento?

    Cuando el envío se tramita, Genei avisa a la notificationUrl que indicaste al crearlo con el número de seguimiento, el enlace de seguimiento y tu número de pedido. Tu sistema lo informa en Magento para que tu cliente lo tenga.

    ¿Puedo hacer pruebas antes de enviar?

    Sí. Un envío creado por la API no se notifica al transportista hasta que lo confirmas llamando a paymentUrl, así que los envíos sin confirmar sirven para probar la integración.

    ¿Puedo usar mi propio contrato con un transportista?

    Sí. Con Genei SaaS conectas tu contrato con Celeritas, GLS, DHL, Correos Express, UPS, FedEx, Correos, CTT, SEUR o TDN y generas las etiquetas con él, sin dejar de gestionarlo todo desde Genei.

    ¿Puedo enviar fuera de España?

    Sí. Genei trabaja con transportistas nacionales e internacionales: al consultar los servicios verás los disponibles para el país de destino de cada envío. Para envíos fuera de la UE prepara la información de contenido y aduanas.

    Otras integraciones

    Todas conectan con tu cuenta de Genei y con los mismos transportistas. Ver todas las integraciones.

    Actualizado: octubre de 2026

    Pregúntale a la IA sobre Genei

    Consulta a tu asistente favorito cómo conectar Magento con Genei.

    Volver al inicio
    Volver al inicio