- 7.6. WS da NFC-e - SEFAZ/SP
7.6.1. Obter lista de chaves de NFC-e emitidas - 7.6. WS da NFC-e - SEFAZ/SP
« Anterior - 7.6.2. Download de NFC-e
Próximo »
7.6.1. Obter lista de chaves de NFC-e emitidas
Obter a lista de chaves de NFC-e emitidas no período informado.
Assinatura
string listaChaveNFCeSP(int tipoAmbiente, string nomeCertificado, string versao, out int cStat, out string msgResultado, out string msgDados, out string msgRetWS, string dataHoraInicial, string dataHoraFinal, out string verAplic, out string dhReq, out string dhEmisUltNfce, out int qtdeChaves, out int qtdeChaves, string proxy, string usuario, string senha, string licenca);
Descrição:
O serviço permite que um contribuinte emissor de NFC-e paulista obtenha a lista de chave das NFC-e emitidas no período de tempo informado.
O serviço realiza a pesquisa das chaves de acesso das NFC-e emitidas pelo CNPJ que consta no certificado digital utilizado na pesquisa, este detalhe impossibilita o uso de um certificado digital único para todos os estabelecimentos da empresa, ou seja, cada filial deverá possuir um certificado digital com o seu CNPJ para realizar a pesquisa, cabendo ressaltar que é uma limitação imposta pela SEFAZ.
A quantidade de chaves que o serviço retorna é limitada em 2.000 chaves de NCF-e, se existir(em) mais chave(s) de NFC-e no período informado pelo usuário, o serviço irá retornar somente as 2.000 chaves iniciais e indicar que existem mais chaves:
"cStat=101, xMotivo=”Consuta realizada com sucesso, mas lista incompleta. Ajustar período de busca”
Quando existirem mais chaves na pesquisa, o serviço devolverá a data e hora de emissão da última nota fiscal da lista de chaves retornada que deverá ser utilizada como data e hora inicial da consulta para obter o restante das chaves das NFC-e existentes.
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 |
|---|---|---|---|
| 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 |
| cStat | inteiro | saída | retorna o resultado da chamada do WS |
| msgResultado | string | saída | retorna a literal do resultado da chamada do WS |
| msgDados | string | saída | retorna a mensagem XML enviada para o WS |
| msgRetWS | string | saída | retorna a mensagem XML de resposta do WS |
| dataHoraInicial | string | entrada | informar a data e hora inicial do período a ser pesquisado no formato "AAAA-MM-DDTHH:MM" |
| dataHoraFinal | string | entrada | informar a data e hora final do período a ser pesquisado no formato "AAAA-MM-DDTHH:MM" |
| verAplic | string | saída | retorna a versão da aplicação do Web Service. |
| dhReq | string | saída | retorna a Data e hora da mensagem de Resposta. |
| dhEmisUltNfce | string | saída | retorna a Data e hora da emissão da última NFC-e retornada, no formato AAAA-MMDDTHH:MM:SS, a ser usado quando o limite da quantidade de chaves a ser retornada tiver sido atingido |
| qtdeChaves | int | saída | retorna a quantidade de chaves devolvidas 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 licença 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 uma chave de acesso por linha.
- 7.6.1. Obter lista de chaves de NFC-e emitidas
7.6. WS da NFC-e - SEFAZ/SP - « Anterior
7.6. WS da NFC-e - SEFAZ/SP - Próximo »
7.6.2. Download de NFC-e