# 4.11 Lalamove

> Como conectar a conta da Lalamove ao Cota Frete para oferecer entrega no mesmo dia: chaves de API, endereço de coleta, veículos, cobertura e o que a integração faz e não faz.

Fonte: https://www.cotafrete.app/manual/transportadoras/lalamove/
Planos: Widget, Basic, Business · no checkout, requer o Carrier Calculated Shipping (CCS) da Shopify
No app: Transportadoras → Lalamove
Atualizado em 25/10/2026

---

A Lalamove é um serviço de entrega no mesmo dia. Um entregador da Lalamove coleta no seu endereço e entrega dentro da mesma região metropolitana, de moto, carro, utilitário, van ou caminhão. Faz sentido para a loja com estoque na capital que quer oferecer entrega hoje sem manter um motoboy próprio.

A Lalamove funciona diferente das transportadoras com coleta agendada. Vale ler a seção [O que a integração faz e o que não faz](#faz-e-nao-faz) antes de ativar.

## Onde a Lalamove entrega

A Lalamove atende 15 cidades e suas regiões metropolitanas: Aracaju, Belém, Belo Horizonte, Brasília, Curitiba, Florianópolis, Fortaleza, Goiânia, Manaus, Porto Alegre, Ribeirão Preto, Rio de Janeiro, Salvador, São Luís e São Paulo (que inclui Campinas).

A entrega é sempre dentro do mesmo estado da coleta. Brasília e Goiânia contam como uma região só, então DF e GO se atendem. Um cliente de outro estado não recebe cotação da Lalamove, e isso é decidido antes de qualquer consulta: as outras transportadoras seguem normais.

## O que você precisa antes

Uma **conta empresarial na Lalamove**, criada em [partnerportal.lalamove.com](https://partnerportal.lalamove.com). Na aba **Developers** do portal ficam dois pares de chaves:

| Par de chaves | Para quê |
|---|---|
| **Sandbox** (`pk_test_` e `sk_test_`) | Disponível na hora. Serve para testar a conexão, mas as cotações vêm do ambiente de testes, não do preço real |
| **Production** (`pk_prod_` e `sk_prod_`) | Aparece depois que você adiciona saldo à carteira da Lalamove. É o par que a loja precisa |

Tenha também o **endereço completo de coleta**: CEP, logradouro, número, bairro, cidade e UF. A Lalamove calcula o frete pela distância entre esse endereço e o do cliente, então ele precisa estar certo.

## Conectando

1. Abra **Transportadoras → Lalamove**.
2. Cole a **API Key** e a **API Secret** da sua conta. A própria aba lembra onde encontrar: partnerportal.lalamove.com, aba Developers.
3. Em **Endereço de coleta**, informe o **CEP**, o **Logradouro**, o **Número**, o **Bairro**, a **Cidade** e a **UF**. Ao salvar, o app completa os campos em branco a partir do CEP; confira o resultado.
4. Em **Serviços do contrato**, ligue os veículos que fazem sentido para o seu produto.
5. Ligue o interruptor **Ativo**, no topo da aba.
6. Clique em **Salvar** na barra da Shopify.

Ao salvar, o app valida as chaves na Lalamove. Chave ou segredo errado marca a conta como inválida e desliga a transportadora até você corrigir. Se você colou chaves de sandbox, a aba avisa: "Chaves de sandbox: as cotações vêm do ambiente de testes da Lalamove."

O app também confere se a cidade do endereço de coleta está na lista da Lalamove. Se não estiver, aparece o aviso **Não confirmamos a cobertura da Lalamove em** (o nome da cidade). É um aviso, não um erro: as credenciais estão certas, e a Lalamove publica uma entrada por região metropolitana, então uma loja em Guarulhos pode receber o aviso e cotar normalmente. Se as cotações não aparecerem na loja, aí sim a região não é atendida.

> A seção **Endereço de coleta** some quando a origem da cotação são os perfis de entrega da Shopify (plano Business): nesse caso a coleta sai do endereço do perfil. Ao voltar para **CEPs das transportadoras**, o app desliga a Lalamove até você conferir o endereço e ligar de novo.

![Aba Lalamove com API Key, API Secret, endereço de coleta e veículos](https://www.cotafrete.app/manual/images/manual/transportadoras-lalamove.webp)

## Serviços: um por veículo

Cada serviço é um veículo. Só o **Lalamove Moto** vem ativo por padrão.

| Serviço | Carga máxima | Observação |
|---|---|---|
| Lalamove Moto (LalaGo) | 20 kg | Até 30 × 40 × 30 cm |
| Lalamove Moto Baú (LalaPro) | 20 kg | Só em São Paulo e Rio de Janeiro |
| Lalamove Carro Hatch | 200 kg | |
| Lalamove Carro | 300 kg | |
| Lalamove Utilitário | 500 kg | |
| Lalamove Van | 1.000 kg | |
| Lalamove Caminhão | 1.500 kg | |

O app só cota os veículos em que o pedido cabe, pelo peso do carrinho e pelas dimensões da caixa. Um pedido de 25 kg pula a moto e vai direto para o carro. Marcar vários veículos não faz mal: o cliente vê só os que servem, do mais barato ao mais caro.

O prazo aparece como **Entrega hoje**, porque a cotação da Lalamove é de coleta imediata. Se você precisa de tempo de separação, some dias com uma regra de [Acréscimo](https://www.cotafrete.app/manual/regras-de-frete/acrescimo/) só para a Lalamove.

## Teste

O app valida as chaves ao salvar. Para conferir a cotação, use o [Simular frete](https://www.cotafrete.app/manual/inicio/simular-frete/) com um CEP da sua cidade, ou abra um produto na loja. Cada cotação fica guardada por 5 minutos, então repetir o mesmo CEP em seguida devolve o mesmo valor.

## O que a integração faz e o que não faz {#faz-e-nao-faz}

- **O app cota.** O cliente vê preço e prazo da Lalamove na loja e escolhe no checkout como qualquer outro frete.
- **O app não chama o entregador.** Depois do pedido, você faz a solicitação no app ou no portal da Lalamove. Ao marcar o envio na Shopify, informe o **número do pedido Lalamove** como código de rastreio.
- **O app rastreia.** Com o número do pedido no envio, o Cota Frete consulta a Lalamove a cada 10 minutos e atualiza o pedido na Shopify, que avisa o cliente. Veja [Rastreamento automático](https://www.cotafrete.app/manual/pedidos/rastreamento-automatico/).
- **O valor pode mudar na hora do pedido.** A cotação do checkout é de coleta imediata. Quando você solicita o entregador, horas depois, a Lalamove cobra o preço daquele momento. A diferença costuma ser pequena, mas existe e fica por conta da loja.

## Dicas de configuração

- **Lalamove na cidade, outra transportadora no resto.** A Lalamove só cota dentro do estado. Mantenha uma transportadora nacional ativa.
- **Só em parte da região.** Para oferecer a Lalamove só na capital, crie uma regra de [Bloquear](https://www.cotafrete.app/manual/regras-de-frete/bloquear/) com as faixas de CEP de fora.
- **Motoboy próprio ou Lalamove?** Se você já tem entregador com preço fixo, os [Fretes Próprios](https://www.cotafrete.app/manual/fretes-proprios/entrega-local/) resolvem sem conta na Lalamove. A Lalamove compensa quando você não quer operar a entrega ou quando o volume varia. As duas podem conviver.

## No checkout

A cotação no checkout entra a partir do plano Basic e depende do Carrier Calculated Shipping (CCS, "cotação calculada pela transportadora") ativo na loja. Veja [Ativar o CCS na Shopify](https://www.cotafrete.app/manual/checkout/ativar-ccs/).
