PARAMETRIZAO RECEPTOR NFS-E

MASTERSAF DF-E

MASTERSAF DF-E

PARAMETRIZAO DO RECEPTOR NFS-E

NDICE
Login ....................................................................................................................................................................... 1
Troca de senha ........................................................................................................................................................ 1
Administrao do Sistema.......................................................................................................................................2
Certificados .............................................................................................................................................................2
Usurios .................................................................................................................................................................. 3
Dados do Usurio .................................................................................................................................................................................. 4
Permisses do Usurio .......................................................................................................................................................................... 4

Empresas.................................................................................................................................................................5
Parmetro do Receptor NFS-e ................................................................................................................................. 7
Mdulo Integrador...................................................................................................................................................8
Tipos de Eventos .................................................................................................................................................................................... 9
Formato de nomenclatura dos arquivos de retorno ............................................................................................................................. 9

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

LOGIN
Com o portal iniciado, vamos iniciar o navegador de internet com o seguinte link http://localhost:8080/portal/mvc/login
(onde localhost deve ser o servidor onde a aplicao est hospedada).

TROCA DE SENHA
Na parte superior do site, conforme figura abaixo, so apresentadas as seguintes opes:
Mastersaf >> Trocar senha: permite a alterao da senha;
Logout:Sair do sistema;

Opes na parte superior

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

ADMINISTRAO DO SISTEMA
O link Administrao do Sistema leva tela com as funes administrativas.

Administrao do Sistema

CERTIFICADOS
Nessa opo cadastra-se o certificado da(s) empresa(s). Selecionar o arquivo do certificado, digitar a senha e clicar em
Cadastrar. Observar tambm se o mesmo poder ser vinculado s filiais, de acordo regras de cada municpio. Em caso
afirmativo, a opo Aplicar para matriz e filiais pode ser marcada;

Atualizao do certificado

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

USURIOS
Na opo Usurios, so apresentados todos os usurios cadastrados no sistema. Para efetuar uma busca, utilizar a opo Filtrar
Resultado. Itens dessa tela:

Cadastrar novo usurio (

);

Filtrar Resultado (

Indicador de usurio habilitado. Clicar para desabilitar (

);

Indicador de usurio desabilitado. Clicar para habilitar (

);

Para Editar dados do Usurio (

);

);

E o mdulo mensageria fica responsvel pela comunicao com a SEFAZ para fazer a consulta da chave do CT-e.

Tela de listagem de usurios

Para cadastrar um novo usurio, clicar em Cadastrar Usurio. Na tela que se abre, preencher os campos solicitados.

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

Cadastro de usurio

DADOS DO USURIO

Login: preencher com o login do novo usurio;

Seu Nome: preencher com o nome do novo usurio;

Email: email do novo usurio;

Data de Expirao: data na qual expira o usurio sendo criado;

Status: se o usurio ser includo com o status habilitado ou desabilitado;

Grupo Empresa: grupo de empresas ao qual o usurio faz parte;

PERMISSES DO USURIO
Aqui so selecionadas as permisses que o novo usurio receber. Caso o usurio sendo criado seja um usurio para ser utilizado no
Integrador, selecionar permisso de integrao (NFSE Integrador).
Filtro: atravs do filtro de pesquisa pode-se buscar por usurio atravs de uma parte de seu login/nome.

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

Tela de listagem de usurios

EMPRESAS
Os seguintes dados so solicitados no cadastramento de uma nova empresa:

CNPJ: CNPJ da nova empresa;

Razo Social: razo social da nova empresa;

Inscrio Estadual: Para nota Mercantil / CT-e esse campo ser Obrigatrio;

Inscrio Municipal: Para nota de Servio esse campo ser Obrigatrio;

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 no;

Parmetro de Fuso Horrio: O sistema adota por padro a hora local do Servidor, caso o servidor no esteja no mesmo
fuso onde sero emitidos os documentos fiscais possvel fazer o ajuste para mais ou menos horas de acordo com a hora
do servidor.

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

Parmetros especficos: parmetros dos mdulos de NFS, NFE e CTE;

Os campos de preenchimentos obrigatrios esto sinalizados com um asterisco.

OBS: no caso de instalao in house, ser solicitado o arquivo XML de licenciamento no cadastramento de uma
nova empresa.

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

Dados da empresa

Assim como na tela de usurios, uma empresa pode ser desabilitada ou habilitada. Para isso clicar no cone
Atravs da opo Filtrar Resultado pode-se buscar por uma empresa atravs de seu CNPJ/Razo Social.

Listagem de empresas
Publicado em 21/12/2012

ou

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

PARMETRO DO RECEPTOR NFS-E

Os parmetros para o Receptor NFSE (notas de servio) so os seguintes, por municpio:

Ativo: indica se as notas tomadas pela empresa no municpio sendo parametrizado sero recebidas ou no. Em outras
palavras, se a recepo estar ou no ativa;

Periodicidade: indica qual a periodicidade com que a verificao e recepo de notas emitidas contra a empresa ocorrero;

ltima consulta: esse parmetro indica a data a partir de quando as notas recebidas devem ser consultadas. Por exemplo,
se desejar se buscar todas as notas a partir de 01/01/2011, basta colocar essa data. Ela ser atualizada conforme forem
ocorrendo as consultas;

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E

MDULO INTEGRADOR
O mdulo Integrador responsvel pela integrao/ recepo da Nota com o portal do Mastersaf DFE.
A forma de integrao disponvel:

Integrao WebService: nesse modo de integrao o portal DFE faz a consta na prefeitura das nota emitidas para cliente
e retorna os arquivos com os dados da nota em uma pasta/diretrio;
(consultar o portal http://docs.dfe.mastersaf.com.br para obter os layouts)

Sua configurao se d atravs do arquivo integrador.properties, cujos principais parmetros so:

Pastas para o Receptor NFS-e: aqui se define a localizao para cada uma das pastas de integrao:
Retorno: aqui sero gerados os arquivos com informaes de retorno (parmetro pasta_receptor_nfs_retorno);
Erro: aqui sero gravados os retorno de erros (parmetro pasta_receptor_nfs_erro);

url_webservice: endereo do WebService para a integrao;

portal_username: usurio do portal com permisso para integrao;

portal_password: senha do usurio do portal para integrao;

modulos: esse parmetro indica quais mdulos o integrador ir trabalhar poder ser: fs,recptor_nfs, nfe e cte, recebimento;

modo_operacional_manual: se esse parmetro estiver como true, uma tela do integrador ser exibida ao iniciar. Esse
modo utilizado na fase de testes de layout, pois nessa tela possvel colar o contedo de um arquivo e envi-lo ao portal;

Verificar se o ambiente necessita de Proxy para comunicao com o portal. Caso seja necessrio, configurar os parmetros:
proxy_url
proxy_port
proxy_username
proxy_password

Publicado em 21/12/2012

PARAMETRIZAO DO RECEPTOR NFS-E

MASTERSAF DF-E
Caso a integrao no esteja ocorrendo, verificar:
1.

Se os testes de comunicao passaram (visualizar em log/integrador.log);

2.

Se as credenciais do usurio do portal esto configuradas corretamente no arquivo integrador.properties

(portal_username, portal_password) e se esse usurio possui permisso de integrao 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 gerao 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

Publicado em 21/12/2012