Central de ajuda

Visão geral

O Carga Entregue registra e comprova as entregas da sua empresa. Cada carga é uma lista de entregas (notas fiscais ou pedidos) atribuída a um entregador. O entregador confirma cada entrega no aplicativo, com o nome e o CPF de quem recebeu, a localização GPS e, conforme as regras da sua empresa, foto e assinatura. Você acompanha tudo em tempo real no painel web.

Conceitos

Carga

Conjunto de entregas de um entregador, identificado pelo código da carga do seu sistema (único na sua empresa). Fica Ativa enquanto houver entregas pendentes e passa a Concluída sozinha quando todas são realizadas (ou quando você a fecha à mão).

Entrega

Um documento (NF ou pedido) para um destinatário. Fica Aguardando até o entregador confirmar; depois fica Realizada, como Completa, Parcial ou Devolução.

Tentativa

Quando o entregador não consegue entregar (destinatário ausente, endereço não encontrado…), registra uma tentativa com o motivo. A entrega continua pendente.

Comprovante

Página pública com os dados da entrega, foto, assinatura e mapa, que pode ser compartilhada por link ou baixada em PDF.

APP_KEY

Chave da sua empresa para a integração por API. Fica em Configurações.

Primeiros passos

Painel da empresa

No topo do painel ficam os menus Início, Cargas, Pesquisar Entregas, Configurações, Ajuda e o nome da sua empresa (com Alterar Senha e Desconectar).

Início (cargas ativas)

Mostra um cartão para cada carga ativa e para as concluídas nos últimos 7 dias. Cada cartão tem:

• o código da carga, o entregador e a data de criação;
• o total de entregas e a barra de progresso;
• quantas foram realizadas e quantas estão em andamento;
• o selo Concluída quando todas foram feitas.

Clique no cartão para abrir o detalhe. O botão Atualizar recarrega a lista sem sair da página.

Detalhe da carga

À esquerda ficam as entregas da carga, em ordem; à direita, o mapa com o ponto de cada entrega realizada (clique no marcador para ver data, destinatário e cidade). Cada entrega mostra um círculo aguardando ou realizada. Clique nela para ver:

• endereço, data da entrega, nome e CPF de quem recebeu, motivo (parcial/devolução) e observações;
• a foto do comprovante e a assinatura (clique na foto para ampliar);
• o histórico de tentativas sem sucesso, com data, motivo, observação e foto;
• os botões Abrir comprovante e Copiar link, para enviar o comprovante ao cliente.

Selos que podem aparecer ao lado da entrega:

Ações da carga (botões no topo):

• Exportar CSV — planilha com todas as entregas desta carga (ver Exportar CSV).
• Fechar carga — conclui a carga à mão, mesmo com entregas pendentes. As pendentes saem do app do entregador e, se houver webhook, o seu sistema recebe o evento carga_concluida com o número de pendentes.
• Reabrir carga — volta a deixá-la ativa; as pendentes reaparecem no app e o entregador é notificado.
• Trocar entregador — informe o celular (com DDD) de outro entregador já cadastrado no app. O novo recebe uma notificação; as pendentes saem do app do anterior. Entregas que o anterior fez e ainda não sincronizou deixam de ser aceitas.

Histórico de cargas

Em Cargas você consulta todas as cargas, 20 por página, filtrando por:

• De / Até — período da data de criação;
• Situação — Todas, Ativas ou Concluídas;
• Código da carga — o código enviado pelo seu sistema.

A lista mostra data de início e de fim, entregador, entregas realizadas/total e situação. Clique no código para abrir a carga ou no ícone para baixar o CSV dela.

Pesquisar entregas

Encontre uma entrega em qualquer carga digitando pelo menos 3 caracteres do documento / NF, do nome do destinatário ou do CPF/CNPJ. O resultado mostra a situação (tipo, data e recebedor, ou as tentativas), a carga e um atalho para o comprovante. O botão Exportar CSV baixa o resultado da pesquisa.

Exportar CSV

O arquivo usa ponto e vírgula (;) como separador e abre direto no Excel com acentos corretos. Colunas:

Carga · Código · Ordem · Documento · Destinatário · CNPJ/CPF · Endereço · Número · Bairro · Cidade · UF · Situação · Tipo · Motivo · Recebedor · CPF recebedor · Data entrega · GPS · Distância (m) · Tentativas · Observações · Comprovante (link)

Configurações

Clique em Gravar no fim da página para aplicar as alterações.

Comprovante na app do entregador

• Assinatura do recebedor obrigatória — o app só deixa confirmar depois de o recebedor assinar na tela.
• Foto do comprovante obrigatória — o app exige a foto (canhoto, mercadoria, fachada…).
• Distância máxima do endereço (metros, padrão 500) — se o GPS do entregador estiver mais longe que isso do endereço, o app pede o motivo nas observações e o painel marca a entrega com o selo vermelho.

Aviso ao destinatário

• Enviar email — o destinatário recebe um email com o link do comprovante (quando a carga traz o email).
• WhatsApp — serviço extra; o painel mostra se está contratado. Ver Aviso ao destinatário.

Integração com o seu sistema

• APP_KEY — chave usada pela API. Gerar nova chave invalida a atual na hora: atualize o seu sistema logo em seguida.
• URL do webhook — endereço do seu sistema que recebe os eventos. Vazio = sem webhook.
• Segredo da assinatura — usado para assinar cada aviso (botão Gerar cria um aleatório). Ver Webhook.

Dados pessoais (LGPD)

• Guardar fotos, assinaturas e CPF durante 6, 12 (padrão), 24, 36 ou 60 meses. Depois do prazo esses dados são apagados automaticamente. Ver Privacidade e retenção.

Senha e saída

• Alterar Senha — no menu com o nome da empresa. Informe a senha atual e a nova duas vezes (mínimo de 6 caracteres).
• Desconectar — encerra a sessão neste navegador.
• Lembrar meu login (tela de entrada) — guarda só o CNPJ por 3 meses; a senha nunca fica guardada.
• Esqueceu a senha? Fale com o suporte.

App do entregador

O aplicativo Carga Entregue funciona em Android e iOS. Esta parte do manual pode ser repassada aos entregadores.

Instalação e cadastro

Esqueceu a senha? Use a opção de nova senha no app: ele envia outro código por WhatsApp. Os dados do cadastro podem ser alterados em Meus Dados.

Entrar e sincronizar

• Entre com celular e senha. Nas vezes seguintes pode usar a biometria ou o PIN do aparelho.
• Ao abrir e ao tocar em sincronizar, o app envia as entregas já confirmadas e baixa as novas.
• As entregas aparecem separadas por empresa e na ordem definida na carga.
• A aba de realizadas mostra as entregas dos últimos 7 dias.
• Se o app pedir atualização, instale a versão mais recente na loja: versões muito antigas são bloqueadas.

Confirmar uma entrega

Não foi possível entregar

Na entrega, toque em Não foi possível entregar, escolha o motivo e, se quiser, tire uma foto e escreva uma observação. Motivos: Destinatário ausente, Endereço não encontrado, Recusado, Estabelecimento fechado, Mercadoria avariada e Outro (exige observação). A entrega continua pendente para uma nova tentativa, e a empresa vê o histórico no painel.

Sem internet

O app funciona offline: as confirmações e tentativas ficam guardadas no celular e são enviadas na próxima sincronização com internet. Nada pendente é apagado. No painel, as que chegam com mais de 2 horas de atraso recebem o selo offline. Ao trocar de entregador no mesmo celular, o app primeiro envia as pendentes do anterior.

Notificações

No Android, o entregador recebe uma notificação quando chega uma carga nova, quando uma carga é passada para ele, retirada dele ou reaberta. Ao tocar na notificação, o app sincroniza. No iOS, por enquanto, é preciso abrir o app e sincronizar.

Comprovante digital

Cada entrega realizada ganha um link público e permanente, no formato https://cargaentregue.com.br/c.php?t=…. A página mostra:

• empresa remetente, documento e destinatário;
• tipo de entrega, data e hora, nome do recebedor e CPF mascarado;
• foto, assinatura e mapa do local;
• o botão para baixar em PDF.

O link está no painel (Abrir comprovante / Copiar link), no CSV, na API (comprovante_url), no webhook e no aviso enviado ao destinatário. Quem não tem o link não consegue ver as fotos. Se a entrega for reenviada pelo app, o link continua o mesmo.

Aviso ao destinatário

Quando a entrega é realizada, o destinatário pode ser avisado com o link do comprovante:

• Email (incluído) — ligado por padrão em Configurações. Enviado de nao-responder@cargaentregue.com.br; se o destinatário responder, a resposta vai para o email da sua empresa.
• WhatsApp (serviço extra) — ativado pela MendesSoft a pedido da empresa.

Para o aviso funcionar, a carga precisa trazer destinatario_email e/ou destinatario_celular em cada entrega (ver Enviar carga). O WhatsApp só é enviado para entregas dos últimos 2 dias.

Integração (API)

A API usa JSON sobre HTTPS no endereço base https://cargaentregue.com.br/api/v1/. A autenticação é feita pela APP_KEY da sua empresa, que você copia em Configurações. Guarde-a só no servidor do seu sistema (nunca em páginas web ou apps de clientes).

Enviar carga — POST inserircarga.php

Envie o JSON no corpo da requisição (Content-Type: application/json). O entregador já precisa estar cadastrado no app com o celular informado.

Exemplo:

curl -X POST https://cargaentregue.com.br/api/v1/inserircarga.php \
  -H "Content-Type: application/json" \
  -d '{
  "app_key": "SUA_APP_KEY",
  "carga_codigo": "12345",
  "entregador_celular": "11998765432",
  "entregas": [
    {
      "codigo": 999,
      "ordem": 1,
      "documento": "45004/001",
      "destinatario": "Mercado Exemplo Ltda",
      "cnpj_cpf": "12345678000199",
      "endereco": "Rua das Flores",
      "numero": "120",
      "bairro": "Centro",
      "complemento": "Loja 2",
      "cidade": "Mirassol",
      "sigla_uf": "SP",
      "destinatario_celular": "17998765432",
      "destinatario_email": "compras@exemplo.com.br"
    }
  ]
}'

Resposta de sucesso:

{"status": "succsess", "code": "INSERT_SUCCESS", "message": "Itens inseridos com sucesso. Total: 1"}

Consultar situação — GET status.php

Parâmetros: app_key, carga_codigo e, opcionalmente, codigo para devolver só uma entrega.

GET https://cargaentregue.com.br/api/v1/status.php?app_key=SUA_APP_KEY&carga_codigo=12345

{
  "status": "success",
  "code": "OK",
  "message": "Situação da carga",
  "carga": {
    "carga_codigo": "12345",
    "situacao": "concluida",          // ativa | concluida
    "data_inicio": "2026-10-28 08:00",
    "data_fim": "2026-10-28 17:40",   // null enquanto ativa
    "total_entregas": 1,
    "realizadas": 1,
    "entregas": [
      {
        "codigo": 999,
        "ordem": 1,
        "documento": "45004/001",
        "destinatario": "Mercado Exemplo Ltda",
        "status": "R",                // A aguardando | R realizada
        "tipo_entrega": "C",          // C completa | P parcial | D devolução
        "recebedor_nome": "Ana Paula",
        "recebedor_cpf": "12345678909",
        "data_entrega": "2026-10-28 16:14",
        "localizacao": "-20.8186, -49.5208",
        "observacoes": null,
        "foto_url": "https://cargaentregue.com.br/img.php?t=…&f=…",
        "comprovante_url": "https://cargaentregue.com.br/c.php?t=…",
        "assinatura_url": "https://cargaentregue.com.br/img.php?t=…&f=…",
        "distancia_m": 35,            // distância entre o GPS e o endereço
        "motivo_id": null,            // motivo da parcial / devolução
        "motivo": null,
        "tentativas": 0,
        "historico_tentativas": []    // mesmo formato do evento tentativa_falhada
      }
    ]
  }
}

Webhook

Com o URL configurado, enviamos um POST com JSON para o seu sistema logo depois de o app sincronizar. Eventos:

Cabeçalhos enviados:

Content-Type: application/json
X-CargaEntregue-Evento: entrega_realizada | tentativa_falhada | carga_concluida
X-CargaEntregue-Assinatura: sha256=<HMAC-SHA256 do corpo com o seu segredo, em hex>

Exemplos de corpo:

{
  "evento": "tentativa_falhada",
  "carga_codigo": "12345",
  "codigo": 999,
  "documento": "45004/001",
  "destinatario": "Mercado Exemplo Ltda",
  "tentativa_numero": 1,
  "motivo_id": 1,
  "motivo": "Destinatário ausente",
  "data": "2026-10-28 11:40",
  "localizacao": "-20.8186, -49.5208",
  "observacoes": "Portaria fechada",
  "foto_url": null
}

{
  "evento": "carga_concluida",
  "carga_codigo": "12345",
  "data_inicio": "2026-10-28 08:00",
  "data_fim": "2026-10-28 17:40",
  "total_entregas": 2,
  "completas": 1,
  "parciais": 0,
  "devolucoes": 1,
  "pendentes": 0
}

Responda com HTTP 2xx em até 15 segundos. Qualquer outra resposta (ou falta de resposta) faz o aviso ser reenviado a cada 5 minutos, até 10 tentativas. Como pode haver reenvio, trate o mesmo evento recebido duas vezes sem duplicar (use carga_codigo + codigo, ou tentativa_numero).

Confira a assinatura antes de aceitar o aviso (exemplo em PHP):

$corpo = file_get_contents('php://input');
$esperada = 'sha256=' . hash_hmac('sha256', $corpo, $segredo);
if (!hash_equals($esperada, $_SERVER['HTTP_X_CARGAENTREGUE_ASSINATURA'] ?? '')) {
    http_response_code(401);
    exit;
}
$evento = json_decode($corpo, true);
// ... grave o evento ...
http_response_code(200);

Códigos de erro

Em erro, a resposta tem "status": "error", um code e uma message:

Privacidade e retenção (LGPD)

• A sua empresa é a controladora dos dados das entregas; a MendesSoft atua como operadora.
• As fotos, assinaturas e o CPF do recebedor são apagados automaticamente no fim do prazo escolhido em Configurações (12 meses por padrão). O restante do histórico continua disponível.
• Fotos e assinaturas não ficam em pasta pública: só são mostradas no painel ou a quem tem o link do comprovante.
• O comprovante público mostra o CPF do recebedor só parcialmente.

Leia a Política de Privacidade completa.

Perguntas frequentes

Suporte

O Carga Entregue é desenvolvido pela MendesSoft. Para dúvidas, acesso, contratação do aviso por WhatsApp ou ajuda com a integração, entre em contato pelo site da MendesSoft.

Pedidos sobre dados pessoais: privacidade@cargaentregue.com.br.