mmaannuuaall ddee iinntteeggrraaççããoo … · smr – para documentar prestações de...

Prefeitura Municipal de Florianópolis – Secretaria Municipal da Receita

Sistema de Geração e Emissão de Nota Fiscal de Prestação de Serviços Eletrônica

Manual de Integração – Versão 1.0 1

SSiisstteemmaa ddee GGeerraaççããoo ee

EEmmiissssããoo ddee NNoottaa FFiissccaall ddee

PPrreessttaaççããoo ddee SSeerrvviiççooss

EElleettrrôônniiccaa

MMaannuuaall ddee IInntteeggrraaççããoo

VVeerrssããoo 11..00 (Especificação Técnica de Integração entre Sistema do Contribuinte e Cliente NFPS-e)

FFLLOORRIIAANNÓÓPPOOLLIISS -- SSCC




Sumário

1. Introdução ..................................................................................................................... 3

2. Modelo Operacional ..................................................................................................... 5

3. Padrão de Mensagens XML......................................................................................... 7

3.1. Validação da estrutura das Mensagens XML ................................................................................... 7

4. Tipos Utilizados ............................................................................................................ 8

4.1. Formatos e Padrões Utilizados ........................................................................................................ 8

4.2. Tipos Simples ................................................................................................................................. 10

4.3. Tipos Complexos............................................................................................................................ 13

5. Integração com ERPs ................................................................................................. 17

5.1. Tabelas de Países e Municípios ..................................................................................................... 18

5.2. Códigos Tributários........................................................................................................................ 19

5.3. Filtros de Validação Tributária....................................................................................................... 21

5.4. Criação de Requisições de NFPS-e ................................................................................................. 25

5.5. Leitura de NFPS-e .......................................................................................................................... 27




1. Introdução

Considera-se Nota Fiscal de Prestação de Serviço Eletrônica, – NFPS-e – o

documento eletrônico gerado e emitido pela Secretaria Municipal da Receita –

SMR – para documentar prestações de serviços, de existência exclusivamente

digital, fornecido mediante requisição enviada pelo contribuinte, com validade

jurídica garantida por assinatura digital.

A NFPS-e poderá ser utilizada por contribuinte do Imposto Sobre Serviços de

Qualquer Natureza – ISQN –, em substituição à Nota Fiscal de Prestação de

Serviço – modelo I.

O contribuinte que optar por emitir e conservar os seus documentos fiscais, na

forma prevista nesta Subseção, deverá:

I. Valer-se de assinatura digital, baseada em certificado digital

emitido na forma prevista pela Medida Provisória nº. 2.200-2, de 24

de agosto de 2001, que instituiu a Infraestrutura de Chaves Públicas

Brasileiras – ICP Brasil;

II. Obter autorização junto à Secretaria Municipal da Receita –

SMR, na forma prevista no art. 30 A;

III. Manter as Notas Fiscais de Prestação de Serviço Eletrônica –

NFPS-e em arquivo digital, pelo prazo estabelecido na legislação

tributária.

Conforme previsto na legislação (art. 25 C. da Subseção V, da Seção II, do

Capítulo II, do Anexo III, do RISQN) em casos especiais a assinatura digital

poderá ser substituída por login e senha, é o caso da versão 1.0 do sistema.

Inicialmente será opcional a utilização de certificado digital pelo prestador de

serviços.




O sistema de emissão e geração de NFPS-e consiste em uma aplicação

Servidor NFPS-e instalada no ambiente da SMR e uma aplicação Cliente NFPS-e,

fornecida pela SMR, que é um software instalado no computador do prestador de

serviços para utilização dos serviços de emissão, cancelamento, substituição e

consulta de NFPS-e.

Figura 1. Arquitetura do Sistema de Geração e Emissão de NFPS-e

Os serviços oferecidos pelo sistema são solicitados através de requisições,

que podem ser para emissão, cancelamento, substituição ou consulta de NFPS-e.

A Figura 1 apresenta a arquitetura do sistema e o fluxo completo das requisições

no sistema.

1. Software do contribuinte gera requisição para emissão de NFPS-e;

2. Software do contribuinte armazena a requisição no diretório de

requisições;

3. Cliente NFPS-e realiza importação das requisições do diretório;

4. Estabelecimento de canal seguro de comunicação com o servidor:




a. Transmissão da requisição;

5. Recepção da requisição:

a. Validação de estrutura da requisição;

b. Verificação da assinatura ou autenticação da requisição;

6. Validação das Regras de Negócio:

a. Validação da data de emissão (na emissão, substituição e

cancelamento);

b. Validação dos itens de serviço (na emissão e substituição);

7. Validações na FIAC:

a. Validação do prestador;

b. Validação de responsável pelo prestador que enviou a

requisição;

c. Validação da AEDF-e;

8. Geração da NFPS-e: normal, substituta ou cancelada;

9. Disponibiliza a NFPS-e para consultas;

10. Envia a NFPS-e emitida ao prestador;

11. Armazena a NFPS-e no diretório de notas fiscais;

12. Envia a NFPS-e por e-mail ao tomador (se configurado o envio de e-

mails no Cliente NFPS-e);

2. Modelo Operacional

O módulo cliente (Cliente NFPS-e) é um software instalado no computador do

contribuinte que deseja utilizar os serviços do sistema de geração e emissão de




Nota Fiscal de Prestação de Serviços Eletrônica – NFPS-e da Secretaria Municipal

de Receita – SMR de Florianópolis. O Cliente NFPS-e tem as seguintes

funcionalidades:

Importação de requisições para emissão de NFPS-e;

Criação de requisições para emissão de NFPS-e;

Assinatura e Autenticação de requisições;

Emite Recibo Provisório Serviço (RPS) em contingência;

Envia NFPS-e para tomador por e-mail;

Visualização e Impressão de RPS e de NFPS-e;

Cancela/Substitui NFPS-e;

Consulta de NFPS-e;

Exportação de NFPS-e;

Validação de dados dos serviços;

Atualização automática de códigos tributários;

O Cliente NFPS-e pode trabalhar de forma integrada com software ERP desde

que este gere uma Requisição para emissão de NFPS-e no formato XML

(tcRequisicao) definido pela SMR. Caso o usuário não possua sistema ERP que

gere a Requisição, o próprio Cliente NFPS-e se encarregará de gerá-la. As

Requisições geradas são armazenadas em um diretório específico.

O Cliente NFPS-e possibilita a importação das requisições presentes no

diretório em modo de edição ou diretamente para fila de emissão. Se houverem

erros nas requisições os mesmos serão exibidos para o contribuinte no momento

da importação. As NFPS-e(s) geradas pelo sistema são também armazenadas em

diretório específico possibilitando a leitura das notas emitidas pelo ERP do

contribuinte.




Este documento especifica a estrutura das requisições e das notas fiscais de

prestação de serviço eletrônicas para possibilitar a integração do Cliente NFPS-e

com ERP(s) dos prestadores de serviço.

Os contribuintes deverão solicitar junto à secretaria municipal da receita de

Florianópolis uma Autorização para Emissão de Documentos Fiscais Eletrônicos

(AEDF-e) de forma análoga à Autorização para Impressão de Documentos Fiscais

(AIDF). No primeiro cadastro do contribuinte serão definidos usuário e senha para

acesso ao Cliente NFPS-e.

3. Padrão de Mensagens XML

A especificação adotada para as mensagens XML é a recomendação W3C

para XML 1.0, disponível em www.w3.org/TR/REC-xml e a codificação dos

caracteres será em UTF-8.

3.1. Validação da estrutura das Mensagens XML

Para garantir minimamente a integridade das informações prestadas e a

correta formação das mensagens XML, o contribuinte deverá submeter cada uma

das mensagens XML de requisição ao respectivo arquivo XSD (XML Schema

Definition, definição de esquemas XML) antes da importação. Neste manual

utilizaremos a nomenclatura Schema XML para nos referir a arquivo XSD. Um

Schema XML define o conteúdo de uma mensagem XML, descrevendo os seus

atributos, elementos e a sua organização, além de estabelecer regras de

preenchimento de conteúdo e de obrigatoriedade de cada elemento ou grupo de

informação.




A validação da estrutura da mensagem XML é realizada por um analisador

sintático (parser) que verifica se a mensagem XML atende as definições e regras

de seu respectivo Schema XML.

Qualquer divergência da estrutura da mensagem XML em relação ao seu

respectivo Schema XML, provoca um erro de validação do Schema XML. Neste

caso o conteúdo da mensagem XML de requisição não poderá ser processado. A

primeira condição para que a mensagem XML seja validada com sucesso é que

ela seja submetida ao Schema XML correto.

Assim, os sistemas de informação dos contribuintes devem estar preparados

para gerar requisições XML de acordo o Schema XML em vigor.

4. Tipos Utilizados

A seguir são apresentados os formatos e padrões, tipos simples e complexos

utilizados nos Schemas XML de requisição e NFPS-e. Estes tipos estão definidos

no Schema XML de TiposNFPS-e (arquivo TiposNFPSe_V01.xsd).

Para obter a versão mais recente do Schema XML de TiposNFPS-e (bem

como os demais Schemas XML) acesse o link:

http://nfe.pmf.sc.gov.br/nfse/versao?tipo=SCHEMAS.

4.1. Formatos e Padrões Utilizados

Abaixo segue algumas formatações padrão de dados que devem ser seguidas

para geração correta na estrutura dos arquivos.

http://nfe.pmf.sc.gov.br/nfse/versao?tipo=SCHEMAS




Formato Observação Data (date) Formato: AAAA-MM-DD

onde: AAAA = ano com 4 caracteres MM = mês com 2 caracteres DD = dia com 2 caracteres

Data/Hora (datetime) Formato AAAA-MM-DDTHH:mm:ss.ccc onde: AAAA = ano com 4 caracteres MM = mês com 2 caracteres DD = dia com 2 caracteres T = caractere de formatação que deve existir separando a data da hora HH = hora com 2 caracteres mm: minuto com 2 caracteres ss: segundo com 2 caracteres ccc: milisegundos com 3 caracteres

Valores Decimais (decimal)

Formato: 0.00 Não deve ser utilizado separador de milhar. O ponto (.) deve ser utilizado para separar a parte inteira da fracionária. Exemplo: 48.562,25 = 48562.25 1,00 = 1.00 ou 1 0,50 = 0.50 ou 0.5

Valores Percentuais

(decimal) Formato 0.0000

O formato em percentual presume o valor percentual em sua forma fracionária, contendo 5 dígitos. O ponto (.) separa a parte inteira da fracionária. Exemplo: 62% = 0.62 150% = 1.5 25,32 = 0.2532

Não deve ser inserido caractere não significativo para preencher o tamanho

completo do campo, ou seja, zeros antes de número ou espaço em branco após

cadeia de caracteres. A posição do campo é definida na estrutura do documento

XML através de TAGs (<tag>conteúdo</tag>).

A regra constante do parágrafo anterior deverá estender-se para os campos

onde não há indicação de obrigatoriedade e que, no entanto, seu preenchimento

torna-se obrigatório por estar condicionado à legislação específica ou ao negócio

do contribuinte. Neste caso, deverá constar a TAG com o valor correspondente e,

para os demais campos, deverão ser eliminadas as TAGs.

Para reduzir o tamanho final do arquivo XML da NFPS-e alguns cuidados de

programação deverão ser assumidos:

Não incluir "zeros não significativos" para campos numéricos;




Não incluir "espaços" no início ou no final de campos numéricos e alfanuméricos;

Não incluir comentários no arquivo XML;

Não incluir anotação e documentação no arquivo XML (TAG annotation e TAG documentation);

Não incluir caracteres de formatação no arquivo XML ("line-feed", "carriage return", "tab", caractere de "espaço" entre as TAGs).

As TAGs que permitirem valores nulos devem ser omitidas da estrutura XML a ser enviada.

4.2. Tipos Simples

A seguir encontra-se a tabela com a lista dos tipos simples que serão

utilizados como tipos de dados. A tabela está dividida em 4 colunas, a saber:

Campo: nome do tipo simples;

Tipo: tipo primitivo de dados utilizados pelo campo:

B: Binário;

C: Caractere;

N: Número;

Descrição: descreve informações sobre o campo;

Tam.: tamanho do campo:

Quando for de caracteres o tamanho define a quantidade máxima de

caracteres que o texto poderá ter;

Quando for numérico o tamanho pode ser representado das seguintes

formas:




o - Número inteiro, que define o total de dígitos existente no

número. Exemplo: “15” significa que o número poderá ter, no

máximo, 15 dígitos;

o - Número fracionário, que define o total de dígitos e quantos

deles serão designados para a parte fracionária. Exemplo: “15,2”

significa que o número poderá ter, no máximo, 15 dígitos sendo

2 deles a identificação da parte fracionária. A parte fracionária

não é obrigatória quando assim definido;

Quando for data, não haverá definição de tamanho.

Nome do Tipo Descrição

(Tipo utilizado para informar ...)

Tipo Base

Tamanho Observação

tsIdTag Atributo identificador da tag a ser assinada no documento XML.

C 23 Automaticamente gerado pelo Cliente NFPS-e.

tsNumeroAEDF Numero da Autorização para Emissão de Documentos Fiscais Eletrônicos.

C 7

tsTipoAEDF Tipo da AEDF C 6 Tipos de AEDF: NORMAL (NFPS) FATURA (NFPS-F)

tsAutenticacao Utilizada a função HMAC com SHA-1 informando a senha do contribuinte e a requisição.

C 40 Automaticamente gerada pelo cliente caso não seja utilizada assinatura com certificado ICP-Brasil.

tsAliquota Valor da alíquota do serviço. N 5,4 Alíquota. Valor percentual. Formato: 0.0000 Ex: 1% = 0.01 25,5% = 0.255 100% = 1.0000 ou 1

tsBairro Bairro do endereço. C 60 Bairro.

tsCEP CEP do endereço. N 8 Código postal para tomadores domiciliados Brasil.

tsPostalCode CEP de outros países. C 10 Código postal para tomadores domiciliados fora do Brasil.

tsCodigoAtividade Subclasse do CNAE obtida da tabela de Código Nacional de Atividade Econômica disponibilizada pela PMF.

N 8 O código de atividade (subclasse) deve ser informado para cada item de prestação de serviço em cada nota emitida.




tsIdCNAE Identificador do CNAE obtido da tabela de Código Nacional de Atividade Econômica disponibilizada pela PMF.

N 5 O IDCNAE deve ser informado para cada item de prestação de serviço em cada nota emitida.

tsCNPJ Número no Cadastro Nacional da Pessoa Jurídica.

C 14

tsCFPS Código Fiscal de Prestação de Serviço

N 4

tsCodigoCampanha Código de campanha promocional.

C 8 Código de campanha promocional gerado pelo Sistema de NFPS-e.

tsCodigoVerificacao Código de verificação da NFPS-e. C 16 Código de verificação da NFPS-e gerado pelo Sistema de NFPS-e.

tsComplementoEndereco Complemento do endereço. C 30

tsCPF Número no Cadastro de Pessoas Físicas.

C 11

tsCST Código de situação tributária. N 2

tsDadosAdicionais Dados adicionais C 256 Texto descritivo contendo dados adicionais da nota.

tsDiscriminacao Discriminação do Serviço Prestado ou de motivo de cancelamento da NFPS-e.

C 1000 Texto descritivo do serviço prestado ou do motivo de cancelamento da NFPS-e.

tsEmail E-mail. C 80 tsIdentificacaoRequisicao Identificação da requisição. C 10 Campo utilizado exclusivamente pelo

prestador para controle externo das requisições/NFPS-e.

tsInscricaoMunicipal Inscrição Municipal. C 7 tsLogradouro Endereço. C 80 tsMunicipio Nome do município. C 60 Utilizar apenas para municípios do

exterior.

tsMunicipioIBGE Código do município (Tabela do IBGE).

N 7 Utilizar apenas para municípios do Brasil.

tsNumeroSerie Número de série de uma NFPS-e. N 6

tsNumeroEndereco Número do endereço. C 9 tsOutrosDocIdentificacao Documento de identificação. C 30 Só deve ser utilizado quando o

tomador não possuir CPF ou CNPJ. Ex: Tomador do exterior.

tsPais Tipo país. N 5 Código do país (Tabela do BACEN). Deve ser informado se o tomador for domiciliado fora do Brasil. Se o tomador for do Brasil não usar.

tsQuantidade Tipo quantidade. N 3 Quantidade de serviços ou de itens de serviço.

tsRazaoSocial Tipo Razão Social. C 80 Nome/Razão Social.

tsStatusNFPSe Status da NFPS-e. N 1 Status da NFPS-e: 0 – Normal; 1 – Cancelada.

tsStatusRequisicao Status da Requisição. N 1 Status da Requisição: 0 – Em edição; 1 – Pendente; 2 – Recibo provisório.




tsTelefone Número de telefone. N 14 Número do telefone com prefixos inclusos.

tsTipoSistema Tipo do sistema. Homologação ou Produção.

N 1 Tipo do Sistema: 0 – Homologação; 1 – Produção;

tsUF Sigla da UF do endereço. C 2 Sigla da UF do endereço. Deve ser informado apenas para tomadores domiciliados no Brasil. Se o tomador for de outro país não usar.

tsValor Valores. N 15, 2 Tipo utilizado para valores com 15 dígitos, sendo 13 de corpo e 2 decimais. Exemplo: R$ 500,85 – 500.85 R$ 826,00 – 826

tsVersao Versão do XML Schema. N 3, 2 O conteúdo deste campo indica a versão do Schema XML utilizado. Ex: 1.0, 1.01, 2.55

4.3. Tipos Complexos

Layout da tabela utilizada para representar a estrutura XML dos Tipos

Complexos:

<Nome do Tipo Complexo> <Descrição do Tipo Complexo>

Nome do Elemento Tipo do Elemento Ocorrência Descrição do elemento

<Nome do Elemento 1> <Tipo do Elemento 1> x-y <Descrição do elemento 1>

<Nome do Elemento ...> <Tipo do Elemento ...> x-y <Descrição do elemento ...>

Elemento que deriva de uma escolha (Choice).

<Nome do Elemento de Escolha a>

<Tipo do Elemento a>

x-y

<Descrição do elemento a>

<Nome do Elemento de Escolha b>

<Tipo do Elemento b.> <Descrição do elemento b>

<Nome do Elemento de Escolha c>

<Tipo do Elemento c.> <Descrição do elemento c>

<Nome do Elemento N> <Tipo do Elemento N> x-y <Descrição do elemento N>

* Ocorrência: x - y, onde x indica a ocorrência mínima e y a ocorrência máxima.

tcCodigoPostal Tipo que representa um código postal

Nome do Elemento Tipo do Elemento Ocorrência Descrição

(Choice)

CEP tsCEP 1-1 CEP.

PostalCode tsPostalCode 1-1 Código postal para outros países.




tcInformacaoAEDF Tipo que representa informações da AEDF.


AEDF tsNumeroAEDF 1-1 Número da AEDF.

TipoAEDF tsTipoAEDF 1-1 Tipo da AEDF (NORMAL ou FATURA).

tcMunicipio

Tipo que representa um Município brasileiro ou do exterior. Nome do Elemento Tipo do Elemento Ocorrência Descrição

(Choice)

CodigoMunicipio tsMunicipioIBGE 1-1 Código do município (Tabela do IBGE).

Apenas para municípios brasileiros.

NomeMunicipio tsMunicipio 1-1 Nome do município.

Apenas para municípios do exterior.

tcEndereco

Tipo que representa um Endereço Nome do Elemento Tipo do Elemento Ocorrência Descrição

Logradouro tsLogradouro 1-1 Endereço.

NumeroEndereco tsNumeroEndereco 0-1 Número do endereço.

ComplementoEndereco tsComplementoEndereco 0-1 Complemento do endereço.

Bairro tsBairro 1-1 Bairro do endereço.

Municipio tcMunicipio 1-1 Município do endereço.

CodigoPostal tcCodigoPostal 1-1 Código postal do endereço.

UF tsUF 0-1 Usar quando o endereço for do Brasil

Pais tsPais 0-1 Usar quando o endereço for do Exterior

tcContato

Representa forma de contato com a pessoa (física/jurídica) Nome do Elemento Tipo do Elemento Ocorrência Descrição

Telefone tsTelefone 0-1 Número de telefone.

Email tsEmail 1-1 Endereço de e-mail.

tcCPFCNPJ Tipo que representa um CPF/CNPJ


(Choice) CPF tsCPF 1-1 Número no Cadastro de Pessoas Físicas.

CNPJ tsCNPJ 1-1 Número no Cadastro Nacional da Pessoa Jurídica.

tcDocIdTomador Tipo que representa um documento de identificação do tomador.


(Choice) CPFCNPJ tcCPFCNPJ 1-1 CPF ou CNPJ do tomador.

Outros tsOutrosDocIdentificacao 1-1 Outro documento de identificação do tomador.

tcIdentificacaoTomador Representa dados de identificação do tomador de serviço. Nome do Elemento Tipo do Elemento Ocorrência Descrição




DocIdTomador tcDocIdTomador 1-1 Número de CPF, CNPJ ou de outros documentos de identificação.

InscricaoMunicipal tsInscricaoMunicipal 0-1 Número de inscrição municipal do tomador.

tcDadosTomador Representa dados do tomador de serviço.

Nome do Elemento Tipo do Elemento Ocorrência Descrição IdentificacaoTomador tcIdentificacaoTomador 1-1 Identificador para o tomador.

RazaoSocial tsRazaoSocial 1-1 Razão social do tomador.

Endereco tcEndereco 1-1 Endereço do tomador.

Contato tcContato 1-1 Contato do tomador

tcIdentificacaoPrestador Representa dados de identificação do prestador de serviço. Nome do Elemento Tipo do Elemento Ocorrência Descrição

CNPJ tsCNPJ 1-1 Número do CNPJ.

InscricaoMunicipal tsInscricaoMunicipal 0-1 Número de inscrição municipal do tomador.

tcDadosPrestador Representa dados do prestador de serviço.

Nome do Elemento Tipo do Elemento Ocorrência Descrição IdentificacaoPrestador tcIdentificacaoPrestador 1-1 Identificador para o tomador.

RazaoSocial tsRazaoSocial 1-1 Razão social do tomador.

Endereco tcEndereco 1-1 Endereço do tomador.

Contato tcContato 1-1 Contato do tomador

tcItemServico

Tipo que representa um item de serviço de uma requisição ou NFPS-e.

Nome do Elemento Tipo do Elemento Ocorrência Descrição IdCNAE tsIdCNAE 1-1 Identificador do Código de atividade.

CodigoAtividade tsCodigoAtividade 1-1 Código de atividade.

DescricaoServico tsDiscriminacao 1-1 Descrição do serviço prestado.

CST tsCST 1-1 Código da situação tributária.

Aliquota tsAliquota 1-1 Alíquota

ValorUnitario tsValor 1-1 Valor unitário do item de serviço.

Quantidade tsQuantidade 1-1 Quantidade do serviço prestado.

ValorTotal tsValor 1-1 Valor total do serviço prestado.

tcDadosServico Tipo que representa os dados do(s) serviço(s) de uma requisição ou NFPS-e.

Nome do Elemento Tipo do Elemento Ocorrência Descrição ItensServico tcItemServico 1-999 Itens de serviço prestados.

BaseCalculo tsValor 1-1 Base de cálculo do ISSQN.

ValorISSQN tsValor 1-1 Valor do ISSQN.

BaseCalculoSubstituicao tsValor 0-1 Base de cálculo do ISSQN Substituição.

ValorISSQNSubstituicao tsValor 0-1 Valor do ISSQN Substituição.

ValorTotalServicos tsValor 1-1 Valor total dos serviços.

DadosAdicionais tsDiscriminacao 0-1 Dados adicionais da nota fiscal.

tcInfRequisicao

Representa dados informativos da requisição. Nome do Elemento Tipo do Elemento Ocorrência Descrição




Id tsTagId 0-1 Identificador da requisição composto pela inscrição municipal, AEDF e número da requisição. Definido pelo Cliente NFPS-e.

Versao tsVersao 1-1 Versão do XML Schema deste tipo complexo.

TipoSistema tsTipoSistema 1-1 Tipo do sistema (homologação – 0 ou produção – 1).

Identificacao tsIdentificacaoRequisicao 0-1 Identificador para a requisição.

AEDF tsInformacaoAEDF 1-1 Informações de Autorização para Emissão de Documentos Fiscais Eletrônicos.

CodigoVerificacao tsCodigoVerificacao 0-1 Código de Verificação da NFPS-e. Gerado pelo Cliente NFPS-e.

DataEmissao Date 1-1 Data da emissão da NFPS-e.

NumeroSerieRequisicao tsNumeroSerie 0-1 Número de série desta requisição. Definido pelo Cliente NFPS-e

NumeroSerieSubst tsNumeroSerie 0-1 Número de série da NFPS-e a substituída por esta.

CFPS tsCFPS 1-1 Código fiscal de prestação de serviço.

StatusRequisicao tsStatusRequisicao 0-1 Status da requisição. Definido pelo Cliente NFPS-e.

DadosServico tcDadosServico 1-1 Dados do(s) serviço(s).

Prestador tcDadosPrestador 0-1 Dados do prestador. Definido pelo Cliente NFPS-e.

Tomador tcDadosTomador 1-1 Dados do tomador.

tcRequisicao

Representa a estrutura da requisição opcionalmente assinada. Nome do Elemento Tipo do Elemento Ocorrência Descrição

InfRequisicao tcInfRequisicao 1-1 Dados informativos da requisição (ver detalhes na tabela tcInfRequisicao).

Signature dsig:Signature 0-1 Deve ser utilizado o padrão brasileiro de assinaturas digital AD-RB, conforme DOC-ICP-15.03.

Autenticacao ts:Autenticacao 0-1 Ver tsAutenticacao. Deve ser estar presente apenas quando não for utilizada a tag Signature.

tcInfNFPSe Representa dados informativos da NFPS-e.


Id tsTagId 1-1 Identificador da NFPS-e.

Versao tsVersao 1-1 Versão do XML Schema deste tipo complexo.

TipoSistema tsTipoSistema 1-1 Tipo do sistema (homologação – 0 ou produção – 1).

Identificacao tsIdentificacaoRequisicao 0-1 Identificador para a requisição associada.

AEDF tsInformacaoAEDF 1-1 Autorização para emissão de documentos fiscais eletrônicos.

CodigoVerificacao tsCodigoVerificacao 0-1 Código de Verificação da NFPS-e.

NumeroSerie tsNumeroSerie 1-1 Número de série da NFPS-e.

NumeroSerieSubst tsNumeroSerie 0-1 Número de série da NFPS-e substituída por




esta.

DataEmissao Date 1-1 Data da emissão da NFPS-e.

DataCancelamento Date 0-1 Data de cancelamento da NFPS-e.

MotivoCancelamento tsDiscriminacao 0-1 Motivo do cancelamento da NFPS-e.

CFPS tsCFPS 1-1 Código fiscal de prestação de serviço.

CodigoCampanha tsCodigoCampanha 0-1 Código promocional de campanha.

StatusNFPSe tsStatusNFPSe 1-1 Status da NFPS-e.

DadosServico tcDadosServico 1-1 Dados do(s) serviço(s).

Prestador tcDadosPrestador 1-1 Dados do prestador.

Tomador tcDadosTomador 1-1 Dados do tomador.

tcNFPSe

Representa a estrutura da NFPS-e assinada Nome do Elemento Tipo do Elemento Ocorrência Descrição

InfNFPSe tcInfNFPSe 1-1 Dados informativos da NFPSe (ver detalhes na tabela tcInfNFPSe).

Signature dsig:Signature 1-1 Deve ser utilizado o padrão brasileiro de assinaturas digital AD-RT, conforme DOC-ICP-15.03. Obrigatoriamente realizada pela prefeitura municipal de Florianópolis.

5. Integração com ERPs

Esta seção descreve os procedimentos necessários para integração do

aplicativo Cliente NFPS-e disponibilizado pela SMR de Florianópolis com os

softwares (ERPs) utilizados pelos contribuintes.

Os ERPs poderão gerar requisições para emissão de NFPS-e que devem ser

salvas em diretório configurado no Cliente NFPS-e. As requisições serão geradas

no formato XML de acordo com o XML Schema descrito neste manual e

disponibilizado em http://nfe.pmf.sc.gov.br/nfse/versao?tipo=SCHEMAS.

Para o envio das requisições é necessário que o contribuinte utilize a

funcionalidade de importação de requisições no Cliente definindo se as

requisições importadas serão editadas ou estão prontas para o envio. Após a

importação as requisições são tratadas da mesma forma que as requisições

geradas pelo Cliente.

http://nfe.pmf.sc.gov.br/nfse/versao?tipo=SCHEMAS




As seções subseqüentes descrevem as informações necessárias para criação

de requisições para emissão de NFPS-e e para interpretação das notas fiscais de

prestação de serviço eletrônicas geradas pela prefeitura.

5.1. Tabelas de Países e Municípios

As requisições e NFPS-e(s) contem dados da localidade de prestadores e

tomadores de serviços. O município deve ser informado através do código do

mesmo de acordo com a tabela de municípios do IBGE, nos casos onde o

tomador for do Brasil. Quando o tomador for estrangeiro o país do tomador deve

ser informado através do código do mesmo de acordo com a tabela de países do

BACEN.

O tipo complexo TcMunicipio é uma estrutura XSD do tipo Choice que

possibilita a definição exclusiva dos tipos simples TsMunicipioIBGE ou

TsMunicipio. A escolha do tipo simples a ser utilizado depende da localidade do

tomador, se for do Brasil deve ser usado TsMunicipioIBGE com o código do

município, se for do exterior deve ser usado TsMunicipio com o nome do

município.

A tabela de municípios do IBGE pode ser obtida diretamente através do link

ftp://geoftp.ibge.gov.br/Organizacao/Divisao_Territorial/2009/DTB_05_05_2009.zip ou

no site do IGBE (http://www.ibge.gov.br).

O tipo simples TsPais é uma estrutura que possibilita a informação do país de

tomadores do exterior. Quando o tomador for do Brasil este tipo não deve ser

informado.

A tabela de países do BACEN pode ser obtida diretamente através do link

http://www.bcb.gov.br/rex/ftp/paises.txt ou no site do Banco Central Brasileiro

(http://www.bcb.gov.br/).

ftp://geoftp.ibge.gov.br/Organizacao/Divisao_Territorial/2009/DTB_05_05_2009.zip

http://www.ibge.gov.br/

http://www.bcb.gov.br/rex/ftp/paises.txt

http://www.bcb.gov.br/




5.2. Códigos Tributários

O sistema de geração e emissão de NFPS-e de Florianópolis utiliza códigos

tributários de acordo com a legislação tributária municipal. Os códigos utilizados

pelo sistema são: Código Nacional de Atividade Econômica – CNAE, Código

Fiscal de Prestação de Serviços – CFPS e Código de Situação Tributária – CST.

A prefeitura disponibiliza serviços para obtenção e atualização de tabelas

contendo todos estes destes códigos tributários. Os serviços são disponibilizados

através requisições HTML com os parâmetros do tipo GET “doc” e “tipo”. O serviço

de consulta permite obter o conteúdo das tabelas e o serviço de atualização

permite obter um resumo do conteúdo, valor de HASH obtido com a função de

resumo MD5.

Para obtenção acessar os serviços deve se adicionar os parâmetros “doc”

com o nome da tabela (CNAE, CFPS ou CST) e o parâmetro “tipo” com o valor “1”

para obter o conteúdo ou “0” para obter o resumo do conteúdo na URL a baixo.

http://adm2.pmf.sc.gov.br/sefinnet/lista_csv/lista_csv.dados.php

Exemplos:

1. Download da Tabela de CNAE:

Adicionar “?doc=cnae&tipo=1” na URL dos serviços.

http://adm2.pmf.sc.gov.br/sefinnet/lista_csv/lista_csv.dados.php?doc=cnae&tipo=1

2. Resumo MD5 da Tabela da CNAE:

Adicionar “?doc=cnae&tipo=0” na URL dos serviços.


Para acesso às outras tabelas é necessário informar o nome da tabela no

parâmetro “doc” da mesma forma como no exemplo acima.









É importante que o resumo seja verificado após o download de uma tabela,

para tanto é necessário aplicar a função de resumo MD5 ao conteúdo recebido e

compará-lo com o valor do resumo obtido do serviço. Após a verificação o resumo

deve ser armazenado juntamente com a tabela para facilitar a identificação de

alterações na tabela.

As tabelas são arquivos de texto no formato CSV. O separador dos arquivos é

o caractere “|” (pipe). As figuras a seguir apresentam as tabelas.

Figura 2. Trecho da Tabela de CNAE.

Figura 3. Tabela de CFPS.




Figura 4. Tabela de CST.

5.3. Filtros de Validação Tributária

O sistema faz uso de alguns filtros de validação tributária para restrição de

códigos tributários e valores impróprios em determinadas situações. O Cliente

NFPS-e utiliza estes filtros em dois momentos: na criação e na importação de

requisições. São utilizados os filtros de CFPS por localidade do tomador, CST por

CFPS e alíquota por CFPS x CST.

O filtro de CFPS restringe a utilização de CFPS pela localidade do tomador da

seguinte forma:

Localidade do Tomador:

1. Do Município

CFPS: 9201, 9205 e 9208

2. De Outro Município de SC

CFPS: 9202, 9205 e 9209

3. De Outro Estado Brasileiro

CFPS: 9203, 9206 e 9210

4. Do Exterior

CFPS: 9204, 9207 e 9211




Logo, quando os tomadores de serviço forem de Florianópolis somente serão

aceitos os códigos 9201, 9205 e 9208 para o CFPS, quando forem de outro

município catarinense 9202, 9205 e 9209, e assim por diante.

Os filtros de CST por CFPS e de alíquota por CFPS x CST estão definidos na

grade de validação tributária. Esta grade é um arquivo CSV separado pelo

caractere “|” assim como as tabelas de códigos tributários apresentadas na seção

anterior.

A URL para obtenção da grade de validação é a mesma utilizada para

obtenção das tabelas de códigos tributários CNAE, CFPS e CST. Neste caso deve

se usar o parâmetro “doc” com o valor “grade”.


Exemplos:

1. Download da Grade de Validação Tributária:

Adicionar “?doc=grade&tipo=1” na URL dos serviços.

http://adm2.pmf.sc.gov.br/sefinnet/lista_csv/lista_csv.dados.php?doc=grade&ti

po=1

2. Resumo MD5 da Grade de Validação Tributária:

Adicionar “?doc=grade&tipo=0” na URL dos serviços.

http://adm2.pmf.sc.gov.br/sefinnet/lista_csv/lista_csv.dados.php?doc=grade&ti

po=0




http://adm2.pmf.sc.gov.br/sefinnet/lista_csv/lista_csv.dados.php?doc=grade&tipo=1







Figura 5. Trecho da Grade de Validação Tributária (CFPS x CST).

O Filtro de CST restringe a utilização de CST pelo CFPS informado. Uma

NFPS-e deve ter apenas um CFPS e vários itens de serviço cada um com seu

CST.

Para identificar quais CST(s) podem ser utilizados para um CFPS deve se

mapear todos os valores “1” da coluna EXIBE_CST para o CFPS em questão. Ex.:

Para o CFPS 9201 apenas os CST(s) 0, 2, 8 e 9 podem ser informados, conforme

Figura 5.




O Filtro de alíquota por CFPS x CST restringe a definição da alíquota e da

base de cálculo utilizada da seguinte forma:

Valor da coluna CD_NFE, dados um CFPS e um CST:

1. Alíquota fixa (tabela de CNAE) computada na base de cálculo;

2. Alíquota variável, mín. 2% e máx. 5%, computada na base de

cálculo;

3. Não tem alíquota (0%), não entra em base de cálculo;

4. Alíquota fixa (tabela CNAE) computada na base de cálculo de

substituição;

Exemplos:

1. CFPS = 9201 e CST = 0, então CD_NFE = 0.

Logo o valor da alíquota para o item de serviço em questão deve ser obtido

da tabela de CNAE e ser computada na base de cálculo ISSQN;


Logo o valor da alíquota para o item de serviço em questão deve estar

entre 2 e 5 por cento e ser computada na base de cálculo ISSQN;


Logo não há alíquota para o item de serviço em questão;


Logo o valor da alíquota para o item de serviço em questão deve ser obtido

da tabela de CNAE e ser somado à base de cálculo ISSQN substituição;




5.4. Criação de Requisições de NFPS-e

As requisições para emissão de NFPS-e seguem o layout especificado no tipo

complexo tcInfRequisicao. Apenas os campos obrigatórios, ocorrência 1-1, são

necessários (Versao, TipoSistema, AEDF, DataEmissao, CFPS, DadosServico e

Tomador). Com exceção dos campos opcionais UF e País presentes no

TcEndereco do TcDadosTomador.

Se o Tomador for domiciliado em outro país, o campo tsPais deve ser

informado com o respectivo código do país de acordo com a tabela do BACEN, o

campo tsUF não deve ser informado e o campo TcMunicipio deve ser preenchido

com tsMunicipio (NomeMunicipio). Em todos os casos onde o Tomador for

domiciliado no Brasil, o TcMunicipio deve ser preenchido com tsMunicipioIBGE

informando o respectivo código do município conforme a tabela do IBGE, o campo

tsUF deve ser informado com a sigla do estado e o campo tsPais não deve ser

informado. Estas restrições visam a otimização do espaço em disco necessário

para armazenamento das notas fiscais emitidas..

O campo Identificacao deve ser utilizado para controle das requisições no

sistema, se for informado em uma requisição importada a NFPS-e correspondente

terá este campo com o mesmo valor informado na requisição.

As requisições de NFPS-e são assinadas digitalmente ou autenticadas de

acordo com a configuração do Cliente NFPS-e. A assinatura das requisições

segue o padrão ICP-Brasil de assinaturas digitais com referências básicas (ADRB)

se estiver configurado para assinar digitalmente, caso contrário, as requisições

serão autenticadas utilizando a senha do responsável pelo prestador.

O exemplo seguir é um XML de uma requisição para emissão de NFPS-e.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<InfRequisicao xmlns="http://nfe.pmf.sc.gov.br/nfse/versao?tipo=xsd"

xmlns:ns2="http://www.w3.org/2000/09/xmldsig#">




<Versao>1.0</Versao>

<TipoSistema>0</TipoSistema>

<Identificacao>M9D2N0</Identificacao>

<AEDF>

<AEDF>000000</AEDF>

<TipoAedf>NORMAL</TipoAedf>

</AEDF>

<DataEmissao>2011-09-02Z</DataEmissao>

<CFPS>9202</CFPS>

<DadosServico>

<ItemServico>

<IdCNAE>8900</IdCNAE>

<CodigoAtividade>1610202</CodigoAtividade>

<DescricaoServico>Extração de Pau Brasil</DescricaoServico>

<CST>0</CST>

<Aliquota>0.05</Aliquota>

<ValorUnitario>10.0</ValorUnitario>

<Quantidade>999</Quantidade>

<ValorTotal>9990.0</ValorTotal>

</ItemServico>

<BaseCalculo>9990.0</BaseCalculo>

<ValorISSQN>499.5</ValorISSQN>

<ValorTotalServicos>9990.0</ValorTotalServicos>

</DadosServico>

<Tomador>

<IdentificacaoTomador>

<DocIdTomador>

<CPFCNPJ>

<CNPJ>83930545000124</CNPJ>

</CPFCNPJ>

</DocIdTomador>

<InscricaoMunicipal>0000001</InscricaoMunicipal>

</IdentificacaoTomador>

<RazaoSocial>TRIBO CARIJOS</RazaoSocial>

<Endereco>

<Logradouro>MORRO DOS CAVALOS</Logradouro>

<NumeroEndereco>123</NumeroEndereco>

<Bairro>CENTRO</Bairro>

<Municipio>

<CodigoMunicipio>4211900</CodigoMunicipio>

</Municipio>

<CodigoPostal>

<CEP>88020001</CEP>

</CodigoPostal>




<UF>SC</UF>

</Endereco>

<Contato>

<Email>[email protected]</Email>

<Telefone>4812345678</Telefone>

</Contato>

</Tomador>

</InfRequisicao>

5.5. Leitura de NFPS-e

As notas fiscais de prestação de serviços eletrônicas emitidas pela prefeitura

seguem o layout especificado no tipo complexo tcNFPSe.

Todas as notas são assinadas com certificado digital da prefeitura sob a

política ICP-Brasil de assinatura digital com referência do tempo (ADRT).

O exemplo apresentado seguir é um XML de uma nota fiscal de prestação de

serviços eletrônica correspondente a requisição do exemplo anterior.

<?xml version="1.0" encoding="UTF-8"?>

<NFPSe xmlns:ns2="http://nfe.pmf.sc.gov.br/nfse/versao?tipo=xsd"

xmlns="http://www.w3.org/2000/09/xmldsig#">

<InfNFPSe Id="00000000000009">

<Versao>1.0</Versao>

<TipoSistema>0</TipoSistema>

<Identificacao>M9D2N0</Identificacao>

<AEDF>

<AEDF>000000</AEDF>

<TipoAedf>NORMAL</TipoAedf>

</AEDF>

<CodigoVerificacao>D694EF08778EDF5C</CodigoVerificacao>

<NumeroSerie>9</NumeroSerie>

<DataEmissao>2011-09-02Z</DataEmissao>

<CFPS>9202</CFPS>

<StatusNFPSe>0</StatusNFPSe>

<DadosServico>

<ItemServico>




<IdCNAE>8900</IdCNAE>

<CodigoAtividade>1610202</CodigoAtividade>

<DescricaoServico>Extração de Pau Brasil</DescricaoServico>

<CST>0</CST>

<Aliquota>0.05</Aliquota>

<ValorUnitario>10.0</ValorUnitario>

<Quantidade>999</Quantidade>

<ValorTotal>9990.0</ValorTotal>

</ItemServico>

<BaseCalculo>9990.0</BaseCalculo>

<ValorISSQN>499.5</ValorISSQN>

<ValorTotalServicos>9990.0</ValorTotalServicos>

<DadosAdicionais/>

</DadosServico>

<Prestador>

<IdentificacaoPrestador>

<CNPJ>04802335518571</CNPJ>

<InscricaoMunicipal>0000000</InscricaoMunicipal>

</IdentificacaoPrestador>

<RazaoSocial>COROA PORTUGUESA</RazaoSocial>

<Endereco>

<Logradouro>ENDERECO XXX</Logradouro>

<Bairro>BAIRRO0</Bairro>

<Municipio>


</Municipio>

<CodigoPostal>

<CEP>88088000</CEP>

</CodigoPostal>

<UF>SC</UF>

</Endereco>

<Contato>



</Contato>

</Prestador>

<Tomador>

<IdentificacaoTomador>

<DocIdTomador>

<CPFCNPJ>

<CNPJ>83930545000124</CNPJ>

</CPFCNPJ>

</DocIdTomador>

</IdentificacaoTomador>




<RazaoSocial>TRIBO CARIJOS</RazaoSocial>

<Endereco>

<Logradouro>MORRO DOS CAVALOS</Logradouro>

<NumeroEndereco>123</NumeroEndereco>

<Bairro>CENTRO</Bairro>

<Municipio>


</Municipio>

<CodigoPostal>

<CEP>88020001</CEP>

</CodigoPostal>

<UF>SC</UF>

</Endereco>

<Contato>



</Contato>

</Tomador>

</InfNFPSe>

<Signature>...</Signature>

</NFPSe>

mmaannuuaall ddee iinntteeggrraaççããoo … · smr – para documentar prestações de...

Documents