Smart importacao Excel pedido

Smart_importacao_pedido_Excel

Objetivo

O processo SCImpPedido tem como objetivo realizar a importação automatizada de pedidos comerciais a partir de um arquivo Excel. A operação interpreta e valida cada linha, identifica cliente, produto, empresa, natureza de operação, transportador, representante e monta a estrutura completa de Pedido e Item de Pedido para posterior gravação no sistema. Esse processo é utilizado principalmente pelas áreas de Comercial, Backoffice, Faturamento, TI (automação) e Operações, garantindo padronização, agilidade e segurança na entrada de pedidos.

Funcionamento do Processo

O robô atua da seguinte forma:

Lê o arquivo Excel fornecido. Identifica automaticamente cada coluna pelo cabeçalho. Para cada linha, interpreta dados de cliente, produto, valores, representante e datas. Cria um novo pedido ou adiciona itens a um pedido já iniciado (quando o número do pedido é igual). Monta itens, grade, natureza de operação, pagamento e dados fiscais. Valida o pedido inteiro. Grava ou retorna erro diretamente no Excel.

O comportamento é governado pela classe SCImpPedido, que contém toda lógica de mapeamento, validação e montagem dos pedidos. [wiki_template_limpo | Txt]

Colunas do Excel (Planilha de Importação)

Abaixo estão as colunas identificadas na sua planilha real ʻPlanilhaimportar.xlsx’ e interpretadas pelo processo durante a importação. Elas devem existir exatamente com esses nomes:

cnpj CNPJ do cliente para identificação da Unidade de Faturamento.

inscricao Inscrição Estadual utilizada para confirmar o cliente.

transportador CNPJ do transportador responsável pelo pedido.

id_produto Identificador interno do produto (usado se o código auxiliar não localizar nenhum produto).

cod_aux_produto Código auxiliar interno do produto. Prioritário para identificação.

nr.pedido Número do pedido do cliente. Linhas com o mesmo número são agrupadas dentro do mesmo pedido.

observacao Observação geral do pedido.

representante CNPJ do representante responsável.

valor_unitario Valor unitário do item.

quantidade Quantidade solicitada no item.

data_emissao Data de emissão do pedido.

data_previsao Data prevista para saída e faturamento.

nr_item_pedido Número sequencial do item no pedido.

valor_total Valor total do item (usado para validações de totais).

id_natureza_operacao Identificador da Natureza de Operação.

id_empresa Empresa vinculada ao pedido e utilizada para localizar opções financeiras/fiscais.

Essas informações foram extraídas diretamente da sua planilha anexada. [Planilhaimportar | Excel]

Campos Processados pelo Robô

Dados do Cliente

CNPJ Inscrição Estadual Unidade de faturamento associada O cliente deve estar ativo e possuir unidade de faturamento ativa. Caso contrário, a linha recebe erro. [wiki_template_limpo | Txt]

Dados do Produto

Identificado por código auxiliar ou ID. Também determina unidade de medida, grade e modelo fiscal. [wiki_template_limpo | Txt]

Dados Comerciais

Número do pedido Número do item Quantidade e valores Observação Itens com o mesmo número de pedido são agrupados. [wiki_template_limpo | Txt]

Dados Operacionais

Representante (CNPJ) Transportador Natureza de operação Empresa

Pagamento

O processo monta informações de pagamento com base nas regras financeiras da empresa. Se o meio de pagamento não estiver definido no cliente, usa o meio padrão da empresa. [wiki_template_limpo | Txt]

Dicas de Análise do Processo

Padronize o Excel sempre com os mesmos nomes de colunas. Evite fórmulas em células de valor e quantidade; utilize números simples. Garanta a coerência das datas (emissão não pode ser posterior à previsão). Sempre revise CNPJ/Inscrição, pois erros nesses campos impedem identificar o cliente. Prefira usar cod_aux_produto — mais seguro e menos sujeito a inconsistências. Verifique se todos os CNPJs (cliente, transportador e representante) estão ativos no sistema.

Problemas e Soluções

Cliente não encontrado

Ocorre quando CNPJ ou Inscrição Estadual não existem ou não correspondem à unidade de faturamento. → Verifique a grafia dos dados no Excel.

Produto não encontrado

Nem código auxiliar nem ID resultaram em produto válido. → Verifique cod_aux_produto e id_produto.

Natureza de operação inválida

O ID informado não existe. → Verificar cadastro ou ajustar planilha.

Representante ou Transportador não localizados

CNPJ incorreto ou entidade inativa. → Validar cadastro nos sistemas internos.

Erro ao salvar pedido

Pode estar relacionado a:

Modelos fiscais Condições de pagamento Situação do pedido Campos obrigatórios faltando → Verificar mensagem da coluna de observação no Excel.

Sucesso/Erro no Excel

O processo devolve no próprio arquivo:

Status (Sucesso/Erro) Mensagem explicativa Registradas pela função writeStatusResult. [wiki_template_limpo | Txt]

Recomendações Finais

Utilize sempre o layout padrão. Mantenha um modelo de planilha aprovado para evitar retrabalhos. Utilize códigos auxiliares atualizados para produtos. Não deixe linhas com valores inconsistentes ou fórmulas. Revisite regularmente as regras de Natureza de Operação.