Conectar DoorDash Drive: cotizar, despachar y rastrear entregas locales
Copie Developer ID, Key ID y Signing Secret de la página Credentials del DoorDash Developer Portal, elija una opción de recogida en Integration (una dirección de recogida, o el par External Business ID más External Store ID), pruebe y empiece a pedir entregas de DoorDash Drive.
El conector de DoorDash pide entregas locales de DoorDash Drive desde este sistema: obtiene una cotización, crea una entrega, consulta el estado y puede cancelar una entrega. Es solo una conexión de entrega de última milla: no trae pedidos del marketplace de DoorDash a este sistema ni sincroniza menús o catálogos de tienda. Las cotizaciones y entregas corren con su propia cuenta de DoorDash Drive y su punto de recogida.
Requisitos previos#
- Una cuenta de DoorDash Drive y acceso al DoorDash Developer Portal, donde la página Credentials muestra su Developer ID, Key ID y Signing Secret.
- Usted sabe cómo identificar la recogida: o bien la dirección de recogida en una línea de su tienda o almacén, o bien una tienda ya registrada en DoorDash, nombrada con su External Business ID y su External Store ID. La dirección y el par de ID son alternativas: decida cuál usará antes de empezar.
- El nombre del negocio de recogida y un teléfono al que el repartidor pueda llamar en la recogida, si quiere mostrarlos: por ejemplo, el nombre de la tienda y su línea directa.
Obtener credenciales#
- Inicie sesión en el DoorDash Developer Portal y abra la página Credentials.
- Copie el Developer ID que muestra esa página. Identifica su cuenta de desarrollador y es uno de los tres valores con los que la conexión firma las solicitudes.
- Copie el Key ID que muestra la misma página Credentials.
- Copie completo el Signing Secret que muestra la misma página Credentials. El Key ID y el Signing Secret van juntos como un par, y el Signing Secret es un valor en base64 que la conexión usa para firmar un token de corta duración en cada solicitud: cópielo de la misma página que el Key ID, no de otro par de claves.
Completar en Integration#
- Abra Integration → Marketplace → DoorDash → Nueva conexión.
- developer_id, obligatorio, Developer ID: pegue el Developer ID de DoorDash Developer Portal → página Credentials.
- key_id, obligatorio, Key ID: pegue el Key ID de la misma página Credentials.
- signing_secret, obligatorio, Signing Secret: pegue completo el Signing Secret de la misma página Credentials. Es un campo de tipo contraseña y se guarda como secreto.
- Ahora elija UNA opción de recogida. Opción A, la dirección: complete pickup_address con la dirección de recogida en una línea de su tienda o almacén, por ejemplo 901 Market Street, San Francisco, CA 94103, US, y deje vacíos los dos campos de ID externos.
- Opción B, una tienda registrada: deje pickup_address vacío y complete AMBOS campos, pickup_external_business_id (External Business ID) y pickup_external_store_id (External Store ID), con los ID de la tienda registrada en DoorDash. Los dos ID deben completarse siempre juntos como un par: completar solo uno no funciona, porque la dirección de una tienda registrada solo sustituye a la dirección de recogida cuando están los dos ID.
- pickup_business_name, opcional, nombre del negocio de recogida: el nombre que ve el repartidor para la recogida, por ejemplo el nombre de su tienda. pickup_phone_number, opcional, teléfono de recogida: un número al que el repartidor puede llamar en la recogida, por ejemplo +16505550100.
- user_agent, opcional, User-Agent: en la mayoría de los casos déjelo vacío; la conexión usará su valor predeterminado, Docklify/1.0.
Probar la conexión#
Haga clic en Probar la conexión. La prueba primero comprueba que estén los tres valores de credenciales (developer_id, key_id y signing_secret) y se detiene sin enviar ninguna solicitud si falta alguno. Con los tres presentes, firma un token de corta duración (cinco minutos) a partir de los tres valores y lo usa para buscar una entrega que no existe: docklify-probe-nonexistent. Que DoorDash responda 404 es el aprobado: significa que el token firmado fue aceptado y que solo falta esa entrega inventada, así que el resultado esperado de esta prueba es un 404, no un error que corregir. Una respuesta 401 o 403 se informa como AUTH_FAILED y sí es el fallo real: DoorDash rechazó el token firmado. Si ejecuta la prueba antes de guardar credenciales, el resultado es solo una comprobación simulada: guarde las credenciales reales y pruebe de nuevo para un resultado real. La prueba no crea ninguna entrega ni comprueba su dirección de recogida ni su par de ID externos, por lo que una configuración de recogida incorrecta puede pasar la prueba y fallar después, al cotizar o al crear la entrega.
Mapping / elegir plantilla#
DoorDash Drive no necesita mapping de pedidos: trabaja con entregas, no con pedidos. Lo que confirma aquí es la configuración de recogida del paso de completar, más los campos de entrega que lleva cada solicitud: la recogida viene de su pickup_address o de su tienda registrada (External Business ID más External Store ID), y cada solicitud de entrega usa la dirección de destino, el contacto y los artículos del envío de este sistema. Antes de activar, cree una cotización real y una entrega de prueba a su propia dirección, y compare el nombre de recogida, el teléfono de recogida y los datos de destino con el envío.
Activar#
Tras activar, los envíos de este sistema pueden pedir entregas de DoorDash Drive: la conexión cotiza la entrega, la crea después de aceptada la cotización, mantiene el estado de la entrega en el envío y puede cancelar una entrega que aún no fue recogida. Vigile las primeras entregas reales en Runs / Logs y compare los datos de recogida y destino con DoorDash antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no trae pedidos del marketplace de DoorDash a este sistema, no sincroniza menús ni catálogos de tienda y no liquida pagos a repartidores ni la facturación de DoorDash por usted. Solo cotiza, crea, rastrea y cancela entregas de DoorDash Drive para los envíos que usted pase por ella.
Preguntas frecuentes#
La prueba menciona 404: ¿falló?
No: para DoorDash Drive, ese 404 es la señal de éxito. La prueba busca a propósito una entrega que no existe, docklify-probe-nonexistent. Recibir una respuesta de no encontrado significa que DoorDash aceptó el token firmado con su developer_id, key_id y signing_secret, y solo rechazó esa entrega inventada.
Considere la prueba como aprobada y continúe con la activación. Solo una respuesta 401 o 403, informada como AUTH_FAILED, significa que la prueba realmente falló.
La prueba falla con AUTH_FAILED, 401 o 403
DoorDash rechazó el token firmado, lo que significa que uno de los tres valores no coincide: developer_id, key_id o signing_secret se copió mal, o el Signing Secret que pegó no pertenece al Key ID que pegó: los dos son un par emitido junto en la página Credentials.
Vuelva a DoorDash Developer Portal → página Credentials y copie de nuevo los tres valores de esa misma página: Developer ID en developer_id, Key ID en key_id y el Signing Secret que pertenece a ese Key ID, completo, en signing_secret. Luego pruebe de nuevo.
La prueba se detiene antes de enviar nada porque falta una credencial
La prueba firma su token con los tres valores de credenciales, así que ni siquiera puede empezar cuando falta uno: sin developer_id, key_id y signing_secret juntos, no hay con qué firmar, y la prueba se detiene en lugar de enviar una solicitud que no puede tener éxito.
Complete los tres campos desde DoorDash Developer Portal → página Credentials, guarde la conexión y pruebe de nuevo. Pruebe sin credenciales solo si busca la comprobación simulada: guarde los valores reales para un resultado real.
Completé solo uno de los dos campos de ID externos y las recogidas no funcionan
El External Business ID y el External Store ID solo funcionan como un par. La dirección de una tienda registrada sustituye a la dirección de recogida solo cuando están los dos ID juntos: con un solo ID, la conexión no tiene una tienda registrada completa ni, si dejó la dirección vacía, ninguna dirección de recogida.
Elija una opción y complétela: o complete AMBOS campos, pickup_external_business_id y pickup_external_store_id, para la tienda registrada, o borre los dos campos de ID y complete pickup_address con la dirección de recogida en una línea. Luego cotice de nuevo.
La prueba pasa, pero crear una entrega falla en el lado de la recogida
La prueba de conexión solo demuestra las credenciales: firma un token y consulta una entrega que no existe. No comprueba su dirección de recogida ni su par de ID externos, por lo que una dirección ausente, un par de ID incompleto o un par de ID de una tienda no registrada puede pasar la prueba y aparecer solo cuando una cotización o entrega real intenta usar esa recogida.
Revise la opción de recogida en la conexión: pickup_address completo como dirección en una línea, o los dos campos de ID externos completos para una tienda registrada en DoorDash, sin mezclar y sin un solo ID. Corríjalo, guarde y vuelva a cotizar antes de crear la entrega.
El repartidor va al lugar equivocado o no localiza a nadie en la recogida
El repartidor sigue lo que la conexión envía para la recogida: la dirección de recogida (o la tienda registrada detrás de su par de ID externos), el pickup_business_name mostrado para la recogida y el pickup_phone_number al que el repartidor puede llamar. Si alguno de esos datos es incorrecto o falta, el repartidor recibe el lugar equivocado, el nombre equivocado o un número que no funciona.
Corrija los campos de recogida en la conexión: la dirección de recogida o el par de ID de la tienda registrada, pickup_business_name con el nombre que el personal de la recogida reconocerá y pickup_phone_number con un número que se atienda en el horario de recogida. Guarde y los valores corregidos se usarán en la siguiente entrega: las entregas ya creadas conservan los datos de recogida con los que se crearon.