V 1.2. Sistema de Envio de Lotes RPS. Belgadata Soluções em Informática Sistema de Envio de Lotes RPS V 1.2 Rev. 1 23/10/2013

Transcrição

1 1 V 1.2 Sistema de Envio de Lotes RPS Belgadata Soluções em Informática Sistema de Envio de Lotes RPS V 1.2 Rev. 1 23/10/2013

2 1 SUMÁRIO 1. Apresentação Objetivos Fluxo de Utilização Estrutura da Solução Enviar Lote Consultar Situação do Lote Consultar Lote Consultar Nota Fiscal Consultar Nota Fiscal por Período Consultar Nota Fiscal por RPS Cancelar Nota Fiscal Consultar Dados do Prestador Conexão com o Serviço Estrutura de Dados Estruturas da funcionalidade EnviarLote Estrutura Lote Estrutura RPS Estrutura Tomador Estrutura Endereco Estrutura Deducao Estrutura DeducaoMapa Estrutura DeducaoPercentual Estrutura Item Estrutura RetornoSituacaoLote Estrutura Mensagem Estruturas da funcionalidade Consultar Situação do Lote Estrutura RetornoSituacaoLote Estruturas da funcionalidade Consultar Lote Estrutura RetornoLote Estruturas da funcionalidade Consultar Nota Fiscal Estrutura RetornoNfse... 14

3 Estrutura NFSE Estrutura Prestador Estrutura Enquadramento Estruturas da funcionalidade Consultar Nota Fiscal por Período Estruturas da funcionalidade Consultar Nota Fiscal Por RPS Estruturas da funcionalidade Cancelar Nota Fiscal Estrutura RetornoCancelamentoNota Estruturas da funcionalidade Consultar Dados do Prestador Estrutura RetornoDadosPrestador Estrutura DadosPrestador Estrutura Atividade Estrutura TipoDeducao Estrutura DeducaoPercentual Exemplos Envio de Lote Arquivo de envio Arquivo de retorno Consultar Situação do Lote Arquivo de envio Arquivo de retorno Consultar Lote Arquivo de envio Arquivo de retorno Consultar Nota Fiscal Arquivo de envio Arquivo de retorno Consultar Nota Fiscal por RPS Arquivo de envio Arquivo de retorno Cancelar Nota Fiscal Arquivo de envio Arquivo de retorno Consultar Dados do Prestador Arquivo de envio... 27

4 Arquivo de retorno Anexo A... 29

5 4 1. Apresentação O Sistema de Nota Fiscal Eletrônica, em sua plataforma web, é utilizado por usuários que possuem acesso normal à internet, e que não possuem uma demanda muito alta de criação de notas fiscais. Dessa forma, através do site da nota, é possível fazer emissão de documentos fiscais, com informações relativas à prestação de serviços, além de consultas e impressão de guias, entre outros serviços. Alguns contribuintes, entretanto, possuem uma demanda alta de emissão de notas e precisam de formas mais rápidas para a geração desses documentos. Nesse contexto, foi criado o Regime em Lote, no qual o contribuinte pode implementar, dentro do seu sistema próprio, um módulo para que Recibos Provisórios sejam armazenados localmente, e posteriomente, sejam convertidos em notas fiscais. Os contribuintes que aderirem a esse modo de envio de notas, precisarão se cadastrar como tal, para que sejam habilitados a realizar esse procedimento. 2. Objetivos Esse regime foi criado, principalmente, por causa das grandes empresas que necessitam do envio de uma enorme quantidade de notas fiscais. É o caso de colégios, por exemplo, que possuem uma enorme quantidade de alunos, e precisa, em uma determinada data, emitir notas fiscais para um grande número de pessoas. Neste manual, encontram-se todas as instruções para integração dos sistemas de informações dos contribuintes emissores de notas que optarem pelo Regime em Lote. O webservice foi criado para possibilitar a troca de informações entre o sistema do prestador e o ambiente da nota fiscal, possibilitando a emissão, consulta e cancelamento de notas. 3. Fluxo de Utilização Para utilizar o Sistema de Envio de Lotes RPS, o prestador deve comparecer à prefeitura e solicitar a liberação de uso. Após a solicitação, a prefeitura irá habilitar o prestador para emissão de lotes, disponibilizará um ambiente de testes e fornecerá um token de 8 dígitos, que será utilizado para a assinatura das mensagens. É de extrema importância que o prestador mantenha o token em sigilo, pois o mesmo garantirá a autenticidade do arquivo XML enviado.

6 5 4. Estrutura da Solução O funcionamento do Sistema de Envio de Lotes de RPS baseia-se na comunicação entre cliente e servidor através de um Web Service utilizando o padrão XML para a comunicação entre ambos. Desta forma, o sistema é independente de plataforma ou linguagem de programação, abrindo a possibilidade de o Prestador de Serviços desenvolver seu próprio sistema de emissão de Lotes de RPS para funcionar em conjunto com os outros sistemas presentes no sua organização. O Web Service disponibiliza sete serviços para a utilização do prestador. São eles: Enviar Lote; Consultar Situação do Lote; Consultar Lote; Consultar Nota Fiscal; Consultar Nota Fiscal por RPS; Cancelar Nota Fiscal; Consultar Dados do Prestador; Abaixo segue a descrição completa de cada serviço. 4.1 Enviar Lote O serviço Enviar Lote envia um lote contendo um ou mais RPS para posterior processamento dos mesmos. O cliente envia um arquivo XML com a estrutura Lote e recebe como resposta um arquivo XML com a estrutura RetornoSituacaoLote que confirma o recebimento do mesmo no sistema. Note que o processamento dos RPS não acontecem logo após o recebimento do lote. Os mesmos são armazenados em um banco de dados para posterior processamento. 4.2 Consultar Situação do Lote O serviço Consultar Situação do Lote faz a consulta de um lote enviado para obter informações do mesmo. Desta forma, o cliente pode saber se o lote já foi processado e se foi encontrado algum erro durante o processamento. A consulta é feita através do número do lote e retorna para o cliente um arquivo XML com a estrutura RetornoSituacaoLote.

7 6 4.3 Consultar Lote O serviço Consultar Lote retorna todos os dados de um lote enviado anteriormente, permitindo que o cliente formate os dados do lote para visualização. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Número do lote; Assinatura; Esta consulta retorna um arquivo XML com a estrutura RetornoLote. 4.4 Consultar Nota Fiscal O serviço Consultar Nota Fiscal retorna todos os dados de uma nota fiscal, tendo esta sido enviada através de um lote de RPS ou não. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Número da Nota Fiscal; Assinatura; Esta consulta retorna um XML com a estrutura RetornoNfse. 4.5 Consultar Nota Fiscal por Período O serviço Consultar Nota Fiscal por Período retorna todas as notas fiscais de um determinado período, tendo estas sendo enviadas através de lotes de RPS ou não. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Data inicial do período; Data finao do período; Assinatura; Esta consulta retorna um XML com a estrutura RetornoNfse.

8 7 4.6 Consultar Nota Fiscal por RPS O serviço Consultar Nota Fiscal por RPS retorna todos os dados de uma nota fiscal através de uma consulta pelo número do RPS que gerou a nota. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Número do RPS; Assinatura; Esta consulta retorna um arquivo XML com a estrutura RetornoNfse. 4.7 Cancelar Nota Fiscal O serviço Cancelar Nota Fiscal permite ao cliente cancelar qualquer nota fiscal, inclusive notas que não foram enviadas através de um lote de RPS. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Número da Nota Fiscal; Assinatura; Esta consulta retorna um arquivo XML com a estrutura RetornoCancelamentoNota. 4.8 Consultar Dados do Prestador O serviço Consultar Dados do Prestador permite ao cliente obter informações relevantes para a emissão dos seus lotes de RPS, tais como enquadramento, aliquotas e atividades permitidas para o mesmo. A consulta é feita através do envio dos seguintes dados: CNPJ do prestador (somente números); Código do município; Assinatura; Esta consulta retorna um XML com a estrutura RetornoDadosPrestador.

9 8 5. Conexão com o Serviço A URL de conexão ao serviço é: Está também disponibilizado um serviço para o contribuinte efetuar testes, possibilitando um processo de desenvolvimento mais seguro, sem que os dados enviados durante o desenvolvimento sejam convertidos em notas reais pelo sistema do município. A URL para testes de desenvolvimento é: PS. A utilização do serviço de testes é similar ao serviço disponibilizado pela prefeitura. O token para a criação da assinatura é o mesmo e a estrutura das mensagens é idêntica.

10 9 6. Estrutura de Dados Abaixo segue as estruturas de dados das funcionalidades do web service. INFORMAÇÃO DESCRIÇÃO OC Ocorrência Número de vezes que a informação pode ser apresentada. DESCRIÇÃO Descrição do atributo. OB Obrigatório Obrigatoriedade de preenchimento. TIP Tipo N Numérico C Caracteres [ ] Array B Booleano TAM Tamanho Quantidade máxima de caracteres, precisão numérica ou tamanho máximo do array 6.1 Estruturas da funcionalidade EnviarLote A funcionalidade Enviar Lote passa como parâmetro a estrutura Lote e recebe como retorno uma estrutura RetornoSituacaoLote Estrutura Lote assinatura 1-1 Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + data S C 40 Inicio no formato (dd-mm-aaaa) + data Fim no (dd-mm-aaaa) + quantidade de RPS do lote codmunicipio 1-1 Código IBGE do Município S N 7 cpfcnpjprestador 1-1 CPF/CNPJ do prestador (somente dígitos) S C 14 datainicio 1-1 Data de emissão do RPS mais antigo no formato (dd-mm-aaaa) S C 10 datafim 1-1 Data de emissão do RPS mais novo no formato (dd-mm-aaaa) S C 10 quantidaderps 1-1 Quantidade de RPS do lote S N 3 razaosocial 1-1 Razão social do prestador S C 115 valortotalrps 1-1 Somatório do valor de todos os RPS do lote S N 15,2 versao 1-1 Versão do layout da mensagem (mesma versão deste documento) S C 10 RPS 1-N Lista de RPS do lote S RPS[ ] 200

11 Estrutura RPS numero 1-1 Número do RPS S N 15 dataemissao 1-1 Data de emissão do RPS no formato (dd-mm-aaaa hh:mm:ss) S C 19 tipotomador Normal 2 Estrangeiro S N 1 3 Não Identificado tomador 1-1 Tomador do serviço S Tomador 1 atividade 1-1 Código da atividade de acordo com a tabela de CNAEs do município S N 9 (somente números) codigomunicipioprestacao 1-1 Código IBGE do município de prestação do serviço S N 7 tiporecolhimento ISS a recolher pelo prestador 2 ISS a recolher pelo tomador S N 1 3 Sem incidência no município tributacao Imune 2 Isento 3 Tributável S N 1 4 Exigibilidade suspensa aliquota 1-1 Alíquota do serviço S N 3,2 deducao 1-1 Dedução do serviço S Deducao 1 descricaonota 1-1 Descrição da nota S C 1500 itensnota 1-N Itens da nota S Item[ ] 25 valorinss 0-1 Valor da retenção do INSS N N 15,2 valorir 0-1 Valor da retenção do IR N N 15,2 valorpis 0-1 Valor da retenção do PIS N N 15,2 valorcofins 0-1 Valor da retenção do COFINS N N 15,2 valorcsll 0-1 Valor da retenção do CSLL N N 15,2 aliquotainss 0-1 Alíquota da retenção do INSS N N 3,2 aliquotair 0-1 Alíquota da retenção do IR N N 3,2 aliquotapis 0-1 Alíquota da retenção do PIS N N 3,2 aliquotacofins 0-1 Alíquota da retenção do COFINS N N 3,2 aliquotacsll 0-1 Alíquota da retenção do CSLL N N 3,2 valorservicos 1-1 Valor total dos serviços S N 15,2 valordeducoes 1-1 Valor total das deduções S N 15,2 situacaorps Normal 2 Cancelada S N Estrutura Tomador cpfcnpj 0-1 CPF/CNPJ do tomador do serviço (somente dígitos) N C 14 razaosocial 0-1 Razão social do tomador do serviço N C 115 idestrangeiro 0-1 Número de identificação to tomador estrangeiro N C 20 inscricaomunipal 0-1 Número da inscrição municipal N C 20

12 do tomador N C 80 telefone 0-1 Telefone com DDD (somente dígitos) N C 10 Endereco 0-1 Endereço do tomador N Endereco Estrutura Endereco tipologradouro 1-1 Valor referente ao tipo de logradouro de acordo com a tabela do Anexo A S N 2 tipologradourodescricao 0-1 Descrição do tipo de logradouro N C 60 logradouro 1-1 Logradouro do tomador S C 115 cep 1-1 Cep do tomador (somente dígitos) S C 8 bairro 1-1 Bairro do tomador S C 60 municipio 1-1 Código IBGE do município S C 7 municipiodescricao 0-1 Nome do município N C 60 numero 1-1 Número S C 10 pais 0-1 Código país de acordo com a tabela do Anexo A N N 3 paisdescricao 0-1 Nome do País N C Estrutura Deducao deducaomapa 0-N Lista de itens a serem deduzidos N DeducaoMapa[ ] 10 DeducaoPercentual 0-1 Dedução percentual N DeducaoPercentual Estrutura DeducaoMapa cpfcnpjfornecedor 1-1 CPF/ CNPJ do fornecedor (somente dígitos) S N 14 numeronotafiscal 1-1 Número da nota fiscal S N 32 valornotafiscal 1-1 Valor da nota fiscal S N 15,2 valordeducao 1-1 Valor da dedução S N 15,2 tipodeducaomapa Despesas com Materiais S N 1 tipodeducaomapadescricao 1-1 Descrição do tipo de dedução por mapa N C 60

13 Estrutura DeducaoPercentual percentual 1-1 Percentual de dedução S N 3, Estrutura Item descricao 1-1 Descrição do ítem S C 115 quantidade 1-1 Quantidade de itens S N 15 valorunitario 1-1 Valor unitário do ítem S N 15,2 valortotal 1-1 Valor total do ítem S N 15, Estrutura RetornoSituacaoLote sucesso 1-1 Informa se o lote foi enviado com sucesso S B processado 1-1 Informa se o lote foi processado S B protocolo 1-1 Número de protocolo do lote enviado S N 15 cpfcnpj 1-1 CPF/CNPJ do prestador S N 15,2 dataenvio 1-1 Data de envio do lote S N 15,2 versao 1-1 Versão do arquivo XML enviado S N 10 mensagens 0-N Mensagens de erro ou alerta N Mensagem[ ] Estrutura Mensagem tipo Erro 2 Alerta S N 1 codigo 1-1 Código da mensagem S C 7 descricao 1-1 Descrição da mensagem S C Estruturas da funcionalidade Consultar Situação do Lote A funcionalidade Consultar Situação Lote passa como parâmetro o número de protocolo do lote e recebe como retorno uma estrutura RetornoSituacaoLote.

14 Estrutura RetornoSituacaoLote sucesso 1-1 Informa se o lote foi processado com sucesso S B protocolo 1-1 Número de protocolo do lote enviado S N 20 cpfcnpj 1-1 CPF/CNPJ do prestador S N 15,2 dataenvio 1-1 Data de envio do lote S N 15,2 versao 1-1 Versão do arquivo XML enviado S N 10 mensagens 0-N Mensagens de erro ou alerta N Mensagem[ ] Estruturas da funcionalidade Consultar Lote A funcionalidade Consultar Lote passa os seguintes parâmetros: PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N numerolote Número de protocolo do lote consultado C assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + código do município + N de protocolo do lote C Esta funcionalidade recebe como retorno uma estrutura RetornoLote Estrutura RetornoLote sucesso 1-1 Informa se o lote foi processado com sucesso S B municipio 1-1 Código IBGE do município S N 7 lote 1-1 Lote consultado S Lote 1 mensagens 1-1 Mensagens de erro ou alerta S Mensagem[ ] Estruturas da funcionalidade Consultar Nota Fiscal A funcionalidade Consultar Nota Fiscal passa os seguintes parâmetros:

15 14 PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N numero Número da Nota Fiscal C assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + código do município + N da nota fiscal C Esta funcionalidade recebe como retorno uma estrutura RetornoNfse Estrutura RetornoNfse sucesso 1-1 Informa se o lote foi processado com sucesso S B municipio 1-1 Código IBGE do município S N 7 nfse 1-1 Nota Fiscal consultada S NFSE 1 mensagens 1-1 Mensagens de erro ou alerta S Mensagem[ ] Estrutura NFSE numero 1-1 Número do RPS S N 15 dataemissao 1-1 Data de emissão do RPS no formato (dd-mm-aaaa hh:mm:ss) S C 19 tipotomador Normal 2 Estrangeiro S N 1 3 Não Identificado tomador 1-1 Tomador do serviço S Tomador 1 atividade 1-1 Código da atividade de acordo com a tabela de CNAEs do município S N 9 (somente números) codigomunicipioprestacao 1-1 Código IBGE do município de prestação do serviço S N 7 tiporecolhimento ISS a recolher pelo prestador 2 ISS a recolher pelo tomador S N 1 3 Sem incidência no município tributacao Imune 2 Isento 3 Tributável S N 1 4 Exigibilidade suspensa aliquota 1-1 Alíquota do serviço S N 3,2 deducao 1-1 Dedução do serviço S Deducao 1 descricaonota 1-1 Descrição da nota S C 1500 itensnota 1-N Itens da nota S Item[ ] 25 valorinss 0-1 Valor da retenção do INSS N N 15,2

16 15 valorir 0-1 Valor da retenção do IR N N 15,2 valorpis 0-1 Valor da retenção do PIS N N 15,2 valorcofins 0-1 Valor da retenção do COFINS N N 15,2 valorcsll 0-1 Valor da retenção do CSLL N N 15,2 aliquotainss 0-1 Alíquota da retenção do INSS N N 3,2 aliquotair 0-1 Alíquota da retenção do IR N N 3,2 aliquotapis 0-1 Alíquota da retenção do PIS N N 3,2 aliquotacofins 0-1 Alíquota da retenção do COFINS N N 3,2 aliquotacsll 0-1 Alíquota da retenção do CSLL N N 3,2 valorservicos 1-1 Valor total dos serviços S N 15,2 valordeducoes 1-1 Valor total das deduções S N 15,2 situacaorps Normal 2 Cancelada S N 1 municipioincidencia 1-1 Município de incidência S C 115 estadomunicipioincidencia 1-1 Estado do município de incidência S C 60 prestador 1-1 Prestador de serviços S Prestador 1 codigoautenticidade 1-1 Código de autenticidade da nota S C 8 situacao 1-1 Situação da nota S C 32 Rps 1-1 Número do RPS que gerou a nota S N 15 valortotalnota 1-1 Valor total da nota S N 15,2 deducaototal 1-1 Total de deduções S N 15,2 valoritenstributaveis 1-1 Valor dos itens tributáveis S N 15,2 valoriss 1-1 Valor do ISS S N 15,2 basecalculo 1-1 Base de cálculo S N 15,2 municipioprestacao 1-1 Município de prestação do serviço S C 115 estadomunicipioprestacao 1-1 Estado do município de prestação S C 60 descricaotiporecolhimento 1-1 Tipo de recolhimento S C 60 descricaotributacao 1-1 Tipo de tributação S C Estrutura Prestador cpfcnpj 0-1 CPF/CNPJ do tomador do serviço (somente dígitos) S C 14 razaosocial 0-1 Razão social do tomador do serviço S C 115 idestrangeiro 0-1 Número de identificação to tomador estrangeiro S C 20 inscricaomunipal 0-1 Número da inscrição municipal S C do tomador S C 80 telefone 0-1 Telefone com DDD (somente dígitos) S C 10 endereco 0-1 Endereço do tomador S Endereco 1 enquadramento 0-1 Enquadramento do prestador S Enquadramento Estrutura Enquadramento

17 16 tipo Homologado 2 Estimado 3 Sociedade de Profissionais 4 Simples Nacional 5 Simples Nacional Estimado S N 2 6 SIMEI 7 Imune 8 Isento 9 Exigibilidade Suspensa descricao 1-1 Descrição do enquadramento S C Estruturas da funcionalidade Consultar Nota Fiscal por Período A funcionalidade Consultar Nota Fiscal por Período passa os seguintes parâmetros: PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N datainicio Data inicial do período, no formato (dd-mm-yyyy) C datafim Data final do período, no formato (dd-mm-yyyy) C assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + data Inicio no formato (dd-mm-aaaa) + data Fim no (dd-mm-aaaa) + código do município + N do RPS C Esta funcionalidade recebe como retorno uma estrutura RetornoNfse. As estruturas desta funcionalidade são idênticas às do ítem Estruturas da funcionalidade Consultar Nota Fiscal Por RPS A funcionalidade Consultar Nota Fiscal Por RPS passa os seguintes parâmetros: PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N rps Número do RPS C assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + código do município + N do RPS C Esta funcionalidade recebe como retorno uma estrutura RetornoNfse. As estruturas desta funcionalidade são idênticas às do ítem 4.4.

18 Estruturas da funcionalidade Cancelar Nota Fiscal A funcionalidade Cancelar Nota Fiscal passa os seguintes parâmetros: PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N numero Número da Nota Fiscal C assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + código do município + N da nota fiscal C Esta funcionalidade recebe como retorno uma estrutura RetornoCancelamentoNota Estrutura RetornoCancelamentoNota sucesso 1-1 Informa se o cancelamento foi processado com sucesso S B numeronota 1-1 Número da nota fiscal N 15 cpfcnpj 1-1 CPF/CNPJ do prestador C 18 municipio 1-1 Código IBGE do município S N 7 dataenvio 1-1 Data da solicitação (no formato dd-mm-yyyy hh:mm:ss S C 1 mensagens 1-1 Mensagens de erro ou alerta S Mensagem[ ] Estruturas da funcionalidade Consultar Dados do Prestador A funcionalidade Consultar Dados do Prestador passa os seguintes parâmetros: PARÂMETRO DESCRIÇÃO TIP cpfcnpj CPF/CNPJ do prestador C municipio Código IBGE do município N assinatura Assinatura da mensagem. Formada pela concatenação dos elementos citados abaixo e criptografado no formato SHA1: token do prestador + CPF/CNPJ(somente dígitos) + código do município + data atual no formato (dd-mm-aaaa) + N da nota fiscal C Esta funcionalidade recebe como retorno uma estrutura RetornoDadosPrestador.

19 Estrutura RetornoDadosPrestador sucesso 1-1 Informa se o cancelamento foi processado com sucesso S B municipio 1-1 Código IBGE do município S N 7 dataprestador 1-1 Informações do prestador S DadosPrestador 1 mensagens 1-1 Mensagens de erro ou alerta S Mensagem[ ] Estrutura DadosPrestador prestador 1-1 Informações sobre o prestador S Prestador 1 atividades 1-N Atividades do prestador S Atividade[ ] Estrutura Atividade subclasse 1-1 Subclasse da atividade S C 14 descricaoatividade 1-1 Descrição da atividade S C 256 ativo 1-1 Informa se é uma atividade ativa S B emitenota 1-1 Informa se a atividade emite nota S B simplesnacional 1-1 Informa se é uma atividade que pode ser utilizada por prestadores enquadrados S B como Simples Nacional descricaoitem 1-1 Descrição do item que a atividade pertence S C 256 issdevidolocalprestacao 1-1 Informa se o ISS é devido no local da prestação do serviço S B deducao 1-1 Tipo de dedução permitido S TipoDeducao 1 itenstributaveis 1-1 Informa se os itens são tributáveis S B atividadeeconomica 1-1 Informa a atividade econômica S C 60 permitetomadornaoidentificado 1-1 Informa se é permitido tomador não identificado S B tributavel 1-1 Informa se a atividade é tributável S B

20 Estrutura TipoDeducao tipo Sem dedução 2 Permite dedução por percentual 3 Permite dedução por mapa S N 1 4 Permite dedução por percentual ou mapa descricao 1-1 Descrição do tipo de dedução S C 115 deducaopercentual 0-N Deduções percentuais, caso o tipo de dedução permita N DeducaoPercentual[ ] Estrutura DeducaoPercentual percentual 1-1 Valor percentual da dedução S N 3,2

21 20 7. Exemplos 7.1 Envio de Lote Arquivo de envio <?xml version="1.0"?> <S:Envelope xmlns:s=" <S:Body> <ns2:enviarlote xmlns:ns2=" <lote> <assinatura>3685e7abbdb9aad21e0226a237eb c3b6f</assinatura> <codmunicipio> </codmunicipio> <cpfcnpjprestador> </cpfcnpjprestador> <datafim> </datafim> <datainicio> </datainicio> <quantidaderps>1</quantidaderps> <razaosocial>prestador de Serviços Exemplo</razaoSocial> <rps> <aliquota>3.0</aliquota> <aliquotacofins>0.0</aliquotacofins> <aliquotacsll>0.0</aliquotacsll> <aliquotainss>3.0</aliquotainss> <aliquotair>0.0</aliquotair> <aliquotapis>0.0</aliquotapis> <atividade> </atividade> <codigomunicipioprestacao> </codigomunicipioprestacao> <dataemissao> :20:45</dataEmissao> <deducao> <deducaomapa> <cpfcnpjfornecedor> </cpfcnpjfornecedor> <numeronotafiscal>9999</numeronotafiscal> <tipodeducaomapa>1</tipodeducaomapa> <valordeducao>100.0</valordeducao> <valornotafiscal>200.0</valornotafiscal> </deducaomapa> </deducao> <descricaonota>descrição da nota fica aqui</descricaonota> <itensnota> <descricao>descrição de item exemplo</descricao> <quantidade>2</quantidade> <tributavel>true</tributavel> <valortotal>1200.0</valortotal> <valorunitario>600.0</valorunitario> </itensnota> <numero>9</numero> <situacaorps>1</situacaorps> <tiporecolhimento>1</tiporecolhimento> <tipotomador>1</tipotomador> <tomador> <cpfcnpj> </cpfcnpj> <endereco> <bairro>bairro Exemplo</bairro> <cep> </cep> <complemento>complemento Exemplo</complemento> <logradouro>logradouro Exemplo</logradouro> <numero>999</numero> <pais>0</pais> <tipologradouro>1</tipologradouro> </endereco> <inscricaomunicipal>99999</inscricaomunicipal> <razaosocial>tomador de Serviços Exemplo</razaoSocial> <telefone> </telefone> </tomador> <tributacao>3</tributacao> <valorcofins>0.0</valorcofins> <valorcsll>0.0</valorcsll>

22 21 <valordeducoes>100.0</valordeducoes> <valorinss>36.0</valorinss> <valorir>0.0</valorir> <valorpis>0.0</valorpis> <valorservicos>1200.0</valorservicos> </rps> <valortotalrps>1200.0</valortotalrps> <versao>1</versao> </lote> </ns2:enviarlote> </S:Body> </S:Envelope> Arquivo de retorno <?xml version='1.0' encoding='utf-8'?> <S:Envelope xmlns:s=" <S:Body> <ns2:enviarloteresponse xmlns:ns2=" <return> <cpfcnpj> </cpfcnpj> <dataenvio> :53:40</dataEnvio> <numerolote> </numerolote> <sucesso>true</sucesso> <versao>1</versao> </return> </ns2:enviarloteresponse> </S:Body> </S:Envelope> 7.2 Consultar Situação do Lote Arquivo de envio <?xml version="1.0"?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarsituacaolote xmlns:ns2=" <numerolote> </numerolote> </ns2:consultarsituacaolote> </S:Body> </S:Envelope> Arquivo de retorno <?xml version='1.0' encoding='utf-8'?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarsituacaoloteresponse xmlns:ns2=" <return> <cpfcnpj> / </cpfcnpj> <dataenvio> :12:41</dataEnvio> <numerolote> </numerolote> <sucesso>true</sucesso> <versao>1</versao> </return> </ns2:consultarsituacaoloteresponse> </S:Body> </S:Envelope>

23 Consultar Lote Arquivo de envio <?xml version="1.0"?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarlote xmlns:ns2=" <cpfcnpj> </cpfcnpj> <numerolote> </numerolote> <assinatura>bae3e3bcd5fdfc157fc85a04ccc df31</assinatura> </ns2:consultarlote> </S:Body> </S:Envelope> Arquivo de retorno <?xml version='1.0' encoding='utf-8'?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarloteresponse xmlns:ns2=" <return> <lote> <assinatura>3685e7abbdb9aad21e0226a237eb c3b6f</assinatura> <codmunicipio> </codmunicipio> <cpfcnpjprestador> </cpfcnpjprestador> <datafim> </datafim> <datainicio> </datainicio> <quantidaderps>1</quantidaderps> <razaosocial>prestador de Serviços Exemplo</razaoSocial> <rps> <aliquota>3.0</aliquota> <aliquotacofins>0.0</aliquotacofins> <aliquotacsll>0.0</aliquotacsll> <aliquotainss>0.0</aliquotainss> <aliquotair>0.0</aliquotair> <aliquotapis>0.0</aliquotapis> <atividade> </atividade> <codigomunicipioprestacao> </codigomunicipioprestacao> <dataemissao> </dataemissao> <deducao> <deducaomapa> <cpfcnpjfornecedor> / </cpfcnpjfornecedor> <numeronotafiscal>9999</numeronotafiscal> <tipodeducaomapa>1</tipodeducaomapa> <tipodeducaomapadescricao>despesas com Materiais</tipoDeducaoMapaDescricao> <valordeducao>100.0</valordeducao> <valornotafiscal>200.0</valornotafiscal> </deducaomapa> </deducao> <descricaonota>descrição da nota fica aqui</descricaonota> <itensnota> <descricao>descrição de item exemplo</descricao> <quantidade>2</quantidade> <tributavel>true</tributavel> <valortotal>1200.0</valortotal> <valorunitario>600.0</valorunitario> </itensnota> <numero>9</numero> <situacaorps>1</situacaorps> <tiporecolhimento>1</tiporecolhimento> <tipotomador>1</tipotomador> <tomador> <cpfcnpj> </cpfcnpj> <endereco> <bairro>bairro Exemplo</bairro> <cep> </cep> <complemento>complemento Exemplo</complemento> <logradouro>logradouro Exemplo</logradouro>

24 23 <numero>999</numero> <pais>0</pais> <tipologradouro>1</tipologradouro> <tipologradourodescricao>rua</tipologradourodescricao> </endereco> <inscricaomunicipal>99999</inscricaomunicipal> <razaosocial>tomador de Serviços Exemplo</razaoSocial> <telefone> </telefone> </tomador> <tributacao>3</tributacao> <valorcofins>0.0</valorcofins> <valorcsll>0.0</valorcsll> <valordeducoes>0.0</valordeducoes> <valorinss>0.0</valorinss> <valorir>0.0</valorir> <valorpis>0.0</valorpis> <valorservicos>0.0</valorservicos> </rps> <valortotalrps>1200.0</valortotalrps> <versao>1</versao> </lote> <sucesso>false</sucesso> </return> </ns2:consultarloteresponse> </S:Body> </S:Envelope> 7.4 Consultar Nota Fiscal Arquivo de envio <?xml version="1.0"?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarnota xmlns:ns2=" <cpfcnpj> </cpfcnpj> <numero>15</numero> <assinatura>f43a7c411c95ca3479b73c6a0a6347a0dca9d98e</assinatura> </ns2:consultarnota> </S:Body> </S:Envelope> Arquivo de retorno <?xml version='1.0' encoding='utf-8'?> <S:Envelope xmlns:s=" <S:Body> <ns2:consultarnotaresponse xmlns:ns2=" <return> <nfse> <aliquota>3.0</aliquota> <aliquotacofins>0.0</aliquotacofins> <aliquotacsll>0.0</aliquotacsll> <aliquotainss>0.0</aliquotainss> <aliquotair>0.0</aliquotair> <aliquotapis>0.0</aliquotapis> <atividade>1066-0/00-00</atividade> <codigomunicipioprestacao> </codigomunicipioprestacao> <dataemissao> </dataemissao> <deducao> <deducaomapa> <cpfcnpjfornecedor> / </cpfcnpjfornecedor> <numeronotafiscal>9999</numeronotafiscal> <tipodeducaomapa>1</tipodeducaomapa> <tipodeducaomapadescricao>despesas com Materiais</tipoDeducaoMapaDescricao> <valordeducao>100.0</valordeducao>