Tutoriel d'accès au catalogue

Introducción

Esta documentación tiene como objetivo guiar a los desarrolladores en la integración del catálogo de ventas y la realización de pedidos, con o sin pago, utilizando la API Yoplanning.pro. El objetivo es habilitar la venta de actividades de Yoplanning dentro de su sistema. Asumimos que ya ha leído la documentación de la API y que es propietario de su token de API.

Pasos del flujo de trabajo de integración

1. Recuperación de los Datos de tu Equipo

• Punto final: /api/v3.1/teams/

• Información esencial: team_id y vendor_id

• Uso: El team_id es necesario para casi todas las solicitudes de API. El vendor_id es necesario si desea utilizar el Administrador de pagos.

2. Obtención de la lista de productos

• Punto final: /api/v3.1/teams/[teamId]/online-products/

• Función: Recupera la lista de productos que se pueden vender online.

• Parámetros adicionales:

  • lang: (cadena) Indica el idioma de los campos traducibles (como título, descripción, etc.). Utilice un código ISO2. Predeterminado: en (inglés). Posibles opciones: fr (francés), de (alemán).

  • start_date: (fecha) Filtra los resultados para devolver solo aquellos con disponibilidad después de esta fecha. Formato de fecha: AAAA-MM-DD.

  • end_date: (fecha) Filtra los resultados para devolver solo aquellos con disponibilidad antes de esta fecha. Formato de fecha: AAAA-MM-DD.

  • categoría: (cadena) Filtra productos por categoría específica.

3. Recuperación de la Disponibilidad del Producto

• Punto final: /api/v3.1/teams/[teamId]/online-products/[productId]/availabilities/

• Función: Muestra las sesiones disponibles para un producto específico.

• Filtrado: Fecha, precio, número de entradas, personal (instructor), etc.

4. (Opcional) Recuperación de Opciones Disponibles (Equipo)

• Punto final: /api/v3.1/teams/[teamId]/availability-details/[pk]/

• Función: Recupera detalles de las opciones disponibles para una sesión específica.

5. (Opcional) Verificación de disponibilidad

• Punto final: /api/v3.1/teams/[teamId]/order-validation

• Función: Permite comprobar si el contenido de la cesta aún está disponible antes de finalizar el pedido.

• Ver más detalles, haga clic aquí

6. (Opcional) Crear un pago a través del Administrador de pagos

• Punto final: https://paid.yoplanning.pro/api/create-paid

• Función: Crea un pago y recupera el enlace de pago.

• Gestión de IPN: Gestión de notificación de pago instantáneo en la URL de devolución de llamada proporcionada.

7. Realizar el pedido

• Punto final: /api/v3.1/teams/[teamId]/orders/

• Función: Registra el pedido en Yoplanning, actualiza el cronograma, muestra el pedido y los participantes en Yoplanning, notifica al personal y actualiza la disponibilidad.

Ejemplo de uso con cURL

• Recuperación de Productos:

curl https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/online-products -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada'

* **Recuperación de disponibilidad del producto**: ```bash curl https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/online-products/f16ed6c6-e972-4232-b452-ecd393e61642/availabilities -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada' ``` * **Realizar el pedido**: ```bash curl -H "Content-Type: application/json" -X POST -d '{"external_reference" : "956", "items" : [{"session_group" : "4f655815-58d9-4c7c-b1c9-2ea152073371", "price" : {"amount" : 51.25}, "client" : {"id" : "71ea849f-226c-4302-a433-528179634aa7", "first_name" : "John", "last_name" : "Doe", "email" : "[e-mail]"}}], "payments" : [{"amount" : 51.25, "client" : {"first_name" : "Framold", "last_name" : "Doe", "email" : "[e-mail]"}}]}' https://yoplanning.pro/api/v3.1/teams/5a90332e-568f-4980-9859-88a984844a4d/orders -H 'Authorization: Token 4504c2cb0d87a93106d4de029f407c86149f2ada' ```

Asegúrate de reemplazar los ID y tokens con los de tu equipo para todas las solicitudes.

---

Nota: Esta documentación es un ejemplo básico de integración. Para obtener detalles más específicos y casos de uso avanzados, consulte la documentación oficial de la API de Yoplanning.pro.