Professional Documents
Culture Documents
ELETRNICA (NFS-e)
Manual de Integrao
Verso 1.3
SUMRIO
1 INTRODUO
2 CONSIDERAES INICIAIS
MODELO CONCEITUAL
Recepo e Processamento de Lote de RPS
Consulta de Situao de Lote de RPS
Consulta de NFS-e por RPS
Consulta de Lote de RPS
Consulta de NFS-e
Cancelamento de NFS-e
PADRES TCNICOS
Padro de Comunicao
Padro de Certificado Digital
Padro de Assinatura Digital
Validao de Assinatura Digital pelo Sistema NFS-e
Uso de Assinatura com Certificado Digital
PADRO DAS MENSAGENS XML
rea do Cabealho
Validao da estrutura das Mensagens XML
Schemas XML (arquivos XSD)
Verso dos Schemas XML
MODELO OPERACIONAL
Servios Sncronos
Servios Assncronos
FORMATOS E PADRES UTILIZADOS
TIPOS SIMPLES
TIPOS COMPLEXOS
SERVIOS
Recepo de Lote de RPS
Consulta de Situao de Lote de RPS
Consulta de NFS-e por RPS
Consulta de NFS-e
Consulta de Lote de RPS
Cancelamento NFS-e
5
5
6
6
6
6
7
8
8
9
10
10
11
11
13
13
14
14
14
15
15
16
16
16
17
18
19
21
26
27
27
28
28
29
29
2
5 ANEXOS
5.1 TABELA DE ERROS
5.2 REGRAS ESPECFICAS DE CURITIBA
30
30
35
1 INTRODUO
Este manual tem como objetivo apresentar as especificaes e critrios tcnicos
necessrios para utilizao do Web Service disponibilizado pela Prefeitura Municipal de
Curitiba, conforme modelo ABRASF - Associao Brasileira de Secretrios e Dirigentes
das Finanas dos Municpios das Capitais, para as empresas prestadoras e/ou
tomadoras de servios.
Atravs do Web Service as empresas podero integrar seus prprios sistemas de
informaes com o Sistema da Prefeitura. Desta forma, consegue-se automatizar o
processo de gerao, consulta e cancelamento de NFS-e.
2 CONSIDERAES INICIAIS
uma
mensagem
com
resultado
o resultado do processamento
3.2
PADRES TCNICOS
10
11
Deve-se evitar o uso das TAGs abaixo, pois as informaes sero obtidas a partir do
Certificado do emitente:
<KeyValue>
<RSAKeyValue>
<Modulus>
<Exponent>
#
XS01
XS02
XS03
XS04
XS05
Campo
Signature
Id
SignedInfo
CanonicalizationMethod
Algorithm
Elemento
Raiz
A
G
G
A
Pai
Tipo
Ocorrnci
a
1-1
1-1
1-1
1-1
XS01
XS01
XS03
XS04
XS06
XS07
SignatureMethod
Algorithm
G
A
XS03
XS06
XS08
XS09
XS10
XS11
Reference
URI
Transforms
Unique_Transf_Alg
G
A
G
RC
XS03
XS08
XS08
XS10
1-1
1-1
XS12
XS13
Transform
Algorithm
G
A
XS10
XS12
1-1
1-1
1-1
1-1
2-2
1-1
Descrio
http://www.w3.org/2000/09/xmldsig#rsa-sha1
Grupo do Mtodo de Reference
Atributo URI da tag Reference
Grupo do algorithm de Transform
Regra para o atributo Algorithm do Transform ser
nico
Grupo de Transform
Atributos vlidos Algorithm do Transform:
http://www.w3.org/TR/2001/REC-xml-c14n-
XS14
XS15
XS16
Xpath
DigestMethod
Algorithm
E
G
A
XS12
XS08
XS15
XS17
XS18
XS19
DigestValue
SignatureValue
KeyInfo
E
G
G
XS08
XS01
XS01
0-N
1-1
1-1
20010315
http://www.w3.org/2000/09/xmldsig#envelopedXpath
Grupo do Mtodo de DigestMethod
Atributo Algorithm de DigestMethod:
1
1-1
1-1
12
XS20
XS21
X509Data
X509Certificate
G
E
XS19
XS20
1-1
1-1
Grupo X509
Certificado Digital x509 em Base64b
3.3
Nome
cabecalho
Elemento
G
Pai Tipo
Ocorrncia
1-1
Tamanho
Descrio
TAG raiz do cabealho da
Verso
versaoDados
A
E
1
1
1-1
1-1
4
4
Verso do leiaute.
O contedo deste campo indica a
N
N
15
Implementao
Assncrona
Sncrona
Sncrona
Sncrona
Consulta de NFS-e
Sncrona
Cancelamento de NFS-e
Sncrona
16
17
4.2
do
Abaixo segue algumas formataes de dados que devem ser seguidas para gerao
correta na estrutura dos arquivos.
Formato
Observao
Data (date)
Formato: AAAA-MM-DD
onde:
Data/Hora (datetime)
Valores Decimais
Formato: 0.00
(decimal)
No deve ser utilizado separador de milhar. O ponto (.) deve ser utilizado para separar a
parte inteira da fracionria.
Exemplo:
Valores Percentuais
48.562,250.0000
= 48562.25
Formato
(decimal)
18
TAG documentation);
C: Caractere;
N: Nmero;
D: Data ou Data/Hora;
tamanho
pode
ser
representado
das
Campo
Tipo
Descrio
TsNumeroNfse
Tam.
tsCodigoVerificacao
TsStatusRps
1 Normal
2 Cancelado
TsStatusNfse
1 Normal
2 Cancelado
tsNaturezaOperacao
suspensa
por
procedimento
20
tsRegimeEspecialTributacao
TsSimNao
Identificao de Sim/No
1 - Sim
2 No
TsQuantidadeRps
TsNumeroRps
TsSerieRps
TsTipoRps
N
N
C
N
4
15
5
1
1 - RPS
2 Nota Fiscal Conjugada (Mista) No utilizado em
Curitiba
3 Cupom No utilizado em Curitiba
tsOutrasInformacoes
TsValor
C
N
255
15,2
C
N
C
N
1.000,00de= item
1000.00
Cdigo
da lista de servio
Cdigo CNAE
Cdigo de Tributao
Alquota. Valor percentual. Formato: 0.0000
5
7
20
5,4
Ex: 1% = 0.01
25,5% = 0.255
100% = 1.0000 ou 1
tsDiscriminacao
tsCodigoMunicipioIbge
C
N
tsIncricaoMunicipal
tsRazaoSocial
tsNomeFantasia
TsCnpj
tsEndereco
tsNumeroEndereco
tsComplementoEndereco
tsBairro
tsUf
tsCep
tsEmail
tsTelefone
TsCpf
C
C
C
C
C
C
C
C
C
N
C
C
C
21
tsIndicacaoCpfCnpj
1 CPF
2 CNPJ
3 No Informado
tsCodigoObra
tsArt
tsNumeroLote
TsNumeroProtocolo
tsSituacaoLoteRps
C
C
N
C
N
Cdigo de Obra
Cdigo ART
Nmero do Lote de RPS
Nmero do protocolo de recebimento do RPS
Cdigo de situao de lote de RPS
15
15
15
50
1
1 No Recebido
2 No Processado
3 Processado com Erro
4 Processado com Sucesso
tsCodigoMensagemAlerta
TsDescricaoMensagemAlerta
TsCodigoCancelamentoNfse
C
C
C
4
200
4
tsIdTag
Erros e alertas.
Atributo
de identificao da tag a ser assinada no 255
documento XML
(1)
(2)
Nome
(3)
(4)
(4)
Tipo
(5)
(5)
Ocorrncia
(6)
(6)
Descrio
(7)
(7)
Tipo
tsCpf
tsCnpj
Ocorrncia
1-1
1-1
Descrio
Nmero do Cpf
Nmero do Cnpj
TcEndereco
Representao completa do endereo
Nome
Endereco
Numero
Complemento
Bairro
CodigoMunicipio
Uf
Cep
Tipo
tsEndereco
tsNumeroEndereco
tsComplementoEndereco
tsBairro
tsCodigoMunicipioIbge
tsUf
tsCep
Ocorrncia
0-1
0-1
0-1
0-1
0-1
0-1
0-1
Descrio
Endereo
Nmero do endereo
Complemento do Endereo
Nome do bairro
Cdigo da cidade
Sigla do estado
CEP da localidade
TcContato
Representa forma de contato com a pessoa (fsica/jurdica)
Nome
Tipo
Telefone
tsTelefone
Email
tsEmail
Ocorrncia
0-1
0-1
Descrio
tcIdentificacaoOrgaoGerador
Representa dados para identificao de rgo gerador
Nome
Tipo
CodigoMunicipio
tsCodigoMunicipioIbge
Uf
tsUf
Ocorrncia
1-1
1-1
Descrio
tcIdentificacaoRps
Dados de identificao do RPS
Nome
Numero
Serie
Tipo
Tipo
tsNumeroRps
tsSerieRps
tsTipoRps
Ocorrncia
1-1
1-1
1-1
Descrio
tcIdentificacaoPrestador
Representa dados para identificao do prestador de servio
Nome
Tipo
Cnpj
tsCnpj
InscricaoMunicipal
tsInscricaoMunicipal
Ocorrncia
1-1
0-1
Descrio
Ocorrncia
0-1
0-1
Descrio
tcIdentificacaoTomador
Representa dados para identificao do tomador de servio
Nome
Tipo
CpfCnpj
tcCpfCnpj
InscricaoMunicipal
tsInscricaoMunicipal
tcDadosTomador
Representa dados do tomador de servio
Nome
Tipo
IdentificacaoTomador
TcIdentificacaoTomador
Ocorrncia
0-1
RazaoSocial
Endereco
Contato
0-1
0-1
0-1
TsRazaoSocial
TcEndereco
TcContato
Descrio
TcIdentificacaoIntermediarioServico
Representa dados para identificao de intermedirio do servio
Nome
Tipo
Ocorrncia
Descrio
23
RazaoSocial
CpfCnpj
InscricaoMunicipal
tsRazaoSocial
tcCpfCnpj
tsInscricaoMunicipal
1-1
1-1
0-1
TcValores
Representa um conjunto de valores que compe o documento fiscal
Nome
Tipo
Ocorrncia
ValorServicos
tsValor
1-1
ValorDeducoes
tsValor
0-1
ValorPis
tsValor
0-1
ValorCofins
tsValor
0-1
ValorInss
tsValor
0-1
ValorIr
tsValor
0-1
ValorCsll
tsValor
0-1
IssRetido
tsSimNao
1-1
ValorIss
tsValor
0-1
OutrasRetencoes
tsValor
0-1
BaseCalculo
tsValor
1-1
Aliquota
ValorLiquidoNfse
tsAliquota
tsValor
0-1
0-1
ValorIssRetido
DescontoCondicionado
DescontoIncondicionado
tsValor
tsValor
tsValor
0-1
0-1
0-1
Descrio
(ValorServicos
ValorPIS
ValorCOFINS - ValorINSS - ValorIR
ValorCSLL - OutrasRetenoes
ValorISSRetido
DescontoIncondicionado
DescontoCondicionado)
TcDadosServico
Representa dados que compe o servio prestado
Nome
Tipo
Valores
tcValores
ItemListaServico
tsItemListaServico
CodigoCnae
tsCodigoCnae
CodigoTributacaoMunicipio
tsCodigoTributacao
Discriminacao
tsDiscriminacao
CodigoMunicipio
tsCodigoMunicipioIbge
Ocorrncia
1-1
1-1
0-1
0-1
1-1
1-1
Descrio
tcDadosConstrucaoCivil
Representa dados para identificao de construo civil
Nome
Tipo
CodigoObra
tsCodigoObra
Art
tsArt
Ocorrncia
1-1
1-1
Descrio
tcDadosPrestador
Representa dados do prestador do servio
Nome
Tipo
IdentificacaoPrestador
tcIdentificacaoPrestador
RazaoSocial
tsRazaoSocial
NomeFantasia
tsNomeFantasia
Endereco
tcEndereco
Contato
tcContato
Ocorrncia
1-1
1-1
0-1
1-1
0-1
Descrio
TcInfRps
Representa dados informativos do Recibo Provisrio de Servio (RPS)
Nome
Tipo
Ocorrncia
Id
IdentificacaoRps
DataEmissao
1-1
1-1
tsIdTag
TcIdentificacaoRps
Datetime
Descrio
Identificador da TAG
24
NaturezaOperacao
RegimeEspecialTributacao
OptanteSimplesNacional
IncentivadorCultural
Status
RpsSubstituido
Servico
Prestador
Tomador
IntermediarioServico
ConstrucaoCivil
TsNaturezaOperacao
TsRegimeEspecialTributacao
TsSimNao
TsSimNao
TsStatusRps
TcIdentificacaoRps
TcDadosServico
TcIdentificacaoPrestador
TcDadosTomador
tcIdentificacaoIntermediarioServico
TcDadosContrucaoCivil
1-1
0-1
1-1
1-1
1-1
0-1
1-1
1-1
1-1
0-1
0-1
TcRps
Representa a estrutura do Recibo Provisrio de Servio (RPS) assinada
Nome
Tipo
Ocorrncia
InfRps
tcInfRps
1-1
Signature
dsig:Signature
0-1
Descrio
tcIdentificacaoNfse
Representa dados que identificam uma Nota Fiscal de Servios Eletrnica
Nome
Tipo
Ocorrncia
Numero
tsNumeroNfse
1-1
Cnpj
tsCnpj
1-1
InscricaoMunicipal
tsInscricaoMunicipal
0-1
CodigoMunicipio
tsCodigoMunicipioIbge
Descrio
TcInfNfse
Representa os dados informativos da Nota Fiscal de Servios Eletrnica
Nome
Tipo
Id
tsIdTag
Ocorrncia
Descrio
Identificador da TAG
Numero
CodigoVerificacao
DataEmissao
IdentificacaoRps
DataEmissaoRps
NaturezaOperacao
RegimeEspecialTributacao
OptanteSimplesNacional
IncetivadorCultural
Competencia
NfseSubstituida
OutrasInformacoes
Servico
ValorCredito
PrestadorServico
TomadorServico
IntermediarioServico
OrgaoGerador
ConstrucaoCivil
1-1
1-1
1-1
0-1
0-1
1-1
0-1
1-1
1-1
1-1
0-1
0-1
1-1
0-1
1-1
1-1
0-1
1-1
0-1
a ser assinada
Ocorrncia
1-1
1-2
Descrio
tsNumeroNfse
tsCodigoVerificacao
Datetime
tcIdentificacaoRps
Date
tsNaturezaOperacao
tsRegimeEspecialTributacao
TsSimNao
TsSimNao
Date
tsNumeroNfse
tsOutrasInformacoes
tcDadosServico
TsValor
tcDadosPrestador
tcDadosTomador
tcIdentificacaoIntermediarioServico
tcIdentificacaoOrgaoGerador
tcDadosContrucaoCivil
TcNfse
Representa a estrutura da Nota Fiscal de Servios Eletrnica assinada
Nome
Tipo
InfNfse
tcInfNfse
Signature
Dsig:Signature
tcInfPedidoCancelamento
Representa a estrutura de dados do pedido de cancelamento enviado pelo prestador ao cancelar uma
Nota Fiscal de Servios Eletrnica. Tipo
Nome
Id
tsIdTag
Ocorrncia
Observao
Identificador da TAG a ser
assinada
25
IdentificacaoNfse
CodigoCancelamento
tcIdentificacaoNfse
tsCodigoCancelamentoNfse
1-1
1-1
TcPedidoCancelamento
Representa a estrutura de Pedido de Cancelamento da Nota Fiscal de Servios Eletrnica assinada
Nome
Tipo
Ocorrncia
Descrio
InfPedidoCancelamento
tcInfPedidoCancelamento
1-1
Signature
Dsig:Signature
0-1
tcInfConfirmacaoCancelamento
Representa a estrutura de dados da confirmao de cancelamento Nota Fiscal de Servios Eletrnica feito pelo Fisco
Municipal.
Nome
Tipo
Ocorrncia
Observao
Sucesso
boolean
1-1
DataHora
datetime
1-1
TcConfirmacaoCancelamento
Representa a estrutura de Confirmao de Cancelamento da Nota Fiscal de Servios Eletrnica assinada
Nome
Tipo
Ocorrncia
Descrio
Id
tsIdTag
Identificador da TAG
Pedido
InfConfirmacaoCancelamento
TcPedidoCancelamento
tcInfConfirmacaoCancelamento
1-1
1-1
TcCancelamentoNfse
Representa a estrutura completa (pedido + confirmao) de cancelamento de NFS-e.
Nome
Tipo
Ocorrncia
Confirmacao
TcConfirmacaoCancelamento
1-1
Signature
Dsig:Signature
1-1
Descrio
TcInfSubstituicaoNfse
Representa os dados de registro de substituio de NFS-e.
Nome
Tipo
Id
tsIdTag
Ocorrncia
NfseSubstituidora
1-1
tsNumeroNfse
Descrio
Identificador
assinada
da
TAG
ser
TcSubstituicaoNfse
Representa a estrutura de substituio de NFS-e.
Nome
Tipo
SubstituicaoNfse
tcInfSubstituicaoNfse
Signature
dsig:Signature
Ocorrncia
1-1
1-2
Descrio
TcCompNfse
Representa a estrutura de compartilhamento de dados de uma NFS-e.
Nome
Tipo
Ocorrncia
Nfse
tcNfse
1-1
NfseCancelamento
tcCancelamentoNfse
0-1
NfseSubstituicao
tcSubstituicaoNfse
0-1
Descrio
tcMensagemRetorno
Representa a estrutura de mensagem de retorno de servio.
Nome
Tipo
Codigo
TsCodigoMensagemAlerta
Mensagem
tsDescricaoMensagemAlerta
Correcao
tsDescricaoMensagemAlerta
Ocorrncia
1-1
1-1
0-1
Descrio
ListaMensagemRetorno
Representa a estrutura de mensagem de retorno de servio.
26
Nome
MensagemRetorno
Tipo
tcMensagemRetorno
Ocorrncia
1-N
Descrio
Ocorrncia
1-1
1-1
1-1
Descrio
Observao
Identificador
assinada
tcMensagemRetornoLote
Representa a estrutura de mensagem de retorno de servio.
Nome
Tipo
IdentificacaoRps
TcIdentificacaoRps
Codigo
TsCodigoMensagemAlerta
Mensagem
tsDescricaoMensagemAlerta
tcLoteRps
Nome
Id
Tipo
tsIdTag
Ocorrncia
NumeroLote
Cnpj
InscricaoMunicipal
QuantidadeRps
ListaRps
Rps
TsNumeroLote
TsCnpj
TsInscricaoMunicipal
TsQuantidadeRps
1-1
1-1
1-1
1-1
1-1
1-N
TcRps
da
TAG
ser
4.5 Servios
A seguir esto os servios disponveis, conforme descritos no item 3.1, no WebService
e seus XML Schema. O XML Schema define a estrutura e formatao do arquivo XML
que conter os dados a serem trafegados. Esses documentos sero enviados de forma
textual (como uma string) como parmetros do servio oferecido pelo Web Service,
como descrito em 3.2.1.
As tabelas que detalham cada XML Schema esto divididas da seguinte forma:
(1)
#
(2)
Nome
(3)
Tipo
(4)
Pai
(5)
Ocorrncia
(6)
(8)
Observao
(7)
(9)
servico_enviar_lote_rps_envio.xsd
#
1
Nome
EnviarLoteRpsEnvio
LoteRps
Signature
Tipo
Pai
TcLoteRps
dsig:Signature
1
1
Ocorrncia
1-1
1-1
0-1
Observao
servico_enviar_lote_rps_resposta.xsd
#
1
Nome
EnviarLoteRpsResposta
NumeroLote
DataRecebimento
Protocolo
ListaMensagemRetorno
Tipo
Pai
tsNumeroLote
Datetime
tsNumeroProtocolo
ListaMensagemRetorno
1
1
1
1
Ocorrncia
1-1
Observao
1-1
1-1
Choice
servico_consultar_situacao_lote_rps_envio.xsd
#
1
Nome
ConsultarSituacaoLoteRpsEn vio
Tipo
Pai
Ocorrncia
1-1
Prestador
Protocolo
TcIdentificacaoPrestador
TsNumeroProtocolo
1
1
1-1
1-1
Observao
28
#
1
Nome
ConsultarSituacaoLoteRpsRe
sposta
NumeroLote
Situao
ListaMensagemRetorno
Tipo
Pai
Ocorrncia
1-1
Observao
tsNumeroLote
tsSituacaoLoteRps
ListaMensagemRetorno
1
1
1
1-1
Choice
1-1
Nome
ConsultarNfseRpsEnvio
IdentificacaoRps
Prestador
Tipo
Pai
Ocorrncia
tcIdentificacaoRps
tcIdentificacaoPrestador
1
1
1-1
1-1
Observao
Nome
ConsultarNfseRpsResposta
CompNfse
ListaMensagemRetorno
Tipo
Pai
Ocorrncia
Observao
tcCompNfse
ListaMensagemRetorno
1
1
1-1
1-1
Choice
Nome
ConsultarNfseEnvio
Prestador
NumeroNfse
PeriodoEmissao
DataInicial
DataFinal
Tomador
IntermediarioServico
Tipo
Pai
tcIdentificacaoPrestador
tsNumeroNfse
1
1
1
2
2
1
1
date
date
tcIdentificacaoTomador
TcIdentificacaoIntermediar
ioServico
Ocorrncia
1-1
1-1
0-1
0-1
1-1
1-1
0-1
0-1
Observao
Nome
ConsultarNfseResposta
ListaNfse
CompNfse
ListaMensagemRetorno
Tipo
Pai
tcCompNfse
ListaMensagemRetorno
1
2
1
Ocorrncia
1-1
1-1
Observao
Choice
1-1
Esse servio
ser executado atravs
da
chamada
ao
mtodo
ConsultarLoteRps, passando a mensagem XML como parmetro com a estrutura
definida na tabela que segue.
servico_consultar_lote_rps_envio.xsd
#
1
Nome
ConsultarLoteRpsEnvio
Prestador
Protocolo
Tipo
Pai
TcIdentificacaoPrestador
TsNumeroProtocolo
1
1
Ocorrncia
1-1
1-1
1-1
Observao
Nome
ConsultarLoteRpsResposta
ListaNfse
CompNfse
ListaMensagemRetorno
Tipo
Pai
tcCompNfse
ListaMensagemRetorno
1
2
1
Ocorrncia
1-1
1-1
1-N
1-1
Observao
Choice
Nome
CancelarNfseEnvio
Pedido
Tipo
Pai
TcPedidoCancelamento
Ocorrncia
1-1
1-1
Observao
Nome
CancelarNfseResposta
Cancelamento
ListaMensagemRetorno
Tipo
Pai
Ocorrncia
Observao
TcCancelamentoNfse
ListaMensagemRetorno
1
1
1-1
1-1
Choice
5 ANEXO
5.1 TABELA DE ERROS
As mensagens de erro definidas pela ABRASF pdem ser encontradas na Planilha
de Mensagens de Erro, Alerta e Regras Curitiba aba (Erros), disponibilizada no
endereo: https://isscuritiba.curitiba.pr.gov.br/portalnfse/manuais.aspx.
5.2 TABELA DE ERROS ESPECFICOS DE CURITIBA
As mensagens de erro especficas para o municpio de Curitiba podem ser
encontradas na Planilha de Mensagens de Erro, Alerta e Regras Curitiba aba (Erros
30
31