Vender en Fnac Marketplace y enviar con Genei
Si vendes en Fnac Marketplace, puedes enviar tus pedidos con Genei a través de su API. Tu sistema crea cada envío con los datos del pedido, comparas más de 25 transportistas y descargas la etiqueta. El número de seguimiento te llega por webhook, listo para informarlo en Fnac y que tu cliente lo tenga.
Actualizado: octubre de 2026
Del pedido en Fnac 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 Fnac
Tu cliente 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 Fnac 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 Fnac.
- 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 Fnac
Tu cliente 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 Fnac 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 Fnac.
"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 Fnac por la API
Fnac 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 Fnac, crea los envíos en Genei y recibe el seguimiento por webhook para informarlo en Fnac. Lo que conecta Fnac 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 Fnac. - 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 Fnac 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 Fnac
Recibe el número y el enlace de seguimiento por webhook en tu
notificationUrle infórmalos en Fnac.
¿Qué necesitas para conectar Fnac 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 Fnac.
| 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 Fnac con la API de Genei
- Sin teclear envíos. Tu sistema crea cada envío con los datos del pedido de Fnac.
- Seguimiento al momento. El número y el enlace de seguimiento te llegan por webhook, listos para informarlos en Fnac.
- 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 Fnac y enviar tú
Cuando vendes en Fnac 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 Fnac.
En un marketplace de tecnología, libros y ocio, los pedidos suelen llevar productos que hay que embalar bien y entregar a tiempo. Con la API, tu sistema crea los envíos sin teclearlos y tú te centras en preparar los paquetes.
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 Fnac),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 Fnac
Envía tus pedidos de Fnac Marketplace con Correos, GLS, SEUR o Correos Express, y elige en cada envío el servicio que mejor encaja con su destino y su plazo.
Lo que conecta Fnac con cada transportista es Genei: no hay una integración directa entre Fnac 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 Fnac 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 Fnac con Genei
¿Cómo conecto Fnac 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 Fnac, 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 Fnac, con la API de Genei y quien informa el seguimiento en Fnac.
¿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 Fnac 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.
Tiendas online
Marketplaces
Otros
Actualizado: octubre de 2026
Pregúntale a la IA sobre Genei
Consulta a tu asistente favorito cómo conectar Fnac con Genei.