Obtener Métodos de Entrega
Esta llamada permite obtener los métodos de entrega disponibles para una reserva específica en Colaborador. Es un paso esencial si los tickets requieren gestión de entrega, lo cual se indica en el catálogo de productos con la propiedad RequiresDeliveryManagement.
1. Método de Acceso
2. Datos de Envío
Para obtener los métodos de entrega, se deben enviar los siguientes parámetros:
3. Ejemplo de Petición
curl -X GET "{baseurl}/api/deliverymethods?PartnerId={partnerId}&ReservationId=zp83haxd5ucwn" \
-H "Content-Type: application/json"
También puedes hacer la solicitud desde un navegador o Postman con la siguiente URL:
{baseurl}/api/deliverymethods?PartnerId={partnerId}&ReservationId=zp83haxd5ucwn
4. Estructura de la Respuesta
La API devuelve un array con los métodos de entrega disponibles. Dependiendo del Type, puede haber métodos de envío o recogida en un punto específico.
5. Ejemplo de Respuesta Exitosa
{
"Methods": [
{
"Id": "hen3s1e7ao4ch",
"Name": "Envío a domicilio",
"Type": 0
},
{
"Id": "stai6dbnn7xws",
"Name": "Entrega en hotel",
"Description": "Entrega en la recepción del hotel asociado.",
"Type": 1,
"DeliveryPoints": [
{
"Id": "md8jo6fumzj56",
"Name": "Hotel Prueba",
"Address": "Carrer Botiguers, 1",
"City": "Paterna",
"ZipCode": "46019",
"Province": "Valencia",
"CountryCode": "es",
"PhoneNumber": "961345415",
"Email": "email@hotel.com"
}
]
}
],
"Success": true,
"Timestamp": "2025-02-05T15:30:00.000Z"
}
6. Ejemplo de Respuesta con Error
Si la ReservationId no es válida o no se requieren métodos de entrega, la API devolverá un mensaje de error:
{
"Success": false,
"ErrorMessage": "No se encontraron métodos de entrega para esta reserva.",
"Timestamp": "2025-02-05T15:32:00.000Z"
}
7. Consideraciones Finales
- Algunos tickets requieren un método de entrega obligatorio, lo cual debe verificarse en el catálogo de productos.
- Si el método de entrega es recogida (Type = 1), se debe elegir un DeliveryPoint.
- El Id del método de entrega debe incluirse en la transacción final.
Si no hay métodos de entrega disponibles, podría ser un error en la reserva o el producto podría no requerir gestión de entrega.