Documentação Técnica - Padrão SIGISS

Manual de integração com o webservice

Manual é disponibilizado de acordo com cada prefeitura. 

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Síncrono.
• Consultar NFSe.
• Cancelamento de NFSe.
  • Obs.: Para algumas cidades, não foi possível cancelar uma nota via WebService, por conta de instabilidades por parte da prefeitura. Dessa forma, o método Cancelar está indisponível temporariamente.

Observações

• A senha da prefeitura utilizada, deve ser informada como parâmetro extra.

• Mesmo com envio síncrono, há municípios enfrentando lentidão no processamento devido à etapa de autorização no Ambiente Nacional de Dados (ADN). Por isso, em determinadas situações, será indispensável consultar a NFSe posteriormente para confirmar se a autorização foi efetivada pela prefeitura.

  • Manager SaaS: Essa verificação deve ser realizada por meio da rota RESOLVE.

  • Componente NFSe: Será necessário realizar o método de Consulta NFSe.

  • PlugNotas: A API irá realizar as consultas automaticamente, sem necessidade de interação.

• O link de impressão da nota pode ser obtido utilizando os comandos do executar, através do método "ObterLinkImpressaoNFSe", segue o exemplo abaixo:  

Cancelamento no Componente:

Para preencher o motivo do cancelamento em algumas cidades, será necessário preencher a propriedade ParametrosExtras=Motivo=Teste de Cancelamento

Cancelamento no Manager SaaS:

Algumas cidades não permitem o Motivo de Cancelamento vazio no cancelamento da NFS-e, para informá-lo, deve ser informado o campo parametroExtra na requisição, com o motivo do titulo, exemplo de requisição:

curl --location 'https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfse/cancela' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic YWRtaW46dGVjbA123444' \
--data-urlencode 'Grupo=GrupoTeste' \
--data-urlencode 'CNPJ=99999999999999' \
--data-urlencode 'NomeCidade=MOGIGUACUSP' \
--data-urlencode 'parametroExtra=teste motivo Cancelamento' \
--data-urlencode 'encode=true' \
--data-urlencode 'handle=132013817'

Desta forma, o motivo será preenchido no XML de cancelamento:

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:sigiss_ws">
<soapenv:Header/>
<soapenv:Body>
<urn:CancelarNota soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<DadosCancelaNota xsi:type="urn:tcDadosCancelaNota">
<ccm>9999999</ccm>
<cnpj>99999999999999</cnpj>
<senha>999999</senha>
<nota>999</nota>
<motivo>teste motivo Cancelamento</motivo>
<email/>
</DadosCancelaNota>
</urn:CancelarNota>
</soapenv:Body>
</soapenv:Envelope>

Geração do XML - Campos Importantes

• O Código do serviço segue o que está descrito na LC-116.
• Não é obrigatório informar o código Cnae entretanto se for informado será gerado no XML.
• Não é obrigatório informar o código tributação município entretanto se for informado será gerado no XML.
• É obrigatório informar o código NBS e o mesmo será gerado no XML.
   

Observações específicas por cidade

Novos campos disponibilizados para adequação da Reforma Tributária

Observação: Campos obrigatórios conforme o arquivo de esquema do Padrão estão destacados em negrito.

O padrão ainda não retorna o XML de NFSe com os campos novos de IBS e CBS.

Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.

Arquivos de exemplo:

- Exemplo Tx2

- Xml de envio

- Exemplo Json

Campos customizados para a impressão

Impressão da NFSe

• CpfCnpjPrestador=String[30]
• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualPrestador=String[40]
• InscricaoMunicipalPrestador=String[40]
• TelefonePrestador=String[20]
• EnderecoPrestador=String[80]
• NumeroPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[10]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• InscricaoEstadualTomador=String[40]
• UfTomador=String[2]
• PaisTomador=String[30]
• EmailPrestador=String[80]
• ValorDeducoes=String[80]
• OutrasInformacoes=String[250]
• AliquotaISS=String[10]

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualPrestador=String[40]
• TelefonePrestador=String[20]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• InscricaoEstadualTomador=String[40]
• UfTomador=String[2]
• EmailPrestador=String[80]
• ValorDeducoes=String[80]
• CepPrestador=String[10]
• OutrasInformacoes=String[250]
• NumeroRPS=String[20]
• SerieRPS=String[20]

Soluções Tecnospeed

• Componente NFSe:   Release 8.7.50.X.
• Manager eDoc:  Release 3.0.84.X