Importar e Exportar dados
Quatro módulos do Mocho suportam CSV: Estoque, Procedimentos, Contas a Receber e Contas a Pagar. Útil pra:
- Migrar dados de outro sistema sem digitar tudo de novo
- Fazer backup periódico
- Ajustar muitos itens em lote no Excel/Sheets
Fluxo recomendado
- Baixar modelo (botão no modal de Importar) — você recebe um CSV com cabeçalhos + 3 linhas de exemplo no formato Excel BR (separador
;, decimal vírgula) - Editar no Excel/Sheets — preencher com seus dados
- Salvar como "CSV UTF-8" (preserva acentos)
- Voltar no Mocho → botão Importar → enviar o arquivo
- Conferir preview das primeiras 5 linhas antes de confirmar
- Importar — o Mocho processa em batches de 1000
Formato dos arquivos
Separador
O importador detecta automaticamente vírgula (,) ou ponto-e-vírgula (;). Excel BR salva com ; por padrão.
Números
Aceita formato BR (1.234,56) ou US (1234.56). Não precisa converter.
Datas
Aceita DD/MM/AAAA (BR) ou AAAA-MM-DD (ISO). Pra competência use MM/AAAA ou AAAA-MM.
Encoding
Use UTF-8 sempre que possível. Quando salvar no Excel, escolha:
"Arquivo → Salvar como → CSV UTF-8 (delimitado por vírgula)"
Senão acentos podem ficar quebrados (Ant�ssico em vez de Antisséptico).
Regras de duplicata
| Módulo | Critério de skip |
|---|---|
| Estoque | Mesmo nome (case-insensitive) |
| Procedimentos | Mesmo nome |
| Contas a Receber | Mesma descrição + previsão |
| Contas a Pagar | Mesma descrição + vencimento |
Itens duplicados são ignorados silenciosamente durante o import. O modal mostra quantos e quais foram pulados ao final.
💡 Pra Contas a Receber/Pagar, o critério inclui a data — então parcelas legítimas (mesma descrição, datas diferentes) entram normalmente.
Importação por entidade
Estoque
Colunas reconhecidas (qualquer ordem, aliases case-insensitive):
nome, quantidade, minimo, unidade, unidades/pacote, custo/pacote, fornecedor, codigo_barras, validade, estoque_ideal
Procedimentos
nome, especialidade, tempo, comissao, tipo_comissao (percentual/fixa), custo_lab, preco, margem
⚠️ Não importa insumos vinculados — só os procedimentos. Vincule manualmente depois na aba Insumos de cada um.
Contas a Receber
descricao, categoria, previsao, competencia (opcional), valor, desconto (opcional), tipo_desconto (opcional)
⚠️ Não cria parcelamento automático. Se quer 3 parcelas, importe 3 linhas com a mesma descrição e datas diferentes.
Contas a Pagar
descricao, tipo (fixo/variavel), categoria, vencimento, competencia (opcional), valor
⚠️ Não cria recorrência automática. Importe N linhas pra N meses se precisar.
Exportação
Cada módulo tem o botão Exportar. Ele:
- Respeita os filtros + busca + sort atuais (você exporta exatamente o que está vendo)
- Limita a 5000 linhas (filtre antes pra reduzir)
- Gera CSV no formato Excel BR (separador
;, números com vírgula) - Inclui BOM UTF-8 (Excel abre acentos corretamente)
- Nome do arquivo:
{módulo}-{data}.csv(ex:estoque-2026-05-31.csv)
Códigos de barras (EAN-13) no Excel
Excel converte automaticamente números de 13 dígitos pra notação científica (7,89123E+12). Soluções:
- Antes de digitar: formate a coluna como Texto (botão direito → Formatar células → Texto)
- Se já importou e quebrou: o parser do Mocho detecta notação científica e converte de volta automaticamente — pode importar sem se preocupar
Limite por chamada
- Backend aceita até 1000 itens por POST
- Se seu CSV tem 5000 itens, o Mocho divide em 5 batches automaticamente
- Cada batch é atômico: erro inesperado num lote não afeta os outros