Documentação Técnica - Padrão iiBrasil – Central de Atendimento
Documentação Técnica - Padrão iiBrasil
27 de junho de 2022 16:53
Manual Padrão iiBrasil
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".
Portal da prefeitura de Limeira-SP
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
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 formato @NifTomador=.
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.
O padrão não possui Envio Assíncrono;
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.
Caso ocorra divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Rejeitada), 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
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.
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.