WSConsultarDFe - Consulta de lista de documentos destinados
Através do web service WSConsultarCTeDFe, o ERP efetua uma consulta na SEFAZ que retorna um documento ou uma lista dos documentos destinados ao requisitante. Podendo consultar através do NSU ou da chave de acesso. É contemplado apenas o modelo CT-e.
<XML retorno> ConsultarCTeDFe (<XML consulta>)
|
Adequado o software de acordo com a NT 2015.002 de CT-e que trata do web service de Distribuição de Documentos Fiscais Eletrônicos (DF-e) para CT-e
Este web service permite que o ator do CT-e tenha acesso aos documentos fiscais eletrônicos (DF-e) e informações resumidas que não tenham sido gerados por ele e que sejam de seu interesse. Pode ser consumido por qualquer ator do CT-e, Pessoa Jurídica ou Pessoa Física, que possua um certificado digital de PJ ou PF. No caso de Pessoa Jurídica, a empresa será autenticada pelo CNPJ base e poderá realizar a consulta com qualquer CNPJ da empresa desde que o CNPJ base consultado seja o mesmo do certificado digital.
Para efetuar o download do schema xsd clique aqui!
<eformsConsultarCTeDFe xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.nddigital.com.br/connector">
<versao> </versao>
<identificador></identificador>
<distDFeInt versao="1.00">
<tpAmb></tpAmb>
<cUFAutor></cUFAutor>
<CNPJ></CNPJ>
</distDFeInt>
</eformsConsultarCTeDFe>
|
Detalhamento do Schema eformsConsultarDFe
|
eformsConsultarDFe
|
#
|
pai
|
Campo
|
Descrição
|
Tipo
|
Obrigatório
|
Ocorrências
|
Tamanho
|
Observações
|
1
|
|
versao
|
Versão do schema.
|
C
|
S
|
1
|
4
|
Versão do schema.
|
2
|
|
identificador
|
JobKey (Chave do Job) que será utilizado para capturar as configurações.
|
C
|
S
|
1
|
1..60
|
|
3
|
|
integrarDoc
|
Opção de define se o procNfe ou ProcEvento será disponibilizado para o EntryDocuments
|
N
|
N
|
1
|
1
|
0 = Não envia documento para o Entry
1 = Envia documento para Entry
|
4
|
|
distDFeInt
|
|
G
|
S
|
1
|
|
|
5
|
4
|
tpAmb
|
Tipo de ambiente
|
N
|
S
|
1
|
1
|
1 = produção
2 = homologação
|
6
|
4
|
cUFAutor
|
Código da UF do autor
|
N
|
S
|
1
|
2
|
Vide tabela do IBGE
|
7
|
4
|
CNPJ
|
CNPJ do interessado no DF-e
|
N
|
S
|
1
|
14
|
CNPJ do interessado no DF-e
Se esta tag for informada, a tag CPF não pode aparecer.
|
8
|
4
|
CPF
|
CPF do interessado no DF-e
|
N
|
S
|
1
|
11
|
CPF do interessado no DF-e
Se esta tag for informada, a tag CNPJ não pode aparecer.
|
9
|
4
|
distNSU
|
Grupo para distribuir DF-e de interesse.
|
G
|
N
|
1
|
|
Se esta tag for informada no XML, a tag consNSU não pode aparecer.
|
10
|
9
|
ultNSU
|
Último NSU recebido pelo ator.
|
N
|
S
|
1
|
1..15
|
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. A utilização desta tag altera a sequência de NSU no banco de dados.
|
11
|
4
|
consNSU
|
Grupo para consultar um DF-e a partir de NSU especifico
|
G
|
N
|
1
|
|
Se esta tag for informada no XML, a tag distNSU não pode aparecer.
|
12
|
11
|
NSU
|
Número sequencial único
|
N
|
S
|
1
|
1..15
|
Esta consulta será utilizada quando identificado pelo interessado um NSU faltante, o WS retornará o documento ou informara que o NSU é inexistente no Ambiente nacional.
|
Caso não sejam informadas as tags distNSU ou consNSU, o web service irá realizar uma consulta informando o NSU inicial. Quando obtido o retorno, o ultNSU é registrado no banco de dados para que o web service possa seguir a sequência de consultas sem necessidade de informar estas tags em todas as chamadas.
Legenda do schema Web Services
Legenda
|
Item pai
|
Número do item que agrupa este elemento.
|
|
Campo
|
Nome do campo conforme está no schema.
|
|
Descrição
|
Descrição rápida dos campos.
|
|
Tipo
|
Tipo de dado no campo.
|
N = Numérico
C = Alfanumérico
D = Data no formato AAAA-MM-DD HH:MM:SS
G = Grupo que conterá outros elementos filhos
|
Obrigatório
|
Indica se o campo é obrigatório ou não
|
S = Obrigatório
N = Não é obrigatório
|
Ocorrência
|
Indica a quantidade de ocorrências possíveis de determinado elemento
|
1 = Apenas 1 vez
1..N = Pode ser de 1 a vários elementos
0..N = Pode ser de nenhum a vários elementos
|
Tamanho
|
Indica o tamanho aceitável do campo
|
1 = Apenas 1 caractere ou número
1..N = Entre 1 caractere ou número ou vários até o valor final definido
|
Observação
|
Observações adicionais sobre o campo
|
|
|
Visualizar modelo do retorno da chamada