Para realizar a exportação de uma NFSe ou RPS no formato .pdf podemos utilizar três métodos disponíveis na interface do Manager Client, são eles:
- ExportarNFSePorHandle
- ExportarNFSePorNumero
- ExportarNFSePorRPS
Todos utilizam a mesma interface de retorno. Seguem abaixo os detalhes dos métodos e de seus retornos.
Detalhes ExportarNFSePorHandle
Função: Realiza a exportação de uma NFS-e ou um RPS utilizando o identificador do registro no banco de dados do Manager SaaS/EDoc.
Classe: TspdNFSeClientX
Método: ExportarNFSePorHandle
Tipo Retorno: spdRetExportarX
Parâmetros aceitos:
Nome | Tipo | Obrigatório | Valor |
aHandle | Texto | Sim |
Número do identificador único da NFS-e no banco de dados do Manager SaaS/EDoc.
Observação: o handle é informado no retorno do envio do RPS. |
Detalhes ExportarNFSePorNumero
Função: Realiza a exportação de uma NFS-e ou um RPS através do número da NFS-e (fornecido após a prefeitura autorizar o RPS). Ou seja, somente notas AUTORIZADAS podem ser impressas por esse método.
Classe: TspdNFSeClientX
Método: ExportarNFSePorNumero
Tipo Retorno: spdRetExportarX
Parâmetros aceitos:
Nome | Tipo | Obrigatório | Valor |
aNumNFSe | Texto | Sim |
Número da NFS-e autorizada retornado pelo WebService da prefeitura. |
Detalhes ExportarNFSePorRPS
Função: Realiza a exportação de uma NFS-e ou um RPS através dos dados do RPS, deve-se observar que a nota será exportada em modelo RPS caso ainda não tenha sido autorizada. E após ser autorizada, será gerada apenas em modelo NFS-e.
Classe: TspdNFSeClientX
Método: ExportarNFSePorRPS
Tipo Retorno: spdRetExportarX
Parâmetros aceitos:
Nome | Tipo | Obrigatório | Valor |
aNumRPS | Texto | Sim |
Número do RPS enviado ao WebService da prefeitura. |
aSerieRPS | Texto | Sim |
Série do RPS. |
aTipoRPS | Texto | Sim |
Tipo do RPS enviado. Exemplos: 1 - RPS (Padrão) 2 - Nota Fiscal Conjugada (Mista) 3 - Cupom |
Atenção!
- Caso o RPS não tenha sido autorizado, a exportação será no modelo RPS , caso o mesmo já esteja autorizado, a exportação será no modelo NFSe.
- Esse caso descrito no item acima se aplica aos métodos ExportarNFSePorHandle e ExportarNFSePorRPS.
Delphi
procedure TfrmExemplo.btnExportarNFSePorHandleClick(Sender: TObject);
var
_Retorno: spdRetExportarX;
_Handle: string;
begin
if not InputQuery('Handle', 'Handle da Nota:', _Handle) then exit;
//Esse método exporta a nota através do Componente Manager Client
_Retorno := NFSe.ExportarNFSePorHandle(_Handle);
//Exibe o retorno no memo
memoRetorno.Clear;
if _Retorno.Status = Sucesso then
memoRetorno.Lines.Add('Caminho: ' + _Retorno.CaminhoArquivoPDF)
else
memoRetorno.Lines.Add('Erro: ' + _Retorno.NomeExcecao + ', ' + _Retorno.Mensagem);
end;
No exemplo acima utilizamos o método ExportarNFSePorHandle, mas o processo e o tipo de retorno é exatamente o mesmo para os demais métodos, bastando trocar a linha do exemplo onde o _Retorno recebe seu valor.
Para o método ExportarNFSePorNumero:
//Esse método exporta a nota através do Componente Manager Client
_Retorno := NFSe.ExportarNFSePorNumero(_NumeroNFSe);
Para o método ExportarNFSePorRPS:
//Esse método exporta a nota através do Componente Manager Client
_Retorno := NFSe.ExportarNFSePorRPS(_NumRPS,_SerieRPS,_TipoRPS);
C#
private void ExportarNFSe_Click(object sender, EventArgs e)
{
spdRetExportarX Retorno = null;
string Handle= InputBox("Handle da Nota", "Handle da Nota:", "");
if (Handle != "")
{
//Esse método exporta a NFSe através do Componente Manager Client
Retorno = NFSe.ExportarNFSePorHandle(Handle);
//Exibe o retorno do memo
if (Retorno.Status == spdManagerClientX.TStatus.Sucesso)
memoRetorno.Text = "Caminho: " + Retorno.CaminhoArquivoPDF + "\n";
else
memoRetorno.Text = "Erro: " + Retorno.NomeExcecao + ", " + Retorno.Mensagem;
}
}
Para o método ExportarNFSePorNumero:
//Esse método exporta a NFSe através do Componente Manager Client
Retorno = NFSe.ExportarNFSePorNumero(NumeroNFSe);
Para o método ExportarNFSePorRPS:
//Esse método exporta a NFSe através do Componente Manager Client
Retorno = NFSe.ExportarNFSePorRPS(_NumRPS,_SerieRPS,_TipoRPS);
Visual Basic 6
Private Sub btnExportarNFSe_Click()
Dim Retorno As spdRetExportarX
Dim Handle As String
Chave = InputBox("Handle da Nota:", "Handle da Nota", "")
'Esse método exporta a NFSe através do Componente Manager Client
Set Retorno = NFSe.ExportarNFSePorHandle(Handle)
'Exibe o retorno do memo
If Retorno.Status = Sucesso Then
memoRetorno.Text = "Caminho: " + Retorno.CaminhoArquivoPDF + vbCrLf
Else
memoRetorno.Text = "Erro: " + Retorno.NomeExcecao + ", " + Retorno.Mensagem
End If
End Sub
Para o método ExportarNFSePorNumero:
'Esse método exporta a NFSe através do Componente Manager Client
Set Retorno = NFSe.ExportarNFSePorNumero(NumeroNFSe)
Para o método ExportarNFSePorRPS:
'Esse método exporta a NFSe através do Componente Manager Client
Set Retorno = NFSe.ExportarNFSePorRPS(NumRPS,SerieRPS,TipoRPS)
Retorno
O tipo spdRetExportarX possui os seguintes campos:
Campo | Tipo | Descrição |
Status | Constante | Retorna o status da operação: Sucesso ou Erro. |
NomeExcecao | Texto | Em caso de erro retorna a classe da Exception. |
Mensagem | Texto | Retorna a descrição da resposta do servidor. |
CaminhoArquivoPDF | Texto | Retorna a URL do arquivo .PDF |
Comentários
0 comentário
Por favor, entre para comentar.