manual importação xml - helpfacil t_cnico... · pasta de destino onde o programa irá mover os...
TRANSCRIPT
1
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
Manual Importação XML
2
Procedimentos para Implementação 1. Aplicar Path. 2. Compilar pontos de entrada.
Pré-Nota
Ponto de Entrada Descrição
MT103CWH
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.
MA140BUT Inclusão de botão no Enchoice da rotina de recebimento.
A140EXC Valida a Exclusão da Pré-Nota. SF1140I Executado após a gravação do SF1. MT140TOK Valida a inclusão do Pré-Nota.
Documento de Entrada
Ponto de Entrada Descrição
MT103CWH
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.
MA1003BUT Inclusão de botão no Enchoice do Doc.Entrada. SF1100E Executado antes de deletar o registro do SF1, na
exclusão da Nota de Entrada. SF100I Executado após a gravação do SF1. MT100TOK 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>
3
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.
4
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 @.
5
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.
6
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:
7
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.
8
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.
9
2.2 - Mensagem Nota: Apresenta a mensagem adicional do XML - TAG InfAdic.
10
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.
11
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)
12
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.
13
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.
14
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.
15
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
16
3.2 – Consultando XML na SEFAZ
3.3 – Status da Importação
17
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.
18
4.4 Msg. Erro
Verifica o código de retorno do XML, coluna Cód.Ret.XML.
19
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.
20