mastersafdfe_8 - parametrização receptor - ct-e.pdf

PARAMETRIZAÇÃO RECEPTOR CT-EMASTERSAF DF-E

MASTERSAF DF-E PARAMETRIZAÇÃO DO RECEPTOR CT-E

Publicado em 21/12/2012

ÍNDICELogin ....................................................................................................................................................................... 1

Troca de senha ........................................................................................................................................................ 1

Administração do Sistema.......................................................................................................................................2

Certificados .............................................................................................................................................................2

Usuários ..................................................................................................................................................................3Dados do Usuário .................................................................................................................................................................................. 4Permissões do Usuário .......................................................................................................................................................................... 4

Empresas.................................................................................................................................................................5

Extrator de E-mail.................................................................................................................................................... 7Integração com Receptor ...................................................................................................................................................................... 7Configurações Gerais............................................................................................................................................................................. 8Configurações de Contas....................................................................................................................................................................... 9

Módulo Integrador.................................................................................................................................................. 11Tipos de Eventos................................................................................................................................................................................... 13Formato de nomenclatura dos arquivos de retorno: ........................................................................................................................... 13


LOGIN

Com o portal iniciado, vamos iniciar o navegador de internet com o seguinte link http://localhost:8080/portal/mvc/login (onde loca-lhost deve ser o servidor onde a aplicação está hospedada).

TROCA DE SENHA

Na parte superior do site, conforme figura abaixo, são apresentadas as seguintes opções:

Mastersaf >> Trocar senha: permite a alteração da senha;

Logout:Sair do sistema;

Opções na parte superior

1Publicado em 21/12/2012

http://localhost:8080/portal/mvc/login


ADMINISTRAÇÃO DO SISTEMA

O link “Administração do Sistema” leva à tela com as funções administrativas.

Administração do Sistema

CERTIFICADOS

Nessa opção cadastra-se o certificado da(s) empresa(s). Selecionar o arquivo do certificado, digitar a senha e clicar emCadastrar. Observar também se o mesmo poderá ser vinculado às filiais, de acordo regras de cada município. Em casoafirmativo, a opção Aplicar para matriz e filiais pode ser marcada;

Atualização do certificado



USUÁRIOS

Na opção Usuários, são apresentados todos os usuários cadastrados no sistema. Para efetuar uma busca, utilizar a opção FiltrarResultado. Itens dessa tela:

• Cadastrar novo usuário ( );

• Filtrar Resultado ( );

• Indicador de usuário habilitado. Clicar para desabilitar ( );

• Indicador de usuário desabilitado. Clicar para habilitar ( );

• Para Editar dados do Usuário ( );

E o módulo mensageria fica responsável pela comunicação com a SEFAZ para fazer a consulta da chave do CT-e.

Tela de listagem de usuários

Para cadastrar um novo usuário, clicar em Cadastrar. Na tela que se abre, preencher os campos solicitados.



Cadastro de usuário

DADOS DO USUÁRIO

• Login: preencher com o login do novo usuário;

• Seu Nome: preencher com o nome do novo usuário;

• Email: email do novo usuário;

• Data de Expiração: data na qual expira o usuário sendo criado;

• Status: se o usuário será incluído com o status habilitado ou desabilitado;

• Grupo Empresa: grupo de empresas ao qual o usuário faz parte;

PERMISSÕES DO USUÁRIO

Aqui são selecionadas as permissões que o novo usuário receberá. Caso o usuário sendo criado seja um usuário para ser utilizado noIntegrador, selecionar permissão de integração (NFSE Integrador).

Filtro: através do filtro de pesquisa pode-se buscar por usuário através de uma parte de seu login/nome.



Tela de listagem de usuários

EMPRESAS

Os seguintes dados são solicitados no cadastramento de uma nova empresa:

• CNPJ: CNPJ da nova empresa;

• Razão Social: razão social da nova empresa;

• Inscrição Estadual: Para nota Mercantil / CT-e esse campo será Obrigatório;

• Inscrição Municipal: Para nota de Serviço esse campo será Obrigatório;

• Email Administrador: email do administrador da nova empresa;

• Grupo Empresa: grupo de empresas ao qual a nova empresa faz parte;

• Estado e cidade;

• Status: indica se a empresa está habilitada ou não;

• Parâmetro de Fuso Horário: O sistema adota por padrão a hora local do Servidor, caso o servidor não esteja no mesmofuso onde serão emitidos os documentos fiscais é possível fazer o ajuste para mais ou menos horas de acordo com a horado servidor.

• Logotipo: logo da nova empresa (selecionar a imagem);

• Parâmetros específicos: parâmetros dos módulos de NFS, NFE e CTE;

Os campos de preenchimentos obrigatórios estão sinalizados com um asterisco.

OBS: no caso de instalação in house, será solicitado o arquivo XML de licenciamento no cadastramento de umanova empresa.



Dados da empresa

Assim como na tela de usuários, uma empresa pode ser desabilitada ou habilitada. Para isso clicar no ícone ou .

Através da opção Filtrar Resultado pode-se buscar por uma empresa através de seu CNPJ/Razão Social.

Listagem de empresas



EXTRATOR DE E-MAILO módulo extrator é responsável por “baixar” os e-mails da caixa de entrada de uma conta especificada para o recebimento de XMLdo CT-e, salvando os mesmos em pastas pré-configurada pelo usuário.Para iniciar o extrator deve-se abrir um terminal de comandos, acessar o diretório onde o arquivo “extrator.jar” foi descompactado edigitar uma das seguintes linhas de comando:

(a) java -jar extrator.jar (inicia o extrator sem o modo de configuração de dados)

(b) java -jar extrator.jar --configurar (inicia o extrator com o modo de configuração de dados).

Caso a opção (b) tenha sido a escolhida, ou o extrator foi iniciado pela primeira vez, uma tela irá aparecer onde o usuário irá configuraros dados das contas de e-mail onde este deseja que o extrator pegue os arquivos para a importação do módulo de Recebimento.

INTEGRAÇÃO COM RECEPTOR

A integração do extrator com o módulo extrator com o receptor de CT-e se dá quando o extrator busca nas contas de e-mail configura-das, os XML processados e os coloca na pasta de entrada/envio do receptor.



CONFIGURAÇÕES GERAIS

A aba “Geral” possui os dados que serão compartilhados por todas as contas de e-mail que o usuário irá configurar:

Campo Utilização

Tam. máximo e-mail Limita o tamanho máximo que um e-mail pode ter para ser salvo, no exemplo se algum e-mail ultrapassar 1024Kb, este será ignorado. Caso deseja-se que todos os e-mails sejamsalvos sem se preocupar com limites de tamanho o valor zero deve ser informado.

Tam. máximo anexo Limita o tamanho máximo que os anexos do e-mail podem ter, no exemplo se algum anexoultrapassar os 256Kb, o e-mail será ignorado. Caso deseja-se que todos os anexos sejamsalvos sem se preocupar com limites de tamanho o valor zero deve ser informado.

Extensões anexos Informado extensões exclusivas do extrator. Ao adicionar novas extensões nessa lista, oextrator irá salvar um arquivo caso o anexo tenha a extensão presente na lista. Caso nãoseja informada nenhuma extensão o extrator irá salvar todos os anexos do e-mail em quehouver xml. Adicionam-se novas extensões clicando no botão “+” presente no lado da listade extensões, e remove-se selecionando a extensão desejada e clicando no botão “-”.

Pasta log Determina onde os arquivos de log do extrator serão salvos. Utilizar o botão “...” para locali-zar o local desejado.

Tam. máximo log Tamanho máximo que um arquivo de log possuirá.

Total arquivos log Quantidade máxima de arquivos de log que serão salvos por vez, quando o limite é alcan-çado os arquivos mais antigos são sobrescritos. Caso deseja-se ter uma quantidade inde-terminada de arquivos log, o valor zero deve ser informado.

Nível log Nível de detalhamento do que o extrator está fazendo, aonde INFO é o que possui menosdetalhes e TRACE o que possui mais.

INFO: descreve informações de execução da aplicação;

WARN: informa situações que devem ser averiguadas para não ocorrer erros; ERROR: des-creve situações onde erros ocorrem que ainda permitem a execução do sistema;

FATAL: descrevem situações aonde os erros irão levar o sistema a parar de funcionar;

DEBUG: informa a execução do sistema de uma forma mais detalhada para averiguar errose melhorias;

TRACE: detalha de uma forma mais meticulosa cada parte da execução do sistema.

Total de threads Total de serviços simultâneos que irá comunicar-se com as contas de e-mail e extrair osmesmos.

Proxy URL URL do servidor de proxy, deixar em branco se nenhum servidor de proxy é utilizado. Ao uti-lizar proxy recomenda-se utilizar do tipo socket5 (proxy de soquete).

Proxy porta Porta do servidor de proxy, deixar em branco se nenhum servidor de proxy é utilizado.

Proxy usuário Usuário do servidor de proxy, deixar em branco se nenhum servidor de proxy é utilizado.

Proxy senha Senha do servidor de proxy, deixar em branco se nenhum servidor de proxy é utilizado.



CONFIGURAÇÕES DE CONTAS

A aba “Contas” possui os dados que serão utilizados para a conexão com os servidores de e-mails e suas devidas contas:



Após configurado e salvo os dados, o usuário pode fechar a janela e executar o comando java -jar extrator.jar, fazendo com que oextrator inicie a comunicação com as contas de e-mails configuradas anteriormente.

Campo Utilização

Contas Lista dos servidores de e-mails cadastrados, caso deseja-se modificar algum dadode um dos servidores, este deve ser selecionado primeiramente nesse campo. Paraadicionar um servidor novo utiliza-se o botão “+” ao lado do campo e, para remo-ver uma conta, deve-se selecioná-la e clicar no botão “-”.

Servidor Campo que permite a alteração do nome do servidor.

Conexão segura Marcar este campo se o servidor utilizar SSL.

Protocolo Selecionar qual protocolo que o servidor utiliza (POP3 ou IMAP).

Porta Porta de conexão do servidor.

E-mails Lista de contas de e-mails do servidor selecionado. Para adicionar uma conta de e-mail utiliza-se o botão “+” ao lado deste campo e, para remover alguma conta de e-mail, deve-se selecioná-la e clicar no botão “-”.

Habilitada Indica se a conta de e-mail deve ser lida e tiver seus e-mails processados pelo extra-tor.

Usuário Campo que permite alterar o nome da conta de e-mail que o usuário usa paraconectar-se ao servidor.

Senha Senha da conta de e-mail.

Caixa Caixa de e-mails que deve ser verificada pelo extrator. Por padrão utiliza-se “Inbox”.

Pasta XML Determina onde os arquivos de XML serão salvos. Utilizar o botão “...” para localizaro local desejado. Todos os arquivos XML serão salvos nessa pasta, caberá ao recep-tor decidir se o XML é válido e importa-lo para o software.

Pasta outros anexos Determina onde os outros arquivos que foram adicionados na lista de extensões deanexo serão salvos. Utilizar o botão “...” para localizar o local desejado.

Pasta outros (sem XML) Determina onde os e-mails que não possuem relação com XML serão salvos (essesserão salvos com a extensão “eml”). Utilizar o botão “...” para localizar o local dese-jado.



MÓDULO INTEGRADOR

O módulo Integrador é responsável pela integração dos CT-e com o portal do Mastersaf DF-e. A forma de integração disponível:

• Integração TXT: nesse modo de integração arquivos contendo os documentos a serem enviados ao portal são gravadosem uma pasta/diretório. Após a integração e processamento, o produto gravará o retorno/resultado em outra pasta;

(consultar o portal http://docs.dfe.mastersaf.com.br para obter os layouts)

Sua configuração se dá através do arquivo integrador.properties, cujos principais parâmetros são:

• Pastas para Receptor CT-e: aqui se define a localização para cada uma das pastas de integração:

– Envio: Esta pasta é o local que deverão ser colocados todos os XML que se deseja importar para o sistema (parâmetropasta_recebimento_envio);

– Retorno: Esta pasta é o local que ir á manter todos os XML de carta de correção importados para o sistema (parâ-metro pasta_recebimento_retorno);

– Importado: Pasta que irá conter todos os XML importados corretamente que não forem de cancelamento (parâmetropasta_recebimento_importado);

– importado_cancelamento: Pasta que irá conter todos os XML importados corretamente que forem do tipo cancela-mento (parâmetro pasta_recebimento_importado_canc);

– importado_Ocorrencia: Esta pasta é o local que irá manter todos os XML de carta de correção importados para osistema (parâmetro pasta_recebimento_importado_ocor);

– Erro: Local onde os XML serão movidos quando estes tiverem algum erro na importação (parâmetropasta_recebimento_erro);

• url_webservice: endereço do WebService para a integração;

• portal_username: usuário do portal com permissão para integração;

• portal_password: senha do usuário do portal para integração;

• modulos: esse parâmetro indica quais módulos o integrador irá trabalhar poder ser: fs,recptor_nfs, nfe e cte, recebimento;

• modo_operacional_manual: se esse parâmetro estiver como “true”, uma tela do integrador será exibida ao iniciar. Essemodo é utilizado na fase de testes de layout, pois nessa tela é possível colar o conteúdo de um arquivo e enviá-lo ao portal;

• Verificar se o ambiente necessita de Proxy para comunicação com o portal. Caso seja necessário, configurar os parâme-tros:

– proxy_url

– proxy_port

– proxy_username

– proxy_password


http://docs.dfe.mastersaf.com.br


Exemplo do arquivo integrador.properties

Tela do módulo de operação manual



Caso a integração não esteja ocorrendo, verificar:

1. Se os testes de comunicação passaram (visualizar em log/integrador.log);

2. Se as credenciais do usuário do portal estão configuradas corretamente no arquivo integrador.properties(portal_username, portal_password) e se esse usuário possui permissão de integração NFSE no portal.

TIPOS DE EVENTOS

Os arquivos de retorno podem conter os seguintes tipos de eventos

FORMATO DE NOMENCLATURA DOS ARQUIVOS DE RETORNO

Para a geração do nome do arquivo de retorno a estrutura proposta consiste em:<chave de acesso>_<cnpj da empresa>_<codigo do evento>

Exemplo:

12345678901234567890123456789012345678901234_12345678901234_1.txt

ou

12345678901234567890123456789012345678901234_12345678901234_1.xml


mastersafdfe_8 - parametrização receptor - ct-e.pdf

Documents