Nfs-e Prefeitura de Cotia
Nota Fiscal de Serviços Eletrônica
MANUAL DE INTEGRAÇÃO WEB SERVICE

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/WSNfsesCotia/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/WSNfsesCotia/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/WSNfsesCotia/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.

      XML - Envio


      XML - Retorno


  • 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/WSNfsesCotia/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.

      XML - Envio

      Utilizar o Serviço "http://webservice.giap.com.br/WSNfsesCotia/nfseresources/ws/v2/exemplo" citado acima

      XML - Retorno de Sucesso


      XML - Retorno com Erro


  • http://webservice.giap.com.br/WSNfsesCotia/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.

      XML - Envio

      Utilizar o Serviço "http://webservice.giap.com.br/WSNfsesCotia/nfseresources/ws/v2/exemplo" citado acima

      XML - Retorno de Sucesso


      XML - Retorno com Erro


  • http://webservice.giap.com.br/WSNfsesCotia/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
      8ERRO - MÊS COMPETÊNCIA
      9ERRO - LOCAL DA PRESTAÇÃO
      10ERRO - ALÍQUOTA
      11ERRO - BASE DE CALCULO
      12ERRO - DESCRIÇÃO DOS SERVIÇOS
      13ERRO - DIVERGÊNCIA CADASTRAL
      14ERRO - DADOS DO TOMADOR

      XML - Envio


      XML - Retorno de Sucesso


      XML - Retorno com Erro


  • Todos os direitos reservados