Manual Importação XML Ambiente : Compras \ Estoque Custos Data: 23/02/2011 Base de Dados: DBF \ SQL Tabelas envolvidas: ZXM (XML Fornecedor) ZXN (Tabela Auxiliar XML) SA2 (Cadastro Fornecedor) SA5 (Amarração Produto x Fornecedor) SB1 (Cadastro de Produto) SF1 (Cabeçalho das NF de Entrada) SD1 (Itens das NF de Entrada) SC7 (Pedidos de Compra) Características: 1. Arquiva XML em tabela(zxm - ZXN), não é necessário guardar arquivo.xml opção de rotina para exportar arquivo. 2. Roda em TOPCONNECT e em DBF. 3. Exporta arquivo XML gravado. 4. Importa XML do e-mail ou pasta. 5. Consulta XML na SEFAZ na hora da Importação. 6. Configuração por Empresa \ Filial. 7. Utiliza protocolo POP\IMAP\MAPI 8. Utilizando protocolo IMAP pode-se mover de uma caixa origem para uma de destino, na importação por e-mail. Ex.: Carrega XML da Caixa de Entrada (pasta de Origem) e após a importação, com sucesso, move o e-mail para pasta Importados (pasta de Destino). 9. Importa XML de uma empresa para outra. Ex.: Importando XML da Empresa 01 porém o XML é da Empresa 04. 10.É possível criar a tabela ZXM, ZXN em apenas uma empresa, caso o XML for para outra empresa o sistema ira verificar se a tabela existe, caso não exista o sistema ira criar automaticamente. 11.Recusa XML do fornecedor com opção de envio de e-mail, informando o motivo da recusa. 12.Cancelar Importação. 13.Gera Pré-Nota ou Doc.Entrada, conforme configuração. 14.Vincula pedido de compra. 15.Replica Produto, TES e Almoxarifado. 16.Workflow verifica se fornecedor cancelou o XML. 17.Rotina de Envio de E-mail 1
1. Aplicar Path. 2. Compilar pontos de entrada. Procedimentos para Implementação Pré-Nota Ponto de Entrada MT103CWH MA140BUT A140EXC SF1140I MT140TOK Descrição Checa WHEN dos campos de cabeçalho da Pré-Nota e Nota. Bloqueia a edição dos campos: Tipo da Nota, Numero da NF, Serie, Fornecedor, Uf.Origem. Inclusão de botão no Enchoice da rotina de recebimento. Valida a Exclusão da Pré-Nota. Executado após a gravação do SF1. Valida a inclusão do Pré-Nota. Documento de Entrada Ponto de Entrada MT103CWH MA1003BUT SF1100E SF100I MT100TOK Descrição Checa WHEN dos campos de cabeçalho do Documento de Entrada. Bloqueia a edição dos campos: Tipo da Nota, Numero da NF, Serie, Fornecedor, Uf.Origem. Inclusão de botão no Enchoice do Doc.Entrada. Executado antes de deletar o registro do SF1, na exclusão da Nota de Entrada. Executado após a gravação do SF1. Valida a inclusão do Doc.Entrada. 3. Criar tabelas ZXM e ZXN. Appendar para tabela SIX o arquivo SIX_ZXM_ZXN. Appendar para tabela SX2 o arquivo SX2_ZXM_ZXN. Appendar para tabela SX3 o arquivo SX3_ZXM_ZXN. (versão DBF deverá criar os campos MEMO via configurador) Salvar arquivo ZXM_ERROS_NFE.txt na pasta \System. 4. Criar campo F1_XMLOBS. (Grava o motivo da inclusão do Doc.Entrada \ Pré-Nota sem o XML). 5. Colocar no Menu do modulo de Compras ou Estoque. <MenuItem Status="Enable"> <Title lang="pt">importa XML NF-e</Title> <Title lang="es">importa XML NF-e </Title> <Title lang="en">importa XML NF-e </Title> <Function>ImpXMLNFe</Function> <Type>03</Type> <Tables>ZXM</Tables> <Tables>ZXN</Tables> <Access>xxxxxxxxxx</Access> <Module>02</Module> ou <Module>04</Module> <Owner>0</Owner> </MenuItem> 2
Configurações Iniciais Configuração é realizada por Empresa Filial ou seja cada Empresa - Filial deverá ser configurada individualmente. Config. Empresa Num. Horas Canc. XML: Informa a quantidade de horas para possibilitar o cancelamento da NF-e. Parâmetro utilizado para verificar se fornecedor cancelou o XML. Caso o XML esteja com status de Importado\Gravado, e o fornecedor cancelou o XML ANTES desse período, é enviado um e-mail, para determinado(s) usuário(s) informando o cancelamento (e-mail disparado pelo workflow). Parâmetro MV_SPEDEXC. Caminho arq. XML: Caminho padrão de onde estão os arquivos XML. Utilizado na opção de carregar XML para selecionar a pasta de origem dos arquivos. Série NF Saída: Série da NF Saída que da Filial. Parâmetro utilizado para os XML s que forem de transferencia. Na primeira inicialização o programa busca a série do parâmetro MV_ESPECIE. Gera Pré-Nota\Doc.Entr: Gera Pré-Nota o Documento de Entrada. 3
Inclui Pré\Nota sem XML? É possível a inclusão da Pré-Nota ou Doc.Entrada sem o arquivo XML. Deverá ser informado um motivo da inclusão da Pré-Nota\Doc.Entrada sem o XML. Pré\Doc com Status <> Aprovado? Grava Pré-Nota ou Doc.Entrada com Status <> Aprovado. Caso ocorra problema na consulta do XML na SEFAZ e não retornar nenhum status é possível incluir a Pré-Nota ou Doc.Entrada. Recebem e-mail quando: Ocorrer problema no envio dos e-mail: Quando é disparado um e-mail e ocorre algum problema (e-mail destinatário inválido), é possível enviar um e-mail, para determinado(s) usuário(s), e informar que o e-mail não foi enviado para o(s) destinatário(s). Ex.: Ao recusar um XML e enviado um e-mail ao fornecedor e ocorrer algum erro no envio. Obs.: colocar apenas o nome da conta sem @. Coloque ";" para adicionar mais contas. Fornecedor cancelar XML antes do prazo: Conta de e-mail do(s) usuário(s) para receber e-mail informando que XML foi cancelado pelo fornecedor. Obs.: colocar apenas o nome da conta sem @. Coloque ";" para adicionar mais contas. Domínio Empresa: Ex.: colocar empresaxyz.com.br sem @. 4
Config. XML Fornec. Nota com 9 Dígitos: Completa com "0" Zeros o restante dos caracteres da Pre-Nota\Doc.Entrada. Série com 3 Dígitos: Completa com "0" Zeros o restante dos caracteres da Pre-Nota\Doc.Entrada. 5
Config. E-mail Path Table: Diretório onde esta localizado os arquivos SX s. Protocolo de E-mail: Indica o protocolo de e-mail que será usado para recebimento de e-mail. Autentificação: Utiliza Autentificação? Conexão Segura: Utiliza conexão segura? SSL: Define o envio de e-mail utilizando uma comunicação segura através do SSL - Secure Sockets Layer. O suporte aos protocolos (SSL e/ou TLS) foram implementados a partir da build 7.00.101220A. TLS: Define no envio de e-mail o uso de STARTTLS durante o protocolo de comunicação. O suporte aos protocolos (SSL e/ou TLS) foram implementados a partir da build 7.00.101220A. Pasta Origem E-mail: 6
Pasta de Origem de onde o programa irá LER os e-mails e buscar os XMLs. Pasta Destino E-mail: Pasta de Destino onde o programa irá MOVER os e-mails após importa-los para o sistema. Obs.: Opção apenas para Protocolo IMAP. Servidor de Envio: Indica o endereço ou alias do servidor de Envio e-mail IMAP/POP/MAPI/SMTP. Porta SMTP: Indica a porta de comunicação para conexão SMTP (Padrão 25) para envio dos e- mails. Porta POP\IMAP\MAPI Indica a porta de comunicação de recebimento de e-mails. Servidor de Recebimento: Indica o endereço ou alias do servidor de Recebimento de e-mail IMAP/POP/MAPI/SMTP. Teste Conexão: Testa se as configurações estão corretas. 7
Menu Principal Obs.: Foi disponibilizado um Ponto de Entrada (ROT_IMPXMLNFE) onde é possível adicionar, alterar, retirar, customizar os botões do menu principal. 1. Pesquisar: Realiza pesquisa conforme opção do usuário. 2. Visualizar: Abre browser com dados do arquivo XML para visualizar e grava-lo. Botões tela de visualização: 2.1 - Visualizar XML: Abre browser com a estrutura do XML. 8
2.2 - Mensagem Nota: Apresenta a mensagem adicional do XML - TAG InfAdic. 9
2.3 - Histórico Fornecedor: Monta tela com informações sobre o fornecedor tais como: Informações Gerais, Títulos em Aberto, Títulos Pagos, Pedidos de Compras, Faturamento e Produtos. 2.4 - Cad. Fornecedor: Mostra tela de cadastro do fornecedor, apenas visualização. 10
2.5 - Pedido de Compras: Opção para selecionar pedido de compra do fornecedor Opção por item. Após confirmar o n.º e item do pedido de compra o sistema ira alimentar os campos No do Pedido e Item do Ped. Obs.: Tecla de atalho - F6. 2.6 - Replicar Produtos: O usuário poderá amarrar 1 produto para 1 ou vários itens do fornecedor. Após confirmar o sistema ira replicar para o campo Código os itens selecionados. Obs.: Tecla de atalho F7. (Almox. F8, TES F9) 11
2.7 - Pré-Nota \ Doc. Entrada: Gera Pré-Nota ou Doc. Entrada, conforme configuração, após gerar Pré-Nota ou Doc. Entrada. Após inclusão do Doc.Entrada\Pré-Nota não será possível alterar o GRID de importação, o usuário apenas poderá visualizar as informações. 2.7.1 Divergência XML x Doc.Entrada\Pré-Nota: Ao confirmar os dados e clicar em gerar Doc.Entrada Pré-Nota é verificado o NCM cadastrado no sistema e o NCM que esta no XML, quantidade e valor unitário também são verificados. 12
Ao confirmar a geração da nota a tela de Documento de Entrada é apresentada, para o usuário confirmar os dados e então gravar, ou não o documento. Obs.: Caso ocorra algum erro na geração do documento uma tela será apresentada e o usuário poderá verificar o erro. 13
Observações: 1- Antes de apresentar a tela o sistema ira verificar se é uma operação de transferência e se o cadastro de produto, SB1, é compartilhado então o sistema já ira trazer preenchido o campo Código com o(s) código(s) que estão no XML, sem a necessidade de preenchimento pelo usuário. 2- Ao clicar no campo Código o sistema ira verificar se existe amarração do produto que esta posicionado. Caso haja amarração, tabela SA5, e sistema abrira uma tela com o(s) código(s) existente. O Usuário poderá selecionar um produto ou adicionar novo. 14
3. Carregar XML Carrega XML a partir de um diretório ou direto do e-mail. Para cada arquivo que é importado é verificado o status do XML na SEFAZ. Após carregar o XML o sistema apresentará o status da importação que poderá ser: Importado com Sucesso, CNPJ do Destinatário não encontrado, CNPJ do Remetente não encontrado, Problema na estrutura do XML, Problema com a tabela ZXM e Arquivo já Importado. Após importado o arquivo é renomeado, para NomeArquivo_IMPORTADO e gravado em uma pasta dentro do diretório atual chamada XML_IMPORTADO. 3.1 Selecionando Arquivo XML 15
3.2 Consultando XML na SEFAZ 3.3 Status da Importação 16
4. Consulta SEFAZ 4.1 Status XML Verifica na SEFAZ Status do XML. Após verificação é atualizado o status do arquivo. 4.2 Status SEFAZ Retorna o status da SEFAZ no momento. 4.3 Site SEFAZ Abre browser do portal NF-e para consultar XML, já traz a chave de acesso. 17
4.4 Msg. Erro Verifica o código de retorno do XML, coluna Cód.Ret.XML. 18
5. Exporta Exporta XML conforme parâmetro do usuário. 6. Recusa XML O usuário terá a opção de recusar o XML e enviar e-mail para o fornecedor informando que o porque o seu arquivo foi recusado. 19
20