PARAMETRIZAO EMISSOR NF-E

MASTERSAF DF-E

MASTERSAF DF-E

PARAMETRIZAO DO EMISSOR NF-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 NF-e..................................................................................................................................... 7
Parmetros de Contingncia NF-e........................................................................................................................................................ 7
Parmetros de Impresso NF-e ............................................................................................................................................................ 8
Parmetro Campos Carta de Correo ................................................................................................................................................. 9

Mdulo Integrador...................................................................................................................................................9

Publicado em 21/12/2012

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

MASTERSAF DF-E

PARMETRO DO EMISSOR NF-E

Parmetros de NF-e

Os parmetros para NF-E (notas mercantil) so os seguintes:

Envio de e-mail automtico de Carta de Correo: indica se um email contendo os dados da carta de correo ser
enviado automaticamente ao destinatrio, aps sua aprovao;

Tipo de Retorno: 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);

Envio de e-mail automtico: indica se um email contendo os dados da nota fiscal eletrnica ser enviado automaticamente ao destinatrio, aps sua aprovao;

Forma NT2011.002: Parametro para adequao a NT 2011.002, a partir de 01/05/2011 as notas fiscais enviadas
para o ambiente de homologao somente sero aprovadas se tiverem nos campos CNPJ, Razo Social, e Inscrio Estadual os contedos predefinidos.

Definido na Integrao quando parametrizado dessa forma o Mastersaf NF-e no faz

nenhuma ao nos dados recebidos da integrao, nem na gerao do XML.

Conforme NT quando parametrizado dessa forma, o Mastersaf NF-e no momento da recepo da Nota na integrao ir alterar os trs campos conforme definido na NT.

PARMETROS DE CONTINGNCIA NF-E

Modo de Contingncia: O sistema permite escolher 3 modos de contingncia:

Manual - Haver interveno do usurio para liberar a emisso da nota em contingncia.
Automtico No havendo conexo com a SEFAZ ou internet o sistema adotar a contingncia automaticamente.
Na Origem A contingncia ser feita no sistema de faturamento do cliente (ERP) e s posteriormente ser informado ao portal DF-e.

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR NF-E

MASTERSAF DF-E

Tipo Contingencia: O sistema permite escolher os tipos de contingencia hoje disponibilizado conforme o manual do
contribuinte 4.01.

Forado: Indica se o sistema deve entrar em contingncia ou no por determinao do usurio Administrador.

URL Teste de Conexo: O Sistema utiliza a url informada no campo para determinar o tipo de mensagem que deve sair
impressa no DANFE, quando o modo de contingncia esta parametrizado para a forma automtica.

Mensagem em Caso de erro da SEFAZ: Mensagem que deve ser impressa no DANFE quando o motivo da contingncia
for indisponibilidade da SEFAZ.

Mensagem em Caso de erro Interno: Mensagem que deve ser impressa no DANFE quando o motivo da contingncia for
indisponibilidade interna da empresa.

PARMETROS DE IMPRESSO NF-E

Impresso Automtica: Indica se aps a autorizao da nota o DANFE ser enviado a impressora automaticamente.

Nmero de Cpias: Indica o nmero de copias do DANFE que devem ser impressos.

Atribuir a data de sada automtica:

No Permanecer a data informada na integrao.
Data Ser atribuda a data do sistema no momento da emisso da nota.
Data e Hora - Ser atribuda a data e hora do sistema no momento da emisso da nota.

Formato de Impresso: O DANFE pode ser impresso em 4 formatos: Retrato - Imprime no formato folha retrato
Retrato 2 Imprime no formato folha retrato e partir da segunda pgina a expanso do quadro Produtos/servios,
conforme possibilita o manual do contribuinte, otimizando em aproximadamente 50% o numero de folha impressas
Paisagem Imprime no formato folha paisagem
Paisagem 2 Imprime no formato folha paisagem e partir da segunda pgina a expanso do quadro Produtos/servios, e incluso de duas novas colunas (valor da base de calcula ST e Valor do ICMS ST) conforme possibilita o manual
do contribuinte, otimizando em aproximadamente 50% o numero de folha impressas

Valor Unitrio no DANFE: - Permite escolher com quantas casas decimais ser impresso no DANFE na coluna valor
Unitrio do Produto.

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR NF-E

MASTERSAF DF-E

PARMETRO CAMPOS CARTA DE CORREO

Grupo Empresa: Permite selecionar o Grupo de Empresas para qual ser criado a descrio dos campos a serem corrigidos na carta de correo.

Status: Habilita e desabilita o campo

Descrio: Descrio dos campos que poder ser corrigido no momento da gerao da CC-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 NF-e: aqui se define a localizao para cada uma das pastas de integrao:
Entrada: onde so gravados os arquivos contendo as NF-es para a integrao (parmetro pasta_nfe_entrada);
Enviadas: nessa pasta ficaro os arquivos j enviados para a integrao (parmetro pasta_nfe_enviadas);
Retorno: aqui sero gerados os arquivos com informaes de retorno (parmetro pasta_nfe_retorno);
Retorno_cancelamento: aqui sero gerados os arquivos com informaes de retorno de cancelamento (parmetro
pasta_nfe_retorno_cancelamento);
Retorno_Inutilizao: aqui sero gerados os arquivos com informaes
(pasta_nfe_retorno_inutilizacao);

de retorno de inutilizado

Erro: aqui sero gravados os retorno de erros (parmetro pasta_nfe_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

Publicado em 21/12/2012

PARAMETRIZAO DO EMISSOR NF-E

MASTERSAF DF-E
proxy_username
proxy_password

Exemplo do arquivo integrador.properties

Tela do mdulo de operao manual

Caso a integrao no esteja ocorrendo, verificar:

Publicado em 21/12/2012

10

PARAMETRIZAO DO EMISSOR NF-E

MASTERSAF DF-E
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