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.
No XPRIO, chama-se estafeta parceiro. 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. O 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, o XPRIO mostra-lhe o preço com IVA de uma viagem típica.
O pagamento online é obrigatório. Um estafeta parceiro não recebe nada. Os modos de estafeta parceiro 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). O 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. O 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 no 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 ao XPRIO
No XPRIO, menu esquerdo, abra Configuração da Aplicação e depois Estafetas parceiros.
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. O XPRIO liga-se à Stuart, verifica que 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, o XPRIO relê o estado de cada viagem a cada 20 segundos: funciona. Com ele, a Stuart avisa o XPRIO instantaneamente a cada alteração (estafeta atribuído, posição, pedido recolhido, entregue).
No 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 o XPRIO rejeita os eventos). Em Chave de autenticação, cole a mesma chave que no XPRIO. Marque todos os eventos V2 (job, delivery, driver). Guarde.
O cartão Stuart no XPRIO passa a «Notificações em tempo real ativas» na primeira viagem.
Passo 5: escolher o modo de cada estabelecimento
No XPRIO, menu Estabelecimentos, abra a ficha do estabelecimento (Editar) e depois o separador Entrega e Serviços.
Verifique que o serviço Entrega está ativo.
Na secção Quem entrega os seus pedidos, escolha:
Os meus estafetas: nada muda.
Os meus estafetas + estafeta parceiro de reforço: os seus estafetas têm prioridade; um botão Chamar um estafeta parceiro aparece em cada pedido de entrega pago online enquanto nenhum estafeta estiver atribuído. Opção Chamar automaticamente um estafeta parceiro se nenhum estafeta aceitar o pedido, com um prazo de 5 a 30 minutos após «pronto».
Apenas estafeta parceiro: 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 parceiro», 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 parceiro 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 parceiro 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 parceiro», 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.
Artigos relacionados