Tópicos deste artigo

• Manual do webservice
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais
• Observações específicas por cidade
• Emissão pelo PlugNotas
• Emissão pelo ManagerEDoc/ManagerSaaS
• Emissão pelo Componente NFSe
• Erros comuns
• Observações sobre a geração do XML
• Campos customizados para a impressão do RPS
• Campos customizados para a impressão da NFSe

 

 

Manual de integração com o webservice

Manual é disponibilizado de acordo com cada prefeitura.

 

 

Portais Disponíveis

• Produção

 

 

Métodos Disponíveis

• Envio.
  • Assíncrono.
  • Síncrono.
  • Necessita envio sequencial¹
  • Aceita envio de lote de RPS
• Consulta de Lote.
• Consulta de NFSe.
• Consulta de NFSe por RPS
• Cancelamento (Algumas cidades)

 

¹Necessita que as notas sejam enviadas de forma sequencial

Tipo de impressão

• A impressão é feita via link da prefeitura.¹

 

 ¹Nossos produtos realizam o download do PDF da NFSe que foi gerado pela própria prefeitura.

Observações

• Padrão exige que o prestador solicite autorização para emitir via WebService. A Solicitação deve ser feita na prefeitura do prestador. 
• O Xml de retorno do Envio Síncrono não é valido para a impressão, sendo assim, deve ser utilizado os métodos de consulta de NFSe ou Consulta de NFSe por RPS.
• O campo Login deve ser configurado sem máscara.
• No caso em que um prestador possuir matriz e filiais, é possível emitir notas pelo CNPJ da filial utilizando o certificado da matriz. Para isso, deve ser inserido o CNPJ da matriz nos parâmetros extras de todos os métodos do componente. Exemplo: "CnpjMatriz=11111111111111"
• No SaaS/PlugNotas, na Autenticação da prefeitura, o campo Login deve ser preenchido com a informação de CNPJ da Matriz, Exemplo: login=11111111111111, caso o prestador possua filiais e deseja utilizar o certificado da matriz.
• Caso o tomador for um consumidor não identificado informar no campo CPFCNPJTomador o valor ‘77777777777’, no campo RazaoSocialTomador informar ‘Consumidor’
  e nos campos TipoLogradouroTomador, LogradouroTomador, TipoBairroTomador, BairroTomador
• EmailTomador informar o valor ‘-’ quando não possuir essa informação. No campo NumeroEnderecoTomador informar valor zero e no campo CEPTomador informar
  ‘00000000’.
• Caso o tomador for estrangeiro informar no campo CidadeTomador o valor ‘9999’ e no
  campo CidadeTomadorDescricao informar o nome do país, no campo CepTomador informar ‘00000000’.
• Caso o município de prestação for no exterior informar no campo MunicipioPrestacao o
  valor ‘9999’ e no campo MunicipioPrestacaoDescricao informar o nome do país.
  Quando a situação do RPS for cancelada, deve se informar o motivo do cancelamento
  no campo MotCancelamento.
• Para que seja gerado o mapa anexo de deduções deve ser informado no TX2 padrão único o dataSet INCLUIRDEDUCAO da seguinte forma:

INCLUIRDEDUCAO
DeducaoPor=1
TipoDeducao=1
CPFCNPJReferencia=29062609000177
NumeroNFReferencia=2
ValorTotalReferencia=1.00
PercentualDeduzir=2
ValorDeducao=0.02
SALVARDEDUCAO

• Esse padrão não permite o envio dos campos DescontoIncondicionado e DescontoCondicionado, o tratamento do desconto deverá ser feito no valor total dos serviços

 

 

________________________________________________________________________________________________________________

Observações específicas por cidade

Cidade	Observação	Códigos de cancelamento
São Luis/MA	Não possui cancelamento. O serviço foi desativado e deve ser realizado pelo portal da prefeitura.
Campinas/SP	Para cancelamento de notas no munícipio de Campinas, é necessário informar os códigos correspondentes ao texto previsto pelo manual da prefeitura. A impressão é feita via RTM (layout da Tecnospeed). Para gerar o valor líquido na impressão, deve ser utilizado o campo customizado "ValorLiquido"	1 - Servico Nao Prestado 2 - Nota Fiscal Emitida em Duplicidade 3 - CPF ou CNPJ do Tomador do Serviço Incorreto
Nova Iguaçu/RJ	Para cancelar uma nota fiscal, é preciso entrar em contato com o departamento de fiscalização tributária: Telefone: 2666-4928 E-mail:fiscalizacaotributos@novaiguacu.rj.gov.br

 

 

Emissão pelo PlugNotas

No painel PlugNotas acesse o menu Empresas para cadastrar ou editar algum cadastro já realizado, em seguida selecione a guia NFS-e, caso não esteja aparecendo será necessário acessar Documentos Ativos para habilitar a mesma.

Na guia NFS-e, localize a área Autenticação Prefeitura, onde deverá ser informados as credenciais de acesso ao portal sem máscara.

 

Exemplo de configuração pela API

 

 

Emissão pelo ManagerEDoc/ManagerSaaS

Deve ser informado no painel ManagerEdoc/ManagerSaaS no meu Configurações → Autenticação da prefeitura os dados de acesso ao portal da prefeitura, sendo CNPJ(sem máscara) e senha.

 

Para cancelamentos basta inserir no tx2 gerado para a pasta 'Cancela' o campo 'CodigoCancelamento', exemplo:

          NomeCidade=Campinas
          NumNFSe=1
          CodigoCancelamento=1

 Na rota Cancela, do Manager SaaS, o 'CodigoCancelamento' precisará ser informado no Body da             requisição, contendo um dos valores listados acima. Exemplo - Formato 4 - Doc - Cancelamento

 

 

Emissão pelo componente NFSe

As credenciais de acesso ao portal da prefeitura deverão ser informadas nos parâmetros extras "Login" e "Senha", lembrando de não utilizar máscaras no login.

NFSe.ParametrosExtras = "Login=12123123000112;Senha=1234BC2";

           

No componente, para realizar o cancelamento deverá ser informado na propriedade 'ParametrosExtras' da seguinte forma, exemplo: 

           NFSe.ParametrosExtras = "MotivoCancelamento=Servico Nao Prestado";
           NFSe.ParametrosExtras = "MotivoCancelamento=Nota Fiscal Emitida em Duplicidade";
           NFSe.ParametrosExtras = "MotivoCancelamento=CPF ou CNPJ do Tomador do Serviço Incorreto";

       

 

 

Erros Comuns

• 1 - Lote não encontrado com o numero 1.
  É necessário solicitar o credenciamento do contribuinte junto a prefeitura para emissão em lote. 
  
  
• Verificar se não houve informação de retenção indevida no RPS para empresa fora de Campinas.
  É necessário que a inscrição municipal do tomador esteja preenchida.
  
  
• 1465-Tomador e um Substituto Tributario no Cadastro do Municipio. Por este motivo, o prestador nao podera emitir RPS como A recolher. Favor cancelar e emitir um novo RPS com imposto Retido na Fonte.
  É necessário preencher o campo TipoTributacao com o valor 5.
  
  
• 1433 - Contribuinte nao credenciado para o metodo de integracao com a NFSe utilizado. Contribuinte credenciado para emitir NFS-e pelo site, para possibilitar a entrega em Lote deve ser solicitado junto a prefeitura a alteração no credenciamento para habilitar entrega em lote.
  É necessário solicitar o credenciamento do contribuinte junto a prefeitura para emissão via WebService (algumas prefeituras solicitam, também, o envio de um PDF com protocolo de RPS). Em algumas cidades é possível ativar a emissão de RPS através do menu "Minha Empresa" > "Configurar Empresa" > Na aba "Credenciamento" marque a opção "Lote" e depois clique em "Gravar" no final da página.

 

 

Observações sobre a geração do XML

• O código do serviço segue o que está descrito na LC-116.
• Para algumas cidades do padrão, ao enviar um Item do SubItens 7.02, 7.04 e 7.05, a prefeitura exige a Inscrição Municipal da Obra, para isso, basta passar a inscrição no campo CodigoObra.

 

 

Campos customizados para a impressão do RPS

• CPFCNPJPrestador=String[14]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[8]
• DescricaoCidadePrestador=String[30]
• UFPrestador=String[2]
• UFTomador=String[2]
• ValorISS=String[10]
• CodigoItemListaServico=String[256]
• BairroTomador=String[50]
• ValorCredito=String[10]
• ValorLiquidoNFSe=String[20]
• ValorTotalComposicao=[8]

 

 

Campos customizados para a Impressão da NFSe

• CPFCNPJPrestador=String[14]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[8]
• DescricaoCidadePrestador=String[30]
• UFPrestador=String[2]
• UFTomador=String[2]
• ValorISS=String[10]
• CodigoItemListaServico=String[256]
• DataCancelamento=String[15]
• BairroTomador=String[50]
• DataVencimentoISSQN=String[20]
• OptanteSimplesNacional=String[2]
• ValorTotal=String[10]
• ValorLiquido=String[20]
• DataEmissao=String[20]
• DescricaoNBS=String[256]
• ValorTotalComposicao=[8]

 

 

Soluções Tecnospeed

 

• Componente NFSe:     Release 8.7.53.X.
• Manager eDoc:  Release 3.0.87.X