Você está na página 1de 11

Sistema Integrado de

Gerenciamento do ISS


SIG-ISS
Manual de integrao do
WebService para NFS-e









So Paulo, 7 de Novembro de 2013.




1. Introduo
Este manual tem como objetivo apresentar as especificaes e critrios tcnicos
necessrios para utilizao do WebService do SIGISS.
Utilizando o WebService as empresas podero integrar seus prprios sistemas de
informaes com o SIGISS. Desta forma, consegue-se automatizar o processo de
gerao, consulta e cancelamento de NFS-e.


2. Especificao
Os contribuintes do ISSQN que optarem, junto ao municpio, pela emisso de notas
fiscais eletrnicas podem utilizar o WebService do SIGISS para importar essa
informao para os seus sistemas.
A informao que ser importada ser sobre cada nota fiscal emitida juntamente
com as informaes mais importantes que compem a mesma. A nota fiscal
eletrnica tem como objetivo facilitar todo o processo de escriturao e emisso de
notas fiscais automatizando todo o processo.
A qualquer momento o contribuinte pode usar o WebService SIGISS para receber as
informaes das notas fiscais emitidas.


3. Conexo com o WebService
Para verificar os mtodos disponveis basta acessar a pgina:
https://bauru.sigiss.com.br/bauru/ws/sigiss_ws.php.
Para carregar as informaes dos mtodos basta criar um client do WebService do
SIGISS acessando https://bauru.sigiss.com.br/bauru/ws/sigiss_ws.php?wsdl.


4. Ambiente de Homologao
Antes da utilizao do WebService necessrio solicitar dados de acesso para o
ambiente de homologao, via processo SIGIPM, com o assunto . No prprio
processo esto as orientaes para preenchimento dos dados. S assim ser
possvel a correta configurao e envio de XML para essa integrao e aps a
homologao pela Prefeitura Municipal de Bauru


5. Arquivo XML
(Antigo item 4)
Assim que a nota escriturada utilizando o WebService, gerado um email para o
tomador com o arquivo XML da nota anexado a ele. Caso o contribuinte deseje
baixar este arquivo, basta acessar a rea de contribuinte do site
https://bauru.sigiss.com.br, acessar a aba de Movimento, na rea de servios
prestados acessar o boto de Ferramentas NF-e e escolher a opo de Exportar
notas emitidas em XML, os arquivos XML estaro dentro de um arquivo de
extenso *.zip.
Essa opo no est disponvel para o(s) mdulo(s) disponvel (is) para o municpio
de Bauru.

6. Mtodos do WebService

6.1 GERAO DE NFS-e
A funcionalidade de gerao de NFS-e se responsabiliza por receber os dados
referentes a uma prestao de servios e grav-los na base do SIGISS, gerando
uma Nota Fiscal de Servios Eletrnica. Aps sua gravao, a NFS-e fica disponvel
para consulta e visualizao (No disponvel para o mdulo utilizado pela Prefeitura
Municipal de Bauru). Caso haja alguma inconsistncia nos dados informados
durante o processo, a mensagem do problema retornada ao requisitante.
Durante o preenchimento dos dados que geraro uma NFS-e, o contribuinte poder
fazer o seu vnculo com um RPS emitido, bastando para isso informar o nmero, a
srie e a data do RPS.
O campo id_sis_legado serve para fazer o controle do contribuinte das notas
emitidas, se o contribuinte informar este campo ele nunca poder ser repetido,
evitando que o contribuinte emita duas vezes a mesma nota. Se este campo no for
informado este controle ignorado.
Para o campo tomador_cod_cidade, favor informar o cdigo da cidade de acordo
com a classificao do IBGE. O cdigo da cidade pode ser verificado no seguinte
link abaixo:
http://www.ibge.gov.br/home/geociencias/areaterritorial/area.shtm

Este um processo sncrono.

Chamada do Mtodo: GerarNota

Parmetros de Envio: DadosPrestador(tns:tcDadosPrestador), DescricaoRps (tns:
tcDescricaoRps).

Parmetros de Resposta: RetornoNota(tns: tcRetornoNota), DescricaoErros(tns:
tcDescricaoErros)

6.2 CANCELAMENTO DE NFS-e
A funcionalidade de cancelamento de NFS-e cancela uma Nota Fiscal de Servios
Eletrnica j emitida. Caso a NFS-e no tenha sido gerada (ou j tenha sido
cancelada) uma mensagem informando o fato retornada. Esta funcionalidade
cancela apenas uma NFS-e gerada por vez e no vincula esse cancelamento a
nenhum RPS, assim como a nenhuma nota substituta.

Este um processo sncrono.

Chamada do Mtodo:CancelarNota

Parmetros de Envio: DadosPrestador(tns:tcDadosPrestador), DescricaoCancelaNota (tns:
tcDescricaoCancelaNota)

Parmetros de Resposta: RetornoNota(tns: tcRetornoNota), DescricaoErros(tns:
tcDescricaoErros)




6.3 CONSULTA DE NFS-e VLIDA
A funcionalidade de consulta de NFS-e retorna de uma nota especfica para saber
se a nota vlida mediante a identificao da nota, identificao do prestador e
identificao do tomador.

Este um processo sncrono.

Chamada do Mtodo:ConsultarNotaValida

Parmetros de Envio: DadosPrestador(tns:tcDadosPrestador) , Gruponotas (tns: tcNotas)

Parmetros de Resposta: RetornoNota(tns: tcRetornoNota), DescricaoErros(tns:
tcDescricaoErros)




6.4 CONSULTA DE NFS-e SERVIOS PRESTADOS
A funcionalidade de consulta de NFS-e retorna informaes de uma ou mais NFS-e
conforme os parmetros de pesquisa que podem ser a identificao da prpria nota,
identificao do prestador; identificao do tomador.

Este um processo sncrono.

Chamada do Mtodo: ConsultarNotaPrestador

Parmetros de Envio: DadosPrestador(tns:tcDadosPrestador) , Nota(xsd:int)

Parmetros de Resposta: DadosNfse (tns: tcDadosNfse), DescricaoErros(tns:
tcDescricaoErros)





















7. Estrutura de Dados
7.1 Estruturas de Envio
7.1.1 tns:tcDescricaoRps (Tipo Complexo)

Campo Formato Tipo Descrio Ocorrncia
ccm xsd:int Simples Inscrio Municipal
do prestador de
servio.
Obrigatrio.
cnpj xsd:int Simples CNPJ/CPF do
prestador de
servio.
Obrigatrio.
senha xsd:string Simples Senha do prestador
de servio.
Obrigatrio.
crc xsd:int Simples CRC do contador
do prestador de
servio.
Opcional.
crc_estado xsd:int Simples CRC estado do
contador do
prestador de
servio.
Opcional.
aliquota_simples xsd:string Simples Alquota do simples
nacional.
Obrigatrio se a
empresa prestadora
do tipo simples
nacional.
id_sis_legado xsd:int Simples Cdigo da nota no
sistema legado do
contribuinte.
Opcional.
servico xsd:int Simples Cdigo do servio
utilizado na
emisso da nota
fiscal da lei 116/03.
Obrigatrio.
situacao xsd:string Simples Situao da nota
fiscal eletrnica:
tp Tributada no
prestador;
tt Tributada no
tomador;
is Isenta;
im Imune;
nt No tributada.
Obrigatrio.
valor xsd:string Simples Valor da nota fiscal.
Ex:R$100,50
100,5
No utilize ponto (.)
Obrigatrio.
base xsd:string Simples Valor da base de
calculo.
Ex:R$100,50
100,5
No utilize ponto (.)
Obrigatrio.
descricaoNF xsd:string Simples Descrio do Servio
Prestado.
Opcional.
tomador_tipo xsd:int Simples Tipo do tomador que Obrigatrio.
se quer escriturar:
1 PFNI (Somente
com Autorizao da
Prefeitura);
2 Pessoa Fsica;
3 Jurdica do
Municpio;
4 Jurdica de Fora;
5 Jurdica de Fora
do Pas.
tomador_cnpj xsd:string Simples CPF ou CNPJ do
tomador da nota
fiscal eletrnica.
Obrigatrio. (Para
tomadores de Fora do
Pas deixar em
branco).
tomador_email xsd:string Simples Email do tomador da
nota.
Opcional. Se for
informado, ou j
estiver cadastrado, o
sistema enviar
automaticamente um
email com o link da
nota para este
endereo.
tomador_ie xsd:string Simples Inscrio Estadual do
tomador da nota.
Opcional.
tomador_im xsd:int Simples Inscrio municipal
do tomador da nota.
Opcional. (Obrigatrio
para tomador que
tenha mais de uma
inscrio municipal).
tomador_razao xsd:string Simples Razo Social do
tomador da nota.
Obrigatrio caso o
tomador no esteja
cadastrado.
tomador_fantasia xsd:string Simples Nome Fantasia do
tomador da nota.
Opcional.
tomador_endereco xsd:string Simples Endereo do tomador
da nota.
Obrigatrio caso o
tomador no esteja
cadastrado. (Opcional
para tomadores de
Fora do Pas).
tomador_numero xsd:string Simples Nmero do endereo
do tomador da nota.
Obrigatrio caso o
tomador no esteja
cadastrado. (Opcional
para tomadores de
Fora do Pas).
tomador_complemento xsd:string Simples Complemento do
endereo do tomador
da nota.
Opcional.
tomador_bairro xsd:string Simples Bairro do tomador da
nota.
Obrigatrio caso o
tomador no esteja
cadastrado. (Opcional
para tomadores de
Fora do Pas).
tomador_CEP xsd:string Simples CEP do tomador da
nota.
Obrigatrio caso o
tomador no esteja
cadastrado. (Opcional
para tomadores de
Fora do Pas).
tomador_cod_cidade xsd:string Simples Cdigo da cidade do
tomador da nota.
Obrigatrio caso o
tomador no esteja
cadastrado. (Para
tomadores de Fora do
Pas deixar em
branco).
tomador_fone xsd:string Simples Telefone do tomador
da nota.
Opcional.
tomador_ramal xsd:string Simples Ramal do tomador da
nota.
Opcional.
tomador_fax xsd:string Simples Fax do tomador da
nota.
Opcional.
rps_num xsd:int Simples Nmero do recibo
provisrio de
servios.
Obrigatrio caso o
prestador queira
vincular uma RPS a
nota eletrnica.
rps_serie xsd:string Simples Srie do recibo
provisrio de
servios.
Obrigatrio caso o
prestador queira
vincular uma RPS a
nota eletrnica.
rps_dia xsd:int Simples Dia em que foi
emitido o recibo
provisrio de
servios.
Obrigatrio caso o
prestador queira
vincular uma RPS a
nota eletrnica.
rps_mes xsd:int Simples Ms em que foi
emitido o recibo
provisrio de
servios.
Obrigatrio caso o
prestador queira
vincular uma RPS a
nota eletrnica.
rps_ano xsd:int Simples Ano em que foi
emitido o recibo
provisrio de
servios.
Obrigatrio caso o
prestador queira
vincular uma RPS a
nota eletrnica.
outro_municipio xsd:int Simples Indica se o servio foi
prestado em Bauru
ou fora do municpio.
1 - Fora de Bauru
Opcional
cod_outro_municipio xsd:int Simples Informa o cdigo do
municpio no qual o
servio foi prestado,
segundo a tabela do
IBGE, conforme link
j indicado nesse
manual.
Obrigatrio caso seja
prestado fora de Bauru
retencao_iss xsd:string Simples Informa o valor do
ISS Retido em outro
municpio, caso haja
essa informo
Opcional
pis xsd:string Simples Informa o valor do
PIS
Opcional
cofins xsd:string Simples Informa o valor do
COFINS
Opcional
inss xsd:string Simples Informa o valor do
INSS
Opcional
irrf xsd:string Simples Informa o valor do Opcional
IRRF
csll xsd:string Simples Informa o valor do
CSLL
Opcional
tipo_obra xsd:int Simples Tipo de Obra da
atividade 702
1 Minha Casa
Minha Vida;
2 Regime
Presumido;
3 Regime
Ordinrio;
Obrigatrio quando se
utilizar da atividade
702.
dia_emissao xsd:int Simples Dia da data de
emisso da nota.
Obrigatrio.
mes_emissao xsd:int Simples Ms da data de
emisso da nota.
Obrigatrio.
ano_emissao xsd:int Simples Ano da data de
emisso da nota.
Obrigatrio.

7.1.2 tcLoteRps
No disponvel para a Prefeitura Municipal de Bauru

7.1.3 tcDadosPrestador

No disponvel para a Prefeitura Municipal de Bauru

7.1.4 tns: tcDescricaoCancelaNota (Tipo Complexo)

Campo Formato Tipo Descrio
nota xsd:int Simples Nmero da NFS-e que
deseja que seja
cancelada.
Obrigatrio.
motivo xsd:int Simples Motivo do cancelamento
da Nota.
Obrigatrio.
email xsd:string Simples Email para onde a
notificao da nota
cancelada ser enviada.
Opcional.

7.1.5 tns: tcDadosConsultaNota (Tipo Complexo)

Campo Formato Tipo Descrio
nota xsd:int Simples Nmero da NFS-e que
deseja consultar.
Obrigatrio.
serie xsd:string Simples Srie presente na Nota
fiscal eletrnica.
Obrigatrio.
valor xsd: string Simples Valor da nota fiscal.
Ex:R$100,50 100,5
No utilize ponto (.)
Obrigatrio.
prestador_ccm xsd: int Simples Inscrio Municipal do
prestador de servio.
Obrigatrio.
prestador_cnpj xsd:int Simples CNPJ do prestador de
servio.
Obrigatrio.
autenticidade xsd:string Simples (hash) Obrigatrio.
Autenticidade presente
na Nota fiscal eletrnica

7.1.6 tcDadosCancelaNota

Campo Formato Tipo Descrio
ccm xsd:int Simples Inscrio Municipal do
prestador de servio.
Obrigatrio.
cnpj xsd:string Simples CNPJ/CPF do prestador
de servio.
Obrigatrio.
senha xsd: string Simples Senha do prestador de
servio.
Obrigatrio.
nota xsd: int Simples Nmero da nota a ser
cancelada
Obrigatrio.
motivo xsd:string Simples Descrio com o motivo
do cancelamento
Obrigatrio.
email xsd:string Simples Email de contato Obrigatrio

7.1.7 tcNotas
No disponvel para a Prefeitura Municipal de Bauru

7.2 Estruturas de resposta

7.2.1 tns: tcDadosNota (Tipo Complexo)

Campo Formato Tipo Descrio
nota xsd:int Simples Nmero da NF-e.
autenticidade xsd:string Simples Hash de segurana da nota.
dt_conversao xsd:string Simples Data da escrituao da nota.
num_rps xsd:int Simples Nmero do recibo provisrio de servios.
serie_rps xsd:string Simples Srie do recibo provisrio de servios.
emissao_rps xsd:string Simples Data do recibo provisrio de servios.
prestador_razao xsd:string Simples Razo social do prestador.
prestador_endereco xsd:string Simples Endereo do prestador.
prestador_numero xsd:int Simples Nmero do endereo do prestador.
prestador_complemento xsd:string Simples Complemento do endereo do prestador.
prestador_bairro xsd:string Simples Bairro do endereo do prestador.
prestador_cidade xsd:string Simples Cidade do endereo do prestador.
prestador_estado xsd:string Simples Estado do endereo do prestador.
prestador_cep xsd:int Simples CEP do endereo do prestador.
prestador_email xsd:string Simples Email do endereo do prestador.
valor xsd:string Simples Valor da nota.
base xsd:string Simples Valor base da nota.
servico xsd:string Simples Cdigo do servio prestado.
aliquota_atividade xsd:string Simples Alquota da atividade.
iss xsd:string Simples Iss da Nota.
cnpj_tomador xsd:string Simples CNPJ do Tomador.
razao_tomador xsd:string Simples Fax do tomador da nota.
endereco_tomador xsd:string Simples Endereo do prestador.
numero_tomador xsd:int Simples Nmero do endereo do tomador.
complemento_tomador xsd:string Simples Complemento do endereo do tomador.
bairro_tomador xsd:string Simples Bairro do endereo do tomador.
cidade_tomador xsd:string Simples Cidade do endereo do tomador.
estado_tomador xsd:string Simples Estado do endereo do tomador.
cep_tomador xsd:int Simples CEP do endereo do tomador.
email_tomador xsd:string Simples Email do endereo do tomador.
descricao xsd:string Simples Descrio dos servios prestados.
ISSRetido xsd:string Simples Valor retido.
StatusNFe xsd:string Simples Status da NF-e.
situacao xsd:string Simples Situao da Nota.
OpcaoSimples xsd:string Simples Retorna 1 se a empresa for Simples e 0
quando for diferente de Simples.
LinkImpressao xsd:string Simples Informa o link de impresso em pdf de
uma nota gerada. Tambm pode retornar
o link de impresso de uma nota durante
uma consulta ou cancelamento.
Em caso de falha no ter retorno.


7.2.2 tns: tcEstruturaDescricaoErros (Tipo Complexo)

Campo Formato Tipo Descrio
id xsd:int Simples Informa nota que esta sendo
processada utilizando o id do sistema
legado.
DescricaoProcesso xsd: string Simples Descrio do processo verificado.
DescricaoErro xsd:string Simples Se ocorreu um erro durante o processo
ele ser informado neste campo.

7.2.3 tns: tcDescricaoErros (Tipo Array)

Campo Formato Tipo Descrio
DescricaoErros tns:tcEstruturaDescricaoErros Complexo Informa com detalhes
os erros que ocorreram
durante a execuo de
um processo.

7.2.4 tns: tcRetornoNota (Tipo Complexo)

Campo Formato Tipo Descrio
Resultado xsd:int Simples Se o processo chamado for executado
com sucesso este campo retornar 1.
Em caso de falha retornar 0.
Nota xsd: int Simples Retorna o nmero da nota gerada, pode
retornar tambm o numero da nota de
uma consulta ou de um cancelamento.
Em caso de falha retornar 0.
autenticidade xsd:string Simples Retorna o hash de autenticidade da nota
gerada.
LinkImpressao xsd:string Simples Informa o link de impresso em pdf de
uma nota gerada. Tambm pode retornar
o link de impresso de uma nota durante
uma consulta ou cancelamento.
Em caso de falha no ter retorno.


7.2.5 tcConsultaFaixaNota
No disponvel para a Prefeitura Municipal de Bauru

7.2.6 tcListaDadosNota
No disponvel para a Prefeitura Municipal de Bauru