Sistema Integrado de Gerenciamento do ISS SIG-ISS. Manual de integração do WebService para NFS-e

Transcrição

1 Sistema Integrado de Gerenciamento do ISS SIG-ISS Manual de integração do WebService para NFS-e São Paulo, 27 de Janeiro de 2014

2 1. Introdução Este manual tem como objetivo apresentar as especificações e critérios técnicos necessários para utilização do WebService do SIGISS. Utilizando o WebService as empresas poderão integrar seus próprios sistemas de informações com o SIGISS. Desta forma, consegue-se automatizar o processo de geração, consulta e cancelamento de NFS-e. 2. Especificação Os contribuintes do ISSQN que optarem, junto ao município, pela emissão de notas fiscais eletrônicas podem utilizar o WebService do SIGISS para importar essa informação para os seus sistemas. A informação que será importada será sobre cada nota fiscal emitida juntamente com as informações mais importantes que compõem a mesma. A nota fiscal eletrônica tem como objetivo facilitar todo o processo de escrituração e emissão de notas fiscais automatizando todo o processo. A qualquer momento o contribuinte pode usar o WebService SIGISS para receber as informações das notas fiscais emitidas. 3. Conexão com o WebService Para verificar os métodos disponíveis basta acessar a página: Para carregar as informações dos métodos basta criar um client do WebService do SIGISS acessando 4. Ambiente de Homologação Antes da utilização do WebService é necessário solicitar dados de acesso para o ambiente de homologação, via processo SIGIPM, com o assunto. No próprio processo estão as orientações para preenchimento dos dados. Só assim será possível a correta configuração e envio de XML para essa integração e após a homologação pela Prefeitura Municipal de Bauru 5. Arquivo XML (Antigo item 4) Assim que a nota é escriturada utilizando o WebService, é gerado um 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 acessar a aba de Movimento, na área de serviços prestados acessar o botão de Ferramentas NF-e e escolher a opção de Exportar notas emitidas em XML, os arquivos XML estarão dentro de um arquivo de extensão *.zip. Essa opção não está disponível para o(s) módulo(s) disponível (is) para o município de Bauru. 6. Métodos do WebService

3 6.1 GERAÇÃO DE NFS-e A funcionalidade de geração de NFS-e se responsabiliza por receber os dados referentes a uma prestação de serviços e gravá-los na base do SIGISS, gerando uma Nota Fiscal de Serviços Eletrônica. Após sua gravação, a NFS-e fica disponível para consulta e visualização (Não disponível para o módulo utilizado pela Prefeitura Municipal de Bauru). Caso haja alguma inconsistência nos dados informados durante o processo, a mensagem do problema é retornada ao requisitante. Durante o preenchimento dos dados que gerarão uma NFS-e, o contribuinte poderá fazer o seu vínculo com um RPS emitido, bastando para isso informar o número, a série 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 não for informado este controle é ignorado. Para o campo tomador_cod_cidade, favor informar o código da cidade de acordo com a classificação do IBGE. O código da cidade pode ser verificado no seguinte link abaixo: Este é um processo síncrono. Chamada do Método: GerarNota Parâmetros de Envio: DadosPrestador(tns:tcDadosPrestador), DescricaoRps (tns: tcdescricaorps). Parâmetros 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 Serviços Eletrônica já emitida. Caso a NFS-e não 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 não vincula esse cancelamento a nenhum RPS, assim como a nenhuma nota substituta. Este é um processo síncrono. Chamada do Método:CancelarNota Parâmetros de Envio: DadosPrestador(tns:tcDadosPrestador), DescricaoCancelaNota (tns: tcdescricaocancelanota) Parâmetros de Resposta: RetornoNota(tns: tcretornonota), DescricaoErros(tns: tcdescricaoerros) 6.3 CONSULTA DE NFS-e VÁLIDA

4 A funcionalidade de consulta de NFS-e retorna de uma nota específica para saber se a nota é válida mediante a identificação da nota, identificação do prestador e identificação do tomador. Este é um processo síncrono. Chamada do Método:ConsultarNotaValida Parâmetros de Envio: DadosPrestador(tns:tcDadosPrestador), Gruponotas (tns: tcnotas) Parâmetros de Resposta: RetornoNota(tns: tcretornonota), DescricaoErros(tns: tcdescricaoerros) 6.4 CONSULTA DE NFS-e SERVIÇOS PRESTADOS A funcionalidade de consulta de NFS-e retorna informações de uma ou mais NFS-e conforme os parâmetros de pesquisa que podem ser a identificação da própria nota, identificação do prestador; identificação do tomador. Este é um processo síncrono. Chamada do Método: ConsultarNotaPrestador Parâmetros de Envio: DadosPrestador(tns:tcDadosPrestador), Nota(xsd:int) Parâmetros de Resposta: DadosNfse (tns: tcdadosnfse), DescricaoErros(tns: tcdescricaoerros)

5 7. Estrutura de Dados 7.1 Estruturas de Envio tns:tcdescricaorps (Tipo Complexo) Campo Formato Tipo Descrição Ocorrência ccm xsd:int Simples Inscrição Municipal do prestador de serviço. cnpj xsd:int Simples CNPJ/CPF do prestador de serviço. senha xsd:string Simples Senha do prestador de serviço. crc xsd:int Simples CRC do contador do prestador de serviço. crc_estado xsd:int Simples CRC estado do contador do prestador de serviço. aliquota_simples xsd:string Simples Alíquota do simples nacional. Obrigatório se a empresa prestadora é do tipo simples id_sis_legado xsd:int Simples Código da nota no sistema legado do contribuinte. servico xsd:int Simples Código do serviço utilizado na emissão da nota fiscal da lei 116/03. situacao xsd:string Simples Situação da nota fiscal eletrônica: tp Tributada no prestador; tt Tributada no tomador; is Isenta; im Imune; nt Não tributada. valor xsd:string Simples Valor da nota fiscal. Ex:R$100,50 100,5 Não utilize ponto (. ) base xsd:string Simples Valor da base de calculo. Ex:R$100,50 100,5 Não utilize ponto (. ) descricaonf xsd:string Simples Descrição do Serviço Prestado. nacional. tomador_tipo xsd:int Simples Tipo do tomador que

6 se quer escriturar: 1 PFNI (Somente com Autorização da Prefeitura); 2 Pessoa Física; 3 Jurídica do Município; 4 Jurídica de Fora; 5 Jurídica de Fora do País. tomador_cnpj xsd:string Simples CPF ou CNPJ do tomador da nota fiscal eletrônica. tomador_ xsd:string Simples do tomador da nota. tomador_ie xsd:string Simples Inscrição Estadual do tomador da nota. tomador_im xsd:int Simples Inscrição municipal do tomador da nota. tomador_razao xsd:string Simples Razão Social do tomador da nota. tomador_fantasia xsd:string Simples Nome Fantasia do tomador da nota. tomador_endereco xsd:string Simples Endereço do tomador da nota. tomador_numero xsd:string Simples Número do endereço do tomador da nota. tomador_complemento xsd:string Simples Complemento do endereço do tomador da nota. tomador_bairro xsd:string Simples Bairro do tomador da nota. tomador_cep xsd:string Simples CEP do tomador da nota. (Para tomadores de Fora do País deixar em branco). Se for informado, ou já estiver cadastrado, o sistema enviará automaticamente um com o link da nota para este endereço. (Obrigatório para tomador que tenha mais de uma inscrição municipal). tomador não esteja cadastrado. tomador não esteja cadastrado. (Opcional para tomadores de Fora do País). tomador não esteja cadastrado. (Opcional para tomadores de Fora do País). tomador não esteja cadastrado. (Opcional para tomadores de Fora do País). tomador não esteja cadastrado. (Opcional para tomadores de

7 tomador_cod_cidade xsd:string Simples Código da cidade do tomador da nota. tomador_fone xsd:string Simples Telefone do tomador da nota. tomador_ramal xsd:string Simples Ramal do tomador da nota. tomador_fax xsd:string Simples Fax do tomador da nota. rps_num xsd:int Simples Número do recibo provisório de serviços. rps_serie xsd:string Simples Série do recibo provisório de serviços. rps_dia xsd:int Simples Dia em que foi emitido o recibo provisório de serviços. rps_mes xsd:int Simples Mês em que foi emitido o recibo provisório de serviços. rps_ano xsd:int Simples Ano em que foi emitido o recibo provisório de serviços. outro_municipio xsd:int Simples Indica se o serviço foi prestado em Bauru ou fora do município. 1 - Fora de Bauru cod_outro_municipio xsd:int Simples Informa o código do município no qual o serviço foi prestado, segundo a tabela do IBGE, conforme link já indicado nesse manual. retencao_iss xsd:string Simples Informa o valor do ISS Retido em outro município, caso haja essa informção Fora do País). tomador não esteja cadastrado. (Para tomadores de Fora do País deixar em branco). prestador queira vincular uma RPS a nota eletrônica. prestador queira vincular uma RPS a nota eletrônica. prestador queira vincular uma RPS a nota eletrônica. prestador queira vincular uma RPS a nota eletrônica. prestador queira vincular uma RPS a nota eletrônica. Opcional Obrigatório caso seja prestado fora de Bauru Opcional pis xsd:string Simples Informa o valor do Opcional PIS cofins xsd:string Simples Informa o valor do Opcional COFINS inss xsd:string Simples Informa o valor do Opcional INSS irrf xsd:string Simples Informa o valor do Opcional

8 IRRF csll xsd:string Simples Informa o valor do CSLL tipo_obra xsd:int Simples Tipo de Obra da atividade Minha Casa Minha Vida; 2 Regime Presumido; 3 Regime Ordinário; dia_emissao xsd:int Simples Dia da data de emissão da nota. mes_emissao xsd:int Simples Mês da data de emissão da nota. ano_emissao xsd:int Simples Ano da data de emissão da nota. Opcional Obrigatório quando se utilizar da atividade tcloterps Não disponível para a Prefeitura Municipal de Bauru tcdadosprestador Não disponível para a Prefeitura Municipal de Bauru tns: tcdescricaocancelanota (Tipo Complexo) Campo Formato Tipo Descrição nota xsd:int Simples Número da NFS-e que deseja que seja cancelada. motivo xsd:int Simples Motivo do cancelamento da Nota. xsd:string Simples para onde a notificação da nota cancelada será enviada tns: tcdadosconsultanota (Tipo Complexo) Campo Formato Tipo Descrição nota xsd:int Simples Número da NFS-e que deseja consultar. serie xsd:string Simples Série presente na Nota fiscal eletrônica. valor xsd: string Simples Valor da nota fiscal. Ex:R$100,50 100,5 Não utilize ponto (. ) prestador_ccm xsd: int Simples Inscrição Municipal do prestador de serviço. prestador_cnpj xsd:int Simples CNPJ do prestador de serviço. autenticidade xsd:string Simples (hash)

9 Autenticidade presente na Nota fiscal eletrônica tcdadoscancelanota Campo Formato Tipo Descrição ccm xsd:int Simples Inscrição Municipal do prestador de serviço. cnpj xsd:string Simples CNPJ/CPF do prestador de serviço. senha xsd: string Simples Senha do prestador de serviço. nota xsd: int Simples Número da nota a ser cancelada motivo xsd:string Simples Descrição com o motivo do cancelamento xsd:string Simples de contato Obrigatório tcnotas Não disponível para a Prefeitura Municipal de Bauru 7.2 Estruturas de resposta tns: tcdadosnota (Tipo Complexo) Campo Formato Tipo Descrição nota xsd:int Simples Número da NF-e. autenticidade xsd:string Simples Hash de segurança da nota. dt_conversao xsd:string Simples Data da escrituação da nota. num_rps xsd:int Simples Número do recibo provisório de serviços. serie_rps xsd:string Simples Série do recibo provisório de serviços. emissao_rps xsd:string Simples Data do recibo provisório de serviços. prestador_razao xsd:string Simples Razão social do prestador. prestador_endereco xsd:string Simples Endereço do prestador. prestador_numero xsd:int Simples Número do endereço do prestador. prestador_complemento xsd:string Simples Complemento do endereço do prestador. prestador_bairro xsd:string Simples Bairro do endereço do prestador. prestador_cidade xsd:string Simples Cidade do endereço do prestador. prestador_estado xsd:string Simples Estado do endereço do prestador. prestador_cep xsd:int Simples CEP do endereço do prestador. prestador_ xsd:string Simples do endereço do prestador. valor xsd:string Simples Valor da nota. base xsd:string Simples Valor base da nota. servico xsd:string Simples Código do serviço prestado. aliquota_atividade xsd:string Simples Alíquota 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 Endereço do prestador. numero_tomador xsd:int Simples Número do endereço do tomador.

10 complemento_tomador xsd:string Simples Complemento do endereço do tomador. bairro_tomador xsd:string Simples Bairro do endereço do tomador. cidade_tomador xsd:string Simples Cidade do endereço do tomador. estado_tomador xsd:string Simples Estado do endereço do tomador. cep_tomador xsd:int Simples CEP do endereço do tomador. _tomador xsd:string Simples do endereço do tomador. descricao xsd:string Simples Descrição dos serviços prestados. ISSRetido xsd:string Simples Valor retido. StatusNFe xsd:string Simples Status da NF-e. situacao xsd:string Simples Situação 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 impressão em pdf de uma nota gerada. Também pode retornar o link de impressão de uma nota durante uma consulta ou cancelamento. Em caso de falha não terá retorno tns: tcestruturadescricaoerros (Tipo Complexo) Campo Formato Tipo Descrição id xsd:int Simples Informa à nota que esta sendo processada utilizando o id do sistema legado. DescricaoProcesso xsd: string Simples Descrição do processo verificado. DescricaoErro xsd:string Simples Se ocorreu um erro durante o processo ele será informado neste campo tns: tcdescricaoerros (Tipo Array) Campo Formato Tipo Descrição DescricaoErros tns:tcestruturadescricaoerros Complexo Informa com detalhes os erros que ocorreram durante a execução de um processo tns: tcretornonota (Tipo Complexo) Campo Formato Tipo Descrição 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 número da nota gerada, pode retornar também 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 impressão em pdf de

11 uma nota gerada. Também pode retornar o link de impressão de uma nota durante uma consulta ou cancelamento. Em caso de falha não terá retorno tcconsultafaixanota Não disponível para a Prefeitura Municipal de Bauru tclistadadosnota Não disponível para a Prefeitura Municipal de Bauru

12 8. ANEXO I - MODELOS XML PARA INTEGRAÇÃO Endereço do WebService de Teste: Endereço do WebService Oficial: Ferramenta para auxílio com testes: SOAPUI 8.1 Para gerar nota (Método GerarNota) <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:urn="urn:sigiss_ws"> <soapenv:header/> <soapenv:body> <urn:gerarnota soapenv:encodingstyle=" <DescricaoRps xsi:type="urn:tcdescricaorps">  <ccm xsi:type="xsd:string">?</ccm> <cnpj xsi:type="xsd:string">?</cnpj> <senha xsi:type="xsd:string">?</senha> <crc xsi:type="xsd:int">?</crc> <crc_estado xsi:type="xsd:string">?</crc_estado> <aliquota_simples xsi:type="xsd:string">?</aliquota_simples> <id_sis_legado xsi:type="xsd:string">?</id_sis_legado> <servico xsi:type="xsd:int">?</servico> <situacao xsi:type="xsd:string">?</situacao> <valor xsi:type="xsd:string">?</valor> <base xsi:type="xsd:string">?</base> <descricaonf xsi:type="xsd:string">?</descricaonf> <tomador_tipo xsi:type="xsd:int">?</tomador_tipo> <tomador_cnpj xsi:type="xsd:string">?</tomador_cnpj> <tomador_ xsi:type="xsd:string">?</tomador_ > <tomador_ie xsi:type="xsd:string">?</tomador_ie> <tomador_im xsi:type="xsd:string">?</tomador_im> <tomador_razao xsi:type="xsd:string">?</tomador_razao> <tomador_fantasia xsi:type="xsd:string">?</tomador_fantasia> <tomador_endereco xsi:type="xsd:string">?</tomador_endereco> <tomador_numero xsi:type="xsd:string">?</tomador_numero> <tomador_complemento xsi:type="xsd:string">?</tomador_complemento> <tomador_bairro xsi:type="xsd:string">?</tomador_bairro> <tomador_cep xsi:type="xsd:string">?</tomador_cep> <tomador_cod_cidade xsi:type="xsd:string">?</tomador_cod_cidade> <tomador_fone xsi:type="xsd:string">?</tomador_fone> <tomador_ramal xsi:type="xsd:string">?</tomador_ramal> <tomador_fax xsi:type="xsd:string">?</tomador_fax> <rps_num xsi:type="xsd:int">?</rps_num>

13 <rps_serie xsi:type="xsd:string">?</rps_serie> <rps_dia xsi:type="xsd:int">?</rps_dia> <rps_mes xsi:type="xsd:int">?</rps_mes> <rps_ano xsi:type="xsd:int">?</rps_ano> <outro_municipio xsi:type="xsd:int">?</outro_municipio> <cod_outro_municipio xsi:type="xsd:int">?</cod_outro_municipio> <retencao_iss xsi:type="xsd:string">?</retencao_iss> <pis xsi:type="xsd:string">?</pis> <cofins xsi:type="xsd:string">?</cofins> <inss xsi:type="xsd:string">?</inss> <irrf xsi:type="xsd:string">?</irrf> <csll xsi:type="xsd:string">?</csll> <tipo_obra xsi:type="xsd:int">?</tipo_obra> <dia_emissao xsi:type="xsd:int">?</dia_emissao> <mes_emissao xsi:type="xsd:int">?</mes_emissao> <ano_emissao xsi:type="xsd:int">?</ano_emissao> </DescricaoRps> </urn:gerarnota> </soapenv:body> </soapenv:envelope> 8.2 Para cancelar nota (Método CancelarNota) <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:urn="urn:sigiss_ws"> <soapenv:header/> <soapenv:body> <urn:cancelarnota soapenv:encodingstyle=" <DadosCancelaNota xsi:type="urn:tcdadoscancelanota">  <ccm xsi:type="xsd:int">?</ccm> <cnpj xsi:type="xsd:string">?</cnpj> <senha xsi:type="xsd:string">?</senha> <nota xsi:type="xsd:int">?</nota> <motivo xsi:type="xsd:string">?</motivo> < xsi:type="xsd:string">?</ > </DadosCancelaNota> </urn:cancelarnota> </soapenv:body> </soapenv:envelope> 8.3 Para consultar nota fiscal já emitida (Método: ConsultarNotaPrestador) <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:urn="urn:sigiss_ws">

14 <soapenv:header/> <soapenv:body> <urn:consultarnotaprestador soapenv:encodingstyle=" <DadosPrestador xsi:type="urn:tcdadosprestador">  <ccm xsi:type="xsd:int">?</ccm> <cnpj xsi:type="xsd:string">?</cnpj> <senha xsi:type="xsd:string">?</senha> <crc xsi:type="xsd:int">?</crc> <crc_estado xsi:type="xsd:string">?</crc_estado> <aliquota_simples xsi:type="xsd:string">?</aliquota_simples> </DadosPrestador> <Nota xsi:type="xsd:int">?</nota> </urn:consultarnotaprestador> </soapenv:body> </soapenv:envelope> 8.4 Para verificar validade/autenticidade de uma nota fiscal (Método: ConsultarNotaValida) <soapenv:envelope xmlns:xsi=" xmlns:xsd=" xmlns:soapenv=" xmlns:urn="urn:sigiss_ws"> <soapenv:header/> <soapenv:body> <urn:consultarnotavalida soapenv:encodingstyle=" <DadosConsultaNota xsi:type="urn:tcdadosconsultanota">  <nota xsi:type="xsd:int">?</nota> <serie xsi:type="xsd:string">?</serie> <valor xsi:type="xsd:string">?</valor> <prestador_ccm xsi:type="xsd:int">?</prestador_ccm> <prestador_cnpj xsi:type="xsd:string">?</prestador_cnpj> <autenticidade xsi:type="xsd:string">?</autenticidade> </DadosConsultaNota> </urn:consultarnotavalida> </soapenv:body> </soapenv:envelope> 8.5 Layout Padrão Nota Fiscal

15

16 9. ANEXO II - Informações Tributárias 9.1 OBSERVAÇÕES PRELIMINARES: - Prestador de Bauru Pessoa Física ou Jurídica deverá ter inscrição municipal em Bauru (a inscrição é feita no CAES e importada ao SIGISS). - Prestador de Bauru Pessoa Física ou Jurídica isento ou imune qualquer que seja o tomador não haverá ISS, o sistema deverá emitir a nota eletrônica com a informação de isento ou imune, conforme marcação do CAES e do SIGISS, sem geração do ISS. Regra Geral: Prestador de Bauru Pessoa Física ou Pessoa Jurídica com Serviço Prestado para TOMADOR PESSOA JURÍDICA. Obrigação de recolher o ISS será sempre do TOMADOR, a não ser que o PRESTADOR tenha CNR válida cadastrada no SIGISS. Exceções (deslocam o recolhimento do ISS para o prestador, sem a exigência da CNR): 1) PRESTADOR de Bauru Pessoa Física com RECOLHIMENTO Fixo Trimestral. 2) PRESTADOR de Bauru MEI ou SIMEI. 3) PRESTADOR de Bauru Pessoa Física ou Jurídica com recolhimento do ISS estimado, sendo do Simples Nacional ou não. TOMADOR de Bauru Pessoa Jurídica Firma Individual (Empresário Individual não é MEI): como não tem marcação no sistema para podermos parametrizar, estamos manualmente tirando a marcação no CAES e no SIGISS para a obrigação ficar para o prestador (com problema chamado aberto). 4) TOMADOR de Bauru Pessoa Física. 5) Escritório de Contabilidade (código de ISS 17.18), recolhimento fixo ou de homologação, tendo marcação do Simples Nacional. Nos casos acima a Obrigação de recolher será do PRESTADOR. Não precisará de CNR, a obrigação ficará automaticamente para o prestador recolher.

17 9.2 ÚLTIMAS OBSERVAÇÕES: Serviço prestado fora de Bauru. - O sistema deverá verificar a atividade indicada e se ela está dentre as exceções previstas nos incisos do artigo 397 do decreto 10645/2008 Decreto disponível no site da Prefeitura finanças legislação); - Se estiver, o ISS será devido fora de Bauru e o contribuinte poderá indicar a opção não tributada. Não estando dentre as exceções (por exemplo, conserto), o ISS será devido para Bauru e o contribuinte não terá como se livrar da tributação; Tomador de Fora de Bauru NUNCA será obrigado a recolher o ISS, independente se o prestador é ou não de Bauru. Lembrete: As situações abaixo NÃO devem gerar boletos, pois o recolhimento não será pelo SIGISS. - MEI, SIMEI ou Simples Nacional ou ISSQN Homologação Estimado do Simples Nacional Recolhe pelo DAS e posteriormente vem o retorno para a Prefeitura. - ISSQN Fixo Trimestral ou ISSQN Homologação Estimado Pessoa Física ou Jurídica Recolhe por guia própria da Prefeitura, pelo Sistema Tributário.