Manual de integração com o webservice
Portais Disponíveis
- Produção
- Homologação
Métodos Disponíveis
- Envio.
- Assíncrono.
- Consulta Situação de lote.
- Consulta de lote.
- Consulta de NFSe por RPS.
- Consulta de NFSe.
- Consultar Notas Tomadas.
- Cancelamento de NFSe.
Observações
- ATENÇÃO: antes de realizar a emissão de notas, verifique o cadastro do contribuinte no Portal da Prefeitura. É 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.
- Para o município de RESENDE-RJ, Solicitar liberação para emissão via WebService, para instruções, clique aqui
- O método de cancelamento não está disponível para o munícipio de Xanxerê - SC. É possível fazer apenas a substituição da nota direto no portal da prefeitura.
- 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.
Notas com Divergências no Edoc/SaaS
- 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 demos 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.
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, caso informado será gerado no XML.
- Código CNAE segue a tabela nacional com 7 digítos.
- 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.
- 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.
- Acentuação muitas vezes causa problema de rejeição no servidor. Devido a isso está sendo removido os acentos do RPS.
Campos customizados para a impressão
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)
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)
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.