Cómo integrar Sendcloud en una tienda online de España
Conecta tus propias claves y prepara la expedición de pedidos mediante Sendcloud, sin anunciar como existentes etiquetas o seguimientos que aún no hayas generado.
¿Por qué utilizar Sendcloud para tu tienda española?
Sendcloud agrupa distintos transportistas europeos. Permite preparar pedidos, configurar servicios de transporte, generar etiquetas y consultar su seguimiento según los servicios habilitados por el proveedor. Una cuenta de Sendcloud puede utilizar tarifas propias de transportistas que tengas contratados o modalidades ofrecidas por la plataforma.
1. Crear una cuenta de empresa en Sendcloud
Accede a Sendcloud, verifica los datos del negocio, añade dirección de remitente, confirma la facturación y activa los transportistas o contratos con los que deseas trabajar. Sin esos pasos no tendrás necesariamente disponibles servicios para crear etiquetas.
2. Crear una integración Sendcloud API v3
En el panel Sendcloud abre Integraciones, crea una integración de tipo API y copia Public API Key, Private API Key y el identificador numérico Integration ID. La clave privada pertenece únicamente a tu comercio: no la compartas con terceros ni la incluyas en capturas.
3. Conectar Sendcloud en Tiendli
Abre Negocio → Logística → Operadores logísticos y busca Sendcloud · España. Introduce ambas claves API y el Integration ID; pulsa Probar conexión y guardar. Tiendli valida el acceso consultando el endpoint de pedidos de Sendcloud API v3, y almacena las claves cifradas. Si modificas únicamente el identificador de integración, puedes dejar las claves vacías para conservar las existentes.
Ir a Operadores logísticos4. Sincronizar un pedido con Sendcloud
La primera fase permite enviar un pedido de entrega nacional en EUR a la cola de pedidos de Sendcloud. Necesitarás el ID interno del pedido de Tiendli, su dirección completa en España y el peso real del paquete en kilogramos. Tiendli envía la referencia del pedido, artículos, total y datos de envío a Sendcloud y registra el ID remoto. Si repites la sincronización, Sendcloud actualiza la misma referencia de pedido e integración.
5. Consultar transportistas y cotizaciones reales
Tras sincronizar el pedido, introduce el código postal del remitente y pulsa Consultar modalidades y precios. Tiendli consulta Sendcloud API v3 con destino y peso real del pedido. Los métodos disponibles dependen de los transportistas y contratos habilitados. Algunos contratos no devuelven una tarifa calculable: en ese caso se indica claramente que no hay precio informado.
6. Crear una etiqueta con confirmación y seguridad
Una etiqueta puede originar cargos. El módulo está desactivado hasta que el superadministrador valide una cuenta real y lo habilite expresamente. El propietario selecciona un servicio habilitado, confirma el coste potencial y confirma de nuevo antes de enviar una sola solicitud. Tiendli registra un bloqueo único por pedido antes de llamar a Sendcloud. Si hay error de red o confirmación ambigua, aparece revisión necesaria: no repitas la operación, consulta el proveedor.
7. Descargar la etiqueta PDF y consultar seguimiento real
Una etiqueta confirmada registra el ID de paquete, número de seguimiento y enlace del transportista. Tiendli permite descargar el PDF mediante acceso autenticado sin exponer claves API. Si generaste la etiqueta directamente en Sendcloud, podés introducir su número de seguimiento en Tiendli y vincularlo al pedido: la API verificará que pertenece a la integración del comercio. Para conocer el movimiento del paquete, utiliza Consultar seguimiento: Tiendli obtiene la cronología de la API v3 y muestra phase, exception y descripción de los eventos, sin datos simulados.
8. Tarifas de Sendcloud en el checkout español: consulta y cobro seguro
Sendcloud API v3 ofrece un Dynamic Checkout con tarifas en EUR y una API de puntos de recogida. Tiendli incorpora una vista previa en el checkout español, desactivada inicialmente y habilitable por el superadministrador. Para consultar tarifas, el comercio debe publicar su configuración Dynamic Checkout en Sendcloud, completar el peso de todos los productos físicos en Tiendli y registrar el código postal del remitente en la configuración Sendcloud de Operadores logísticos. Para puntos de recogida, los compradores pueden pulsar «Comprobar disponibilidad y servicios»: Tiendli verifica de nuevo que el punto esté cercano, que Sendcloud lo informe disponible y cuáles son los transportistas compatibles con su cuenta y el paquete. Las cotizaciones siguen siendo orientativas: no se aplican al total del pedido, no reservan lockers ni permiten seleccionar aún el servicio como medio pagado. Hasta completar la validación definitiva del servidor y la selección de servicio, utiliza los medios de envío normales de la tienda.
8.1. Activar el cobro del transporte con un precio verificable
Tras probar el piloto orientativo con una cuenta Sendcloud real, el superadministrador puede habilitar por separado el cobro dinámico de Sendcloud. Este interruptor está desactivado por defecto. En ese modo, las opciones de envío DELIVERY aparecen junto a los demás métodos de la tienda únicamente si Sendcloud API v3 informa precios EUR verificables para el peso real del catálogo (incluido el peso de cada variante si corresponde) y el código postal español. La tienda debe tener su método DELIVERY asociado al operador Sendcloud y configurar el código postal de origen. Cuando el comprador elige la opción, Tiendli vuelve a consultar el precio desde el servidor antes de crear el pedido. Si la tarifa cambia o la opción desaparece, se rechaza la confirmación y se pide volver a seleccionar; nunca se aplica un precio enviado por el navegador.
8.2. Elegir puntos de recogida en el checkout (piloto controlado)
Tiendli incorpora la selección de puntos de recogida para tiendas españolas, pero la funcionalidad queda desactivada por defecto hasta realizar pruebas reales. Para habilitarla, superadministración debe activar tres opciones en orden: vista previa Sendcloud, cobro real con tarifa validada y piloto de puntos de recogida. El comprador consulta los puntos cercanos a su código postal, pulsa Comprobar disponibilidad y servicios y, cuando el piloto está activo, puede elegir uno. Después debe seleccionar una modalidad Sendcloud compatible y con tarifa EUR confirmada. El backend vuelve a verificar punto, transportista, peso, precio y destino antes de guardar el pedido. La referencia del punto se almacena y se envía a Sendcloud API v3 en service_point_details. Si cambia el punto o la modalidad, se recalcula el importe; no se acepta un precio proporcionado por el navegador. Los puntos pueden requerir códigos adicionales del destinatario según transportista (por ejemplo un post number), por lo que deben probarse en una cuenta real antes de activar el piloto.
9. Webhook seguro de eventos de seguimiento
En Operadores logísticos, Tiendli muestra la dirección de webhook privada de cada comercio. El propietario puede copiarla y darla de alta en Sendcloud como conexión a una suscripción de eventos parcels.event.created, función v3 todavía beta. La dirección contiene un secreto: no la publiques. Cuando llega un evento, Tiendli lo contrasta con su propia consulta autenticada a la API de seguimiento y comprueba la integración de la tienda antes de guardar el estado. Los correos automáticos a compradores se enviarán únicamente si el superadministrador habilita el módulo tras probarlo, y la tienda autoriza los avisos en su panel. Los eventos deben verificarse contra Sendcloud, y cada hito de un envío origina como máximo un aviso gracias a la cola persistente. Se notifican tránsito, reparto, entrega y problemas; nunca se modifica el cobro del pedido. La funcionalidad permanece desactivada por defecto y requiere un proveedor de correo configurado en Tiendli.
10. Recuperación periódica cuando falla el webhook
Si Sendcloud pierde un aviso webhook o se interrumpe la conexión, Tiendli dispone de un proceso de recuperación de seguimiento. El superadministrador debe habilitarlo desde Logística → Operadores logísticos → Sendcloud y programar en Dokploy una solicitud POST periódica a /api/cron/sendcloud-tracking-recovery con cabecera x-cron-secret que contenga CRON_SECRET del servidor. El proceso permanece desactivado hasta que se valide. En cada pasada consulta un número limitado de paquetes activos y recientes, comprueba que pertenecen a la cuenta Sendcloud de cada comercio y conserva la fecha de última consulta para evitar llamadas repetitivas. Si la tienda autorizó los correos y la plataforma los habilitó, también encola los avisos pendientes sin duplicarlos. No crea etiquetas, modifica pagos ni cambia automáticamente el pedido a entregado. Para producción recomendamos ejecutarlo cada 30 minutos al principio, supervisando los límites de la API y los resultados. Usa un secreto aleatorio de al menos 24 caracteres para CRON_SECRET y conserva ese secreto únicamente en variables de entorno o mecanismos seguros del programador: nunca en una URL ni en el repositorio. El proceso revisa como máximo ocho seguimientos por ejecución, y por eso no sustituye la entrega de webhooks de Sendcloud.
11. Próximos pasos y límites actuales
La conexión y consulta de servicios no generan gastos por etiquetas. La creación de etiquetas puede cobrarse en Sendcloud. Esta fase se limita a entregas nacionales de comercios españoles en EUR. Los puntos de entrega efectivos en el checkout, devoluciones del transportista y envíos internacionales requieren desarrollo y validación adicionales. El webhook ya está preparado, pero necesita activación y pruebas de la suscripción de eventos de Sendcloud. Si el módulo está apagado, prepara las etiquetas en el panel Sendcloud.
Preguntas frecuentes
¿Puedo cobrar al comprador una tarifa de Sendcloud calculada en directo?
El flujo está preparado para España y EUR, pero la activación global queda deshabilitada por defecto hasta validar compras y tarifas reales. Al activarse, Tiendli toma el importe únicamente de Sendcloud API v3 y vuelve a comprobarlo antes de crear el pedido; un cambio de precio obliga a confirmar de nuevo.
¿Se pueden elegir lockers y puntos de recogida dentro del pago?
El flujo ya está preparado con verificación real, tarifa EUR y guardado del punto en el pedido, pero la activación está bloqueada por defecto hasta pruebas E2E y autorización del superadministrador. No habilites el piloto sin verificar transportista, etiqueta, entrega y los requisitos particulares de cada locker.
¿Cómo activo la selección real de puntos de recogida?
Desde superadministración habilita primero Vista previa Sendcloud y Cobro dinámico de tarifas Sendcloud. Después activa el nuevo piloto Puntos de recogida. Todos los interruptores permanecen desactivados por defecto hasta comprobar el proceso completo con una cuenta de comercio real.
¿Tiendli ya integra Sendcloud España?
Sendcloud API v3 permite conectar cuenta propia, sincronizar pedidos y consultar transportistas y seguimiento. La compra de etiquetas desde Tiendli está implementada pero desactivada por defecto, hasta validación con una cuenta real y habilitación de superadministración.
¿Necesito contratar Correos, SEUR, MRW o GLS por separado?
Depende de los transportistas y tarifas habilitados para tu cuenta Sendcloud. Algunos servicios pueden usarse mediante Sendcloud y otros requieren un contrato directo con el transportista.
¿Qué es el Integration ID?
Es el identificador numérico de tu integración API en el panel Sendcloud. Se utiliza junto con las claves para identificar el origen de los pedidos y evitar duplicados.
¿Sincronizar un pedido genera gastos de envío?
No. Importar pedidos o consultar servicios no crea etiquetas. Comprar una etiqueta sí puede generar cargos y exige confirmación explícita en Tiendli.
¿Puedo enviar pedidos desde cualquier país?
Esta primera versión de la conexión Sendcloud en Tiendli está limitada a comercios de España, pedidos en EUR y entregas nacionales. Las exportaciones necesitan datos aduaneros adicionales.
¿Por qué la tarifa de Sendcloud no se suma todavía al checkout?
El piloto comprueba cotizaciones en tiempo real para orientar al comprador. Por seguridad, Tiendli sigue cobrando únicamente el método de envío configurado y recalculado en el backend. Falta validar la selección definitiva y el importe del proveedor al crear el pedido, incluyendo descuentos y cambios de tarifas.
¿Puedo comprobar si un locker sigue disponible?
Sí, durante el piloto, cuando tu tienda tenga Sendcloud y servicios compatibles. Pulsando «Comprobar disponibilidad y servicios» se consulta la API v3 para verificar el punto y encontrar transportistas compatibles. La respuesta no reserva el locker ni garantiza que continúe disponible al generar la etiqueta.
¿Qué debo configurar para consultar precios de puntos de recogida?
Debes registrar un código postal de origen español en Operadores logísticos, conectar una cuenta Sendcloud con puntos de servicio habilitados y completar el peso real de los productos. Si no se puede confirmar una tarifa, Tiendli muestra «Tarifa no informada» en lugar de inventar un importe.
¿Puedo desactivar la dirección si ofrezco envío gratis?
Solo para métodos gratuitos que el comercio gestione manualmente, sin operador integrado ni tarifas por zona. Los pedidos que quieras enviar mediante Sendcloud siguen necesitando una dirección completa para su sincronización y expedición.
¿Qué significa REVIEW_REQUIRED tras solicitar una etiqueta?
El proveedor puede haber cobrado una etiqueta aunque Tiendli no recibiera confirmación. No repitas el intento; revisa el estado en Sendcloud y solicita conciliación manual.
¿Las tarifas de Sendcloud ya se cobran en el checkout?
Existe un flujo de tarifas reales en EUR con revalidación del importe en el servidor antes de guardar el pedido, pero está desactivado de forma predeterminada. La vista previa de Sendcloud es independiente y nunca añade precios orientativos al total. Activar el cobro real requiere pruebas con una cuenta y configuración de Sendcloud válidas.
¿Puedo seleccionar un locker desde esta vista previa?
De momento la vista solo permite consultar los puntos de recogida del proveedor. Elegir y reservar uno para entregar un pedido requiere validar el transportista, modalidad y punto compatible antes de pagar.
¿Qué pasa cuando se pierde una actualización del webhook?
Tiendli dispone de una recuperación periódica por API v3, desactivada de forma predeterminada. El superadministrador debe activarla tras probar Sendcloud, configurar CRON_SECRET y programar en Dokploy una solicitud POST autenticada. Se verifican únicamente paquetes recientes de tiendas españolas y se evitan notificaciones duplicadas.
¿El webhook envía correos automáticamente al cliente?
Se pueden habilitar emails transaccionales de tránsito, reparto, entrega e incidencias. El módulo está desactivado por defecto: requiere que el superadministrador lo active tras probar el webhook y el proveedor de correo, y que el propietario de cada tienda autorice la opción desde Operadores logísticos. El sistema almacena cada aviso en una cola persistente y evita enviarlo dos veces para el mismo hito del mismo envío.
¿Puedo descargar etiquetas desde Tiendli?
Sí, cuando el módulo esté habilitado y el proveedor confirme la operación. El PDF se recupera de forma privada, sin exponer las claves de tu comercio.
¿Puedo usar el seguimiento si creo la etiqueta en Sendcloud?
Sí. Con el pedido previamente sincronizado, introduce el número de seguimiento de Sendcloud y pulsa Vincular seguimiento. Tiendli comprueba que la operación pertenece a la misma integración antes de mostrar sus eventos, sin generar una segunda etiqueta.
Fuentes y documentación oficial
Sendcloud Quickstart y API Keys