🍽️ LAD Food - Configuração do KDS
Kitchen Display System - Guia de Configuração para Clientes e Implantadores
🔧 O que precisa ser configurado
Para o KDS funcionar, você precisa configurar:
1Habilitar o Sistema
Parâmetro: parametro.ind_kds = true
2Configurar pelo menos UM fluxo
- parametro.kds_delivery (para pedidos de entrega)
- parametro.kds_balcao (para pedidos no balcão)
- parametro.kds_pickup (para pedidos retirada)
📋 Status Disponíveis no Sistema
| Código |
Nome |
Quando Usar |
| A |
Aberto |
Pedido recém-chegado |
| P |
Em Produção |
Cozinha está preparando |
| B |
Embalando |
Pedido sendo embalado |
| D |
Pronto para Despacho |
Aguardando entregador/cliente |
| X |
Expedido |
Saiu para entrega |
| E |
Entregue |
Cliente recebeu o pedido |
⚙️ Exemplos de Configuração
🚚 Delivery Completo
parametro.kds_delivery = "A;P;B;D;X;E"
Fluxo: Aberto → Em Produção → Embalando → Pronto → Expedido → Entregue
🏪 Balcão Simples
parametro.kds_balcao = "A;P;E"
Fluxo: Aberto → Em Produção → Entregue
🥡 Retirada no Local
parametro.kds_pickup = "A;P;D;E"
Fluxo: Aberto → Em Produção → Pronto → Entregue
🖨️ Impressão Balcão
parametro.ind_imprimir_apos_finalizar = true
Regra: Imprime comprovante quando pedido vai para "Entregue" (E)
🖨️ Impressão Delivery/Pickup
# Automática - não precisa configurar
# Imprime quando entra no status "Em Produção" (P)
Regra: Sempre imprime pedido completo automaticamente no status "P"
👥 Configuração de Usuários
📊 Campos do Perfil
| Campo |
Tipo |
Exemplo |
Função |
| status_all |
String |
"A;P;B;D;E" |
Status pré-marcados no KDS |
| tempo_medio |
Número (minutos) |
15 |
Tempo limite para pedido "no prazo" |
| comissao_kds |
Decimal (%) |
5.00 |
Percentual de comissão por pedido |
🔑 Para acessar a versão moderna (V2):
perfil.status_all = "A;P;B;D;E"
O que faz: Define quais status aparecem pré-marcados na tela do KDS
💰 Configuração de Comissão
perfil.comissao_kds = 5.00
O que faz: Define o percentual de comissão por pedido produzido no KDS (usado no dashboard de produtividade)
Formato: Valor decimal (ex: 5.00 = 5%)
⏱️ Configuração de Tempo Limite
perfil.tempo_medio = 15
O que faz: Define o tempo limite em minutos para considerar um pedido "no prazo" ou "atrasado"
Usado para: Métricas de produtividade e cálculo de performance da equipe
⚠️ Importante: Se perfil.status_all estiver vazio (null),
o usuário será redirecionado para a versão antiga do KDS.
🗄️ Comandos SQL para Configurar
📋 ANTES DE EXECUTAR OS COMANDOS:
- Criar tabela erro_classificacao: Execute o script de criação da tabela no banco
- Cadastrar classificações de erro: Use o arquivo
script_erro_classificacao.sql com 40+ exemplos
- Personalizar: Ajuste as descrições conforme o vocabulário usado pela equipe da cozinha
1. Habilitar KDS na empresa
UPDATE parametro
SET ind_kds = true
WHERE id_empresa = [ID_DA_EMPRESA];
2. Configurar fluxo de delivery
UPDATE parametro
SET kds_delivery = 'A;P;B;D;X;E'
WHERE id_empresa = [ID_DA_EMPRESA];
3. Configurar fluxo de balcão
UPDATE parametro
SET kds_balcao = 'A;P;E'
WHERE id_empresa = [ID_DA_EMPRESA];
4. Dar acesso aos usuários
UPDATE perfil
SET status_all = 'A;P;B;D;E'
WHERE id_perfil = [ID_DO_PERFIL];
5. Configurar comissão do perfil
UPDATE perfil
SET comissao_kds = 5.00
WHERE id_perfil = [ID_DO_PERFIL];
6. Configurar tempo limite do perfil
UPDATE perfil
SET tempo_medio = 15
WHERE id_perfil = [ID_DO_PERFIL];
🖨️ Configuração de Impressão Automática
📋 Regras de impressão automática:
- Balcão: Imprime quando status muda para "Entregue" (E) se impressão estiver habilitada
- Delivery/Pickup: Imprime pedido completo quando entra no status "Em Produção" (P)
7. Habilitar impressão após finalizar (Balcão)
UPDATE parametro
SET ind_imprimir_apos_finalizar = true
WHERE id_empresa = [ID_DA_EMPRESA];
📌 Nota: Delivery e Pickup sempre imprimem automaticamente no status "Em Produção" (P).
Não é necessário configurar nada adicional para estes tipos de pedido.
💡 Como funciona a impressão automática:
- Balcão: Se
ind_imprimir_apos_finalizar = true, imprime comprovante quando pedido vai para status "Entregue" (E)
- Delivery: Sempre imprime o pedido completo automaticamente quando entra no status "Em Produção" (P)
- Pickup: Sempre imprime o pedido completo automaticamente quando entra no status "Em Produção" (P)
- Importante: A impressão de delivery/pickup acontece automaticamente, não precisa configurar
🚨 Configuração de Classificação de Erros
🎯 Como funciona a classificação de erros:
- Objetivo: Só cancelamentos com motivos específicos contam como "erro registrado"
- Funcionamento: Sistema compara observação do cancelamento com as descrições cadastradas
- Similaridade: Se similaridade ≥ 70%, conta como erro
- Exemplo: Cancelamento com obs "queimou" será considerado erro se tiver "Produto queimado" cadastrado
📝 Exemplos de erros que devem ser cadastrados:
- Erro na cozinha
- Produto queimado
- Falta de ingredientes
- Demora excessiva
- Erro no preparo
- Equipamento quebrado
- Produto estragado
💡 Dica: Cadastre os termos que sua equipe realmente usa para cancelar pedidos por erro operacional.
⚠️ SEÇÃO TÉCNICA - APENAS ANALISTA/IMPLANTADOR
As informações abaixo são para execução técnica. O cliente não precisa executar estes comandos.
✅ Como verificar se está funcionando
1. Teste básico:
- Faça login no sistema
- Acesse o menu KDS ou "Visualizar Pedidos"
- Deve aparecer uma tela com cards dos pedidos
2. Se não funcionar, verifique:
- parametro.ind_kds está true?
- Tem pelo menos um fluxo configurado (delivery OU balcão)?
- perfil.status_all não está vazio?
- perfil.tempo_medio está definido (ex: 15)?
- perfil.comissao_kds está definido se usar comissão?
- Existem pedidos recentes (menos de 12 horas)?
- Tabela erro_classificacao foi criada e populada?
3. Para verificar impressão automática:
- Balcão:
parametro.ind_imprimir_apos_finalizar = true para imprimir no status "Entregue"
- Delivery/Pickup: Impressão automática no status "Em Produção" (não precisa configurar)
- Impressoras estão configuradas no sistema?
- Teste mudando status de pedido balcão para "Entregue" (E)
- Teste mudando status de pedido delivery/pickup para "Em Produção" (P)
🚨 Dicas Importantes
- Ordem importa: A sequência dos status no parâmetro define a ordem na tela
- Separador: Use sempre ponto e vírgula (;) entre os status
- Performance: Sistema mostra no máximo 120 pedidos
- Período: Só aparecem pedidos com menos de 12 horas
- Impressão: Algumas mudanças de status podem imprimir automaticamente
- Tempo médio: Configurar em minutos (ex: 15 = 15 minutos)
- Comissão: Valor decimal (ex: 5.00 = 5%)
- Erros classificados: Só cancelamentos similares às descrições cadastradas contam como erro
📞 Precisa de ajuda?
Entre em contato com o suporte técnico da LAD Sistemas
Documento atualizado em: 13 de outubro de 2025
Sistema: LAD Food - Módulo KDS