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. Llega un pedido a Etsy
Tu comprador compra como siempre. El pedido tiene todos los datos que necesita el envío.
- 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. 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
externalShippingCodepara relacionarlos. - 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. 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. 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.
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.
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.
Ana Ejemplo
Calle Ejemplo 1
28001 MadridRef.
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.
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.
- 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.
- Conecta tu sistema
Tu desarrollador obtiene el token de acceso con
POST /api/v2/loginy conecta tu sistema, que es el que lee los pedidos de Etsy. - 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. - Confirma y descarga la etiqueta
Confirma el envío con
paymentUrlpara que Genei lo notifique al transportista, y descarga la etiqueta en PDF. - Informa el seguimiento en Etsy
Recibe el número y el enlace de seguimiento por webhook en tu
notificationUrle 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.
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.
| Estado | Significado | Webhook |
|---|---|---|
7 | Pendiente de pago | Sin webhook |
6 | Pendiente de tramitar | Sin webhook |
1 | Tramitado | Shipment processed |
5 | Recogida efectuada / en tránsito | Shipment tracking data updated |
80 | En reparto | Shipment tracking data updated |
85 | Disponible en oficina | Shipment tracking data updated |
3 | Entregado | Shipment tracking data updated |
9 | Recogida fallida | Shipment tracking data updated |
10 | En tránsito con incidencia | Shipment tracking data updated |
14 | Devuelto | Shipment 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.
Tiempo que recuperas al mes
—
- Hoy, a mano
- —
- Revisando borradores
- —
- Envíos al mes
- —
- Recuperas al año
- —
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. Autenticación
Obtén el token y envíalo en la cabecera
Authorization: Bearer.POST /api/v2/login
- 2. Transportistas y servicios
Consulta los servicios disponibles para el envío y guarda el
agencyIddel elegido.GET /api/v2/agencies/prices
- 3. Crear el envío
Con
externalShippingCode(tu pedido de Etsy),notificationUrl, origen, destino y bultos. Devuelve la referencia ypaymentUrl.POST /api/v2/shipments
- 4. Confirmar
Llama a
paymentUrly espera un HTTP 200: a partir de ahí se notifica al transportista.GET {paymentUrl} - 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.
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:
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.
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 APICrea tu cuenta gratis. La documentación está en Mi cuenta → Perfil → API
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.
Tiendas online
Marketplaces
Otros
Actualizado: octubre de 2026
Pregúntale a la IA sobre Genei
Consulta a tu asistente favorito cómo conectar Etsy con Genei.