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.
- 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"). Neste caso, abrir ticket para o desenvolvimento confirmar se é possível implementar o cancelamento.
- 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
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.
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.