WEBSERVICE PARA GRAVAÇÃO DE NOTA FISCAL ELETRÔNICA

Transcrição

1 WEBSERVICE PARA GRAVAÇÃO DE NOTA FISCAL ELETRÔNICA Utilização e Interfaces Prefeitura Municipal de Missão Velha ODTech Soluções em Informática

2 1.Introdução 2.Interfaces Disponíveis 3. Arquitetura de Comunicação 4. Serviços e Métodos 5. Anexos 1 Introdução O WebService tem por objetivo a gravação de Registros Provisórios de Serviços (RPS) na base do sistema de Nota Fiscal Eletrônica da Prefeitura Municipal. O Recibo Provisório de Serviços (RPS) é um documento que deverá ser usado por emitentes da NFSe no eventual impedimento da emissão on-line da Nota. Também poderá ser utilizado pelos prestadores sujeitos à emissão de grande quantidade de NFS-e (exemplo: estacionamentos). Nesse caso, o prestador emitirá o RPS para cada transação Como utilizar o WebService: A aplicação cliente deve enviar um pacote XML criado conforme as definições deste manual. Este pacote é entregue ao Web Service que o analisa e aciona a Aplicação usada para implementar o serviço, e devolve outro pacote XML como resposta. 2 Interfaces Disponíveis A seguir estão resumidas interfaces disponíveis no WebService de RPS, bem como suas funcionalidades: teste() => Esta interface realizar apenas um teste de comunicação, devolvendo o texto enviado acrescido de Você digitou:. Deve ser utilizado para testar a comunicação entre o computador local e o servidor, bem como a formatação de arquivos XML e sua leitura, ou mesmo disponibilidade do serviço. gravarnf() => Nesta interface, os prestadores de serviços através de seus sistemas poderão enviar NFS-e no sistema. O sistema da prefeitura irá processar esse lote, se o lote apresentar críticas de erros não serão geradas as NFSe.

3 3 Arquitetura de Comunicação Serviços A mensagem XML será recebida pelo Web Service para validação de seu respectivo Schema XML (arquivo XSD). Ao realizar o processamento o serviço irá retornar uma mensagem XML com os dados de retorno de processamento. Caso ocorram erros de validação do Schema XML, serão retornados na mensagem XML as prováveis causas do erro. Processamento Assíncrono O rps é gravado numa fila de espera para processamento. Etapas do processo ideal: 1. O sistema do contribuinte inicia a conexão enviando uma mensagem XML de pedido do serviço para o WebService; 2. O WebService recebe a mensagem XML de pedido do serviço e encaminha ao sistema da NFS-e; 3. O sistema da NFS-e recebe a mensagem XML de pedido do serviço e realiza o processamento, devolvendo uma mensagem XML de retorno ao WebService; 4. O WebService recebe a mensagem XML de retorno e a encaminha ao sistema do contribuinte; 5. O sistema do contribuinte recebe a mensagem XML de retorno e encerra a conexão. Regras de preenchimento dos campos Campos que representam CPF e CNPJ (respectivamente 11 e 14 caracteres) devem ser informados com o tamanho fixo previsto, sem formatação e com o preenchimento dos zeros não significativos; Campos numéricos que representam valores e quantidades são de tamanho variável, respeitando o tamanho máximo previsto para o campo e a quantidade de casas decimais (quando houver). O preenchimento de zeros não significativos causa erro de validação do Schema XML. Os campos numéricos devem ser informados sem o separador de milhar, com uso do ponto decimal para indicar a parte fracionária (quando houver) respeitando-se a quantidade de dígitos prevista no layout; As datas devem ser informadas no formato AAAA-MM-DD; Para reduzir o tamanho final das mensagens XML alguns cuidados de programação deverão ser assumidos: incluir espaços no início e/ou no final de campos alfanuméricos; incluir comentários na mensagem XML; incluir anotação e documentação na mensagem XML (TAG annotation e TAG documentation); incluir caracteres de formatação na mensagem XML: LF (Line Feed ou salto de linha, caractere ASCII 10), CR (Carriage Return ou retorno do carro, caractere ASCII 13), tab, caractere de espaço entre as TAGs)

4 4 Serviços e Método Envio de RPS Método: gravarnf() Tipo de Serviço: Assíncrono Funcionamento: O prestador através do seu sistema irá gerar os RPS, o primeiro RPS será o 01, o sistema do prestador é responsável por gerar e controlar esses RPS com numeração sequencial e gerar um pacote de informações com este RPS no formato XML, em seguida estabelecer uma conexão com o WebService da prefeitura e enviar o RPS para o serviço gravarnf() do WebService. Como este é um serviço assíncrono o lote não será processado no mesmo momento, ou na mesma conexão. O WebService irá receber este lote e retornar à informação de gravação correta ou não ao sistema do contribuinte. Esta funcionalidade tem por finalidade receber a mensagem XML enviada pelo sistema do contribuinte, validar a estrutura do XML que deve estar de acordo com os Schemas definidos, gravar e processar as informações. Na tabela seguinte apresenta-se a definição dos campos do XML de remessa de RPS. Estrutura definida no schema XML: Registro Cabeçalho CAMPO TIPO TAMANHO CONTEÚDO OBRIGATÓRIO Prestador int 10 Nome do Prestador Nrsps String 10 O primeiro RPS será o 01, o sistema do prestador é responsável por gerar e controlar esses RPS com numeração sequencial e gerar um pacote de informações com este RPS Nrnotaoriginal String 10 Número da Nota Original, caso seja uma correção de uma nota anterior Data_emissao Data 10 É a data na qual a nota será emitida Ano Int 32 Ano de competência da nota Mês Int 32 Mês de competência da nota Nome_tomador String 125 Nome do contratante do serviço Cnpj_cpf String 14 Preencher com o número do CNPJ ou do CPF do tomador, apenas números Logradouro String 80 Nome da Rua, Avenida do endereço do tomador. Numero String 10 Número do endereço do tomador Complemento String 20 Informações adicionais do endereço Cep String 10 Código de Endereçamento Postal Bairro String 80 Nome do Bairro do Tomador Cidade String 80 Nome da Cidade do Tomador Uf String 2 Nome do Estado do Tomador E_mail String 80 Endereço Eletrônico do Tomador Telefone String 10 Número do Telefone do Tomador Valor_nota Decimal 18 Valor Total do Serviço Contratado Descricao String 1000 Resumo do Serviço Contratado

5 Tipo_servico Int 10 Tipo do Serviço Prestado, de acordo com a atividade do prestador, cadastrada na Receita Federal Local String 40 Local da Prestação do Serviço Modalidade Int 5 Modo de Tributação 1 - Tributado no Município, 2 - Tributado Fora do Município, 3 - Isento Por Decisão Judicial e 4 - Isento por Processo Administrativo Valor_inss Decimal 18 Informar o Valor do Desconto de INSS, se Valor_irrf Decimal 18 Informar o Valor do Desconto de Imposto de Renda, se Valor_pis Decimal 18 Informar o Valor do Desconto do PIS, se Valor_cofins Decimal 18 Informar o Valor do Desconto de COFINS, se Valor_csll Decimal 18 Informar o Valor do Desconto de CSLL, se Valor_materiais Decimal 18 Informar o Valor de Desconto Previsto em Lei, se Valor_desconto Decimal 18 Informar o Valor do Desconto Condicionado, se Valor_descincond Decimal 18 Informar o Valor do Desconto Incondicionado, se Valor_outros Decimal 18 Informar Outros Valores Descontados, se Cod_obra String 15 Informar o Código da Obra, se Nrart String 15 Informar o Número da Anotação de Responsabilidade Técnica, se for o caso Obs String 1000 Anotações que considerar necessárias Retido String 1 Informar de o ISS foi ou não, Retido. S para SIM e N para NÃO Nrlote String 10 Inscrição String 100 Numéro de Inscrição Municipal do Tomador