Para realizar a consulta as NF-e´s registradas no banco de dados do Manager eDoc, devemos gerar um arquivo texto obedecendo o preenchimento através da tabela seguinte:
| Nome | Descrição |
| Filtro |
Aqui você vai informar o filtro da sua consulta, exemplo: situacao = AUTORIZADA and dtautorizacao >= '02/08/2020 10:59:41' Atenção! O filtro executa somente condições simples, com as cláusulas AND e OR e o uso de parênteses. |
| Ordem | Ordena a consulta, exemplo: handle desc |
| Limite |
Limite de registros que a consulta deve retornar. Atenção! O valor máximo é definido em um propriedade na configuração do Manager eDoc e o valor padrão é de 5000 registros. |
| Inicio |
Define a partir de qual registro do resultado da consulta deve ser retornado. O Inicio refere-se a posição do registro dentro do resultado da consulta e não faz referência ao handle (id) do registro em si. |
| Visao | Determina em qual tabela a consulta será realizada. Deve ser preenchido apenas na consulta de numerações inutilizadas (TspdNFeVWInutilizacao). |
| FieldDelimiter | Delimitador que tem a função de separar os campos da consulta. Exemplo: ; |
Exemplo de um arquivo preenchido:
Campos=handle,situacao
Filtro=handle=9088
Ordem=situacao asc
Inicio=50
Limite=100
Visao=TspdNFe
FieldDelimiter=;
Campos
É possível realizar a consulta utilizando os seguintes campos:
| Campo | Descrição |
| handle | Identificador único do registro na base de dados do Manager eDoc. |
| chave | Chave da NF-e. |
| situacao |
Situação da NF-e. Exemplos: AUTORIZADA, CANCELADA |
| nnf | Número da NF-e. |
| codnf | Código numérico identificador do contribuinte da NF-e. |
| nrecibo | Número do recebido de recepção da SEFAZ. |
| nprotenvio | Número do protocolo do envio da NF-e. |
| nprotcanc | Número do protocolo do cancelamento da NF-e. |
| nprotinutil | Número do protocolo de inutilização da numeração da NF-e. |
| nregdpec | Número do protocolo de envio em contingência DPEC. |
| modoentrada |
Modo do Manager eDoc no qual a nota foi registrada no envio. Pode ter os valores: Normal, SVCAN, SVCRS, EPEC e FSDA |
| modosaida |
Modo do Manager eDoc no qual a nota chegou a sua situação final (Autorizada, Cancelada, Rejeitada, Denegada e etc). Pode ter os valores: Normal, SVCAN, SVCRS, EPEC e FSDA |
| cnpj | CNPJ do Emissor da NF-e. |
| serie | Série da numeração da NF-e. |
| motivo | Descrição do status da resposta da SEFAZ. |
| dtautorizacao | Data de autorização da NF-e. |
| dtcadastro | Data de cadastro da NF-e na base de dados do Manager eDoc. |
| dtcancelamento | Data de cancelamento da NF-e. |
| dtemissao | Data de emissão da NF-e. |
| impresso |
Indica se a NF-e já foi impressa. Valores possíveis: Sim - Já impressa Não - Não impressa |
| envemail |
Indica se a NF-e já foi enviada por e-mail ao destinatário. Valores possíveis: Sim - Já enviada Não - Não enviada |
| E-mail do destinatário da NF-e. | |
| docdestinatario | Número do documento do destinatário da NF-e. (CNPJ, CPF) |
| nomedestinatario | Nome do destinatário da NF-e. |
| idgrupo | Identificador único do grupo do Manager EDoc ao qual o CNPJ do emissor da NF-e faz parte. |
| idintegracao | Identificador único da NF-e com a TecnoSpeed. |
| nlote | Número do lote a qual a NF-e pertence. |
| numero | Número da NF-e. |
| dhdpec | Data e hora da entrada em contingência DPEC. |
| nomegrupo | Nome do grupo do Manager EDoc ao qual o CNPJ do emissor da NF-e faz parte. |
| xjustcancelamento | Descrição da justificativa de cancelamento da NF-e. |
| ambiente |
Ambiente o qual a NF-e foi enviada. Homologação ou Produção. |
| impressora | Nome da impressora utilizada para impressão da NF-e. |
| origem |
Origem da NF-e. Valores possíveis: 1 - Emitida a Terceiros 2 - Recebida 3 - Interna |
| sincronizadopm |
Indica se a NF-e foi impresso utilizando a ferramenta PrintManager da TecnoSpeed. Valores possíveis: 1 - Impresso 0 - Não Impresso |
| cstat | Código do status da resposta da SEFAZ. Conforme manual do contribuinte. |
| importado |
Indica se a NF-e foi importada para a base do Manager eDoc. Valores possíveis: 0 - Não 1 - Sim |
| valortotal | Valor Total da NF-e. |
| destinada |
Indica se a NF-e foi gravada via o processo de consulta destinadas (Que utiliza o WebService da SEFAZ). Valores possíveis: 0 - Não 1 - Sim |
| xmldestinatario | XML Destinatário da NF-e conforme padrão definido no manual do contribuinte. |
É possível realizar a consulta de uma inutilização passando o valor TspdNFeFaixaInut no parâmetro Visao e utilizando os seguintes campos:
| Campo | Descrição |
| cnpj | CNPJ do Emissor da NF-e. |
| serie | Série da faixa de numeração. |
| nfini | Valor inicial da faixa de numeração. |
| nffin | Valor final da faixa de numeração. |
| nrprotocolo | Número do protocolo de inutilização da faixa de numeração. |
| ano | Ano da Inutilização. |
| justificativa | Descrição da justificativa para realizar a inutilização. |
| ambiente |
Indica em qual ambiente da SEFAZ a inutilização foi executada. Valores possíveis: 1 - Produção. 2 - Homologação. |
Retorno
Dentro do arquivo da pasta RETORNO teremos o resultado do processamento da consulta, na ordem em que os parâmetros foram informados.
Exemplo:
// Filtro: chave, situacao, serie
41150408187168000160556660000006671000000012,CANCELADA,667
Atenção! Caso o parâmetro Campos da requisição estiver vazio, o retorno do Manager eDoc irá conter todos os campos disponíveis para consulta conforme a tabela de campos disponíveis.
Caso nenhum registro for encontrado, o arquivo na pasta RETORNO terá seu conteúdo vazio.
Observação
As possíveis situações para a situação de uma NF-e no Manager eDoc são:
- Autorizada: Nota autorizada pela SEFAZ.
- Cancelada: Cancelamento autorizado pela SEFAZ.
- Enviada: Nota fiscal enviada para SEFAZ, mas sem retorno da requisição de envio (Nesse caso não sabemos se a nota foi autorizada ou rejeitada).
- Registrada: Nota fiscal gravada na base de dados do Manager SaaS, mas por alguma falha a nota não foi enviada a SEFAZ até o momento. (Normalmente por problemas de conexão).
- Rejeitada: Nota fiscal rejeitada pela SEFAZ e portanto não autorizada.
- Inutilizada: Indica que a faixa de numeração da nota fiscal já foi inutilizada.
- Recebida: Indica que a nota fiscal foi enviada e a SEFAZ retornou que a nota foi recebida e ainda não tem uma situação final (autorizada ou rejeitada).
- Denegada: Indica que a nota fiscal não foi autorizada devido ao emitente possuir alguma irregularidade em seu cadastro junto a SEFAZ ou alguma pendência.
Comentários
0 comentário
Por favor, entre para comentar.