Objetivo: En esta guía te explicamos cómo activar los puntos de servicio para las integraciones de API. Este artículo se centra en la configuración del selector de puntos de servicio en una tienda personalizada y construida a medida, a la que Sendcloud se conecta a través de una integración de API y no a través de unplugin plug and play.
API de Sendcloud
Las API de Sendcloud proporcionan las funcionalidades y las herramientas necesarias para ayudarte a construir tu automatización de envíos en torno a la plataforma Sendcloud, permitiéndote agilizar tu proceso de envío y automatizar tu flujo logístico.
Puedes integrar las principales funcionalidades de Sendcloud con tu sistema de comercio electrónico personalizado. Podrás encontrar nuestra documentación completa sobre la integración de Sendcloud a través de la API en Portal de desarrolladores.
Consulta el Portal de desarrolladores de Sendcloud
La API de puntos de servicio
La API de puntos de servicio te proporcionan la información que necesitas para depositar tus paquetes en un punto de servicio o enviarlos a un punto de entrega elegido por el cliente. La API proporciona cuatro endpoints que te permiten recuperar las ubicaciones de los puntos de servicio, verificar su disponibilidad y almacenarlas en tu plataforma de Sendcloud para utilizarlas durante el proceso de pago.
Visita nuestra Guía sobre la API de puntos de servicio.
Integración del selector de puntos de servicio
Sendcloud ofrece un selector de puntos de servicio que puede integrarse fácilmente en tu sistema. Se mostrará un mapa en tu página de pago, desde el cual tus clientes pueden elegir un punto de servicio conveniente para recoger su paquete. Puedes obtener más información sobre los puntos de servicio aquí.
Ten en cuenta que el punto de servicio se mostrará en el idioma configurado en tu cuenta, y no en el idioma del navegador web.
Antes de empezar, asegúrate de haber
- Obtenido tus claves API
- Activado los puntos de servicio para los transportistas que desees utilizar en Configuración > Integraciones
Para integrar el selector de puntos de servicio de Sendcloud con tu tienda personalizada:
- Prueba con este ejemplo en vivo. Al seleccionar un punto de servicio, recibirás como resultado un objeto de punto de servicio y un número de puesto, si lo has introducido. Necesitarás esos datos más adelante cuando crees un nuevo envío a través de nuestra API de envíos (consulta el apartado Create a parcel (crea un envío) en nuestra Guía de referencia de la API de envíos).
- Asegúrate de completar los parámetros
to_service_point
andto_post_number
cuando envíes los datos. - Puedes copiar el código que aparece en la parte inferior de esta página, en la sección Usage (uso)
Para integrarlo con tu código backend:
- Tienes que realizar una llamada a sendcloud.servicePoints.open y proporcionar un objeto de configuración, un callback de éxito y un callback de error (ejemplo)
- Una vez seleccionado un punto de servicio, nuestra biblioteca llamará a tu función callback con un objeto de punto de servicio. Este contendrá las propiedades de la dirección del punto de servicio y el identificador
service_point_id
único. - Cuando crees un envío a través de la API, tendrás que estructurar tu petición de forma que incluya la información de la dirección del punto de servicio. En el parámetro
to_service_point
incluye el ID del punto de servicio. - Puedes encontrar una guía sobre la creación de envíos para enviar a puntos de servicio con la API de Sendcloud aquí.
Enlaces útiles:
- Documentación de la API de Sendcloud:
https://api.sendcloud.dev/docs/sendcloud-public-api/ - Ejemplo de integración del selector de puntos de servicio:
https://sendcloud-public.gitlab.io/spp-integration-example/ - Repositorio de ejemplos de integración de puntos de servicio
https://gitlab.com/sendcloud-public/spp-integration-example
Historial de versiones
Versión: 1.0.0
Fecha: 11-01-2017
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js