IMPORTAÇÃO DE XML
IMPORTAÇÃO DE XML

NFE DE ENTRADA
🎙️ Podcast: Escute para aprender
📽️ Vídeo: Assista para entender
A Importação de XML é o método mais eficiente e seguro para dar entrada em mercadorias no ERP 2.0. Ao invés de cadastrar produtos manualmente e lançar contas a pagar item por item, o sistema lê o arquivo digital da Nota Fiscal (NFe) enviado pelo seu fornecedor e automatiza dois pilares vitais do seu negócio simultaneamente: Estoque e Financeiro.
Este processo garante que o que entrou fisicamente na loja bata com o documento fiscal, evita erros de digitação e agiliza a precificação através de ferramentas de atualização em massa. 
 
 
✅Pré-Requisitos
Antes de iniciar a importação, certifique-se de ter:
Arquivo XML da Nota: O arquivo digital enviado pelo fornecedor 
Categorias Financeiras: Centros de custo criados (ex: Estoque, Despesas Gerais) para classificar o pagamento corretamente.
Acesso ao Menu de Estoque: Permissão de usuário para realizar entradas de nota.
 
 
⚙️Passo a Passo
1. Acesse a Tela de NFe de Entrada No menu lateral esquerdo, localize a seção Estoque e clique na opção NFe de Entrada.
2. Inicie a Importação Na tela de listagem, clique no botão Importar XML de NFe. Selecione o arquivo em seu computador.
3. Etapa 1: Dados do Fornecedor O sistema lerá o XML e preencherá os dados automaticamente.
Novidade: Agora você pode editar os dados do fornecedor (endereço, e-mail) diretamente nesta tela, caso tenham mudado, sem precisar sair da importação para ir ao cadastro de parceiros.
Verifique os dados e clique em Próximo ou avance para a aba de Produtos.
4. Etapa 2: Vínculo de Produtos (Ação Principal) Aqui você define o que entra no estoque. O sistema tentará fazer o vínculo automático pelo "Código do Fornecedor". Verifique a coluna Ação para cada item:
Vincular: O sistema encontrou o produto no seu estoque.
Criar Novo: O produto não existe e será cadastrado agora.
Dica de Ouro: Use os botões de ação em massa no topo da lista para Atualizar Valores de Venda (aplicar margem de lucro em todos os itens de uma vez) ou Sincronizar Produtos.
Se precisar ajustar Fator de Conversão (ex: caixa para unidade) ou Tributação, clique no item para abrir a edição detalhada.
5. Etapa 3: Pagamentos e Rateio Nesta última aba, você gera o contas a pagar.
Adicionar Frete/Despesas: Clique no botão + Adicionar Pagamento/Frete. Um modal se abrirá para você inserir transportadora, valor do frete e descontos, mantendo a tela principal limpa.
Rateio de Custos: Se essa nota deve ser dividida em setores diferentes, utilize o botão + Adicionar Categoria. Você pode definir, por exemplo, que 50% do valor vai para "Custo de Mercadoria" e 50% para "Material de Uso e Consumo".
6. Finalizar Após conferir os totais, clique em Finalizar Importação. O sistema dará entrada no saldo de estoque e criará o título financeiro.
 
 
❓Dúvidas Frequentes / Pontos de Atenção
1. O produto já existe no meu sistema, mas o importador quer "Criar Novo". O que fazer? Isso acontece quando o ERP não encontra um vínculo pelo código do fornecedor. Não crie duplicidade! Na coluna de ação, altere de "Criar novo produto" para Vincular produto existente e busque o nome do produto no seu cadastro manualmente. O sistema aprenderá esse vínculo para a próxima vez.
2. Comprei uma caixa com 12 unidades, mas vendo por unidade. Como ajusto? Na etapa 2 (Produtos), clique sobre o item para abrir a edição detalhada. Localize o campo Fator de Conversão. Insira a quantidade que vem na embalagem (ex: 12). O sistema dará entrada em 12 unidades no estoque, dividindo o custo unitário proporcionalmente.
3. Onde lanço o valor do frete que veio na nota? No ERP 2.0, os campos de frete não ficam soltos na tela para evitar poluição visual. Na etapa 3 (Pagamentos), clique obrigatoriamente no botão/modal + Adicionar Pagamento/Frete. Lá você encontrará os campos para Transportadora, Frete, Seguro e Outras Despesas.

RATEIO DE DESPESAS - IMPORTAÇÃO DE NFE
🎙️ Podcast: Escute para aprender
📽️ Vídeo: Assista para entender
Este guia é direcionado às equipes de Suporte, Comercial e Implementação para o correto entendimento e configuração do recurso de rateio de despesas durante a importação de Notas Fiscais no ERP ConnectPlug.
 
💡 Contexto/Por que Fazer: A Importância da Composição do Custo Real
Muitas vezes, o custo real de um produto não se limita apenas ao valor impresso na nota fiscal do fornecedor. Existem diversos custos adicionais atrelados à compra, como fretes, impostos complementares, taxas de armazenagem, descarregamento e seguros.
O Impacto no Cliente: Se esses valores extras não forem incorporados corretamente ao custo do produto no momento da entrada, o estoque ficará com um valor financeiro defasado. 
Isso impacta diretamente em três frentes vitais da gestão do cliente:
CMV (Custo da Mercadoria Vendida): Ficará incorreto, mascarando os relatórios de resultado.
Margem de Lucro: Sem o custo real, a percepção de lucro por venda será ilusória (maior do que a realidade).
Formação de Preço: O cliente não conseguirá precificar o produto de forma correta (aplicando o markup sobre o custo real) para garantir a saúde financeira do negócio.
O recurso de rateio no ConnectPlug resolve esse problema distribuindo automaticamente esses custos extras entre os produtos da nota.
 
✅ Pré-Requisitos
Para realizar o rateio das despesas extras, é necessário:
Módulo de Compras/Estoque: Acesso à funcionalidade de Importação de XML no ERP.
Processo de Importação Iniciado: Ter passado pelas etapas iniciais da importação do XML (vínculo de fornecedor e cadastro/vínculo dos produtos).
Valores das Despesas: Ter em mãos os valores adicionais (frete, impostos, seguros) que deverão ser somados à nota.
 
 
⚙️ Passo a Passo: Configurando o Rateio de Despesas
A adição dos custos extras ocorre na etapa final da importação do XML.
Acessar a Aba de Pagamentos:
Após vincular os produtos, avance para a aba Pagamentos na tela de importação.
Localize a seção "Despesas adicionais".
Inserir o Valor da Despesa:
Insira o valor total da despesa extra (ex: R$ 200,00 referente a frete) e clique em Ratear.
Escolher o Método de Rateio:
O sistema disponibiliza três métodos para distribuir o custo entre os itens. Escolha o mais adequado à realidade da nota:
Proporcional por valor: Distribui a despesa com base no valor financeiro de cada produto. (Ex: Um vinho premium caro absorverá uma fatia maior do frete do que um vinho de entrada barato). Ideal para notas com produtos de preços muito diferentes.
Proporcional por quantidade: Distribui o custo baseado puramente na quantidade física de itens, ignorando seus preços. Ideal para fretes cobrados por volume ou custos de armazenagem por unidade.
Manual: Não realiza cálculos automáticos. O usuário define manualmente a porcentagem (%) ou o valor exato que cada produto receberá. Ideal para exceções (ex: apenas um produto da nota sofreu uma tributação específica.
Ajustar o Preço de Venda (Markup):
Com a despesa distribuída, o sistema exibirá o Custo Final (Custo Inicial + Rateio da Despesa).
Como o custo aumentou, aproveite a mesma tela para ajustar o valor de venda. Insira a porcentagem de lucro desejada (ex: 150%) e o sistema calculará automaticamente o Novo Preço de Venda.
Categorização Financeira da Despesa:
Após aplicar o rateio aos produtos, o sistema permite que você divida o valor dessa despesa no módulo financeiro.
Você pode separar o valor total da nota em diferentes Categorias Financeiras e Centros de Custo (ex: R$ 869,60 na categoria ′Custo de Produto′ e R$ 200,00 na categoria 'Fretes e Entregas').
Finalizar a Importação:
Conclua o preenchimento da forma de pagamento e clique em Finalizar. O estoque e o financeiro serão alimentados corretamente.
 
 
❓ Dúvidas Frequentes
Dúvida Comum
Resposta e Lógica
Como o sistema registra esses valores no Módulo Financeiro? Fica tudo junto?
Não. Se você acessar as "Compras", verá o valor total consolidado (Nota + Despesa. Porém, na tela de Lançamentos do Financeiro, o sistema cria registros separados de forma inteligente: um lançamento para o custo original dos produtos e outro lançamento para a despesa extra adicionada. Isso facilita a auditoria.
Quando devo recomendar o rateio "Manual" na Implementação?
O rateio manual deve ser recomendado para situações que fogem da regra de proporção. Exemplos clássicos: quando um único produto exigiu um seguro especial, quando um item ocupou muito mais espaço no caminhão (frete desproporcional) ou quando apenas alguns itens sofreram substituição tributária pesada. O principal benefício é a flexibilidade total.
A alteração do preço de venda na tela de rateio atualiza direto no cadastro?
Sim. Ao inserir a nova margem de lucro (%) com base no novo custo final calculado pelo rateio, o sistema já ajusta o preço de venda daquele produto, dispensando a necessidade de o cliente ir até o cadastro do item para fazer isso manualmente.
O rateio de despesas afeta o CMV?
Sim, diretamente. Ao aplicar o rateio, o Custo Médio e o custo da última compra são atualizados de forma fiel à realidade da operação, o que garante um cálculo de CMV (Custo da Mercadoria Vendida) e de rentabilidade confiáveis nos resultados financeiros.
Suporte/Implantação: Sempre reforce ao cliente que negligenciar as despesas adicionais na importação de nota é o caminho mais rápido para ter prejuízo invisível. A formação de preços só é precisa se o custo de entrada também for. Use o exemplo prático de rateio por quantidade para transportadoras e rateio por valor para impostos para facilitar o entendimento do lojista.