Manual de integração com o webservice
Portais Disponíveis
- Produção
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe.
- Cancelamento de NFSe.
Observações
- Formato de Autenticação: "Login=99999999999999;senha=123"
- Para a consulta de NFSe, deve ser informado o código verificador de autencidade
- Para o Cancelamento é necessário utilizar a chave numeroNFSE|chaveCancelamento___
- No cancelamento, também é possível informar o parâmetro extra MotivoCancelamento. Ex: Login=00000000000000;Senha=123;MotivoCancelamento=Teste
- Por ser um valor obrigatório no XML, caso não seja informado nada no MotivoCancelamento o componente preenche com a seguinte mensagem: NFSe cancelada à pedido do prestador.
- Impressão de RPS pelo componente disponível.
- Caso o tomador seja órgão público informar o campo no campo DescricaoDocumentoTomador o valor "OP".
-
A partir do dia 01/06/2020 o padrão IPM possuirá a inclusão de múltiplas parcelas. O preenchimento no arquivo TX2 de integração fica conforme exemplo abaixo:
INCLUIRFORMAPAGAMENTO
TipoPagamento=1 -> Tipo da forma de Pagamento, verificar possíveis valores abaixo.
Parcela=1 -> Número da parcela
DataVencimentoParcela=2020-05-27 -> Data do vencimento da parcela, deve estar no formato yyyy-mm-dd
ValorParcela=2.00 -> Valor da parcela.
SALVARFORMAPAGAMENTO
Valores referentes ao tipo da forma de pagamento:
1 - À vista
2 - À prazo
3 - Na Apresentação
4 - Cartão de Débito
5 - Cartão de Crédito
Geração do XML - Campos Importantes
- O código do serviço segue o que está descrito na LC-116.
- Caso não esteja utilizando o TecnoNFSe, o código deve ser informado sem pontuação.
- O campo CodigoCNAE não é utilizado no esquema. E o campo CodigoTributacaoMunicipio é facultativo.
- Caso não esteja utilizando o padrão único, a alíquota deve ser informada com o valor inteiro, utilizando ',' para separador decimal. Ex: Aliquota=5,00.
Campos customizados para a impressão
Impressão do RPS
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- CodigoMunicipioPrestador=String[10]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[10]
- ComplementoEnderecoPrestador=String[20]
- BairroPrestador=String[20]
- CepPrestador=String[20]
- TelefonePrestador=String[40]
- EmailPrestador=String[40]
Impressão da NFSe
A impressão de NFSe pode ser feita por um link retornado no envio e na consulta. Para obter esse link, basta utilizar o comando auxiliar ObterLinkImpressaoNFSe ou pode ser feita através do comando ObterPDF onde o PDF da nota é baixado, conforme exemplo abaixo:
Parâmetros:
- Xml de uma NFSe Autorizada.
- Caminho completo e o nome do PDF.
Exemplo de implementação:
procedure TfrmExemplo.btnObterPDFClick(Sender: TObject);
var
_nomeComando, _nomeParametro, _valorParametro, _resposta: string;
_XmlNFSe : TStringList;
begin
_XmlNFSe := TStringList.Create;
try
_nomeComando := 'ObterPDF';
_XmlNFSe.LoadFromFile(XMLNFSE);
_nomeParametro := 'XML';
_valorParametro := _XmlNFSe.Text;
NFSe.Comando(_nomeComando).Parametros[_nomeParametro] := _valorParametro;
_nomeParametro := 'CaminhoCompletoArquivo';
_valorParametro := 'H:\ImpressaoIPM.pdf';
NFSe.Comando(_nomeComando).Parametros[_nomeParametro] := _valorParametro;
_resposta := NFSe.Executar(_nomeComando);
finally
_XmlNFSe.Free;
end;
end;
Resposta:
'Impressão realizada na pasta: H:\ImpressaoIPM.pdf'
Soluções Tecnospeed
- Componente NFSe: Release 8.7.50.X.
- Manager eDoc: Release 3.0.84.X.
Comentários
0 comentário
Por favor, entre para comentar.