Haz un seguimiento del Dasher
En este momento, el proceso de integración en Marketplace se encuentra al máximo de su capacidad. No estamos aceptando nuevos socios por ahora, ya que estamos desarrollando herramientas de autogestión para la incorporación de tiendas. Completa el formulario para interesados en la integración de Marketplace para ponerte en contacto con DoorDash antes de realizar tu integración.
DoorDash mejoró el contrato OpenAPI con un nuevo webhook. DoorDash mejoró el contrato OpenAPI con un nuevo webhook. Los socios de integración pueden suscribirse a este webhook facilitando al Administrador técnico de cuentas un punto de conexión y los datos de autorización.
El webhook de estado del Dasher contiene un indicador de estado, una referencia a la orden específica y la información del Dasher. Se activará un evento de webhook cada vez que se alcance un estado de Dasher específico, por lo que se espera que se activen varios eventos para una orden.
Al proporcionar a las tiendas con puntos de venta la información sobre el ciclo de vida completo de una orden, se puede aumentar la eficiencia operativa permitiendo a las tiendas realizar lo siguiente:
- Agregar los toques finales a una orden justo antes de que el Dasher entre en la tienda, a la vez que se garantiza la calidad de los alimentos (terminar de empacar, sacar el helado del congelador, etc.).
- Comprender el estado actual de una orden, y eliminar la necesidad de contactar con el servicio de asistencia.
- Dar prioridad a las órdenes en curso, completando la orden con el Dasher que llega primero.
- Mejorar la experiencia de entrega de órdenes con la visibilidad de los datos del Dasher.
Formato del webhook
dasher_status: valor de cadena que indica el estado actual de Dasher. Los valores incluyen dasher_confirmed, arriving_at_store, arrived_at_store, dasher_out_for_delivery.
external_order_id: UUID único de la orden que DoorDash envía a la tienda.
client_order_id: merchant_supplied_id de la carga de confirmación de la orden. Cuando la tienda confirma la orden, puede pasar el ID de la orden interna en el campo merchant_supplied_id y guardar este valor como client_order_id. Este es el valor que se devuelve en la carga como client_order_id. Si no se pasa este valor durante la confirmación de la orden, se establecerá en nulo en la carga.
created_at: marca de tiempo del evento de estado del Dasher.
location_id: el identificador de un comerciante proporcionado por la tienda.
Phone_number: número de teléfono oculto del Dasher (Nota: Solo se puede contactar al Dasher si la llamada se inicia desde el número de teléfono de la tienda).
Carga del webhook
A continuación, se muestra un ejemplo de la carga:
{
"event": {
"type": "dasher_status_update",
"status": "<SUCCESS> OR <FAILURE>",
"reference": "<reference_uuid>"
},
"created_at": "2021-06-02T17:41:29.996321Z",
"delivery": {
"external_order_id": "7424215690108_2",
"client_order_id": "12321444",
"location_id": "123852",
"dasher_status": "arrived_at_store",
"dasher": {
"phone_number": "(586) 381-6148",
"first_name": "Jude",
"last_name": "D.",
"vehicle": {
"color": "",
"make": "Dodge",
"model": "Dakota"
}
}
}
}
Códigos de error y respuesta
Una vez que se recibe un webhook, se espera que el proveedor devuelva los siguientes códigos de respuesta:
| Código de estado | Detalles |
|---|---|
| 200 | Devuelve un estado 200 para indicar que los datos se recibieron correctamente |
| 401 | No autorizado. DoorDash no tiene un token de autentificación para este punto de conexión. |
| 403 | Prohibido, DoorDash no tiene acceso a este punto de conexión |
| 500 | Error interno del servidor: algo salió mal del lado de la tienda. |
| 503 | El servicio no está disponible: el punto de conexión de la tienda está parcial o totalmente caído. |