Portais Disponíveis
- Produção
Métodos Disponíveis
- Envio:
- Síncrono.
- Consulta de NFSe por RPS;
Observações
- Para realizar todos os métodos disponíveis pelo WebService, é necessário informar o TOKEN fornecido pelo portal da prefeitura como parâmetro extra. Caso não possua o TOKEN, siga os passos abaixo:
- Para a emissão do TOKEN, o Prestador de Serviços habilitado para emissão de Nota Fiscal de Serviços Eletrônica pela Prefeitura de Limeira deverá acessar o portal da prefeitura, no módulo "NFS-e", acessar o menu "Gerenciar RPS".
- O TOKEN é de uso exclusivo do Prestador e não deve ser compartilhado. Sua validade é de até 3 meses a partir da data de geração ou até sua revogação, devendo ser emitido novamente após seu vencimento.
- Cada prestador de serviço devidamente habilitado pela Prefeitura poderá manter um TOKEN ativo para emissão do RPS.
- O TOKEN deverá ser informado da seguinte forma:
- Senha=ABC1DEFGHIJKLMNO2PQRSTUVWXY3ZA4BCDE56DZQHC
- Para a maioria das cidades, a série do RPS deve ser preenchida com o seguinte valor: RPSL.
- O erro "DEU ERRO 2" pode ocorrer quando uma nota para tomador estrangeiro for enviada sem a tag NifTomador, ou se ela for preenchida com mais de 14 caracteres, que é o limite do campo em algumas prefeituras. Para preencher esta tag no Tx2, utilizar o campo DocTomadorEstrangeiro=.
- No caso de envio de nota para tomador estrangeiro, também é necessário informar o código do país do tomador na tag CodigoPais, dessa forma, o componente irá identificar no XML que trata-se de um tomador do exterior.
- O padrão iiBrasil possui um SubDataSet referente a adição de Quartos na NFSe, para serviços referentes a hotelaria. Deve ser informado da seguinte forma no tx2 do padrão unificado:
@INCLUIRQUARTO
@CodigoInternoQuarto=2635
@QtdHospedes=2
@CheckIn=2021-02-24
@QtdDiaria=1
@ValorDiaria=1.00
@SALVARQUARTO
-
- É OBRIGATÓRIO informar o carácter "@" antes dos comandos e dos campos, pois o padrão unificado não possui nenhum campo referente a hotelaria em sua estrutura.
- Os campos referentes ao Quarto estão disponíveis na versão 11.1.78.7128 ou superior do componente NFSe
- ATENÇÃO: O padrão não possui o método de cancelamento via webservice, sendo necessário cancelar a NFS-e pelo portal da prefeitura.
Envio de RPS
- O padrão não possui Envio Assíncrono;
- Não é possível realizar o envio em Lote, sendo necessário enviar um RPS de cada vez;
Impressão
- Para realizar a impressão da NFSe pelo componente, deverá ser informado o XML de envio do RPS, pois no retorno do Envio (autorizado) e da consulta de NFSe por RPS, não retornam todos os dados necessários para a impressão ser compatível com a da prefeitura.
- Além do XML de envio do RPS, deverá ser informado os campos Customizados informados na seção "Campos customizados para a impressão".
Métodos Adicionais
- O padrão possui o método ObterLinkImpressao, o qual é possível obter o link da impressão da NFSe, direto do portal da prefeitura. Para maiores informações acesse este link: ObterLinkImpressaoNFSe.
Resolve
- Caso ocorra divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Rejeitada) ou (Enviada), o procedimento a ser realizado é um resolve, informando o Número da Nota mais o Código de Verificação separados por underline. Essa informação deve ser passada no parâmetro NumeroNFSE_CodigoVerificacao, conforme abaixo: Exemplo: NumeroNFSE_CodigoVerificacao=1234_12345678AB
- Para encontrar a Código de Verificação da nota, é necessário fazer o download do XML no portal da prefeitura e visualizar o conteúdo da tag "<CodigoVerificacao>" ;
-
Procedimentos:
- Para comunicações via API:
- terá que ser adicionado um novo parâmetro na Key, onde o mesmo é ParametroExtra, com seu valor no body que será 1234_12345678AB por exemplo.
- Para realizar via Interface Web:
- Selecione a nota desejada(apenas uma por vez), e clique no botão RESOLVE. Abrirá uma caixa de texto aonde deve ser informado a NumeroNFSE_CodigoVerificacao daquela nota separados por "_" conforme o exemplo.
-
Obs: O procedimento funcionará apenas quando:
- A nota estiver com a situação REJEITADA;
- A nota estiver com a situação ENVIADA e sem um retorno;
- Possuir um motivo de duplicidade;
- E para apenas uma nota for selecionada.
-
Obs: O procedimento funcionará apenas quando:
- Selecione a nota desejada(apenas uma por vez), e clique no botão RESOLVE. Abrirá uma caixa de texto aonde deve ser informado a NumeroNFSE_CodigoVerificacao daquela nota separados por "_" conforme o exemplo.
- Para comunicações via API:
- ATENÇÃO: após esse procedimentos, será realizado uma Consulta de NFSe por RPS, onde será comparado o Código de Verificação retornado pela prefeitura com o informado. Se os códigos forem iguais, a nota será autorizada, se não forem iguais, a nota permanecerá como rejeitada.
Atenção - Numeração de RPS no PlugNotas
Antes de configurar a emissão neste padrão, é fundamental verificar se a numeração de RPS já foi utilizada anteriormente e conferir se os dados exibidos no PDF das primeiras notas concluídas correspondem ao RPS enviado. Pois se um RPS de notas antigas for configurado, as notas antigas serão retornadas nestas mesmas emissões das notas novas, devido ao fluxo de duplicidade deste padrão.
Este comportamento ocorre porque os Webservices das prefeituras desses padrões frequentemente não retornam as requisições de envio ou respondem com erros na faixa 500.
Em alguns casos, mesmo sem retorno ou com erro, a prefeitura pode recepcionar a nota e gerar a NFS-e. O comportamento padrão do PlugNotas, nesses cenários, é reenviar a nota caso não tenha recebido retorno ou tenha obtido um erro 500. Se a prefeitura já tiver autorizado a NFS-e, esse reenvio resultará na mensagem "RPS já informado em outra NFS-e".
Para lidar com essa situação, o PlugNotas possui um fluxo automático de consultas e recuperação da nota. Ao receber a mensagem de que o RPS já foi utilizado, o sistema consulta esse número junto à prefeitura. No entanto, a resposta da prefeitura contém apenas o número da NFS-e gerada e seu código de verificação, sem informações detalhadas que confirmem se a nota retornada é de fato a enviada.
Em padrões comuns, o PlugNotas compararia os dados da NFS-e retornada antes de concluir a nota. No entanto, neste padrão específico, essa validação não é possível devido à limitação das informações fornecidas pela prefeitura.
Por isso, o PlugNotas conclui a nota sem realizar a comparação. Essa abordagem evita que notas fiquem travadas em processamento e reduz o risco de duplicidades. Se todas as notas que inicialmente não receber retorno e depois recebessem a mensagem "RPS já utilizado em outra NFS-e" fossem rejeitadas, o usuário poderia reenviar a nota com outra numeração, resultando em uma duplicidade na prefeitura.
Vale destacar que esse comportamento só apresenta riscos caso uma empresa recém-configurada no PlugNotas utilize um RPS previamente emitido por outro sistema. No entanto, dentro do próprio PlugNotas, um RPS já concluído nesse padrão não poderá ser reenviado.
Geração do XML - Campos Importantes
- O padrão utiliza número de RPS sequencial.
- O campo CodigoCnae não é obrigatório.
- O campo OutrasInformacoes será referente a tag InformacoesComplementares do XML.
Campos customizados para a impressão
Impressão do RPS
- CpfCnpjPrestador=String[20]
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- InscricaoMunicipalPrestador=String[20]
- EnderecoPrestador=String[80]
- CodigoCidadePrestador=String[10]
- NumeroPrestador=String[7]
- ComplementoPrestador=String[20]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- OptanteSimplesNacional=String[30]
- Preencher com '1' - Sim ou '2' - Não.
- ValorServicos=String[30]
- Preencher com o valor total (bruto) da NFSe.
- ValorLiquidoNfse=String[30]
- Preencher com o valor total (bruto) e subtrair os impostos.
- OutrasInformacoes=String[255]
- NumeroQuarto=String[15]
- DataSaida=String[20]
Impressão da NFSe
- CpfCnpjPrestador=String[20]
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- InscricaoMunicipalPrestador=String[20]
- EnderecoPrestador=String[80]
- CodigoCidadePrestador=String[10]
- NumeroPrestador=String[7]
- ComplementoPrestador=String[20]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- OptanteSimplesNacional=String[30]
- Preencher com '1' - Sim ou '2' - Não.
- ValorServicos=String[30]
- Preencher com o valor total (bruto) da NFSe.
- ValorLiquidoNfse=String[30]
- Preencher com o valor total (bruto) e subtrair os impostos.
- OutrasInformacoes=String[255]
- NumeroQuarto=String[15]
- DataSaida=String[20]
Soluções Tecnospeed
- Componente NFSe: Release 9.1.60.X.
- Manager eDoc: Release 4.1.X.X
Comentários
0 comentário
Por favor, entre para comentar.