Para realizar a consulta as NFC-e´s registradas no banco de dados do Manager eDoc, devemos gerar um arquivo texto obedecendo o seguinte leiaute:
Campos=
Filtro=
Ordem=
Inicio=
Limite=
Visao=
FieldDelimiter=
Abaixo seguem tabela com os campos do leiaute de consulta explicados:
| Nome | Descrição |
| Campos |
Aqui você vai informar todos os campos que deseja obter da consulta, eles são separados por vírgula, por exemplo: chave, nprotenvio Abaixo segue uma tabela com os campos disponíveis para uso. |
| Filtro |
Aqui você vai informar o filtro da sua consulta, exemplo: situacao = AUTORIZADA and dtautorizacao >= '02/08/2017 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 (TspdNFCeFaixaInut). |
| FieldDelimiter | Delimitador que tem a função de separar os campos da consulta. Exemplo: ; |
Exemplo de um arquivo preenchido:
Campos=cnpj,serie
Filtro=handle=9088
Ordem=situacao asc
Inicio=50
Limite=100
Visao=TspdNFCeFaixaInut
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 NFC-e. |
| situacao |
Situação da NFC-e. Exemplos: AUTORIZADA, CANCELADA |
| nnf | Número da NFC-e. |
| codnf | Código numérico identificador do contribuinte da NFC-e. |
| nrecibo | Número do recebido de recepção da SEFAZ. |
| nprotenvio | Número do protocolo do envio da NFC-e. |
| nprotcanc | Número do protocolo do cancelamento da NFC-e. |
| nprotinutil | Número do protocolo de inutilização da numeração da NFC-e. |
| modoentrada |
Modo do Manager eDoc no qual a nota foi registrada no envio. Pode ter os valores: Normal e Contingencia Offline |
| 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 e Contingencia Offline |
| cnpj | CNPJ do Emissor da NFC-e. |
| serie | Série da numeração da NFC-e. |
| motivo | Descrição do status da resposta da SEFAZ. |
| dtautorizacao | Data de autorização da NFC-e. |
| dtcadastro | Data de cadastro da NFC-e na base de dados do Manager eDoc. |
| dtcancelamento | Data de cancelamento da NFC-e. |
| dtemissao | Data de emissão da NFC-e. |
| impresso |
Indica se a NFC-e já foi impressa. Valores possíveis: Sim - Já impressa Não - Não impressa |
| envemail |
Indica se a NFC-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 NFC-e. | |
| docdestinatario | Número do documento do destinatário da NFC-e. (CNPJ, CPF) |
| nomedestinatario | Nome do destinatário da NFC-e |
| idgrupo | Identificador único do grupo do Manager eDoc ao qual o CNPJ do emissor da NFC-e faz parte. |
| idintegracao | Identificador único da NFC-e com a TecnoSpeed. |
| nlote | Número do lote a qual a NFC-e pertence. |
| numero | Número da NFC-e. |
| nomegrupo | Nome do grupo do Manager eDoc ao qual o CNPJ do emissor da NFC-e faz parte. |
| justificativa | Descrição da justificativa de cancelamento da NFC-e. |
| ambiente |
Ambiente o qual a NFC-e foi enviada. Homologação ou Produção. |
| impressora | Nome da impressora utilizada para impressão da NFC-e. |
| sincronizadopm |
Indica se a NFC-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. |
| valortotal | Valor Total da NFC-e. |
| valortroco | Valor do troco da NFC-e. |
| valorrecebido | Valor recebido na NFC-e. |
É possível realizar a consulta de uma inutilização passando o valor TspdNFCeFaixaInut 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. |
| modelo | Modelo do documento fiscal eletrônico, será sempre 65. |
| handle | Identificador único do registro na base de dados do Manager eDoc. |
| dtcadastro | Data de cadastro do registro de inutilização de numeração. |
| ambiente |
Indica em qual ambiente da SEFAZ a inutilização foi executada. Valores possíveis: 1 - Produção. 2 - Homologação. |
| xml | XML de retorno da inutilização de numeração. |
| xmlinutdest | XML destinatário da inutilização de numeração. (Envio + retorno) |
| xmlenvioinut | XML de envio da inutilização de numeração. |
Retorno
Dentro do arquivo da pasta RETORNO teremos o resultado do processamento da consulta.
Exemplo de retorno:
Será de acordo com os campos e ordem informada no parâmetro "campos".
Ex: 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 NFC-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.