¿Qué es un selector de puntos de servicio?
Algunos transportistas de envíos ofrecen puntos de servicio a tus usuarios a los que pueden enviar sus paquetes, de modo que puedan recoger ellos mismos el paquete en una localización cercana. Sendcloud ofrece un selector de puntos de servicio que se puede integrar fácilmente en cualquier sistema para mostrar una excelente interface para seleccionar puntos de servicio disponibles.
¿Cómo funciona?
En este artículo, se indica cómo configurar el selector de puntos de servicio en una tienda personalizada. Estas tiendan deben integrarse directamente en el API de SendCloud.
Historial de versiones
Versión: 1.0.0
Fecha: 11-01-2017
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js
Enlaces relacionados
Documentación de la API de Sendcloud
https://docs.sendcloud.sc/api/v2/index.html
Ejemplo de integración del selector de puntos de servicio
https://sendcloud.github.io/spp-integration-example/
Archivo de ejemplo de integración del selector de puntos de servicio
https://github.com/SendCloud/spp-integration-example/
Paso 1: Obtener una clave de la API
1. Una vez que inicies sesión en nuestro panel, ir a 'Configuración'--> 'Integraciones'
2. Haz clic en 'Más información' en Sendcloud API
3. Rellena los campos solicitados, esta información la obtienes desde tu plataforma:
- Nombre (puede ser el nombre de tu tienda para identificar la integración)
- Clave Pública
- Clave secreta (puede ser la contraseña)
- Activar los comentarios de Webhook para poder enviar las actualizaciones de estado y seguimiento en tu tienda
- El URL de tu webhook
4. Marca la caja de 'Puntos de servicio' y selecciona al transportista (únicamente aparecerán los transportistas que hayas activado y que cuenten con este servicio)
6. Da clic en 'Guardar'
Paso 2: Configurar una integración del selector de puntos de servicio
Para configurar una integración del selector de puntos de servicio, primero necesitas una integración personalizada totalmente utilizable de tu API. Puedes ver una guía sobre cómo configurarla aquí.
Una vez que esté funcionando la integración de la API, pasa a la configuración del selector de puntos de servicio como se indica a continuación:
- Comprueba que has activado los puntos de servicio en la configuración de tu integración.
- Copia el código JavaScript integrado que se facilita en la página de configuración de la integración.
- Pégalo en tu página del proceso de compra.
- En este momento, puedes consultar nuestro ejemplo de selector de puntos de servicio.
Paso 3: Una guía paso a paso sobre cómo integrar el código JavaScript en tu código backend
- Debes llamar a servicePoints.openy proporcionarle un objeto con configuración, un callback de éxito y un callback de error (ejemplo)
- Cuando se seleccione un punto de servicio, nuestra librería llamará a tu función callbak con un objeto del punto de servicio. La información principal que estás buscando es el ID del punto de servicio y todas las propiedades de la dirección que tenga. Tienes que hace un seguimiento del ID de algún modo ya que se va a usar para crear un nuevo envío de paquete en nuestra API.
- Cuando el envío del paquete se cree en nuestra API, debes asegurarte de pasar toda la información de contacto correcta en los campos de dirección y, sobre todo, rellenar el parámetro to_service_pointcon el ID del punto de servicio.
Cuando hayas terminado los pasos anteriores, tu integración debe funcionar correctamente.
Si tienes comentarios, puedes enviarlos por correo electrónico a través de support@sendcloud.com.
¡Disfruta enviando pedidos con Sendcloud!