WSConsultarColdExclusive - Consulta exclusiva de documentos na base do e-Cold
O web service WSConsultarColdExclusive permite bloquear a redundância de buscas dos documentos no e-Cold. O XML de consulta possui duas modificações, em relação ao WSConsultarCold o acréscimo dos atributos Solicitante, utilizado para identificar o usuário que está realizando a pesquisa, e o Considerar, utilizado para definir se devem ser consideradas as pesquisas anteriormente realizadas.
Uma tabela de controle – TBControl – deve ser criada junto à base de dados do e-Cold para identificar os documentos pesquisados.
Seu funcionamento é semelhante ao WSConsultarCold, trabalha em um contexto de pesquisa/processamento/resultado mas efetua o bloqueio de consultas redundantes.
Após efetuar a chamada para o web service de consulta, os dados são armazenados em uma tabela do banco de dados do ColdSearch, este deve ser único para cada conexão de saída e-Cold para, posteriormente, efetuar a consulta no banco de dados do e-Cold. Um serviço do Windows é responsável por realizar a consulta ao e-Cold, este captura a informação armazenada no banco de dados do ColdSearch, informação esta, inserida pela chamada do web service de consulta, e efetua a busca dos registros no e-Cold, conforme os parâmetros passados na consulta.
O ERP que realiza as chamadas ao web service envia os dados e uma expressão de pesquisa. Esta expressão será o filtro da pesquisa, e determina a quantidade de elementos resultantes desta. O resultado desta chamada é um protocolo de pesquisa o qual possibilita ao consumidor do web service a busca do status de processamento da sua solicitação de pesquisa.
Os resultados são retornados pelo Web Service WSRetornarDocumentosCold, podendo ser de duas maneiras distintas: sob demanda ou somente no final do processo. Isto quem decide é o utilizador do web service, pois o resultado será sempre retornado quebrado em lotes de no máximo 50 documentos, porém, este valor pode ser solicitado junto com o pedido de retorno dos dados. Ficam disponíveis para o ERP que utiliza os web services os status de processamento, onde ele poderá efetuar o acompanhamento do status de sua solicitação, sabendo assim, a quantidade total de documentos que estão em processamento e quantos já foram processados. Desta maneira, num contexto de interação com o usuário, o mesmo poderá ser avisado do status do processamento.
É possível que sejam retornados os documentos, autorizações ou PDF. Isto depende dos parâmetros especificados na pesquisa.
O método utilizado por este web service é identificado como: PequisarDocumentosExclusive.
<XML retorno> PesquisarDocumentosExclusive (<XML consulta>)
|
Para efetuar o download do schema xsd clique aqui!
<eformsConsultarColdExclusive 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>
<autenticacao>
<usuario></usuario>
<senha></senha>
<conexaoid></conexaoid>
</autenticacao>
<solicitacao>
<tipodocumento></tipodocumento>
<formatosolicitacao></formatosolicitacao>
<formatodocumento></formatodocumento>
<composicaodocumento></composicaodocumento>
<solicitante></solicitante>
<considerar></considerar>
</solicitacao>
<expressao>
<item>
<blocoinicial></blocoinicial>
</item>
<item>
<campo>
<nome></nome>
<valor>
<conteudo></conteudo>
<parcial></parcial>
</valor>
</campo>
</item>
<item>
<operacaologica></operacaologica>
</item>
<item>
<campo>
<nome></nome>
<intervalo>
<inicial></inicial>
<final></final>
</intervalo>
</campo>
</item>
<item>
<blocofinal></blocofinal>
</item>
</expressao>
</eformsConsultarColdExclusive>
|
Detalhamento do Schema eformsConsultarColdExclusive
|
eformsConsultarColdExclusive
|
#
|
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
|
|
autenticacao
|
Autenticação do usuário na base do e-Cold.
|
G
|
S
|
1
|
|
O acesso ao e-Cold fica restrito, portanto para que se possa consultá-lo é necessário que sejam passadas as informações de acesso e conexão.
|
3
|
2
|
usuario
|
Nome do usuário.
|
C
|
S
|
1
|
1..100
|
Nome do usuário, conforme cadastrado na base do e-Forms.
|
4
|
2
|
senha
|
Senha do usuário.
|
C
|
S
|
1
|
1..100
|
Senha do usuário, conforme cadastrado na base do e-Forms.
|
5
|
2
|
conexaoid
|
Identificador da conexão e-Cold.
|
N
|
S
|
1
|
1..14
|
Identificador dado a conexão e-Cold.
|
6
|
|
solicitacao
|
Define os formatos dos dados a serem retornados.
|
G
|
S
|
1
|
|
|
7
|
6
|
tipodocumento
|
Tipo de documento a ser retornado.
|
N
|
S
|
1
|
1
|
1 = Documento eletrônico de envio;
2 = Documento eletrônico de cancelamento.
|
8
|
6
|
formatosolicitacao
|
Formato da solicitação.
|
N
|
S
|
1
|
1
|
1 = Somente documento Xml;
2 = Somente PDF;
3 = Ambos.
|
9
|
6
|
formatodocumento
|
Formato do documento.
|
N
|
S
|
1
|
1
|
1 = Xml;
2 = Txt delimitado (não implementado ainda).
|
10
|
6
|
composicaodocumento
|
Composição do documento a ser retornado.
|
N
|
S
|
1
|
1
|
1 = Apenas documento de envio;
2 = Apenas autorização;
3 = Documento e autorização (b2b).
|
11
|
6
|
solicitante
|
Id do solicitante.
|
C
|
S
|
1
|
1..14
|
ID do solicitante que irá realizar a pesquisa, no caso o CNPJ.
|
12
|
6
|
considerar
|
Considerar notas.
|
C
|
S
|
1
|
1
|
1 = considera documentos pesquisados para futuros bloqueios;
2 = não considera.
|
13
|
|
expressao
|
Expressão de pesquisa na base de dados.
|
G
|
S
|
1
|
|
|
14
|
13
|
item
|
Item da expressão
|
G
|
S
|
1..n
|
|
Cada item de uma expressão pode assumir apenas um dos itens abaixo.
|
15
|
14
|
blocoinicial
|
Bloco inicial de uma expressão.
|
C
|
S
|
1
|
|
Identifica o início de um bloco ou sub-bloco de pesquisa, seria o mesmo que um sinal de abrir parênteses em uma expressão matemática. Exemplo: <blocoinicial>inicio</blocoinicial>.
|
16
|
14
|
blocofinal
|
Bloco de finalização de uma expressão.
|
C
|
S
|
1
|
|
Identifica o final de um bloco ou sub-bloco de pesquisa, seria o mesmo que um sinal de fechar parênteses em uma expressão matemática. Exemplo: <blocofinal>final</blocofinal>.
|
17
|
14
|
operacaologica
|
Identifica a operação lógica a ser executada.
|
N
|
S
|
1
|
1
|
Identifica uma operação lógica do produto, esta operação pode ser uma conotação booleana de E, OU ou de negação. Pode assumir os seguintes valores: 1 = E; 2 = OU; 3 = Negação. Exemplo: <operacaologica>1</operacaologica.>
|
18
|
14
|
campo
|
Campo filtro de pesquisa.
|
G
|
S
|
1
|
|
Os campos têm obrigatoriamente um nome e também valores de filtros. As duas possibilidades de filtro e de nome podem ser feitas através de valor ou intervalo de valores.
|
19
|
18
|
nome
|
Nome do campo de filtro.
|
C
|
N
|
1
|
1..n
|
Possíveis nomes de campos:
• Para NF-e
o SERIE – série da nota;
o NUMERONFE – número da nota;
o DATAEMISSAO – data de emissão da nota conforme formato utilizado pelo SGBD;
o CNPJEMITENTE – CNPJ do emitente;
o CNPJDESTINATARIO – cnpj do destinatário;
o CPFDESTINATARIO - CPF do destinatário.
• Para CT-e
o SERIE – série do conhecimento;
o NUMEROCTE – número do conhecimento;
o DATAEMISSAO – data de emissão do conhecimento conforme o formato utilizado pelo SGBD;
o CNPJEMITENTE – CPF do emitente;
o CNPJREMETENTE – CNPJ do remetente
o CPFREMETENTE – CPF do remetente
o CNPJEXPEDIDOR – CNPJ do expedidor;
o CPFEXPEDIDOR – CPF do expedidor;
o CNPJRECEBEDOR – CNPJ do recebedor;
o CPFRECEBEDOR – CPF do recebedor;
o CNPJDESTINATARIO – CNPJ do destinatário;
o CPFDESTINATARIO – CPF do destinatário;
o CNPJTOMADOR – CNPJ do tomador do serviço;
o CPFTOMADOR – CPF do tomador do serviço.
• Para MDF-e
o SERIE – série do manifesto;
o NUMEROMDFE – número do manifesto;
o DATAEMISSAO – data de emissão do manifesto;
o CNPJEMITENTE – CPF do emitente.
• Para CT-eOS
o SERIE – série do conhecimento;
o NUMEROCTEOS – número do conhecimento;
o DATAEMISSAO – data de emissão do conhecimento conforme o formato utilizado pelo SGBD;
o CNPJEMITENTE – CPF do emitente;
o CNPJTOMADOR – CNPJ do tomador do serviço;
o CPFTOMADOR – CPF do tomador do serviço.
|
20
|
18
|
valor
|
Valor do filtro a ser aplicado.
|
G
|
S
|
1
|
1
|
O valor do filtro indica que será feita uma comparação direta. Exemplo SERIE = 1.
|
21
|
20
|
conteudo
|
Conteúdo do campo que será utilizado no filtro.
|
C
|
S
|
1
|
1..n
|
|
22
|
20
|
parcial
|
Define busca parcial sobre o campo.
|
N
|
N
|
1
|
1
|
Indica para campos alfanuméricos se o conteúdo é uma parte do todo. Se for 1 ele busca parcialmente, caso contrário, deve ser idêntico.
|
23
|
18
|
intervalo
|
Intervalo fechado de valores.
|
G
|
S
|
1
|
1
|
Intervalo fechado de valores a serem filtrados. Exemplo SERIE >= 1 E SERIE <= 1000.
|
24
|
23
|
inicial
|
Valor inicial do filtro.
|
C
|
S
|
1
|
1..n
|
Valor inicial do filtro.
|
25
|
23
|
final
|
Valor final do filtro.
|
C
|
S
|
1
|
1..n
|
Valor final do filtro.
|
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