✓ Efetua consulta do documento através do identificador;
✓ O campo identificador é guardado no banco de dados associado a sua rejeição ou autorização. O identificador não é salvo em casos de erros de validação ou erros não tratados;
✓ O agente guarda os identificadores do dia atual, os registros diferentes são excluídos por uma rotina de limpeza diária;
✓ Depende da execução do seguinte método, para a correta execução: nddInicializaAgente.
Sequência |
Nome |
Obrigatório |
Descrição |
1 |
identificador |
S |
Identificador da venda que será cancelada/inutilizada. |
2 |
chave |
|
Buffer que receberá a chave da NFC-e (44 caracteres). |
3 |
situacaoOperacao |
|
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.) |
4 |
status |
|
Buffer que receberá o status da NFC-e (máximo de 2 caracteres) |
5 |
protocolo |
|
Buffer que receberá o protocolo da NFC-e (máximo de 15 caracteres) |
6 |
digval |
|
Buffer que receberá o DigVal da NFC-e (máximo de 28 caracteres) |
7 |
urlConsulta |
|
Buffer que receberá a url de consulta da NFC-e (máximo de 640 caracteres) |
8 |
codigoErro |
|
Buffer que contém a código do erro. (máximo de 5 caracteres) |
9 |
descricaoErro |
|
Buffer que contém a descrição da rejeição, quando a NF-e está rejeitada. (máximo de 510 caracteres) |
10 |
podeReutilizarNumero |
|
Buffer que contém a indicação se é possível reutilizar o número, quando não controlado pelo Agente (0: Não pode, 1: Pode) |
A sequência dos parâmetros deve ser respeitada e todos os parâmetros devem fazer parte da chamada do método. |
|||
Retornos
Código |
Descrição |
1 |
Sucesso |
2 |
Erro |
10112 |
Problemas de configuração do AGENTE |
20199 |
Erro não tratado ao realizar integração via metodos |
✓ Caso o identificador seja encontrado o retorno será Rejeição.
Nome |
Valor |
Retorno |
1 |
Chave |
|
situacaoOperacao |
1 |
status |
8 |
protocolo |
|
digval |
|
urlConsulta |
|
codigoErro |
539 |
descricaoErro |
Rejeicao: Duplicidade de NF-e, com diferenca na chave de acesso |
podeReutilizarNumero |
0 |
✓ Caso o identificador seja encontrado o retorno será Autorização.
Nome |
Valor |
Retorno |
1 |
Chave |
13190961189288045875652520000001661744181818 |
situacaoOperacao |
1 |
status |
6 |
protocolo |
113190007439073 |
digval |
8pb2ux+RGaaadRPvfS7Qp1WGvk4= |
urlConsulta |
http://homnfce.sefaz.am.gov.br/nfceweb/consultarNFCe.jsp?p=13190961189288045875652520000001661744181818|2|2|1|D3447A5BA6CB53F5510F074305180D920EA08998 |
codigoErro |
|
descricaoErro |
|
podeReutilizarNumero |
0 |
✓ Caso o identificador não seja encontrado o retorno será:
Nome |
Valor |
Retorno |
1 |
Chave |
|
situacaoOperacao |
5 |
status |
|
protocolo |
|
digval |
|
urlConsulta |
|
codigoErro |
|
descricaoErro |
|
podeReutilizarNumero |
0 |