rNFe_ConsultarPorIdentificador¶

Realiza uma consulta de NF-e no servidor do NFePack por um identificador

Método¶

int CALL rNFe_ConsultarPorIdentificador(emissor_nfce* e, const char* identificador, char* chave, char* situacaoOperacao, char* status, char* protocolo, char* digval, char* codigoErro, char* descricaoErro, char* deveReabrirVenda, const char* reservado1, const char* reservado2, const char* reservado3, const char* reservado4, const char* reservado5);

Parâmetros¶

Nome	Descrição
e	Handle para o emissor_nfe
identificador	Identificador a ser consultado.
chave	O Buffer que receberá a chave da NF-e (44 Caracteres).
situacaoOperacao	O Buffer que receberá a Situação da Operação da NF-e 1 - Sucesso 2 - Erro 3 - Denegada 4 - Sem Valor - Cancelada ou Inutilizda 5 - Não Localizada 6 - Em Processamento (2 Caracteres máx.).
status	O Buffer que receberá o status da NF-e contido no servidor do NFePack (2 Caracteres máx.)
protocolo	O Buffer que receberá o protocolo da NF-e (30 Caracteres máx.)
digval	O Buffer que receberá o DigVal da NF-e (28 Caracteres máx.)
codigoErro	O Buffer que contém a código do erro. (5 Caracteres máx.)
descricaoErro	O Buffer que contém a descrição da rejeição, quando a NF-e está rejeitada. (513 Caracteres máx.)
deveReabrirVenda	O Buffer que contém a indicação se deve reabrir a venda usando o método eNFe_ReabrirVenda (0: Não deve, 1; Deve)
reservado1	Reservado para uso futuro
reservado2	Reservado para uso futuro
reservado3	Reservado para uso futuro
reservado4	Reservado para uso futuro
reservado5	Reservado para uso futuro

Retornos¶

Codigo	Descrição
1	OK
10311	Erro inesperado ao consultar a nota.
10315	Problema na comunicação com o servidor. (Uma reconsulta pode resolver o problema)
10205	Erro ao processar resposta do web service de integracação. (versões do agente e retaguarda incompatíveis pode ocasionar este problema)
10318	Falha na rotina da retaguarda (parâmetros de erro serão preenchidos com o erro da retaguarda)

Exemplos¶

char[] chave = new char[44+1];
char[] situacaoOperacao = new char[2+1];
char[] status = new char[2+1];
char[] protocolo = new char[15+1];
char[] digVal = new char[28+1];
char[] codigoErro = new char[5+1];
char[] descricaoErro = new char[512+1];
char[] deveReabrirVenda = new char[1+1];
int retorno = rNFe_ConsultarPorIdentificador(handleEmissor,
                                             identificador,
                                             chave,
                                             situacaoOperacao,
                                             status,
                                             protocolo,
                                             digVal,
                                             codigoErro,
                                             descricaoErro,
                                             deveReabrirVenda,
                                             "", "", "", "", "");
//chave terá o valor "13141275587915020765650030000000051550351537"
//situacaoOperacao terá o valor "1"
//status terá o valor "6"
//protocolo terá o valor "113140003271818"
//digVal terá o valor "TS0tq6wlCpixyYknPEPqG4Cutas="
//codigoErro terá o valor ""
//descricaoErro terá o valor ""
//deveReabrirVenda terá o valor "0"

//-------------Exemplo com tratamentos-------------
int numeroDeTentativas = 3;
int retorno = 0;
for(int i = 0; i &lt; numeroDeTentativas; i++) {
    retorno = rNFe_ConsultarPorIdentificador(handleEmissor,
                                             "ID_10",
                                             chave,
                                             situacaoOperacao,
                                             status,
                                             protocolo,
                                             digVal,
                                             urlConsulta,
                                             codigoErro,
                                             descricaoErro,
                                             deveReabrirVenda,
                                             "", "", "", "");
    if(retorno == 1) break;
    sleep(2);
}
if(retorno == 1) {
    tratar_resposta();
    //se não encontrar a chave da nota para o identificador o retorno é '1' e a situacaoOperacao é '5'
}
else {
    tratar_quando_nao_consegue_consultar();
}