Objetivo: Todo lo que necesitas saber sobre la integración de tu tienda web personalizada con Sendcloud a través de nuestras API (RESTful).
Hemos actualizado los planes de suscripción de Sendcloud. Si los planes mostrados en el banner de arriba no coinciden con tu suscripción actual y quieres saber más, haz clic aquí.
Enlaces relacionados:
- Guía de referencia de la API de Sendcloud
- Portal de desarrolladores de Sendcloud
- Puntos de servicio para las integraciones API
- Preguntas frecuentes sobre las API de Sendcloud
En Sendcloud, ofrecemos funcionalidades y herramientas que ayudan a las tiendas online a automatizar su proceso de envío. Nuestras funciones, totalmente escalables, facilitan la vida de los vendedores en línea, tanto si eres un comerciante individual o una start-up, como si se trata de una empresa a gran escala que envía miles de paquetes al mes a todo el mundo.
Integración con Sendcloud
Hay dos maneras de conectar una tienda online con Sendcloud:
Integraciones plug and play
Si utilizas un sistema de comercio electrónico como Shopify, WooCommerce, Lightspeed o Magento, no necesitas conocimientos de desarrollo de web para conectar tu tienda. Proporcionamos aplicaciones y plug-ins plug and play (listas para conectar directamente) para más de 80 de las plataformas de comercio electrónico más populares. Puedes descargarlas desde el marketplace o app-store de tu sistema.
API de Sendcloud
API de Sendcloud
Si tienes una tienda web personalizada que no está alojada ni creada a través de una plataforma de comercio electrónico, ahí es donde entran en juego nuestras API. Una API permite a los desarrolladores conectarse y extraer componentes clave de nuestro sistema interno e integrarlos con tu tienda web o sistema. Las API de Sendcloud están diseñadas para cubrir cada etapa del envío de un paquete.
Nuestras funcionalidades se pueden utilizar de forma conjunta o independiente, lo que te da la flexibilidad de diseñar y construir tu propio flujo de trabajo de principio a fin. Nuestras API te dan acceso a una enorme gama de métodos de envío nacionales e internacionales de los más populares transportistas comerciales y postales europeos.
Documentación y guía de referencia de la API
Si eres un desarrollador con experiencia que busca iniciarse rápidamente en nuestras API, puedes dirigirte directamente a nuestra Guía de referencia de la API o acceder a nuestras Colecciones Postman.
Si eres nuevo en esto de las API y quieres ver una explicación en profundidad de cómo podría ser tu flujo de trabajo de procesamiento de pedidos, consulta nuestra Documentación de API. Tendrás a tu disposición guías de inicio rápido y tutoriales para guiarte a través de los aspectos fundamentales, desde la creación de tu primer envío con la API hasta la creación de envíos multibulto y la comparación de las tarifas de envío.
¿Qué puedes hacer con nuestras API?
-
API de envíos
La API de envíos te da acceso a las funcionalidades principales de nuestra plataforma. Crea etiquetas, genera documentos aduaneros para tus envíos internacionales y automatiza todo el procesamiento de envíos con nuestras reglas de envío. -
API de puntos de servicio
Integra un selector de puntos de servicio en tu caja, accede a una base de datos de todas las ubicaciones de puntos de servicio disponibles para transportistas de todo el mundo, y permite a tus clientes elegir el lugar más conveniente para la entrega de su paquete. -
API de productos de envío
Compara tarifas, niveles de servicio y servicios de valor añadido de más de 50 transportistas a nivel nacional e internacional. -
API del portal de devoluciones
Deja que tus clientes gestionen sus propias devoluciones gracias a tu propia versión personalizada del portal de devoluciones de Sendcloud. Utilízalo junto con nuestra funcionalidad de devoluciones pagadas para cobrar proactivamente a tus clientes una tasa de devolución. -
API de seguimiento
Recupera todo el historial de seguimiento de un paquete, desde el momento en que se crea la etiqueta de envío hasta el momento exacto en que llega a la puerta de tu cliente. -
API de recogidas
Programa una recogida puntual con un transportista a través de la API de recogidas y haz que tus paquetes se recojan en tu almacén o tienda en un momento determinado. -
API del Dynamic Checkout
Aumenta tus tasas de conversión gracias a la opción de ofrecer entregas al día siguiente, en el mismo día y en días directamente desde tu página de pago. Configura los métodos de envío por zona de entrega utilizando el panel de Sendcloud, luego recupera los métodos de envío aplicables y preséntalos a tu cliente en tu página de pago con nuestra API. -
API de devoluciones V3
Crea devoluciones independientes para paquetes a través de la API de devoluciones (versión 3) en cuestión de minutos, incluso si creaste la etiqueta de envío original fuera de Sendcloud. Accede a una base de datos de métodos de devolución y valida tu solicitud de devolución antes de crear la etiqueta, para que puedas evitar recargos no deseados si la devolución no es posible con el método de devolución seleccionado.
¿Qué es una API?
"API" corresponde a las siglas en inglés de Application Programming Interface (interfaz de programación de aplicaciones). Una API permite que las aplicaciones se comuniquen entre sí a través de la web. Para recuperar datos de una API, se hace una "solicitud" en un lenguaje de formato como JSON o XML, o en un lenguaje de programación como Python, a un servidor, y este devuelve los datos solicitados en una "respuesta". Las API no son simplemente una base de datos: además de solicitar datos, puedes actualizarlos, crearlos y eliminarlos realizando solicitudes de API a endpoints específicos.
Por ejemplo, la API de envío de Sendcloud te da acceso al endpoint "Crear un envío" (Create a parcel, en inglés). Puedes realizar una solicitud a este endpoint para crear un paquete en el sistema Sendcloud proporcionando al endpoint la información que necesita (dirección, método de envío, etc.). Para realizar una solicitud, es necesario saber qué información necesita nuestro servidor para crear el paquete.
En nuestra Guía de referencia de la API te proporcionamos ejemplos de solicitudes y respuestas, además de una lista de campos obligatorios y opcionales que puedes utilizar
¿Por qué utilizar una API en lugar de una integración plug and play?
Los desarrolladores de web utilizan las API para incorporar funciones específicas a la tienda web o al sistema que han construido a medida. Conectarse a Sendcloud a través de la API te permite personalizar nuestras funcionalidades para satisfacer las necesidades de tu negocio, además de poder integrar nuestras funcionalidades junto con aplicaciones de terceros relacionadas con la facturación y la gestión de almacenes.
Cuando se integra con Sendcloud a través de una API, tienes total flexibilidad para decidir cómo quiere construir su flujo de trabajo de procesamiento de pedidos y logística. Puede optar por procesar sus pedidos directamente a través de la API, o importar los pedidos al panel de Sendcloud y procesarlos desde allí. Dado que nuestra API le da acceso a nuestras características clave de forma individual, puede decidir qué características quiere aprovechar e incorporarlas directamente en su sistema y flujo de trabajo.
Cómo empezar
¿Estás listo para empezar a integrar con las API de Sendcloud? Antes de comenzar, asegúrate de que has creado una cuenta de Sendcloud y seguido los pasos en la Guía de inicio rápido a Sendcloud.
Para que nuestra API acepte tus solicitudes, deberás haber hecho lo siguiente:
- Configurado tus direcciones de remitente y devolución (opcional)
- Activado transportistas en tu cuenta
- Configurado el método de pago (necesario para poder crear etiquetas de envío). Más información sobre cómo factura Sendcloud las etiquetas de envío aquí.
Opcional: No te olvides de crear tu marca, activar las notificaciones de seguimiento y configurar tu portal de devoluciones.
Autenticación
Sendcloud utiliza la autenticación de acceso básica para autenticar las solicitudes de nuestras API. Tendráa que incluir una clave de API pública y una privada en la cabecera de cualquier solicitud que realices a un endpoint de Sendcloud.
Ejemplo:
curl “https://panel.sendcloud.sc/api/v2/parcels” --user “YOUR_API_KEY:YOUR_API_SECRET”
Consulta la sección de Autenticación de nuestro portal para desarrolladores para ver más ejemplos sobre la autenticación con nuestras API.
Cómo obtener tus claves API
- Conéctate a tu cuenta de Sendcloud y ve a Configuración > Integraciones
- Busca la API de Sendcloud en la lista de integraciones y haz clic en Configurar
- Elige un nombre para tu integración API (ejemplo: My tienda online) y haz clic en Guardar cambios
- Tus claves públicas y secretas de la API se generarán automáticamente. Cópialas en un lugar seguro e inclúyelas en las cabeceras de tus solicitudes. La clave pública es tu "nombre de usuario" cuando te autentificas con la API, y la clave secreta (privada) actúa como tu "contraseña".
Activación de los puntos de servicio
En la página de configuración de la integración, tal y como se ha descrito anteriormente en la sección Autenticación, puedes elegir activar o desactivar los puntos de servicio. Si deseas realizar solicitudes a la API de puntos de servicio para enviar paquetes a una ubicación de punto de servicio o para mostrar el selector de puntos de servicio en el checkout de tu web, activa los puntos de servicio.
Una vez que hayas marcado la casilla para activar los puntos de servicio, puedes seleccionar los transportistas que quieres incluir como métodos de entrega de los puntos de servicio y hacer clic en Guardar.
Creación de etiquetas de prueba
Puedes probar nuestra API sin preocuparte por los costes gracias al método de envío "Unstamped letter". Para obtener más ayuda sobre la creación de etiquetas de prueba a través de la API, consulta nuestra documentación.
Preguntas frecuentes
Si tienes alguna pregunta sobre el uso de nuestras API, puedes consultar nuestra Guía de preguntas frecuentes sobre integraciones de API.
Actualización de la lista blanca de direcciones IP
-
3.120.127.184
-
3.121.38.108
-
3.122.58.116
-
35.158.146.12
-
52.29.82.100
-
52.58.233.101
-
52.58.235.98
-
18.158.201.133
-
3.72.209.210
-
3.72.214.91
-
3.122.139.71
-
3.64.78.133
-
3.72.54.241
Si estás limitando el acceso a tus sistemas (con un cortafuegos, por ejemplo), asegúrate de realizar los cambios necesarios a tiempo para garantizar un servicio ininterrumpido.