Manual de Integração com o WebService
Portais Disponíveis
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe Por RPS.
- Cancelamento de NFSe.
Observações
- Não possui envio em Lote, sendo o mesmo limitado a uma nota por vez.
- Para realizar um Envio deverá ser informado no parâmetro extra a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e a Senha.
- O parâmetro extra deve ser informado da seguinte forma:
- Login=GpqP7ysDnwo3y61sd+AJtw==;Senha=XXXXXXX
- O parâmetro extra deve ser informado da seguinte forma:
- Para realizar uma Consulta de NFSe por RPS deverá ser informado no parâmetro extra a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e o CPF ou CNPJ do Tomado.
- O parâmetro extra deve ser informado da seguinte forma:
- Login=GpqP7ysDnwo3y61sd+AJtw==;CpfCnpjTomador=11111111111111
- O parâmetro extra deve ser informado da seguinte forma:
- Para realizar um Cancelamento de NFSe deverá ser informado no parâmetro extra o Motivo do cancelamento, a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e a Senha + Key (Código da Chave de Acesso) separado por underline "_" .
- O parâmetro extra deve ser informado da seguinte forma:
- MotivoCancelamento=Nota emitida para testes;Login=GpqP7ysDnwo3y61sd+AJtw==;Senha=XXXXXX_X
- O parâmetro extra deve ser informado da seguinte forma:
- A impressão de RPS não está disponível no momento da homologação.
- A impressão desse padrão não possui quebra de linha na discriminação do serviço.
- Caracteres especiais como: ( !@#$%*()'"-=+/.,:?][{}\/;.|:& < > " ' ) e acentos não devem ser informados, pois, o padrão ISSMAPAPI não consegue ler esses valores, o que ocasiona em erros internos do WebService.
- ATENÇÃO: No Manager eDoc/SaaS os dados de autenticação devem ser passados da seguinte forma:
- Login: Deve ser informada a Chave de Acesso obtida no portal da prefeitura.
Senha: Deverá ser informada da seguinte maneira: XXXXXX_YY, onde "XXXXXX" refere-se a senha do portal da prefeitura do contribuinte , e "YY" refere-se a Key (Código da Chave de Acesso) (geralmente 2 dígitos), obtido também o portal da prefeitura. - Atenção, Chave de Acesso é diferente do Código da Chave de Acesso.
- No TX2 deve-se passar o campo "TipoCodificacao=YY", onde "YY" refere-se ao Código da Chave de Acesso.
Relação dos campos do TX2, seus valores e significados
* -> Campos Obrigatórios
- * formato=tx2 - Formato do arquivo Tx2
- * padrao=TecnoNFSe - Padrão único TecnoNFSe
- * NomeCidade=FarturaSP- Identificação da cidade no TecnoNFSe
- * INCLUIRRPS - Identificador de inclusão do RPS
- * TipoCodificacao - Identificador do Código da Chave de Acesso "KEY" (Obtido no portal da prefeitura junto com a Chave de Acesso)
- * NumeroRPS - Número do RPS que será transformado no número da nota (Deve conter até 19 caracteres)
- * DataEmissao - Deve ser informado no formato YYYY-MM-DD
- InscricaoMunicipalPrestador - Inscrição municipal do prestador (Máximo 30 caracteres)
- * CpfCnpjPrestador - Documento do Prestador, informar 11 caracteres para CPF ou 14 para CNPJ.
- * RazaoSocialPrestador - Razão Social do Prestador (Máximo 120 caracteres).
- * CepPrestador - Máximo 10 caracteres
- * EnderecoPrestador - Máximo 120 caracteres
- * CodigoCidadePrestador - Código IBGE da cidade do Prestador (Deve conter exatamente 7 caracteres).
- InscricaoEstadualTomador - Inscrição estadual do tomador (Não obrigatório, Máximo 30 caracteres)
- * CpfCnpjTomador - Documento do tomador, informar 11 caracteres para CPF ou 14 para CNPJ.
- * RazaoSocialTomador - Razão social do tomador (Máximo 120 caracteres)
- * EnderecoTomador - Máximo 120 caracteres
- * CodigoCidadeTomador - Código IBGE da cidade do Tomador (Deve conter exatamente 7 caracteres).
- UFTomador - Máximo 2 caracteres
- DescricaoCidadeTomador - Máximo 100 caracteres
- * CepTomador - Máximo 10 caracteres
- EmailTomador - Máximo 60 caracteres
- * CodigoCidadePrestacao - Código IBGE da cidade onde o serviço foi prestado (Deve conter exatamente 7 caracteres).
- * DiscriminacaoServico - Máximo 4000 caracteres
- * ValorServicos - Máximo 14 caracteres
- * BaseCalculo - Máximo 14 caracteres
- * CodigoItemListaServico - Máximo 5 caracteres
- * AliquotaISS - Máximo 4 caracteres, informada sem dividir. Exemplo: 2.00
- ValorInss - Máximo 14 caracteres
- ValorIr - Máximo 14 caracteres
- ValorCsll - Máximo 14 caracteres
- ValorCofins - Máximo 14 caracteres
- ValorPis - Máximo 14 caracteres
- DescontoCondicionado - Máximo 14 caracteres
- DescontoIncondicionado - Máximo 14 caracteres
- ValorDeducoes - Máximo 14 caracteres
- * IssRetido - 1 Para SIM e 2 para Não
- SALVARRPS - Identificador para salvar o RPS
Existe um campo deste padrão que não se encaixa em nenhum campo do padrão unificado da Tecnospeed. Trata-se do campo "porcentagemOutros", que diz respeito de Outros Impostos com
retenção na fonte. Para informar este campo no tx2 deve-se colocar o caracter "@" antes do nome do campo. Desta forma:
@porcentagemOutros=0.10
Particularidades da Impressão
Impressão da NFSe
A impressão de NFSe pode ser feita por um link retornado no envio. Para obter esse link, basta utilizar o comando auxiliar ObterLinkImpressaoNFSe, conforme exemplo abaixo:
Parâmetros:
- Xml de uma NFSe Autorizada ou Cancelada.
procedure TfrmExemplo.btnObterLinkImpressaoClick(Sender: TObject);
var
_nomeComando, _nomeParametro, _valorParametro, _resposta: string;
_XmlNFSe : TStringList;
begin
_XmlNFSe := TStringList.Create;
try
_nomeComando := 'ObterLinkImpressaoNFSe';
_XmlNFSe.LoadFromFile(XMLNFSE);
_nomeParametro := 'XML';
_valorParametro := _XmlNFSe.Text;
NFSe.Comando(_nomeComando).Parametros[_nomeParametro] := _valorParametro;
_resposta := NFSe.Executar(_nomeComando);
finally
_XmlNFSe.Free;
end;
end;
Exemplo de resposta:
'https://www.issmap.com.br/ws/rps/QRCode/2/1111111111111111/20'
- O link da impressão é único para uma NFSe, independente da situação da mesma.
Comentários
0 comentário
Por favor, entre para comentar.