Vendas e pedidos

Pedidos

Em Vendas > Pedidos: lista todos os pedidos com filtros por status, tipo, data e busca por número/cliente.

Cada pedido tem ciclo de vida via status:

1. PENDENTE — recém-criado, aguardando confirmação
2. CONFIRMADO — confirmado pelo lojista
3. PREPARANDO — em produção
4. PRONTO — pronto para retirada/entrega
5. ENTREGUE — finalizado
6. CANCELADO

Você pode imprimir comanda, gerar PDF, ver localização (delivery), ver assinatura digital e remarcar status manualmente.

Editar pedido

O cliente pediu para trocar a quantidade, tirar um item ou você negociou um desconto depois do pedido feito? Dá para ajustar o pedido sem cancelar e refazer. Ative em Configurações > Pedidos > Permitir editar pedidos. A partir daí, o botão Editar pedido aparece nos pedidos Pendente, Confirmado, Preparando e Pronto — pedido entregue ou cancelado não edita.

O que pode mudar:

• Itens: quantidade, preço unitário e observação de cada item, remover itens e adicionar produtos novos. Produto com complementos (adicionais, opções) só entra pelo catálogo — no editor você ajusta os que já estão no pedido
• Desconto e frete: altere o valor do desconto e da taxa de entrega. O total é recalculado na hora, com as mesmas regras do pedido original (tabela de preço e ajuste da forma de pagamento)

Regras que valem sempre:

• Estoque acompanha: em pedido já confirmado, a diferença é devolvida ou baixada do estoque automaticamente (diminuiu 3 para 2? volta 1; aumentou? baixa a diferença)
• Vendedor respeita o desconto máximo cadastrado no produto — não consegue vender abaixo do limite, como no app de vendas
• Pagamento online já confirmado (PIX, cartão ou boleto pago pelo gateway) trava a edição: o valor cobrado não pode mais mudar. Nesse caso, cancele e refaça o pedido

Ao salvar, você pode avisar o cliente por e-mail ou WhatsApp com o pedido atualizado, e o pedido ganha a marca Editado no histórico, com o que era antes e o que ficou depois. Na página de acompanhamento e no PDF do pedido aparece a data do ajuste. Se você usa ERP ou integrador, ele recebe o webhook pedido.editado — veja Webhooks.

Avisos ao cliente

O cliente pode receber o andamento do pedido por e-mail e WhatsApp: confirmado, pronto para retirada ou entrega, enviado (com o código de rastreio), entregue, cancelado e a nota fiscal com o DANFE em anexo. Ative e escolha os canais e as etapas em Configurações > Avisos ao cliente.

• O e-mail de confirmação na hora do pedido continua sempre, independente desse parâmetro
• O WhatsApp só sai com a integração conectada em Configurações > WhatsApp
• "Em preparação" vem desligado por padrão, porque é a etapa que mais gera mensagem sem valor para o cliente
• O cliente pode desligar os e-mails de pedido no cadastro dele, e essa escolha vale acima da loja

Nota fiscal do pedido

O Katalog não emite nota fiscal — ele guarda a nota que você emitiu no seu emissor, ERP ou contador, junto do pedido que a originou. Abra o pedido em Vendas > Pedidos e veja o bloco Nota fiscal.

A nota chega de duas formas:

• Automática: seu ERP ou integrador envia a nota assim que a SEFAZ autoriza, pela API. Nada a fazer no painel. Peça a ele para mandar o XML e o PDF (DANFE) — o XML é o documento fiscal e o PDF é o que você abre e imprime. Passe ao seu integrador a página Notas fiscais do pedido.
• Manual: clique em Anexar e escolha o XML da nota e, se quiser, o DANFE em PDF. Número, série, data e valor são lidos do próprio XML — você não digita nada. Vale para NF-e, NFC-e e NFS-e (nota de serviço).

Depois de anexada:

• O pedido ganha o selo NF na lista, para você ver de relance o que já foi faturado
• Com o PDF anexado, o botão Ver / Imprimir abre o DANFE no visualizador — é de lá que você imprime. Ao lado, PDF e XML baixam os arquivos
• Se a nota tiver só o XML, aparece o selo sem DANFE: o XML é o documento fiscal, mas quem gera o DANFE para impressão é o seu emissor — peça a ele para enviar o PDF junto
• Cancelou a nota na SEFAZ? Anexe o XML do evento de cancelamento: a nota passa a aparecer como CANCELADA, sem sumir do histórico
• Remover só desvincula a nota do pedido e apaga os arquivos aqui — não cancela nada na SEFAZ

Os arquivos ficam privados: o XML traz CPF/CNPJ, endereço e itens do cliente, então só quem tem acesso ao painel da loja consegue baixar. Nenhum link público é gerado.

Etiqueta de envio

Cada pedido tem uma etiqueta pronta para colar na caixa, no estilo das de marketplace: número do pedido grande com código de barras, QR Code de acompanhamento, destinatário com CEP em destaque, forma de entrega, rastreio, nota fiscal (se houver), volume 1/2, 2/2…, conteúdo e o remetente (sua loja).

• Um pedido: abra o pedido e clique em Etiqueta. Informe quantas caixas (volumes) vão sair — cada uma recebe a sua etiqueta.
• Vários pedidos: filtre a lista (ex.: status Pronto, período Hoje) e clique em Etiquetas no topo. Desmarque o que não vai sair e ajuste os volumes de cada um. Pedidos cancelados ficam de fora.
• Tamanho: 10 × 15 cm para impressora térmica de etiquetas (Zebra, Elgin, Argox) ou A4 com 4 etiquetas por folha para impressora comum. O painel lembra a sua escolha.
• Arquivo: PDF abre no navegador para imprimir; ZPL (Zebra) baixa um arquivo para mandar direto à impressora térmica — sai mais nítido, e é o formato que impressoras Zebra e compatíveis entendem sem driver.
• O peso só aparece quando todos os produtos do pedido têm peso cadastrado.

A etiqueta é da sua loja — ideal para entrega própria, motoboy e retirada. Envio pelos Correios ou transportadora usa a etiqueta oficial deles (no Melhor Envio, pelo botão Gerar etiqueta). Seu ERP também pode gerar essas etiquetas pela API: veja Etiqueta de envio do pedido.

Etiqueta da transportadora

Quando você (ou seu ERP) compra o frete nos Correios, Jadlog, Loggi ou num marketplace, a etiqueta oficial pode ficar junto do pedido. Abra o pedido e, no bloco Etiqueta da transportadora, clique em Anexar: escolha o PDF ou ZPL e informe transportadora e código de rastreio.

• Ver / Imprimir abre a etiqueta em PDF; em ZPL, Baixar ZPL gera o arquivo para a impressora térmica
• Anexar de novo com o mesmo código de rastreio substitui a etiqueta, sem duplicar. Pedido com várias caixas pode ter uma etiqueta por volume
• Se o pedido ainda não tinha código de rastreio, o informado passa a aparecer para o cliente no acompanhamento do pedido
• Seu ERP também pode enviar a etiqueta automaticamente pela API — veja Etiqueta da transportadora
• Remover apaga a etiqueta daqui, mas não cancela o envio na transportadora

Módulo Cozinha (KDS)

Disponível para planos com cozinha: true. Em Vendas > Cozinha: kanban em tempo real com 4 colunas (Novos, Confirmados, Preparando, Pronto).

• Atualização automática a cada 5 segundos
• Som de alerta quando chega novo pedido
• Timer por pedido com cores: verde (< 10min), amarelo (> 10min), vermelho (> 20min)
• Modo "All Day" — agrupa quantidades por produto, separando "A Preparar" de "Em Preparo"
• Modo Tela Cheia — ideal para tablet ou TV na cozinha
• Modal ampliado — clique no card para ver pedido em fonte grande

Mesas e QR Code

Em Vendas > Mesas: cadastre mesas e gere QR Codes únicos.

O cliente escaneia o QR Code da sua mesa, faz o pedido pelo celular e o pedido vai direto para a cozinha — sem precisar chamar o garçom. O pedido fica vinculado à mesa.

Contas (comandas abertas)

Em Vendas > Contas: gerencie comandas abertas em mesas. Útil quando o cliente fica consumindo durante a refeição. Permite:

• Adicionar pedidos à conta
• Dividir conta entre vários clientes
• Aplicar taxa de serviço (10%)
• Fechar e gerar pagamento ao final

Cupons de desconto

Em Vendas > Cupons: crie códigos promocionais.

• Tipo — desconto fixo (R$) ou percentual (%)
• Validade — data de início e fim
• Limite de uso — total e por cliente
• Pedido mínimo — valor mínimo para aplicar
• Categorias permitidas — restrição opcional

O cliente aplica o cupom no checkout. Você acompanha quantas vezes foi usado.

Impressão de comanda

Você pode imprimir o pedido direto do painel. Em Configurações escolha:

• Bobina térmica — 80mm (padrão de restaurante)
• A4 — impressora comum

O navegador abre o diálogo de impressão. Para impressão automática (sem clique), configure a impressora térmica via app específico ou ESC/POS.

Avaliações pós-pedido

Após o pedido ser entregue, o cliente recebe link para avaliar (1-5 estrelas + comentário). Veja em Análises > Avaliações. As aprovadas aparecem na página pública do produto.