Conectar o DoorDash Drive: cotar, despachar e rastrear entregas locais

Copie Developer ID, Key ID e Signing Secret da página Credentials do DoorDash Developer Portal, escolha uma opção de coleta no Integration (um endereço de coleta, ou o par External Business ID mais External Store ID), teste e comece a pedir entregas do DoorDash Drive.

O conector do DoorDash pede entregas locais do DoorDash Drive a partir deste sistema: obtém uma cotação, cria uma entrega, consulta o status e pode cancelar uma entrega. É apenas uma conexão de entrega de última milha: não traz pedidos do marketplace do DoorDash para este sistema nem sincroniza menus ou catálogos de loja. Cotações e entregas correm com sua própria conta do DoorDash Drive e seu ponto de coleta.

Pré-requisitos#

• Uma conta do DoorDash Drive e acesso ao DoorDash Developer Portal, onde a página Credentials mostra seu Developer ID, Key ID e Signing Secret.
• Você sabe como identificar a coleta: ou o endereço de coleta em uma linha da sua loja ou armazém, ou uma loja já registrada no DoorDash, nomeada com seu External Business ID e seu External Store ID. O endereço e o par de ID são alternativas: decida qual vai usar antes de começar.
• O nome do negócio de coleta e um telefone para o entregador ligar na coleta, se quiser exibi-los: por exemplo, o nome da loja e sua linha direta.

Obter credenciais#

1. Entre no DoorDash Developer Portal e abra a página Credentials.
2. Copie o Developer ID exibido nessa página. Ele identifica sua conta de desenvolvedor e é um dos três valores com os quais a conexão assina as solicitações.
3. Copie o Key ID exibido na mesma página Credentials.
4. Copie completo o Signing Secret exibido na mesma página Credentials. O Key ID e o Signing Secret pertencem juntos como um par, e o Signing Secret é um valor em base64 que a conexão usa para assinar um token de curta duração em cada solicitação: copie-o da mesma página do Key ID, não de outro par de chaves.

Preencher no Integration#

1. Abra Integration → Marketplace → DoorDash → Nova conexão.
2. developer_id, obrigatório, Developer ID: cole o Developer ID de DoorDash Developer Portal → página Credentials.
3. key_id, obrigatório, Key ID: cole o Key ID da mesma página Credentials.
4. signing_secret, obrigatório, Signing Secret: cole completo o Signing Secret da mesma página Credentials. É um campo do tipo senha e é guardado como segredo.
5. Agora escolha UMA opção de coleta. Opção A, o endereço: preencha pickup_address com o endereço de coleta em uma linha da sua loja ou armazém, por exemplo 901 Market Street, San Francisco, CA 94103, US, e deixe vazios os dois campos de ID externos.
6. Opção B, uma loja registrada: deixe pickup_address vazio e preencha AMBOS os campos, pickup_external_business_id (External Business ID) e pickup_external_store_id (External Store ID), com os ID da loja registrada no DoorDash. Os dois ID devem ser sempre preenchidos juntos como um par: preencher só um não funciona, porque o endereço de uma loja registrada só substitui o endereço de coleta quando os dois ID estão presentes.
7. pickup_business_name, opcional, nome do negócio de coleta: o nome exibido ao entregador para a coleta, por exemplo o nome da sua loja. pickup_phone_number, opcional, telefone de coleta: um número para o entregador ligar na coleta, por exemplo +16505550100.
8. user_agent, opcional, User-Agent: na maioria dos casos, deixe vazio; a conexão usará seu valor padrão, Docklify/1.0.

Testar a conexão#

Clique em Testar a conexão. O teste primeiro verifica se os três valores de credenciais estão presentes (developer_id, key_id e signing_secret) e para sem enviar nenhuma solicitação se algum estiver ausente. Com os três presentes, ele assina um token de curta duração (cinco minutos) a partir dos três valores e o usa para buscar uma entrega que não existe: docklify-probe-nonexistent. A DoorDash responder 404 é a aprovação: significa que o token assinado foi aceito e que só falta aquela entrega inventada, então o resultado esperado deste teste é um 404, não um erro para corrigir. Uma resposta 401 ou 403 é informada como AUTH_FAILED e é a falha real: a DoorDash rejeitou o token assinado. Se você executar o teste antes de salvar credenciais, o resultado é apenas uma verificação simulada: salve as credenciais reais e teste de novo para um resultado real. O teste não cria nenhuma entrega nem verifica seu endereço de coleta nem seu par de ID externos, então uma configuração de coleta errada pode passar no teste e só falhar depois, na cotação ou na criação da entrega.

Mapping / escolher modelo#

O DoorDash Drive não precisa de mapping de pedidos: trabalha com entregas, não com pedidos. O que você confirma aqui é a configuração de coleta da etapa de preencher, mais os campos de entrega que cada solicitação leva: a coleta vem do seu pickup_address ou da sua loja registrada (External Business ID mais External Store ID), e cada solicitação de entrega usa o endereço de destino, o contato e os itens do envio deste sistema. Antes de ativar, crie uma cotação real e uma entrega de teste para seu próprio endereço e compare o nome de coleta, o telefone de coleta e os dados de destino com o envio.

Ativar#

Após ativar, os envios deste sistema podem pedir entregas do DoorDash Drive: a conexão cota a entrega, a cria depois que a cotação é aceita, mantém o status da entrega no envio e pode cancelar uma entrega que ainda não foi coletada. Acompanhe as primeiras entregas reais em Runs / Logs e compare os dados de coleta e destino com o DoorDash antes de deixar a conexão sem supervisão.

O que esta conexão não faz: não traz pedidos do marketplace do DoorDash para este sistema, não sincroniza menus nem catálogos de loja e não acerta pagamentos de entregadores nem o faturamento do DoorDash por você. Ela só cota, cria, rastreia e cancela entregas do DoorDash Drive para os envios que você passar por ela.

Perguntas frequentes#

O teste menciona 404: falhou?

Não: para o DoorDash Drive, esse 404 é o sinal de sucesso. O teste busca de propósito uma entrega que não existe, docklify-probe-nonexistent. Receber uma resposta de não encontrado significa que a DoorDash aceitou o token assinado com seu developer_id, key_id e signing_secret, e só rejeitou aquela entrega inventada.

Considere o teste como aprovado e continue para a ativação. Somente uma resposta 401 ou 403, informada como AUTH_FAILED, significa que o teste realmente falhou.

O teste falha com AUTH_FAILED, 401 ou 403

A DoorDash rejeitou o token assinado, o que significa que um dos três valores não corresponde: developer_id, key_id ou signing_secret foi copiado errado, ou o Signing Secret que você colou não pertence ao Key ID que colou: os dois são um par emitido junto na página Credentials.

Volte ao DoorDash Developer Portal → página Credentials e copie de novo os três valores dessa mesma página: Developer ID em developer_id, Key ID em key_id e o Signing Secret que pertence àquele Key ID, completo, em signing_secret. Depois teste de novo.

O teste para antes de enviar qualquer coisa porque falta uma credencial

O teste assina seu token com os três valores de credenciais, então nem consegue começar quando falta um: sem developer_id, key_id e signing_secret juntos, não há com o que assinar, e o teste para em vez de enviar uma solicitação que não pode ter sucesso.

Preencha os três campos a partir do DoorDash Developer Portal → página Credentials, salve a conexão e teste de novo. Teste sem credenciais só se quiser a verificação simulada: salve os valores reais para um resultado real.

Preenchi só um dos dois campos de ID externos e as coletas não funcionam

O External Business ID e o External Store ID só funcionam como um par. O endereço de uma loja registrada só substitui o endereço de coleta quando os dois ID estão juntos: com um só ID, a conexão não tem uma loja registrada completa nem, se você deixou o endereço vazio, nenhum endereço de coleta.

Escolha uma opção e complete-a: ou preencha AMBOS os campos, pickup_external_business_id e pickup_external_store_id, para a loja registrada, ou apague os dois campos de ID e preencha pickup_address com o endereço de coleta em uma linha. Depois cote de novo.

O teste passa, mas criar uma entrega falha no lado da coleta

O teste de conexão só demonstra as credenciais: assina um token e consulta uma entrega que não existe. Ele não verifica seu endereço de coleta nem seu par de ID externos, então um endereço ausente, um par de ID incompleto ou um par de ID de uma loja não registrada pode passar no teste e só aparecer quando uma cotação ou entrega real tenta usar aquela coleta.

Confira a opção de coleta na conexão: pickup_address preenchido como endereço completo em uma linha, ou os dois campos de ID externos preenchidos para uma loja registrada no DoorDash, sem misturar e sem um ID só. Corrija, salve e cote de novo antes de criar a entrega.

O entregador vai ao lugar errado ou não encontra ninguém na coleta

O entregador segue o que a conexão envia para a coleta: o endereço de coleta (ou a loja registrada por trás do seu par de ID externos), o pickup_business_name exibido para a coleta e o pickup_phone_number para o entregador ligar. Se algum desses dados estiver errado ou ausente, o entregador recebe o lugar errado, o nome errado ou um número que não funciona.

Corrija os campos de coleta na conexão: o endereço de coleta ou o par de ID da loja registrada, pickup_business_name com o nome que a equipe da coleta vai reconhecer e pickup_phone_number com um número atendido no horário da coleta. Salve e os valores corrigidos serão usados na próxima entrega: entregas já criadas mantêm os dados de coleta com os quais foram criadas.