Introdução
Bem-vindo à documentação da plataforma ZFrete! Esta documentação fornece todas as informações necessárias para usar nossa plataforma de forma eficiente.
O ZFrete é uma plataforma inteligente que conecta clientes que precisam de serviços de frete com parceiros qualificados, facilitando o processo de contratação e gestão de fretes.
Como Funciona
Para Clientes
- Cadastre-se gratuitamente na plataforma
- Crie uma solicitação de frete informando origem, destino e detalhes
- Receba propostas de parceiros próximos automaticamente
- Escolha o parceiro que melhor atende suas necessidades
- Acompanhe em tempo real o andamento do frete
- Avalie o serviço após a conclusão
Para Parceiros
- Cadastre-se como parceiro e aguarde aprovação
- Receba notificações de solicitações na sua região
- Aceite ou recuse as solicitações que desejar
- Execute o serviço e atualize o status
- Receba o pagamento após conclusão
- Saque seu saldo via PIX ou transferência
Para Clientes
Criando uma Solicitação
Para criar uma solicitação de frete:
- Acesse o dashboard após fazer login
- Clique em "Nova Solicitação" ou "Novo Frete"
- Preencha os dados:
- Origem e destino
- Tipo de serviço (reboque, transporte, mudança, etc.)
- Detalhes do veículo/carga
- Método de pagamento
- Envie a solicitação
💡 Dica: Quanto mais detalhes você fornecer, melhor será o matching com parceiros adequados.
Acompanhamento
Você pode acompanhar suas solicitações em tempo real através do dashboard. O sistema mostra:
- Status atual do frete
- Localização do parceiro (quando disponível)
- Chat integrado para comunicação
- Histórico completo de atualizações
Para Parceiros
Cadastro
Para se tornar um parceiro:
- Acesse a página de cadastro de parceiro
- Preencha todos os dados pessoais e do veículo
- Envie os documentos necessários:
- Foto de perfil
- CNH
- Antecedentes criminais
- Comprovante de residência
- Configure sua chave PIX para recebimento
- Aguarde a aprovação do administrador
Recebendo Solicitações
Quando você está online e ativo:
- Recebe notificações em tempo real de novas solicitações
- Pode ver a distância até a origem
- Visualiza todos os detalhes antes de aceitar
- Pode aceitar ou recusar cada solicitação
Pagamentos e Saques
Após completar um frete:
- O valor líquido (após comissão) é creditado na sua conta
- Você pode solicitar saque a qualquer momento
- Saques via PIX são processados rapidamente
- Valor mínimo de saque: R$ 10,00
Pagamentos
Métodos de Pagamento do Cliente
Os clientes podem pagar usando:
- PIX - Pagamento instantâneo
- Dinheiro - Pagamento na entrega
- Cartão de Crédito - Parcelamento disponível
- Cartão de Débito - Débito automático
- Boleto - Pagamento em até 3 dias
- Transferência - Transferência bancária
Comissões
A plataforma cobra uma comissão sobre cada frete concluído:
- Reboco: 15-20%
- Transporte: 12-15%
- Mudança: 10-12%
- Entrega: 15-18%
✅ Vantagem: Clientes não pagam nada para usar a plataforma. Apenas os parceiros pagam comissão quando completam um frete.
API
Endpoints Principais
A API do ZFrete está disponível em /api
Autenticação
POST /api/auth/register
POST /api/auth/login
GET /api/auth/verify
Fretes
GET /api/fretes
POST /api/fretes
GET /api/fretes/:id
PUT /api/fretes/:id
Solicitações
GET /api/solicitations/available
POST /api/solicitations
POST /api/solicitations/:id/accept
Chat
GET /api/chat/conversations
POST /api/chat/conversations
POST /api/chat/messages
🔐 Autenticação: A maioria dos endpoints requer autenticação via token JWT no header Authorization: Bearer {token}
Suporte
Canais de Suporte
Recursos Adicionais
