12.10. Distribuição de DF-e [27-05-17]
12.10.1. Consulta DF-e emitidas para um interessado [02-08-15]
12.10. Distribuição de DF-e [27-05-17]
« Anterior
12.10.2. Consulta DF-e por NSU [02-08-15]
Próximo »

12.10.1. Consulta DF-e emitidas para um interessado [02-08-15]

Consultar as informações resumidas e documentos interesse da consulente a partir do NSU informado nformado no parâmetro ultNSURecebido.

Assinatura

string distNSU(string siglaWS, int tipoAmbiente, string nomeCertificado, string versao, out string msgDados, out string msgRetWS, out int cStat, out string msgResultado, string CNPJ, string cUF, string ultNSURecebido, out string verAplic, out string dhResp, out string ultNSU, out string maxNSU, out int qtdeDocto, string proxy, string usuario, string senha, string licenca);

Descrição:

Consulta as informações resumidas e DF-e existentes para o interessesado a partir do NSU informado no parâmetro ultNSURecebido, o Web Service retorna até 50 informações resumidas ou documento fiscal a partir do ultNSURecebido consultado.

Se o ultNSU for menor que o maxNSU, o interesssado deve repetir a consulta atualizando o ultNSURecebido com o ultNSU devolvido pelo WS.

Preenchimento da siglaWS

AN - O WS do Ambiente Nacional (AN) atende qualquer UF.

Preenchimento do nomeCertificado

informar o Nome do titular (campo Assunto) do certificado digital a ser utilizado na conexão SSL, formas possíveis:

1. uso de certificado digital existente no repositório MY do CSP do usuário corrente (currentuser)

É a forma de mais comum de uso, cabe ressaltar que é a única forma de uso de certificado digital do tipo A3 que a DLL oferece.
O usuário deve passar como parâmetro o campo assunto do certificado no parâmetro NomeCertificado para que a DLL localize um certificado digital com mesmo assunto no repositório MY do currentuser do equipamento.
Esta forma de uso requer a prévia instalação do certificado digital na conta do usuário do Windows (logon) que irá utilizar o certificado digital.

2. uso de certificado digital em arquivo no formato pfx

Permite o de uso de certificado digital em arquivo formato pfx.
O caminho da localização (path) do arquivo pfx deve ser passado para a DLL no formato: ARQUIVO | [nome do arquivo pfx com caminho completo] | [senha do arquivo] no parâmetro NomeCertificado, ex.: "ARQUIVO|c:\certificado.pfx|senha".
Esta opção só funciona com certificado digital do tipo A1.

3. uso de certificado digital em string base64

Permite uso o arquivo do certificado digital em formato pfx convertido em uma string base64. O certificado digital em string base64 deve ser passado para a DLL no formato: CERTIFICADO | [string base64 do arquivo pfx] | [senha do arquivo] no parâmetro NomeCertificado, ex.: "CERTIFICADO|MIIGoDCCBYigAwIBAgIQep(arquivo pfx do certificado digital convertido em base64...)QQDExNBQy|senha".
Esta opção só funciona com certificado digital do tipo A1. É uma opção de uso que oferece maior versatilidade, pois permite o armazenamento do certificado digital em banco de dados na aplicação. É a forma mais indicada para uso em ASP.NET.

Parâmetros:

nome tipo fluxo descrição
siglaWS string entrada informar "AN" - o WS do Ambiente Nacional (AN) atende destinatário de qualquer UF.
tipoAmbiente inteiro entrada informar o código do ambiente desejado: 1- produção ou 2-homologação
NomeCertificado string entrada informar o certificado digital que será utilizado para assinatura:
1. informar o assunto do certificado digital que deve existir no repositório MY do current user, ex.: "CN=NFe - Associacao NF-e:99999090910270, C=BR, L=PORTO ALEGRE, O=Teste Projeto NFe RS, OU=Teste Projeto NFe RS, S=RS".
2. informar: ARQUIVO | [nome do arquivo pfx com caminho completo] | [senha do arquivo] para uso do certificado digital em arquivo pfx, ex.: "ARQUIVO|c:\certificado.pfx|senha".
3. informar: CERTIFICADO | [string base64 do arquivo pfx] | [senha do arquivo] no parâmetro NomeCertificado para passar uma string contendo um certificado digital em base64, ex.:"CERTIFICADO|MIIGoDCCBYigAwIBAgIQep(arquivo pfx do certificado digital convertido em base64...)QQDExNBQy|senha".
(novas opções)
versao string entrada informar a versão da mensagem do WS - 1.00
msgDados string saída retorna a mensagem XML enviada para o WS
msgRetWS string saída retorna a mensagem XML de resposta do WS
cStat inteiro saída retorna o resultado da chamada do WS
msgResultado string saída retorna a literal do resultado da chamada do WS
CNPJ string entrada informar o CNPJ do ator que se deseja consultar os documentos fiscais
cUF string entrada informar o cUF
ultNSURecebido string entrada informar o NSU a partir do qual deseja realizar a consulta.Caso seja informado com zero, ou com um NSU muito antigo, a consulta retornará unicamente as notas fiscais que tenham sido recepcionadas nos últimos 3 meses.
verAplic string saída retorna a versão da aplicação do Web Service.
dhResp string saída retorna a Data e hora da mensagem de Resposta.
ultNSU string saída retorna o Último NSU pesquisado na Web Service. Se exisitrem mais NSU (maxNSU > ultNSU), o solicitante pode continuar a consulta a partir deste NSU para obter novos resultados.
maxNSU string saída retorna Maior NSU existente no Ambiente Nacional para o CNPJ/CPF informado.
qtdeDocto int saída retorna a quantidade de documentos devolvidos pelo WS.
proxy string entrada informar 'http://proxyserver:port' quando existir uso de proxy no ambiente. verificar com o cliente qual é o endereço do servidor proxy e a porta https, a porta padrão do https é 443, assim teríamos algo do tipo 'http://192.168.15.1:443'
usuario string entrada informar o usuário para autenticação no proxy, se necessário
senha string entrada informar a senha de autenticação no proxy, se necessário
licenca string entrada informar a chave da licenca de uso ou registro, esta funcionalidade pode ser utilizada sem qualquer restrição no ambiente de homologação. O uso em ambiente de produção requer o licenciamento, para maiores detalhes veja as condições de uso

Retorno:

A chamada devolve uma string com o resumo ou XML do documento consultado separados por quebra de linha.

12.10.1. Consulta DF-e emitidas para um interessado [02-08-15]
12.10. Distribuição de DF-e [27-05-17]
« Anterior
12.10. Distribuição de DF-e [27-05-17]
Próximo »
12.10.2. Consulta DF-e por NSU [02-08-15]