manual importação xml - helpfacil t_cnico... · pasta de destino onde o programa irá mover os...

20
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

Upload: others

Post on 25-Nov-2020

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Manual Importação XML - HelpFacil T_cnico... · 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

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

Page 2: Manual Importação XML - HelpFacil T_cnico... · 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

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>

Page 3: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 4: Manual Importação XML - HelpFacil T_cnico... · 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

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 @.

Page 5: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 6: Manual Importação XML - HelpFacil T_cnico... · 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

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:

Page 7: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 8: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 9: Manual Importação XML - HelpFacil T_cnico... · 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

9

2.2 - Mensagem Nota: Apresenta a mensagem adicional do XML - TAG InfAdic.

Page 10: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 11: Manual Importação XML - HelpFacil T_cnico... · 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

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)

Page 12: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 13: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 14: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 15: Manual Importação XML - HelpFacil T_cnico... · 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

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

Page 16: Manual Importação XML - HelpFacil T_cnico... · 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

16

3.2 – Consultando XML na SEFAZ

3.3 – Status da Importação

Page 17: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 18: Manual Importação XML - HelpFacil T_cnico... · 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

18

4.4 Msg. Erro

Verifica o código de retorno do XML, coluna Cód.Ret.XML.

Page 19: Manual Importação XML - HelpFacil T_cnico... · 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

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.

Page 20: Manual Importação XML - HelpFacil T_cnico... · 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

20