Cadastrar centenas de produtos a partir de uma planilha parece um problema de copiar colunas, mas o produto no Protheus alimenta estoque, custo, faturamento, compras, WMS e tributação. Um lote rápido com campos errados cria retrabalho em várias áreas.
A automação segura usa a planilha como entrada controlada, não como verdade final. Ela valida o layout, enriquece dados, apresenta erros por linha e chama a rotina de cadastro suportada no ambiente.
Defina um template canônico
O arquivo deve ter versão e colunas explícitas: código, descrição, tipo, unidade, segunda unidade quando aplicável, grupo, armazém padrão, NCM, origem e campos fiscais exigidos. Listas de valores válidos e exemplos reduzem variações como UN, Und. e unidade.
Campos customizados entram no mesmo contrato, com dono e regra. Coluna desconhecida, fórmula com erro, código duplicado e célula obrigatória vazia impedem apenas as linhas afetadas e geram relatório de retorno.
MATA010 e tabelas relacionadas
A TOTVS documenta a MATA010 como cadastro central de produtos e mostra pastas cadastrais, impostos, MRP, WMS e outras. Dependendo do processo, o registro pode envolver SB1, dados complementares em SB5 e informações específicas adicionais.
Por isso, inserir uma linha só em SB1 não equivale a cadastrar um produto. O projeto identifica quais campos e tabelas são acionados no seu ambiente, inclusive pontos de entrada e integrações existentes.
Validação antes de gravar
O pré-processamento verifica tamanho e domínio de campos, relacionamentos com grupo e armazém, unidade permitida, formato de NCM e duplicidade por código ou descrição. Regras fiscais devem ser fornecidas e aprovadas pela área responsável; a automação não inventa tributação.
Uma prévia mostra inclusão, atualização, registro ignorado e conflito. Atualizações podem exigir política mais restritiva do que inclusões, especialmente para campos que afetam estoque ou documento fiscal.
Execução e reversibilidade
O conector usa rotina automática, mensagem de integração ou API definida com a equipe Protheus. Cada linha recebe um ID de lote, status, código criado e mensagem retornada. A carga roda primeiro em homologação e com um lote pequeno representativo.
Reversão não deve significar apagar tabelas. O plano pode inativar cadastros novos sem movimento ou aplicar uma correção aprovada. O arquivo original, a versão transformada e o resultado ficam preservados.
Quando vale automatizar
Faz sentido em migrações, ampliação de catálogo, entrada de nova linha e manutenção recorrente distribuída entre áreas. Para poucos itens esporádicos, melhorar o template e usar o cadastro assistido pode ser suficiente.
No diagnóstico, avaliamos amostras da planilha, dicionário de dados, release, customizações da MATA010 e critérios fiscais. O primeiro resultado é um validador; a gravação automática vem depois que os erros da origem estão visíveis.