Tópicos deste artigo
- Manual do web service
- Portais disponíveis
- Métodos disponíveis
- Tipo de impressão
- Observações gerais
- Observações específicas por cidade
- Emissão pelo ManagerEDoc/ManagerSaas
- Observações sobre a geração do XML
- Erros comuns
- Campos customizados para a impressão do RPS
- Campos customizados para a impressão da NFSe
Manual de integração com o webservice
Portais Disponíveis
- Produção
- Homologação
Métodos Disponíveis
- Envio.
- Assíncrono.
- Não necessita envio sequencial¹
- Aceita envio de lote de RPS
- Consulta Situação de lote.
- Consulta de lote.
- Consulta de NFSe por RPS.
- Consulta de NFSe.
- Consultar Notas Tomadas.
- Cancelamento de NFSe.
¹ Não 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 gerais
- Antes de realizar a emissão de notas, é necessário verificar no cadastro do contribuinte no Portal da Prefeitura, pois é importante que os dados do mesmo estejam preenchidos, principalmente a Inscrição Municipal.
- A falta desses campos causará problemas na execução dos métodos disponíveis. Caso os campos não estejam preenchidos, entre em contato com a prefeitura para realizar a atualização dos dados.
- Em alguns municípios desse padrão, não está disponível o cancelamento de notas por webservice em ambiente de homologação, no XML de envio de cancelamento, o código IBGE vai ser "0".
- Os dados de faturas/parcelas devem ser informados no tx2 padrão único da seguinte forma:
- Exemplo.
INCLUIRFORMAPAGAMENTO
QuantidadeParcelas=3
TipoPagamento=3
Parcela=1
DataVencimentoParcela=2020-01-30
ValorParcela=0.10
SALVARFORMAPAGAMENTO
- Os dados de faturas/parcelas devem ser informados no tx2 da cidade da seguinte forma:
- Exemplo.
INCLUIRCONDICAOPAGAMENTO
QtdParcelas=3
TipoPagamento=3
Parcela=1
DataVencimentoParcela=2020-01-30
ValorParcela=0.10
INCLUIRCONDICAOPAGAMENTO
- É possível utilizar o DataSet de Serviço para informar mais de um serviço.
INCLUIRSERVICO
DiscriminacaoServico=DISCRIMINACAO DO SERVICO 1
QuantidadeServicos=1
ValorUnitarioServico=0.10
AliquotaServico=2
CodigoItemListaServico=1005
ValorServicosItem=0.10
BaseCalculoServico=0.10
ValorDeducoesServico=0.00
DescontoCondicionadoServico=0.00
DescontoIncondicionadoServico=0.00
SALVARSERVICO
- Não é possível informar os seguintes caracteres no campo 'DiscriminacaoServico' do TX2:
- '[', ']', '{', '}', '<', '>'. Pois os mesmos quebram a identação do XML.
- Os mesmos serão retirados, caso forem informados.
- Os campos ValorDeducoesServico, DescontoCondicionadoServico e DescontoIncondicionadoServico são utilizados apenas no envio, no momento o layout de impressão do padrão não os utiliza.
Observações especificas por cidade
Cidade | Observação |
Divinópolis/MG |
|
Resende/RJ |
|
Xanxerê/SC |
|
Varginha/MG |
|
Gramado/RS |
|
Emissão pelo ManagerEdoc/ManagerSaaS
- Por conta de algumas notas estarem em divergências com a prefeitura, pois a consulta era feita em um tempo. Criamos uma configuração onde foi dado alguns segundos de espera no momento antes da consulta, para der tempo da nota ser processada na prefeitura. A propriedade chama-se TempoEsperaDaConsultaFluxoDuplicidade onde ela espera um valor em milissegundos para dar uma "pausa" antes de começar a consulta.
Observações sobre a geração do XML
- O código do serviço segue o que está descrito na LC-116.
- Não é obrigatório informar o código CNAE, entretanto, caso informado será gerado no XML.
- Código CNAE segue a tabela nacional com 7 dígitos.
- Tanto a emissão através do portal ou via webservice, não utilizam o código de tributação do município, entretanto, caso informado será gerado no XML.
- O "Código de Tributação do Município" é um código proprietário de cada município, ou seja, cada município tem o seu, não existe um padrão, sendo assim é necessário contatar o município para identificar qual a codificação utilizada. Algumas prefeituras adotam o codificação da lista de serviço da Lei Complementar 116/03 ampliada, outras adotam o código CNAE.
- Acentuação muitas vezes causa problema de rejeição no servidor. Devido a isso está sendo removido os acentos do RPS.
- Para adicionar o código Cnae na impressão de NFSe, use o campo customizado CodigoCnaes, de forma que é possível preencher com multiserviços.
- Exemplo: CodigoCnaes=911325,823912
Erros comuns
- E146-"Informação de optante pelo simples nacional inválida. (Utilize um dos tipos: 1 - Sim; 2 - Não.)"
Verifique se as informações de Simples Nacional foram enviadas de acordo com o cadastro do prestador no portal da prefeitura.
Campos customizados para a impressão do RPS
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- InscricaoEstadualPrestador=String[40]
- EnderecoPrestador=String[80]
- CodigoMunicipioPrestador=String[10]
- NumeroEnderecoPrestador=String[7]
- ComplementoEnderecoPrestador=String[80]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- UfPrestador=String[2]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- CelularPrestador=String[20]
- NomeFantasiaTomador=String[80]
- InscricaoEstadualTomador=String[40]
- CelularTomador=String[20]
- SitePrestador=String[80]
- ValorTributoFederal=string[20]
- ValorTributoEstadual=string[20]
- ValorTributoMunicipal=string[20]
- PorcentagemTributoFederal=string[20]
- PorcentagemTributoEstadual=string[20]
- PorcentagemTributoMunicipal=string[20]
- Pagamento=string[80]
- ValorTTS=string[20]
- ValorTotal=string[20] (Este campo aparecerá na impressão apenas se o ValorTTS também estiver preenchido)
Campos customizados para a impressão da NFSe
- InscricaoEstadualPrestador=String[40]
- InscricaoEstadualTomador=String[40]
- CelularPrestador=String[20]
- SitePrestador=String[80]
- NomeFantasiaTomador=String[80]
- CelularTomador=String[20]
- ValorTributoFederal=string[20]
- ValorTributoEstadual=string[20]
- ValorTributoMunicipal=string[20]
- PorcentagemTributoFederal=string[20]
- PorcentagemTributoEstadual=string[20]
- PorcentagemTributoMunicipal=string[20]
- Pagamento=string[80]
- ValorTTS=string[20]
- ValorTotal=string[20] (Este campo aparecerá na impressão apenas se o ValorTTS também estiver preenchido)
- CodigoCnaes=string[200]
Impressão da NFSe - DataSet Parcelas (verificar observação acima)
- Parcela=String[255]
- Vencimento=String[255]
- Valor=String[255]
Soluções Tecnospeed
- Componente NFSe: Release 8.7.45.X.
- Manager eDoc: Release 3.0.79.X
Comentários
0 comentário
Por favor, entre para comentar.