Dobra e Dobradores¶

📍 Onde fica: Portal do Dobrador (/packer) · catálogo em Configurações → Serviços de Dobra (admin) 👤 Quem pode: Dobrador (portal) · Administrador (catálogo)

O Airo controla o trabalho de dobra (packing): quanto cada dobrador dobrou, quanto a DZ paga, quanto o atleta paga, e os pagamentos entre eles.

Os três tipos de lançamento de dobra¶

Origem	Quando acontece
Automático (`auto`)	Gerado pelo motor quando a decolagem pousa/decola, a partir de itens de produto do tipo packer. Normalmente pago pela DZ (`dz_paid`)
Manual da decolagem (`manual_load`)	O dobrador reivindica uma dobra ligada a um slot
Manual independente (`manual_independent`)	O dobrador registra uma dobra avulsa (fora de decolagem)

Status de uma dobra¶

Status	Significado
pendente	Aguardando pagamento do atleta
pago	O atleta pagou o dobrador
pago pela DZ (`dz_paid`)	Embutido no produto — a DZ banca
dispensado (`waived`)	Cortesia / não cobrado

Fluxo do dobrador (portal)¶

Requer portal do dobrador habilitado na DZ e a função dobrador na pessoa. Ver Integrações e Portais.

No portal (/packer), o dobrador tem:

Painel: resumo das dobras.
Manifesto: visão das dobras do dia.
Registrar dobra: lança uma dobra (manual).
Serviços: catálogo de serviços adicionais + meu preço (preço pessoal por serviço).
Configurações → Dados de recebimento (Pix): cadastra a chave Pix do dobrador (ver abaixo).
Carteira: ganhos com dobra, com detalhamento por atleta.
Carteira DZ: repasses e comissões do lado da DZ.
Pagamentos: histórico de pagamentos recebidos.
Relatórios: estatísticas de dobra, Lista de Dobragens e Serviços Realizados.

Editar / excluir lançamentos extras (Relatórios)¶

Na tela de Relatórios, o dobrador pode alterar ou excluir os lançamentos que não vieram do manifesto:

Dobras extras (marcadas com a etiqueta Extra) — dobras avulsas lançadas manualmente, fora de uma vaga de load.
Serviços realizados — todos os serviços adicionais lançados pelo dobrador.

Use o menu ⋮ ao lado do lançamento → Editar (valor, data e descrição) ou Excluir.

Dobras geradas pelo manifesto (etiqueta DZ) e dobras lançadas em uma vaga de load não aparecem com essas opções — só podem ser desfeitas pelo manifesto.

Só é possível editar/excluir enquanto o lançamento estiver pendente (ainda não pago pelo atleta).

Serviços de dobra (catálogo)¶

📍 Admin: Configurações → Serviços de Dobra

A DZ define um catálogo de serviços de dobra com preço padrão. Cada dobrador pode ter preço próprio por serviço (override). Também há rastreabilidade (auditoria de quem dobrou o quê).

Pagamentos atleta → dobrador¶

Quando a dobra é paga pelo atleta (não pela DZ):

O atleta paga (pix / dinheiro / transferência).
O dobrador registra/recebe o pagamento.
O pagamento passa por confirmação (pendente → confirmado / contestado).

Chave Pix do dobrador¶

O dobrador pode cadastrar sua chave Pix para receber dos atletas com mais facilidade.

Cadastrar (dobrador): Portal do Dobrador → Configurações → Dados de recebimento (Pix). Informe:

Tipo de chave: CPF, CNPJ, E-mail, Telefone ou Aleatória.
Chave Pix, Nome do recebedor e Cidade (esses dois últimos compõem o Pix copia-e-cola).

Como o atleta paga via Pix. Em Meus Repasses, ao tocar em Pagar e escolher Pix, aparece o botão Ver chave Pix / QR code: o atleta vê a chave (com botão de copiar), o QR code e o Pix copia-e-cola já com o valor preenchido.

Compartilhar a cobrança (dobrador). Você pode gerar o QR code / copia-e-cola para mandar pro atleta:

Na Carteira → por atleta, o botão de QR code na linha do atleta gera a cobrança já com o valor devido.
Nas Configurações, o botão Compartilhar Pix gera o QR code da sua chave para compartilhar a qualquer momento.

Em qualquer um desses, além de copiar a chave e o copia-e-cola, há o botão Compartilhar no WhatsApp, que abre o WhatsApp com a mensagem pronta (chave + Pix copia-e-cola) para enviar ao atleta.

O QR code e o copia-e-cola apenas facilitam a transferência: o pagamento continua passando pela confirmação (pendente → confirmado) como sempre.

Avaliação¶

O atleta pode avaliar uma dobra (nota de 1 a 5 + comentário), criando um histórico de qualidade por dobrador.

Painel de Dobragem (gestão)¶

📍 Onde fica: Painéis → Dobragem 👤 Quem pode: somente Administrador

No menu Painéis › Dobragem o administrador tem a visão consolidada da operação de dobra da DZ num período. É uma tela de gestão — só quem tem acesso de administrador enxerga.

No topo, escolha o período (atalhos de Hoje, Semana, Mês, Mês passado ou intervalo personalizado) e, opcionalmente, um dobrador para ver só a operação dele.

Indicadores (com a variação em relação ao período anterior): total de dobras e de serviços, ganho total dos dobradores (somando o que a DZ paga e o que os atletas pagam), ganho médio por dobrador e por dobra, e pendências em aberto (valor e quantidade).

Previsão de ganho. Um destaque mostra a média por dia trabalhado e a projeção mensal — útil para dar a um novo dobrador uma expectativa realista de quanto dá para ganhar na DZ.

Gráficos. Dobras por dia, ganhos no período e ranking de dobradores, todos divididos em DZ × Atleta — para enxergar quem está dobrando mais para a DZ e quem trabalha mais direto para os atletas. O ranking alterna entre quantidade e ganho.

Ranking detalhado. Uma tabela por dobrador com dobras, serviços, ganho total e médio por dobra, % DZ / Atleta, dias trabalhados, pico/dia (o melhor dia, ex.: 85 dobras num único dia), avaliação e pendências. Dá para ordenar por qualquer coluna e exportar em CSV.

Pendências por atleta. A lista agrupa a dívida em aberto por atleta e abre para mostrar quanto ele deve a cada dobrador, com a data da dobra mais antiga.

Regras importantes¶

O gatilho das dobras automáticas (pousou vs decolou) é configurável na Dropzone.
Dobra só pode ser criada com o manifesto aberto / no mesmo dia.
Uma dobra só pode ser desfeita se ainda não foi paga.
Nos Relatórios, o dobrador pode editar/excluir apenas dobras extras (avulsas) e serviços realizados, e somente enquanto estiverem pendentes.

Detalhes dessas regras de ciclo de vida em Regras de Negócio.