Exportando dados do Boteco: o que funciona e onde você vai travar
O Boteco é um sistema brasileiro bastante usado por bares e restaurantes para controle de pedidos, caixa e estoque. Aexportação de dados dele é uma tarefa que todo mundo precisa fazer eventualmente, seja para passar para um contador, para importar em outra ferramenta ou para organizar relatórios próprios. A interface de exportação não é intuitiva, mas depois de entender onde ela mora, o processo fica tranquilo.
Como acessar a função boteco exportacao no sistema
Depois de logado no módulo operacional, navegue até a tela de relatórios. Ela geralmente fica no menu lateral ou na barra superior, dependendo da versão do sistema que sua empresa está rodando. Dentro dos relatórios, procure pela opção de exportar ou baixar planilha. O sistema vai permitir filtrar por período, tipo de operação e às vezes por estabelecimento, se você tiver múltiplas unidades cadastradas. Após aplicar os filtros desejados, clique no botão de exportação. O formato padrão é CSV ou XLS. Eu recomendo CSV sempre que for fazer importação para outra planilha ou sistema, porque o CSV mantém os caracteres especiais corretamente e evita aqueles problemas de formatação que aparecem com XLS em certas versões do Excel.
O download costuma levar alguns segundos para exportações pequenas. Se o período escolhido for grande, como um trimestre inteiro com muitas movimentações, o sistema pode demorar mais. Nesses casos, o ideal é quebrar em meses menores para evitar timeout na geração do arquivo. Eu já perdi tempo precioso tentando exportar um relatório de três meses de uma vez e o sistema simplesmente não respondia. A solução foi separar por mês e juntar os arquivos depois no Excel. Leva dez minutos a mais, mas pelo menos funciona sem erro. Outro problema comum é quando o período tem um dia com muita movimentação. O arquivo pode sair truncado sem aviso. Sempre abra o arquivo baixado e confirme se a última linha faz sentido, comparando com o total de operações que o sistema mostra na tela antes de exportar.
Pegadinhas que ninguém conta
A primeira coisa que as pessoas esquecem é que o Boteco tem campos separados para valor bruto, valor líquido, taxas e comissões. Se você só olha o valor total e tenta reconciliar com o extrato do cartão ou da operadora de pagamento, vai bugar. O correto é exportar também os detalhamentos de pagamento, que ficam em uma aba ou relatório diferente chamado forma de recebimento ou meio de pagamento. Outro ponto importante é o fuso horário. Em alguns relatórios, as vendas do final do dia aparecem na data seguinte porque o corte operacional do Boteco é feito em horário comercial, não no horário civil. Se você está cruzando dados com outro sistema que usa data civil, vai ter uma diferença de um dia em cada venda das 23h às 00h. Anote isso num campo de observação do seu arquivo antes de processar.
O sistema também não exporta itens cancelados junto com os normais em muitos relatórios padrão. Eles vão para um relatório específico de cancelamentos ou devoluções. Se você precisa de uma visão completa, tem que exportar dois arquivos e fazer um join por ID da operação. Não tente confiar num único relatório para ter tudo. Tem também o problema dos códigos de produto. Em locais que fazem atualização frequente do cardápio, os nomes mudam mas os códigos permanecem. O relatório de exportação traz o código, mas em algumas versões mais antigas ele traz apenas o nome por linha, o que complica quando o produto foi renomeado no meio do período. A workaround aqui é exportar também o cadastro de produtos do mesmo período e usar o código como chave primária nos seus cruzamentos.
👉 Clique no botão abaixo para saber mais sobre o assunto!
O que fazer com o arquivo depois que baixa
Depois de ter o CSV na mão, o próximo passo depende do seu objetivo. Para conciliação financeira, o ideal é padronizar as colunas: data, horário, código do item, quantidade, valor unitário, valor total e forma de pagamento. Se o arquivo vier com colunas extras que você não precisa, corte antes de importar em qualquer ferramenta externa para não ter erro de mapeamento. Para quem trabalha com BI ou dashboards, recomendo importar o CSV para uma base PostgreSQL ou pelo menos para o Google Sheets com uma fórmula de conversão de datas explícita, porque o Boteco às vezes exporta datas no formato americano em alguns relatórios e no formato brasileiro em outros. A inconsistência dentro do mesmo banco de dados é real.
Se o seu fluxo envolve nota fiscal eletrônica, o Boteco gera um relatório de saída que pode ser cruzado com a NF-e. Mas o XML da NF-e e a exportação do Boteco não têm a mesma chave de relacionamento em todos os casos. A que funciona melhor é o número do cupom fiscal ou o número do pedido, dependendo do modelo de emissão da sua unidade. Teste com um lote pequeno antes de aplicar em massa.
Limitações que você precisa saber antes de confiar cegamente
O Boteco não foi construído como ferramenta de exportação em massa. Ele é um sistema operacional. Isso significa que ele não tem API pública estável para puxar dados programaticamente. Se você precisa de automação de exportação mensal, a solução via scraping ou integração manual é frágil, porque qualquer atualização do sistema quebra o fluxo. O caminho mais viável é manter um processo manual com checklist, documentando o período, o filtro aplicado e o nome do arquivo baixado, para que em caso de divergência futura seja possível refazer a extração. Outra limitação séria é o volume de retenção. O sistema mantém os dados exportáveis por um período que varia conforme o plano contratado. Em planos mais enxutos, relatórios com mais de um ano podem estar indisponíveis para exportação direta. Se sua empresa precisa de histórico longo, o ideal é criar um arquivo-mestre mensal ownstorage, salvando os CSVs exportados em uma pasta organizada por ano e mês. Isso resolve o problema de uma vez e ainda facilita a comparação anual.
O Boteco também não exporta dados de sessões ou clientes que não fizeram pedido direto no momento. Se você usa integração com app de Delivery ou plataforma de reservas que não passa pelo PDV do Boteco, essas movimentações ficam fora dos relatórios padrão. Verifique isso antes de assumir que a exportação cobre 100% do faturamento. Para quem precisa de uma alternativa mais robusta, existem sistemas de PDV mais orientados para dados que oferecem exportação via API ou relatórios completos integrados com ERPs. Mas aí o custo sobe e a migração é trabalhosa. Se o Boteco atende bem o operacional do dia a dia, o caminho mais razoável é aceitar suas limitações de exportação e construir uma camada leve de tratamento dos dados fora do sistema, em vez de migrar só por causa disso.
O fluxo básico de exportação funciona bem quando você entende onde clicar e quais filtros aplicar. O problema começa quando você tenta automatizar algo que o sistema não foi feito para automatizar. Separe o que é exportação pontual, que o Boteco resolve sem dor, do que é integração contínua, que exige uma solução externa ou uma mudança de plataforma.
