Páginas filhas
  • Tutorial Importação XML Automático


01. DADOS GERAIS

Linha de Produto:PC Sistemas
Segmento:D&L
Módulo:13 - Compra


02. SITUAÇÃO/REQUISITO

Objetivo


A Importação do XML Automático foi desenvolvido a fim de atender as seguintes necessidades:

  • Agilidade no processo de recebimento de mercadoria.
  • Automação na geração de pré-entrada de mercadoria por arquivos XML.
  • Vínculo entre pré-entrada e pedido de compra TAG <xped>
  • Ganho de produtividade no recebimento de mercadoria.
  • Diminuir retrabalho.
  • Aumentar lucro.
  • Maior capacidade de reabastecimento.

Garantindo processos operacionais de conferências XML eficientes para propiciar agilidade no recebimento de mercadoria.

03. SOLUÇÃO

Criado nova Rotina 1321 - Importar XML Automático, para que realize importação de arquivos XML de forma automatizada.

04. CONFIGURAÇÃO

  1. Dependências
  2. Rotina 1321 - Importação XML Automático
  3. Regras de Negócio
  4. Configuração Cadastro
  5. Novas funções 1309
  6. Utilização 1095


Atualizar rotinas e tabelas

560 - Dicionário de dados

560 - Criação/Exclusão Permissão de Acesso (rotina 530)

560 - PCFORNEC

560 - PCNFENTXML

560 - PCPEDIDO e PCPEDIDO (Índice)

560 - PCITEM

560 - PCNENTPREENT

560 - PCMOVPREENTCOMPLE

560 - PCMOVPREENTCOMPLEPREENT

500 - Pacote para Leitura de XML

1321 - Importação XML Automática

530 - Permissão por usuário para a rotina 1321

530 - Permissão por usuário - 1309 - Permitir alterar tipo de entrada

Rotina - 1321 - Importação de XML Automático


Processo da rotina

A importação de XML Automático é simples e funciona seguindo os seguintes passos:

   (seleção) Manifestação do XML via rotina 1095

   (seleção) Inicialização da rotina 1321 (preferencial no servidor)

   (seleção) Verificação do processamento do XML (aba Situação XML rotina 1309)





Configurações/Layout

A rotina 1321 possui duas abas:

  • F2 - Parâmetros
    • Essa aba apresenta as seguintes configurações que podem ser realizadas para todos os arquivos XML importados automaticamente:
      • Filial - poderá ser escolhido qual filial irá processar os arquivos XML automaticamente
      • Tempo em minutos para reprocessar - poderá ser definido tempo para reprocessamento automático dos arquivos XML pendentes (Tempo mínimo 15 minutos)
      • Emitido até X dias antes - poderá ser definido quantos dias será processados os arquivos XML a partir de sua data de emissão (Dias máximo 90 dias)
      • Aceita produtos proibido para venda
      • Aceita produtos fora de linha
      • Carregar tirbutos/pol. comercial fora da NF 212
      • Considerar origem mercadoria do cadastro 238

  • Botão Iniciar/Parar

  • Caso botão seja acionado a rotina irá processar todos os arquivos XML que estão disponíveis para processamento;

  • Uma vez que a rotina 1321 foi iniciada as opções de marcar/desmarcar disponíveis na rotina 1321 ficam desabilitadas, para que seja desmarcado alguma opção deverá clicar o botão Iniciar/Parar novamente;

  • F3 - XML

    Essa aba exibe apenas para visualização a lista dos arquivos XML que estão sendo processados no momento atual:

    • Chave NFE
    • CPF/CNPJ
    • Cód. Fornecedor
    • Nº Nota
    • Dta Emissão
    • Nº Série
    • Cód. Filial


Processamento/Reprocessamento

  • A rotina deverá ser aberta em apenas uma máquina. Sugestão: colocar a rotina em um servidor.
  • A rotina tem a função de ser minimizada e ficará processando em background.



  • As opções marcadas na rotinas são salvas no .ini, caso a rotina seja fechada, ao ser reaberta ele irá buscar as configurações anteriores
  • O tempo de reprocessamento deverá ser definido conforme o volume de arquivos XML manifestados/baixados. Caso tenha muitos arquivos o time de reprocessamento deverá ser maior para que a rotina consiga processar todos os arquivos
  • A data de início de processamento caminha conforme a data atual. Exemplo:
    • A data atual , definido 30 dias (Emitido até x Dias Antes)
    • Será feito leitura ate  
    • Amanhã será dia   a leitura passa a ser do dia   a  
    • Próximo dia será  , a leitura passa a ser do dia  a  

Regras de negócio

1 - Processar do XML Automaticamente

   (informação) Manifestação/Baixa XML realizada via rotina 1095; 


              (aviso) Tabelas que são populadas por esse processo: PCMANIFDESTINATARIO e PCNFENTXML


   (informação) As notas não serão processadas quando:

      (erro) Não ter pré entrada do XML 1301

      (erro) Não ter entrada definitiva do arquivo XML por importação de XML via rotina 1301          

      (erro) Não ter entrada manual via rotina 1301          

      (erro) XML não ter sido rejeitado manualmente 1309               

             (aviso) A rejeição do arquivo XML poderá ser feita via rotina 1309 botão auxiliar (Rejeitar/Reativar XML). PCNFENTXML.SITUACAO = R         

      (erro) XML tem pré entrada ou entrada finalizada               

            (aviso) O XML fica nessa situação quando uma pré entrada é gravada pela rotina 1321. PCNFENTXML.SITUACAO = F


Quando o XML for processado pela rotina 1321, poderá ser colocado em uma situação 'Status' de processamento.

Situações que o arquivo XML poderá estar:

  • A ou nulo - Aguardando fila de processamento do XML
  • E - XML em processamento
  • P - XML Pendente
  • R - XML rejeitado manualmente
  • F - XML Finalizado - Pre entrada gravada

Tabela que a rotina 1321 consulta para encontrar a Situação do XML: PCNFENTXML.SITUACAO



2 - Como a 1321 irá identificar os produtos que estão no XML?

A rotina 1321, identificará os produtos automaticamente utilizando o recurso já existente na rotina 1301 (Pesquisa Automática).

A sequência para encontrar o produto será:

  • Código de Fabrica (253)

  • Código de Fabrica (203)


  • Código de Barras (203)


  • Código de Barras Master (203)




3 - Se a tag <xped> estiver preenchida no XML o que acontecerá?

Caso a rotina 1321 leia o arquivo XML e encontre o número do pedido de compra no XML ;

  • Numero do pedido no XML (tag <xped>) é igual a um pedido de compra já gravado?
  • Gera pré entrada considerando o tipo de entrada do pedido de compra;
  • Vincula pré entrada ao pedido de compra automaticamente;
  • Se a tag <xped> estiver vazia ou número inválido o arquivo XML será processado sem vínculo pré entrada com pedido;
  • Se a tag <xped> estiver com mais de 10 caracteres, o arquivo XML será processado sem vínculo pré entrada com pedido;
  • Se a tag <xped> estiver com letras ou caracteres especiais, o arquivo XML será processado sem vínculo pré entrada com pedido.


Verifica se a filial do pedido corresponde a filial do arquivo XML, olhando para o CGC/CPF do XML e cadastro 535

  • Se SIM vincular a pré entrada com pedido de compra;
  • O processo de vínculo entre pré entrada deverá ocorrer somente se as embalagens da pré entrada for igual a embalagem do pedido;
  • Caso diferentes as embalagens, deverá somente processar o arquivo XML e não vincular com pedido automaticamente;
  • Se NÃO a vinculação não deverá ser realizada, porém a pré entrada deverá ser processada.




4 - Produtos frios e peso variável como será tratado a importação XML?

Uma solução criada para agilizar o processo de entrada de produtos frios é o cálculo automático do fator de conversão conforme o arquivo XML. Assim desconsiderando os fatores já cadastrados.

Regra para conversão automática:

  • Quando o fornecedor estiver utilizando a opção Pedido Unidade Master;

  • Quando o produto encontrado estiver parametrizado:
    • Peso Variável for Sim; 

    • Tipo de estoque deve ser Frios(FR);


Cálculo automático fator:

  • Na importação de XML pela rotina 1301 ou 1321, será feito o cálculo: 
    • (Fator = <qTrib>/<qCom>) encontrando o fator, todavia deverá multiplicar o Fator encontrado pela <qCom> e assim achar a quantidade total do produtos;
    • O produto será sempre gravado na menor unidade Venda;
    • O fator será gravado nas movimentações quando calculado. PCMOVCOMPLE,FATORCALCULADOXML e PCMOVCOMPLEPREENT.FATORCALCULADOXML


OBSERVAÇÃO

  • Se o fator encontrado no calculo for igual a 1, as rotinas 1301 e 1321 olham para o fator da rotina 253




5 - Como será o comportamento ao importar um arquivo XML que os produtos tenham lote?

Se o produto encontrado no XML for controlado por lote:

  • A rotina 1321 irá desdobrar o lote conforme as informações contidas na tag </rastro>

Se o produto não controlar lote será gerado apenas o produto desconsiderando as informações de lote detalhadas no XML.

Parametrizações no cadastro Fornecedor (202)

Deve ser avaliado por fornecedor os parâmetros para a importação do XML utilizando a 1321.

  • Emitir pedido na unidade Master (Master ou Venda)
  • Gerar pedido de compra com XML
  • Importar XML automático
  • Utiliza redução de base ICMS 'PARA'
  • Considera ICMS desoneração motivo 9 cálculo Suframa/Repasse
  • Gravar código de fábrica na rotina 253?
  • Utilizar fator de conversão da rotina 253


Parametrizações no cadastro Produto (203 e 253)

Deve ser avaliado os cadastros dos produtos referente ao código de fábrica e código de barras. Cadastro do Produto rotina 253

  • Avaliar se os códigos de fábricas estão cadastrados corretamente (253 e 203)
  • Avaliar se os fatores de conversão estão cadastrados corretamente (253 e 203)
  • Avaliar se os códigos de barras estão cadastrados corretamente (203)

Regras de negócio 1309

Aba Pré Entrada

Novo Botão: Tipo Entrada

  1. É possível alterar o tipo de entrada de uma pré entrada quando clicar o botão Tipo Entrada;
  2. Alteração pode ser feita caso a pré entrada não esteja vinculada a nenhum pedido de compra;
  3. Alteração pode ser feita apenas com pré entradas divergentes;

      4. Caso a pré entrada esteja vinculada a um pedido de compra não é possível alterar o tipo de entrada via botão Tipo Entrada;

O botão tipo de entrada é controlado por permissão por usuário via rotina 530;

  • Permissão: Permitir alterar tipo de entrada


Aba Situação XML

Funções botão Pesquisar

Realiza a pesquisa do XML conforme dados nas tabelas PCMANIFDESTINATARIO e PCNFENTXML

  • Filial (Filtrar filial conforme tabela PCMANIFDESTINATARIO)
  • Fornecedor
  • Emite a partir de
  • Situação:
    • A ou nulo - Aguardando fila de processamento do XML
    • E - XML em processamento
    • P - XML Pendente
    • R - XML rejeitado manualmente
    • F - XML Finalizado - Pré entrada gravada

  • Núm. Nota
  • Núm. Chave NFe
  • Natureza da Operação (opção para pesquisar por %%)

Grid da aba Situação XML

  • Selecione
  • Chave NFE
  • CPF/CNPJ
  • Cód. Fornecedor
  • Cód. Filial
  • Nº Nota
  • Dta Emissão
  • Transação
  • Dta Processamento
  • Situação
  • Nº Tentativas
  • Natureza Operação
  • XML - (Nessa opção o usuário poderá dar duplo clique e abrir as informações gravadas no campo PCNFENTXML.DADOSXML)
  • Ordem da Fila
  • Possui Nota
  • Possui Entrada


Funções:

Ao clicar em XML no grid poderá ser definido as seguintes ações:

  • Ordenar: Enviar para início
    • A função enviar o XML para o início da fila, dando prioridade ao seu processamento
  • Reabilitar para nova tentativa
    • A função reabilita o XML para que entre na fila de processamento
  • Rejeitar/Reabilitar XML
    • A função Rejeitar coloca o XML em situação Rejeitado e o XML não será reprocessado. Para reprocessamento o usuário deverá Reabilitar XML

Caso tenha necessidade de fazer essa ação para vários XML, basta Selecionar (Grid ou botão) e clicar no botão Ação




Visualização XML

Ao clicar em um XML no grid opção XML poderá ser visualizado o arquivo XML.

Caso queira visualizar o arquivo XML em formato de Danfe, deverá ser clicado no botão Danfe. 

  • O XML impresso como Danfe não tem valor fiscal
  • O layout do Danfe não poderá ser alterado
  • Usuário poderá imprimir, salvar ou visualizar

Log XML

Quando um arquivo XML é processado, é gravado um log do processamento;

Caso o XML não seja gravado como pré entrada irá ser gravado log do motivo;

O log será apenas para visualização, assim o usuário não poderá alterar o mesmo;

Rotina 1095

  • Opção para manifestar vários arquivos, utilizando a função F11 para replicar o tipo de manifestação que será realizado
  • Ao fazer manifestação a rotina irá baixar automaticamente os XML.


Para mais informações sobre download automático de XML acesse o DT - Ajuste fluxo no processo download de XML e nos eventos relacionados a manifestação.



Estamos à disposição para mais esclarecimentos e sugestões.

Central de Relacionamento - (62) 3250 0210