PARAMETRIZAO EMISSOR NFS-E

MASTERSAF DF-E

MASTERSAF DF-E

PARAMETRIZAO DO EMISSOR 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 Emissor NFS-e................................................................................................................................... 7
Autenticao de WebServices..................................................................................................................................8
Servios municipais ............................................................................................................................................................................... 8
Naturezas de operao.......................................................................................................................................................................... 9

Mdulo Integrador................................................................................................................................................. 10

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR 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 EMISSOR 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 EMISSOR 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 EMISSOR 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 EMISSOR 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 EMISSOR 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 EMISSOR NFS-E

MASTERSAF DF-E

PARMETRO DO EMISSOR NFS-E

Parmetros de NFS-e

Os parmetros para NFSE (notas de servio) so os seguintes:

Tipo do Lote: indica a periodicidade na qual os lotes sero montados e enviados para a prefeitura. Se imediatamente aps
for integrada ao portal, de hora em hora ou uma vez ao dia;

Envio de e-mail automtico: indica se um email contendo os dados da nota ser enviado automaticamente ao tomador
(cliente) aps sua aprovao;

Tipo de Retorno (Reenvio de nota): indica qual cdigo ser retornado ao sistema de gesto do cliente, caso uma nota j
aprovada seja encaminhada para a integrao. Se 100 (nota autorizada) ou 204 (nota duplicada/duplicidade);

Retorno Agendado: indica a periodicidade para busca de retornos (resultados dos processamentos) na prefeitura.
Algumas prefeituras no processam os lotes imediatamente e, nesses casos, pode-se acertar esse parmetro para que o
sistema no fique buscando a todo instante;

Regime especial de Tributao: Modalidade de tributao, onde determinado o setor de atividade empresarial que, tem
uma forma diferenciada de aplicao tributria, em relao aos demais contribuintes.

Optante pelo Simples Nacional: um benefcio que a unio concede a pequenas e micro empresas, com reduo de
impostos. Entre esses impostos, est o ICMS.

Tamanho mximo de lote: Ao informar valor maior que 0 (zero), este valor passar a ser o limite de RPS por lote. Caso o
campo no seja preenchido, ser considerado o valor cadastrado no banco de dados.

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR NFS-E

MASTERSAF DF-E

AUTENTICAO DE WEBSERVICES
Nesta tela, deve ser cadastrado o tipo de autenticao que o usurio vai utilizar junto a prefeitura. Os campos sero apresentados
para os municpios que necessitam enviar informaes via WebService da prefeitura, ou seja, o login, chave de acesso e ou CPF/CNPJ
com senha. Essa opo ser apresentada nos parmetros NFS-e.

SERVIOS MUNICIPAIS
Atravs da opo Administrao do Sistema >> Cadastros

pode ser acessado o cadastro de servios municipais.

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR NFS-E

MASTERSAF DF-E

Aqui podero ser cadastrados os servios municipais prestados pela empresa. Dessa forma, a integrao do servio municipal da RPS pode ocorrer de duas formas.

So enviados todos os dados de servio esperados pela prefeitura nos campos

codigoCnae, itemListaServico e codigoTributacaoMunicipio. Nesse caso no necessrio cadastrar o servio no
Mastersaf DFE;

Ou

enviado somente o campo codigoServicoInterno e no os campos acima . Nesse caso, o sistema ir buscar no
cadastro de servio municipal o registro que contenha o cdigo enviado e enviar para a prefeitura os cdigos de servio
cadastrados. Essa segunda forma permite a alterao de informaes da prefeitura sem que a rotina de integrao
do cliente seja modificada;

NATUREZAS DE OPERAO
atravs da opo Administrao do Sistema >> Cadastros,

pode ser acessado o cadastro de naturezas de operao.

Aqui, cada natureza de operao poder ter um cdigo externo configurado. Isso para os casos onde o sistema do cliente envia determinado cdigo de natureza e esse precisa ser traduzido para o cdigo esperado pela prefeitura. Caso o cdigo de natureza de operao j seja enviado no valor esperado, essa parametrizao no necessria.

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR 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 TXT: nesse modo de integrao arquivos contendo os documentos a serem enviados ao portal so
gravados em uma pasta/diretrio. Aps a integrao e processamento, o produto gravar o retorno/resultado em
outra pasta;

Integrao Web Service / API: nesse modo os documentos so enviados diretamente ao Web Service do produto;
(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 NFS: aqui se define a localizao para cada uma das pastas de integrao:
Entrada:

onde so gravados

os arquivos

contendo

os RPSs/notas

para a integrao (parmetro

pasta_nfse_entrada);
Enviadas: nessa pasta ficaro os arquivos j enviados para a integrao (parmetro pasta_nfse_enviadas);
Retorno: aqui sero gerados os arquivos com informaes de retorno (parmetro pasta_nfse_retorno);
Retorno_cancelamento:

aqui

sero

gerados

os

arquivos

com

informaes

de retorno (parmetro

pasta_nfse_retorno_cancelamento);
Erro: aqui sero gravados os retorno de erros (parmetro pasta_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

10

PARAMETRIZAO DO EMISSOR NFS-E

MASTERSAF DF-E

Exemplo do arquivo integrador.properties

Tela do mdulo de operao manual

Caso a integrao no esteja ocorrendo, verificar:

1.

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

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.

Publicado em 21/12/2012

11