Entregar com um estafeta Stuart

A Stuart coloca à sua disposição os seus estafetas independentes, sem passar por uma plataforma de pedidos: o cliente encomenda na sua app, em seu nome, e a Stuart fornece apenas o estafeta. Paga cada viagem à tarifa Stuart, sem comissão sobre as suas vendas.

Na XPRIO, chama-se estafeta a pedido. Liga-o uma vez para a sua empresa e decide depois, estabelecimento a estabelecimento, se entrega todos os pedidos ou apenas reforça os seus próprios estafetas.

O que deve saber antes de começar

A conta Stuart é sua. Cria-a na Stuart, e é a Stuart que lhe fatura cada viagem. A XPRIO não cobra nada.
O cliente paga a sua taxa de entrega, a do seu estabelecimento, cobrada com o pedido. O custo da viagem Stuart é faturado à parte, consoante a distância, o tamanho da encomenda e a hora. Se a sua taxa for inferior à viagem, a diferença fica por sua conta; se for superior, fica para si. Depois de ligado, a XPRIO mostra-lhe o preço com IVA de uma viagem típica.
O pagamento online é obrigatório. Um estafeta a pedido não recebe nenhum pagamento. Os modos de estafeta a pedido só ficam disponíveis quando o pagamento por cartão online (Stripe) está configurado na sua app. Configurar os seus métodos de pagamento
Países cobertos: França, Reino Unido e Polónia, nas grandes cidades onde a Stuart opera (129 cidades em 2025). A XPRIO só propõe a Stuart para os estabelecimentos destes países, e verifica cada morada no carrinho.
Deve haver um cartão bancário registado na Stuart antes da primeira viagem, incluindo na conta de teste. Sem cartão, a Stuart recusa criar a entrega.
Sem código de entrega com a Stuart: a prova de entrega é a do estafeta Stuart (assinatura ou fotografia).
Um cancelamento pode ser cobrado depois de um estafeta estar atribuído. A XPRIO avisa-o antes de confirmar.

Passo 1: abrir as suas contas Stuart

A Stuart disponibiliza dois painéis, com um registo separado para cada um:

Conta de teste em dashboard.sandbox.stuart.com: viagens simuladas, nada faturado, disponível de imediato. É aí que fará os seus ensaios.
Conta real em dashboard.stuart.com: peça a abertura em stuart.com (botão Tornar-se cliente ou equivalente). A Stuart liga-lhe para validar a sua atividade e abre-lhe depois o acesso.

Em ambos os casos, depois de iniciar sessão:

Clique no seu avatar no canto superior direito e depois em A minha conta.
No menu esquerdo, clique em Faturação e registe um cartão bancário. Na conta de teste, qualquer cartão de teste serve (exceto American Express), por exemplo 4242 4242 4242 4242 com uma data de validade futura e um código de três algarismos. Na conta real, o seu cartão real ou os seus dados de faturação conforme o contrato.

Passo 2: obter as suas chaves

Em A minha conta, menu esquerdo, clique em API.
Se a página mostrar Sem credenciais de API, clique em Gerar agora.
A secção Credenciais API mostra três linhas, cada uma com um ícone de cópia:
- ID de cliente: uma longa sequência de carateres (é o «Client ID»).
- Chave secreta API: outra longa sequência (é o «Client secret»). Não a partilhe com ninguém.
- ID de conta Stuart: um número de seis algarismos. Não vai precisar dele na XPRIO.

Os valores aparecem truncados no ecrã: use sempre o ícone de cópia, nunca a seleção com o rato. A conta de teste e a conta real têm cada uma as suas próprias chaves.

Passo 3: ligar a Stuart à XPRIO

Na XPRIO, menu esquerdo, abra Configuração da Aplicação e depois Estafetas a pedido.
No cartão Stuart, clique em Ligar.
Em Ambiente, escolha Teste para as chaves da conta de teste, Produção para as da conta real.
Cole o ID de cliente em Client ID e a Chave secreta API em Client secret. O ícone de olho permite mostrar o segredo para verificar.
Deixe Chave de autenticação dos webhooks vazia por agora (passo 4).
Clique em Guardar e testar. A XPRIO liga-se à Stuart, verifica se a morada do seu estabelecimento é servida e pede um orçamento de teste. Se o cartão passar a Ligado (teste) ou Ligado (produção), está feito. Caso contrário, uma mensagem vermelha reproduz a resposta da Stuart: chaves incompletas, ou estabelecimento fora das zonas Stuart.

Depois de ligado, o cartão mostra «Viagem típica a partir do seu estabelecimento (cerca de 1,5 km)» com o preço real com IVA devolvido pela Stuart.

Passo 4: ativar as notificações em tempo real (recomendado)

Sem este passo, a XPRIO relê o estado de cada viagem a cada 20 segundos: funciona. Com ele, a Stuart avisa a XPRIO instantaneamente a cada alteração (estafeta atribuído, posição, pedido recolhido, entregue).

Na XPRIO, reabra a janela Stuart (Editar no cartão). Copie o URL de notificação a declarar no fornecedor.
Ainda nesta janela, invente uma chave longa (por exemplo 20 carateres sem espaços), cole-a em Chave de autenticação dos webhooks e clique em Guardar e testar.
No painel Stuart, A minha conta, API: por baixo da secção Credenciais, a secção Webhooks mostra Sem Webhooks. Clique em + Adicionar um novo endpoint.
Cole o URL em URL do webhook. Em Cabeçalho de autenticação, escreva exatamente Authentication-Key (sem este nome, a Stuart não envia a chave e a XPRIO rejeita os eventos). Em Chave de autenticação, cole a mesma chave que na XPRIO. Marque todos os eventos V2 (job, delivery, driver). Guarde.

O cartão Stuart na XPRIO passa a «Notificações em tempo real ativas» na primeira viagem.

Passo 5: escolher o modo de cada estabelecimento

Na XPRIO, menu Estabelecimentos, abra a ficha do estabelecimento (Editar) e depois o separador Entrega e Serviços.
Verifique se o serviço Entrega está ativo.
Na secção Quem entrega os seus pedidos, escolha:
- Os meus estafetas: nada muda.
- Os meus estafetas + estafeta a pedido de reforço: os seus estafetas têm prioridade; um botão Chamar um estafeta a pedido aparece em cada pedido de entrega pago online enquanto nenhum estafeta estiver atribuído. Opção Chamar automaticamente um estafeta a pedido se nenhum estafeta aceitar o pedido, com um prazo de 5 a 30 minutos após «pronto».
- Apenas estafeta a pedido: cada pedido de entrega é confiado automaticamente ao estafeta Stuart, no momento que escolher (Quando pedir o estafeta). O cliente só vê o pagamento online.
Se os cartões parceiro estiverem a cinzento com «Pagamento online obrigatório», ative primeiro o Stripe em Configuração da Aplicação, Métodos de Pagamento.
Escolha Stuart em Fornecedor.
Em modo «apenas estafeta a pedido», escolha a taxa cobrada ao cliente: As minhas taxas fixas ou O preço do estafeta (+ margem). Em modo reforço, o cliente paga sempre as suas taxas fixas.
Se necessário, adicione instruções de recolha para o estafeta e decida se a gorjeta do cliente é transferida ao estafeta. Guarde.

No Live e do lado do cliente

No pedido, o bloco Estafeta a pedido mostra o estafeta Stuart a partir da atribuição, o telefone, a etapa (Estafeta a caminho, Estafeta no estabelecimento, Recolhido, No cliente, Entregue) e a hora estimada de chegada. Antes de pedir, a janela de confirmação mostra-lhe o custo da viagem com IVA.

O pedido passa a Em entrega quando o estafeta o recolhe e a Entregue na entrega, sem intervenção. Pode cancelar o estafeta enquanto ele não tiver recolhido o pedido. Em caso de cancelamento pela Stuart ou de devolução do pedido, recebe uma notificação, um som e uma mensagem no Live, e pode pedir outro estafeta ou atribuir um dos seus.

Na sua app, o cliente vê um cartão de contacto Estafeta a pedido com o nome do estafeta, um botão de chamada, uma ligação de acompanhamento e a posição em tempo real no mapa. Num estabelecimento em modo «apenas estafeta a pedido», o carrinho mostra apenas o pagamento por cartão.

Perguntas frequentes

Posso testar sem uma viagem real? Sim, com a conta de teste ligada no ambiente Teste. No painel de teste, o separador Cenário ideal permite fazer avançar uma viagem simulada passo a passo e ver o resultado no Live.

A Stuart recusa a viagem com um erro de pagamento? Não há nenhum cartão registado em Faturação dessa conta, ou está expirado. Adicione um e tente de novo.