genei
Integración por API · Marketplace

Envíos de Etsy con la API de Genei

Puedes conectar tus pedidos de Etsy con Genei a través de la API de Genei. Tu sistema 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 informarlo en Etsy y que tu comprador lo tenga.

Actualizado: octubre de 2026

Del pedido en Etsy 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 Etsy

    Tu comprador 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 sistema 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 sistema crea el envío con la API y guarda el número de pedido de Etsy 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 Etsy.

  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 Etsy

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

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

Paso 2

Tu sistema consulta los transportistas

Con los datos del pedido, tu sistema 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
GLS
Correos Express

Paso 3

Crea el envío en Genei

Tu sistema crea el envío con la API y guarda el número de pedido de Etsy 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 Etsy.

"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 Etsy por la API

Etsy 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 Etsy, crea los envíos en Genei y recibe el seguimiento por webhook para informarlo en Etsy. Lo que conecta Etsy 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 Etsy.

  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 Etsy 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 Etsy

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

¿Qué necesitas para conectar Etsy 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 Etsy.

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 Etsy con la API de Genei

    • Sin teclear envíos. Tu sistema crea cada envío con los datos del pedido de Etsy.
    • Seguimiento al momento. El número y el enlace de seguimiento te llegan por webhook, listos para informarlos en Etsy.
    • 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.

    Vender en Etsy y enviar tú

    Cuando vendes en Etsy y envías tú, el marketplace pone el escaparate y los compradores, pero la preparación y el envío de cada pedido son cosa tuya. Con la API de Genei, tu sistema crea el envío de cada pedido y recibe el seguimiento para informarlo en Etsy.

    Si buscas cómo enviar en Etsy desde España, ten en cuenta que una parte de tus compradores puede estar en otros países. Al crear cada envío por la API ves los servicios de cada transportista para el país de destino y eliges el que mejor encaja con el pedido.

    Plazos de envío y seguimiento

    Los marketplaces piden a sus vendedores que envíen los pedidos dentro de un plazo y que informen del seguimiento. Consulta en tu cuenta de vendedor los plazos que te aplican. Con el seguimiento llegando por webhook en cuanto el envío se tramita, puedes informarlo sin esperas.

    Devoluciones

    Con Genei Returns gestionas la logística de las devoluciones desde el mismo panel: portal de devoluciones, reglas y devoluciones internacionales.

    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 Etsy), 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 Etsy

    Envía tus pedidos de Etsy con Correos, GLS, UPS o DHL, también fuera de España: al comparar ves los servicios disponibles para el país de cada comprador.

    Lo que conecta Etsy con cada transportista es Genei: no hay una integración directa entre Etsy 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 Etsy 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 Etsy con Genei

    ¿Cómo conecto Etsy 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 Etsy, descargas las etiquetas y recibes el seguimiento.

    ¿Cómo hacer envíos en Etsy desde España?

    Con la API de Genei, tu sistema crea el envío de cada pedido de Etsy, comparas más de 25 transportistas nacionales e internacionales, descargas la etiqueta y recibes el número de seguimiento por webhook para informarlo en Etsy. Al consultar los servicios ves los disponibles para el país de cada comprador.

    ¿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 Etsy, con la API de Genei y quien informa el seguimiento en Etsy.

    ¿Cómo recibe mi comprador 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 Etsy para que tu comprador 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 Etsy con Genei.

    Volver al inicio
    Volver al inicio