Manual Importao XML

Ambiente : Compras \ Estoque Custos Base de Dados: DBF \ SQL

Data: 23/02/2011

Tabelas envolvidas:

ZXM (XML Fornecedor) ZXN (Tabela Auxiliar XML) SA2 (Cadastro Fornecedor) SA5 (Amarrao Produto x Fornecedor) SB1 (Cadastro de Produto) SF1 (Cabealho das NF de Entrada) SD1 (Itens das NF de Entrada) SC7 (Pedidos de Compra)

Caractersticas: 1. Arquiva XML em tabela(ZXM - ZXN), no necessrio guardar arquivo .xml opo 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 Importao. 6. Configurao 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 importao por e-mail. Ex.: Carrega XML da Caixa de Entrada (pasta de Origem) e aps a importao, 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 porm o XML da Empresa 04. 10. possvel 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 no exista o sistema ira criar automaticamente. 11.Recusa XML do fornecedor com opo de envio de e-mail, informando o motivo da recusa. 12.Cancelar Importao. 13.Gera Pr-Nota ou Doc.Entrada, conforme configurao. 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-mail1

Procedimentos para Implementao 1. Aplicar Path. 2. Compilar pontos de entrada. Ponto de Entrada Descrio Checa WHEN dos campos de cabealho da Pr-Nota e Nota. Bloqueia a edio dos campos: Tipo da Nota, Numero da NF, Serie, Fornecedor, Uf.Origem. Incluso de boto no Enchoice da rotina de recebimento. Valida a Excluso da Pr-Nota. Executado aps a gravao do SF1. Valida a incluso do Pr-Nota. Descrio Checa WHEN dos campos de cabealho do Documento de Entrada. Bloqueia a edio dos campos: Tipo da Nota, Numero da NF, Serie, Fornecedor, Uf.Origem. Incluso de boto no Enchoice do Doc.Entrada. Executado antes de deletar o registro do SF1, na excluso da Nota de Entrada. Executado aps a gravao do SF1. Valida a incluso do Doc.Entrada.

MT103CWH Pr-Nota MA140BUT A140EXC SF1140I MT140TOK Ponto de Entrada

MT103CWHDocumento de Entrada

MA1003BUT SF1100E SF100I MT100TOK

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. (verso 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 incluso do Doc.Entrada \ Pr-Nota sem o XML). 5. Colocar no Menu do modulo de Compras ou Estoque. Importa XML NF-e Importa XML NF-e Importa XML NF-e ImpXMLNFe 03 ZXM ZXN xxxxxxxxxx 02 ou 04 0 2

Configuraes Iniciais

Configurao 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. Parmetro 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 perodo, enviado um e-mail, para determinado(s) usurio(s) informando o cancelamento (e-mail disparado pelo workflow). Parmetro MV_SPEDEXC.

Caminho arq. XML: Caminho padro de onde esto os arquivos XML. Utilizado na opo de carregar XML para selecionar a pasta de origem dos arquivos. Srie NF Sada: Srie da NF Sada que da Filial. Parmetro utilizado para os XMLs que forem de transferencia. Na primeira inicializao o programa busca a srie do parmetro MV_ESPECIE. Gera Pr-Nota\Doc.Entr: Gera Pr-Nota o Documento de Entrada.

3

Inclui Pr\Nota sem XML? possvel a incluso da Pr-Nota ou Doc.Entrada sem o arquivo XML. Dever ser informado um motivo da incluso 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 no retornar nenhum status possvel 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 destinatrio invlido), possvel enviar um e-mail, para determinado(s) usurio(s), e informar que o e-mail no foi enviado para o(s) destinatrio(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) usurio(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. Domnio Empresa: Ex.: colocar empresaXYZ.com.br sem @.

4

Config. XML Fornec.

Nota com 9 Dgitos: Completa com "0" Zeros o restante dos caracteres da Pre-Nota\Doc.Entrada. Srie com 3 Dgitos: Completa com "0" Zeros o restante dos caracteres da Pre-Nota\Doc.Entrada.

5

Config. E-mail

Path Table: Diretrio onde esta localizado os arquivos SXs. Protocolo de E-mail: Indica o protocolo de e-mail que ser usado para recebimento de e-mail. Autentificao: Utiliza Autentificao ? Conexo Segura: Utiliza conexo segura ? SSL: Define o envio de e-mail utilizando uma comunicao segura atravs 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 comunicao. 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 aps importa-los para o sistema. Obs.: Opo apenas para Protocolo IMAP. Servidor de Envio: Indica o endereo ou alias do servidor de Envio e-mail IMAP/POP/MAPI/SMTP. Porta SMTP: Indica a porta de comunicao para conexo SMTP (Padro 25) para envio dos emails. Porta POP\IMAP\MAPI Indica a porta de comunicao de recebimento de e-mails. Servidor de Recebimento: Indica o endereo ou alias do servidor de Recebimento de e-mail IMAP/POP/MAPI/SMTP. Teste Conexo: Testa se as configuraes esto corretas.

7

Menu Principal

Obs.: Foi disponibilizado um Ponto de Entrada (ROT_IMPXMLNFE) onde possvel adicionar, alterar, retirar, customizar os botes do menu principal.

1. Pesquisar: Realiza pesquisa conforme opo do usurio.

2. Visualizar: Abre browser com dados do arquivo XML para visualizar e grava-lo.

Botes tela de visualizao: 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 - Histrico Fornecedor: Monta tela com informaes sobre o fornecedor tais como: Informaes Gerais, Ttulos em Aberto, Ttulos Pagos, Pedidos de Compras, Faturamento e Produtos.

2.4 - Cad. Fornecedor: Mostra tela de cadastro do fornecedor, apenas visualizao.

10

2.5 - Pedido de Compras: Opo para selecionar pedido de compra do fornecedor Opo por item. Aps 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 usurio poder amarrar 1 produto para 1 ou vrios itens do fornecedor. Aps confirmar o sistema ira replicar para o campo Cdigo 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 configurao, aps gerar Pr-Nota ou Doc. Entrada. Aps incluso do Doc.Entrada\Pr-Nota no ser possvel alterar o GRID de importao, o usurio apenas poder visualizar as informaes.

2.7.1 Divergncia 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 unitrio tambm so verificados.

12

Ao confirmar a gerao da nota a tela de Documento de Entrada apresentada, para o usurio confirmar os dados e ento gravar, ou no o documento.

Obs.: Caso ocorra algum erro na gerao do documento uma tela ser apresentada e o usurio poder verificar o erro.

13

Observaes: 1- Antes de apresentar a tela o sistema ira verificar se uma operao de transferncia e se o cadastro de produto, SB1, compartilhado ento o sistema j ira trazer preenchido o campo Cdigo com o(s) cdigo(s) que esto no XML, sem a necessidade de preenchimento pelo usurio.

2- Ao clicar no campo Cdigo o sistema ira verificar se existe amarrao do produto que esta posicionado. Caso haja amarrao, tabela SA5, e sistema abrira uma tela com o(s) cdigo(s) existente. O Usurio poder selecionar um produto ou adicionar novo.

14

3. Carregar XML Carrega XML a partir de um diretrio ou direto do e-mail. Para cada arquivo que importado verificado o status do XML na SEFAZ. Aps carregar o XML o sistema apresentar o status da importao que poder ser: Importado com Sucesso, CNPJ do Destinatrio no encontrado, CNPJ do Remetente no encontrado, Problema na estrutura do XML, Problema com a tabela ZXM e Arquivo j Importado. Aps importado o arquivo renomeado, para NomeArquivo_IMPORTADO e gravado em uma pasta dentro do diretrio atual chamada XML_IMPORTADO.

3.1 Selecionando Arquivo XML

15

3.2 Consultando XML na SEFAZ

3.3 Status da Importao

16

4. Consulta SEFAZ 4.1 Status XML Verifica na SEFAZ Status do XML. Aps verificao 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 cdigo de retorno do XML, coluna Cd.Ret.XML.

18

5. Exporta Exporta XML conforme parmetro do usurio.

6. Recusa XML O usurio ter a opo de recusar o XML e enviar e-mail para o fornecedor informando que o porque o seu arquivo foi recusado.

19

20

7. Cancelar Cancela importao do XML.

8. Excluir Exclui importao do XML.

9. Configuraes Vide inicio do manual.

10. Legenda

21

Workflow

A rotina WFNfeCanc verifica se o XML esta importado e o por algum motivo o fornecedor cancelou o XML e no informou o cancelamento para a empresa. enviado um e-mail para determinado(s) endereo(s), conforme configurao, informando do cancelamento.

22

Envia Email Esta disponibilizado uma rotina chamada Envia_Email, que envia e-mail. O programa tenta enviar o e-mail para todos os destinatrios, caso algum e-mail esteja com erro o programa ira enviar 1 a 1 o e-mail para seus destinatrios, caso ocorra algum erro enviado um email para um usurio informando que X destinatrio no recebeu o e-mail. O programa utiliza as seguintes configuraes da tela de configuraes:

O desenvolvedor poder utiliza-la passando os seguintes parmetros: Nome da Rotina que esta chamando o Envia_Email. Assunto do E-mail. Destinatrio(s). Cpia do E-mail. Cpia Oculta. Corpo do E-mail. Atachado. Remetente.

23

Ex.: cRotina := REL_FAT>MENSAL cAssunto:= Relatrio Mensal Maro 2011 cPara := diretoria; supervisores; deptofaturamento cCopia := administrador cCopOcult := cCorpoEmail := Segue relatrio Mensal do faturamento das Filiais 01\02\03 cAtachado := \Relato\RelFatMensal.##r cRemetente := empresazxy U_ENVIA_EMAIL(cRotina, cAssunto, cPara, cCopia, cCopOcult, cCorpoEmail, cAtachado, cRemetente)

24