Para realizar a consulta das NFC-e´s enviadas ao Manager SaaS/EDoc basta utilizar o método ConsultarNFCe informando o filtro da consulta e a ordem da mesma. Segue abaixo os detalhes do método e de seu retorno.
Detalhes ConsultarNFCe
Função: Obter informações de notas que foram enviadas ao Manager SaaS/EDoc.
Classe: TspdNFCeClientX
Método: EnviarNFCe
Tipo Retorno: spdRetConsultaNFCeListX
Parâmetros aceitos:
Nome | Tipo | Obrigatório | Valor |
aFiltro | Texto | Não |
Condição para refinar os resultados da consulta. É Case Sensitive. Exemplo: situacao='REJEITADA' |
aOrdem | Texto | Não |
Ordena a consulta. Exemplo: Handle desc |
Atenção! Caso nenhum parâmetro for informado, a consulta irá executar e trazer todos os registros de acordo com o máximo de registros retornados por consulta configurado no Manager EDoc. No Manager SaaS o limite é fixo em 100 registros por consulta.
Delphi
procedure TfrmConsultarNFCe.btnConsultarNFCeClick(Sender: TObject);
var
_Retorno: spdRetConsultaNFCeListX;
I: Integer;
begin
//Esse metodo faz a consulta no Manager eDoc pelo Componente Manager Client
_Retorno := frmExemplo.NFCe.ConsultarNFCe(edtFiltro.Text, edtOrdem.Text);
frmExemplo.memoRetorno.Clear;
//Após capturar o retorno, faremos um loop nas notas encontradas
if _Retorno.Status = Sucesso then
begin
if _Retorno.Count = 0 then
frmExemplo.memoRetorno.Lines.Add('Nenhum resultado encontrado');
for I := 0 to _Retorno.Count - 1 do
begin
frmExemplo.memoRetorno.Lines.Add('Chave: ' + _Retorno.Item(I).Chave);
frmExemplo.memoRetorno.Lines.Add('Situação: ' + _Retorno.Item(I).situacao);
frmExemplo.memoRetorno.Lines.Add('Numero da Nota: ' + _Retorno.Item(I).numeroNFCe);
frmExemplo.memoRetorno.Lines.Add('Valor Total: ' + _Retorno.Item(I).valorTotal);
frmExemplo.memoRetorno.Lines.Add(''); //Quebra uma linha para separar os itens da consulta
end;
end
else
begin
frmExemplo.memoRetorno.Lines.Add('Erro: ' + _Retorno.NomeExcecao + ', ' + _Retorno.Mensagem);
end;
Self.Close;
end;
Atenção!
- O retorno da consulta é uma lista e deve ser tratado como um array.
C#
private void btnConsultarNFCe_Click(object sender, EventArgs e)
{
string s = ConsultaNFCeForm("Consulta", "Exemplo Manager Client:", "");
if ((s != "fechar") && (s != ""))
{
string[] lines = Regex.Split(s, "\r\n");
int i;
string edtFiltro = lines[0];
string edtOrdem = lines[1];
spdRetConsultaNFCeListX Retorno = null;
try
{
//Esse metodo faz a consulta no Manager eDoc pelo Componente Manager Client
Retorno = NFCe.ConsultarNFCe(edtFiltro, edtOrdem);
//Após capturar o retorno, faremos um loop nas notas encontradas
memoRetorno.Text = "";
if (Retorno.Status == spdManagerClientX.TStatus.Sucesso)
{
if (Retorno.Count() == 0)
{
memoRetorno.Text = "Nenhum resultado encontrado";
}
for (i = 0; i < Retorno.Count(); i++)
{
memoRetorno.Text = memoRetorno.Text + "Chave: " + Retorno.Item(i).Chave + "\n";
memoRetorno.Text = memoRetorno.Text + "Situação: " + Retorno.Item(i).situacao + "\n";
memoRetorno.Text = memoRetorno.Text + "Numero da Nota: " + Retorno.Item(i).numeroNFCe + "\n";
memoRetorno.Text = memoRetorno.Text + "\n";
}
}
else
memoRetorno.Text = "Erro: " + Retorno.NomeExcecao + ", " + Retorno.Mensagem;
}
catch (Exception ex)
{
memoRetorno.Text = ex.Message;
}
}
}
Visual Basic 6
Private Sub btnConsultarNFCe_Click()
Dim Retorno As spdRetConsultaNFCeListX
Dim I As Integer
'Esse metodo faz a consulta no Manager eDoc pelo Componente Manager Client
Set Retorno = frmExemplo.NFCe.ConsultarNFCe(edtFiltro.Text, edtOrdem.Text)
'Após capturar o retorno, faremos um loop nas notas encontradas
frmExemplo.memoRetorno.Text = ""
If Retorno.Status = Sucesso Then
If Retorno.Count = 0 Then
frmExemplo.memoRetorno.Text = "Nenhum resultado encontrado"
End If
For I = 0 To Retorno.Count - 1
frmExemplo.memoRetorno.Text = frmExemplo.memoRetorno.Text + "Chave: " + Retorno.Item(I).Chave + vbCrLf
frmExemplo.memoRetorno.Text = frmExemplo.memoRetorno.Text + "Situação: " + Retorno.Item(I).Situacao + vbCrLf
frmExemplo.memoRetorno.Text = frmExemplo.memoRetorno.Text + "Numero da Nota: " + Retorno.Item(I).numeroNFCe + vbCrLf
frmExemplo.memoRetorno.Text = frmExemplo.memoRetorno.Text + vbCrLf
Next I
Else
frmExemplo.memoRetorno.Text = "Erro: " + Retorno.NomeExcecao + ", " + Retorno.Mensagem
End If
Me.Hide
End Sub
Retorno
O tipo spdRetConsultaNFCeListX 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. |
Item | Array do tipo spdRetConsultaNFCeX | Lista com os retornos. |
O tipo spdRetConsultaNFCeX possui os seguintes campos:
Campo | Tipo | Descrição |
handle | Texto | Numero do identificador único do registro da NFC-e no banco de dados do Manager SaaS/eDoc. |
chave | Texto | Chave da NFC-e. |
situacao | Texto |
Situação da NFC-e.
Exemplo: AUTORIZADA, REJEITADA |
numeroNFe | Texto | Número da NFC-e. |
codnf | Texto |
Código da NFC-e. |
nRecibo | Texto |
Número do recibo da NFC-e. |
nProtEnvio | Texto | Número do protocolo do envio da NFC-e. |
nProtCanc | Texto | Número do protocolo do evento de cancelamento da NFC-e. |
nProtInutil | Texto | Número do protocolo de inutilização da numeração da NFC-e. |
modoEntrada | Texto |
Descreve o modo de operação do Manager SaaS/EDoc quando a NFC-e foi recebida pelo Manager.
Exemplo: Normal, Contingencia Offline.
|
modoSaida | Texto |
Descreve o modo de operação do Manager quando a NFC-e foi enviada a SEFAZ.
Exemplo: Normal, Contingencia Offline. |
CNPJ | Texto | O CNPJ do emissor da NFC-e. |
serie | Texto | Número da série da NFC-e. |
motivo | Texto | Descrição do motivo do retorno da SEFAZ. |
dtAutorizacao | Texto | Data de autorização da NFC-e. |
dtCadastro | Texto | Data de cadastro na base do Manager. |
dtCancelamento | Texto | Data de cancelamento da NFC-e. |
dtEmissao | Texto | Data de emissão da NFC-e. |
impresso | Texto |
Indica se a NFC-e já teve seu DANFCE impresso.
1 - Já Impresso. 0 - Ainda sem imprimir.
|
Texto | E-mail do destinatário da NFC-e. | |
docDestinatario | Texto | Número do documento do destinatário da NFC-e. |
nomeDestinatario | Texto | Nome do destinatário da NFC-e. |
idGrupo | Texto | Número de identificação do grupo no qual o CNPJ do emissor da NFC-e faz parte. |
idIntegracao | Texto | Número de identificação da NFC-e pelo emissor. |
nLote | Texto | Número do lote de envio da NFC-e. |
nomeGrupo | Texto | Nome do grupo do Manager SaaS/EDoc ao qual o CNPJ do emissor faz parte. |
Ambiente | Texto |
Ambiente no qual a NFC-e foi emitida. Pode ser:
1 - Produção. 2 - Homologação. |
impressora | Texto | Nome da impressora na qual a NFC-e foi impressa. |
origem | Texto |
Origem da NFC-e. Podendo ser:
1 - Emitida a Terceiros. |
cStat | Texto | Código do status da resposta da SEFAZ. |
valorTotal | Texto | Valor total da NFC-e. |
Comentários
0 comentário
Por favor, entre para comentar.