rVenda_ConsultarPorIdentificador¶
Realiza uma consulta de NFC-e no servidor do NFePack por um identificador
Método¶
int CALL rVenda_ConsultarPorIdentificador(emissor_nfce * e, const char *identificador, char *chave, char *situacaoOperacao, char *status, char *protocolo, char *digval, char *urlConsulta, char* codigoErro, char *descricaoErro, char * podeReutilizarNumero, const char *reservado1, const char *reservado2, const char *reservado3, const char *reservado4);
Parâmetros¶
| Nome | Descrição |
|---|---|
e
|
Handle para o emissor_nfce
|
identificador
|
Identificador a ser consultado.
|
chave
|
O Buffer que receberá a chave da NFC-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.).
|
protocolo
|
O Buffer que receberá o protocolo da NFC-e (30 Caracteres máx.)
|
digval
|
O Buffer que receberá o DigVal da NFC-e (28 Caracteres máx.)
|
urlConsulta
|
O Buffer que receberá a url de consulta da NFC-e (640 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.)
|
podeReutilizarNumero
|
O Buffer que contém a indicação se é possível reutilizar o número, quando não controlado pelo NFCePack (0: Não pode, 1; Pode)
|
reservado1
|
Reservado para uso futuro
|
reservado2
|
Reservado para uso futuro
|
reservado3
|
Reservado para uso futuro
|
reservado4
|
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[] podeReutilizarNumero = new char[1+1];
char[] urlConsulta = new char[640+1];
int retorno = rVenda_ConsultarPorIdentificador( handleEmissor,
"ID_10",
chave,
situacaoOperacao,
status,
protocolo,
digVal,
urlConsulta,
codigoErro,
descricaoErro,
podeReutilizarNumero,
"", "", "", "");
//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 ""
//podeReutilizarNumero terá o valor "0"
//urlConsulta terá o valor "http://homnfce.sefaz.am.gov.br/nfceweb/consultarNFCe.jsp\?chNFe=13141275587915020765650030000000221431581874&nVersao=100&tpAmb=2&cDest=99999999000191&dhEmi=323031342d31322d30395431313a33363a31382d30323a3030&vNF=1548.00&vICMS=0.00&digVal=394d5a677479476d52576e5975593563446d357751656f427847303d&cIdToken=000001&cHashQRCode=4194233056880a9a2650c3e0d6e5738f658f92ba"
//-------------Exemplo com tratamentos-------------
int numeroDeTentativas = 3;
int retorno = 0;
for(int i = 0; i < numeroDeTentativas; i++) {
retorno = rVenda_ConsultarPorIdentificador( handleEmissor,
"ID_10",
chave,
situacaoOperacao,
status,
protocolo,
digVal,
urlConsulta,
codigoErro,
descricaoErro,
podeReutilizarNumero,
"", "", "", "");
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();
}