MASTERSAFDFE_4 - parametrização receptor nfs-e.pdf

Embed Size (px)

Citation preview

  • PARAMETRIZAO RECEPTOR NFS-EMASTERSAF DF-E

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-E

    Publicado em 21/12/2012

    NDICELogin ....................................................................................................................................................................... 1

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

    Administrao do Sistema.......................................................................................................................................2

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

    Usurios ..................................................................................................................................................................3Dados do Usurio .................................................................................................................................................................................. 4Permisses do Usurio .......................................................................................................................................................................... 4

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

    Parmetro do Receptor NFS-e ................................................................................................................................. 7

    Mdulo Integrador...................................................................................................................................................8Tipos de Eventos.................................................................................................................................................................................... 9Formato de nomenclatura dos arquivos de retorno ............................................................................................................................. 9

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-ELOGIN

    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

    1Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-EADMINISTRAO 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 emCadastrar. Observar tambm se o mesmo poder ser vinculado s filiais, de acordo regras de cada municpio. Em casoafirmativo, a opo Aplicar para matriz e filiais pode ser marcada;

    Atualizao do certificado2Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-EUSURIOS

    Na opo Usurios, so apresentados todos os usurios cadastrados no sistema. Para efetuar uma busca, utilizar a opo FiltrarResultado. 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.3Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-ECadastro 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 noIntegrador, 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.4Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-ETela 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 mesmofuso onde sero emitidos os documentos fiscais possvel fazer o ajuste para mais ou menos horas de acordo com a horado 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 umanova empresa.

    5Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-EDados da empresa

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

    Listagem de empresas6Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-EPARMETRO 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 outraspalavras, 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 foremocorrendo as consultas;

    7Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-EMDULO 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 clientee 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. Essemodo 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 parme-tros:

    proxy_url

    proxy_port

    proxy_username

    proxy_password8Publicado em 21/12/2012

  • MASTERSAF DF-E PARAMETRIZAO DO RECEPTOR NFS-ECaso 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:__

    Exemplo:

    12345678901234567890123456789012345678901234_12345678901234_1.txtou

    12345678901234567890123456789012345678901234_12345678901234_1.xml

    9Publicado em 21/12/2012

    LoginTroca de senhaAdministrao do SistemaCertificadosUsuriosDados do UsurioPermisses do Usurio

    EmpresasParmetro do Receptor NFS-eMdulo IntegradorTipos de EventosFormato de nomenclatura dos arquivos de retorno