Manual de Instalação NF-e Captura Express

Transcrição

1 Manual de Instalação NF-e Captura Express Versão 1.1 Abril

2 Controle de Alterações Nome Data Versão Observação Marcello Paz 20/04/ Criação do documento Thaís Oliveira 03/01/ Atualização do Documento 2

3 Índice 1. Introdução Considerações Iniciais Objetivo do Serviço Descrição simplificada do processo Requisitos Técnicos Infraestrutura Métodos de Instalação Fluxo Operacional Etapas Operacionais Cadastramento Contato... 6 ANEXO I... 7 Tabela de informações técnicas... 7 Tabela de informações Gerais... 7 ANEXO II... 7 Tabela Código Ocorrência

4 1. Introdução Este documento tem por objetivo a definição dos requisitos de instalação do software NF-e Captura Express desenvolvido pela SIM Consultas. 2. Considerações Iniciais A SIM>Consultas utilizando das mais avançadas tecnologias de robotização web, disponibiliza de maneira totalmente automática o download dos XML oficiais existentes no Portal Nacional da Receita Federal. 2.1 Objetivo do Serviço A SIM>Consultas tem como objetivo tornar o processo de captação do XML mais seguro e ágil, impedindo o extravio dos arquivos que deveriam chegar via ou outros canais que poucos seguros. 2.2 Descrição simplificada do processo De maneira simplificada o cliente através de seus sistemas ou de forma manual, com ou sem scanner leitor de código de barra, informa o número da DANFE para a consulta no portal nacional, o servidor executa a consulta e retorna o XML oficial, é necessário que o computador onde a solução esteja instalada possua o certificado digital. Nessa primeira versão a consulta será feita apenas no portal nacional. 3. Requisitos Técnicos 3.1 Infraestrutura Sistema Operacional: Windows XP ou superior; Hardware: Computador Dual Core com 2 GB de memória RAM, com leitor de código de barras (opcional); Software: Framework.NET 2.0 SP2; Internet: Liberação do IP Porta 1433 para acesso ao banco de dados da SIMConsultas. 4

5 3.2 Métodos de Instalação Para instalar o software NF-e Captura Express nas maquinas onde serão lidos os DANFEs para que o servidor faça as consultas e necessário o seguinte: Copiar os arquivos contidos no diretório C:\Simconsultas\NFEEXPRESS para a maquina de destino no diretório desejado; Criar atalho para arquivo executável NFECAPTURAEXPRESS.exe no local desejado. 4. Fluxo Operacional A SIM>Consultas disponibiliza um canal direto com o departamento de operações que será responsável pelo suporte ao serviço de consulta via WebServices. O objetivo é prestar todo apoio necessário para que o processo das consultas funcione corretamente, tanto nas etapas de testes e implantação quanto na manutenção dos serviços posteriores. 4.1 Etapas Operacionais Detalhamento das etapas necessárias para realização dos testes e implantação do serviço de consultas via WebServices, após acordo previamente realizado com o departamento comercial Cadastramento O Cliente/Parceiro receberá junto à documentação completa necessária para configuração e implantação dos serviços contratados, suas informações de login, sendo um usuário e uma senha para acesso ao Portal de Clientes SIM>Consultas através do endereço portal.simconsultas.com.br. Através deste portal, será possível realizar consultas, visualizar o extrato das consultas realizadas, bem como exportá-las se necessário. E também recebe uma chave de acesso exclusiva para comunicação via Web Service, assim como créditos para a utilização das consultas liberados pelo departamento comercial após a negociação. Para conhecer mais sobre este Portal, solicite ao departamento de suporte o envio do manual de utilização do mesmo. A SIM Consultas conta com um serviço de notificações e comunicados quando necessário, em casos de instabilidade e outros fatores. Para receber essas notificações é 5

6 necessário informar o e telefone dos responsáveis operacionais para a equipe de suporte para que sejam cadastradas as informações para o devido envio. 5. Contato Dúvidas? Acesse nossa central de ajuda pelo endereço simconsultas.zendesk.com ou entre em contato com nosso setor de Suporte e Operações através do suporte@simconsultas.com.br. 6

7 ANEXO I Tabela de informações técnicas # Tipo Conteúdo Descrição IT01 URL Endereço do Web Service IT02 URL Endereço para acessar IT03 IT04 IT05 IT06 Liberar Firewall contato suporte Método do WebService *.simconsultas.com.br informativo@simconsultas.com.br suporte@simconsultas.com.br ConsultaSincrona o WSDL Devem ser liberados no Firewall todos os endereços terminados por simconsultas.com.br utilizado em comunicações automáticas enviadas pelos serviços. Liberar no Anti-SPAM. utilizado para comunicação de problemas ou esclarecimento de dúvidas. Faz a consulta de forma Síncrona retornando os dados em formato padrão Tabela de informações Gerais # Tipo Conteúdo Descrição IG01 URL Portal para acompanhamento de consultas realizadas, estatísticas, avisos gerais, etc. ANEXO II Tabela Código Ocorrência # Cód. Ocorrência - ErrorCode Mensagem Retornada - ErrorDesc Descrição Quando ocorre um erro de acesso ao site consultado. Em geral significa que o site está indisponível ou apresentando problemas. RE26-9 Falha em analise Falha em analise RE24-4 Param obrig Alguns dos parâmetros Alguns dos parâmetros 7

8 nao inf obrigatórios para esta pesquisa não foi informado obrigatórios para esta pesquisa não foi informado RE01-3 Chave acesso Invalida Chave acesso Invalida Chave de acesso informada inválida RE02-2 Ocorrência não Identificada Ocorrência não Identificada Ocorrência não tratado/esperado Consulta não concluída no tempo de timeout definido pelo RE03-1 Timeout Timeout cliente. RE04 2 Consultado Consultado Indica que não houve problemas na consulta RE05 3 Inexistente Consulta Executada - Inexistente Indica que a consulta foi feita com sucesso porém o registro com os parâmetros informados não existe no cadastro consultado RE06 4 Erro Consulta Erro Consulta Quando ocorre um erro de acesso ao site consultado. Em geral significa que o site está indisponível ou apresentando problemas. Retorno Consulta Executada - Indica que foram retornados mais de 1 registros para os parâmetros informados e não foi possível escolher um deles RE07 5 Múltiplo Retorno Múltiplo para retorno Indica que para os parâmetros consultados, a consulta está RE08 7 Site Fora do ar Site fora do ar temporariamente fora do ar. Verificar Consulta não Executada Indica que ocorreu um erro na consulta e que precisa ser verificado por um analista da RE08 8 Manualmente Verificar Manualmente SIM>Consultas. RE09 10 CNPJ/CPF Inválido CNPJ/CPF Inválido Indica que o CNPJ/CPF informado não é válido, ou seja, o dígito verificador não confere. RE10 12 IE Recadastrada Consulta Executada - IE Recadastrada Indica que o site consultado retornou a mensagem de que a IE foi recadastrada. RE11 13 Site Retornou Erro Consulta Executada - Site Retornou Erro Indica que o site consultado retornou algum erro específico. RE12 14 Site não possui Consulta CPF Site não possui Consulta CPF Indica que o site consultado não possui a opção de consulta por CPF Indica que a IE informada não é válida, ou seja, o dígito RE13 15 IE Invalida IE Invalida verificador não confere. RE14 17 CPF Com Consulta Executada - CPF Mensagem retornada pelo site 8

9 RE15 18 RE27 19 Dados Incompletos Consulta Desligada NF-e em contingência RE28 20 Verificar NIT Digito NF-e RE29 25 inválido Erro ao acessar RE16 30 site Nf-e Inexistente 180 RE30 31 dias RE17 RE UF Inválida CNPJ Diferente Com Dados Incomp Consulta Desligada DANFE emitido em Contingência Consulta executada Procurar Agencia do INSS Digito da chave do DANFE inválido Erro ao acessar site DANFE Inexistente (excedeu 180 dias) UF Inválida Consulta Executada - CNPJ retornado Diferente do informado RE19 52 IE Diferente IE Diferente Numero não corresponde a RE31 55 Não é NFE NFE RE20 98 RE21 99 RE Em estudo problema Parado Manualmente Parser Inexistente Em estudo problema Parado Manualmente da Receita Federal em alguns casos específicos. Indica que para os parâmetros consultados, a consulta está temporariamente fora do ar. Nota Fiscal Eletrônica emitida em contingência e ainda não autorizada pela SEFAZ. Apenas é permitida a Consulta Resumida para esta NF-e. Procure uma agência do INSS Digito do Número da NFe invalido Indica um problema de conexão ao site consultado. Nfe Inexistente 180 dias A UF informada nos parâmetros não é válida Indica que ao fazer a consulta, o registro retornado informa CNPJ diferente do que foi informado nos parâmetros de consulta. Indica que ao fazer a consulta, o registro retornado informa IE diferente da que foi informada nos parâmetros de consulta. Numero não corresponde a NFE Indica que a consulta não pode ser executada pois está em manutenção. Indica que a área de operação cancelou a consulta manualmente por algum problema operacional Indica que o Parser indicado nos parâmetros não existe. RE Sem crédito O número de consultas contratadas foi totalmente utilizado ou sua conta não possui créditos para o serviço: ReceitaFederalCNPJ. Contate seu Gerente de Contas para obter créditos. RE24 75 Divergência Indica que alguma dos Indica que não existem créditos para executar a consulta. 9

10 RE25 76 nos dados Já existe cadastro parâmetros informados não está correto de acordo com o cadastro Indica que já existe uma solicitação de cadastro e não retorna os dados 10