1 - INTRODUÇÃO
|
Este manual tem como objetivo apresentar as especificações e critérios técnicos necessários
para utilização do Web Service disponibilizado pelas Administrações Tributárias Municipais
para as empresas prestadoras e/ou tomadoras de serviços.
Utilizando o Web Service as empresas poderão integrar seus próprios sistemas de informações
com o Sistema de Notas Fiscais de Serviço Eletrônicas das Administrações Tributárias Municipais.
Desta forma, consegue-se automatizar o processo de geração, consulta e cancelamento de NFS-e.
|
2 - EMISSÃO DA NOTA FISCAL DE SERVIÇOS ELETRÔNICA |
A Nota Fiscal de Serviços Eletrônica (NFS-e) é um documento de existência exclusivamente
digital, gerado e armazenado eletronicamente pela Administração Tributária Municipal ou por
outra entidade conveniada, para documentar as operações de prestação de serviços.
A geração da NFS-e será feita, automaticamente, por meio de serviços informatizados, disponibilizados
aos contribuintes. Para que sua geração seja efetuada, dados que a compõem serão informados, analisados,
processados, validados e, se corretos, gerarão o documento.
A responsabilidade pelo cumprimento da obrigação acessória de emissão da NFS-e e pelo correto fornecimento
dos dados à Administração Tributária Municipal, para a geração da mesma, é do contribuinte.
|
2.1 - PARA INICIO DA INTEGRAÇÃO |
Para iniciar a integração Web Service, é necessário solicitar o código “TOKEN” que estará disponível no cadastro do contribuinte no site da NFS-e. |
Abaixo estão os serviços disponibilizados SEM NECESSIDADE DE AUTORIZAÇÃO: |
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/hello
Serviço utilizado para verificar se os serviços relacionados a emissão de NFS-e estão disponíveis.
OBS: Este serviço pode ser acessado através do BROWSER.
|
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/exemplo
Serviço utilizado para visualizar um exemplo do xml a ser enviado.
OBS: Este serviço pode ser acessado através do BROWSER.
|
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/consulta
Serviço utilizado para verificar a veracidade da Nota Fiscal Eletrônica.
OBS: Este serviço NÃO pode ser acessado através do BROWSER.
|
Abaixo estão os serviços disponibilizados que REQUEREM AUTORIZAÇÃO: |
Para realizar a requisição destes serviços terá que informar no HEADER o parametro Authorization, ao qual tera que ser composto da Inscrição-TOKEN. |
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/emissao/simula
Serviço utilizado para realizar a SIMULAÇÃO do envio da NFS-e.
OBS: Este serviço NÃO pode ser acessado através do BROWSER.
Utilizar o Serviço "http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/exemplo" citado acima
|
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/emissao
Serviço utilizado para realizar o ENVIO da NFS-e.
OBS: Este serviço NÃO pode ser acessado através do BROWSER.
Utilizar o Serviço "http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/exemplo" citado acima
|
http://webservice.giap.com.br/WSNfsesScarlos02/nfseresources/ws/v2/cancela
Serviço utilizado para realizar o CANCELAMENTO da NFS-e.
OBS: Este serviço NÃO pode ser acessado através do BROWSER.
Lista de Códigos de Motivo do Cancelamento a ser utilizado no Serviço
| Cod. |
Descrição do Motivo |
| 8 | ERRO - MÊS COMPETÊNCIA |
| 9 | ERRO - LOCAL DA PRESTAÇÃO |
| 10 | ERRO - ALÍQUOTA |
| 11 | ERRO - BASE DE CALCULO |
| 12 | ERRO - DESCRIÇÃO DOS SERVIÇOS |
| 13 | ERRO - DIVERGÊNCIA CADASTRAL |
| 14 | ERRO - DADOS DO TOMADOR |
|