WSConsultarIntegracao têm como pré requisito a versão do e-Forms 4.8.2.0 ou superiores. |
O Web Service WSConsultarIntegracao tem a finalidade de trazer os retornos de status das integrações dos documentos de saída e entrada de NF-e, CT-e/CT-eOS e MDF-e, somente para integrações via banco de dados, sendo estes SQL e Oracle.
O retorno será efetuado com uma limitação de 50 registros por consulta, sendo assim, quando não houver os 50 registros na base de processamento, será retornada a quantidade existente.
O controle destes registros deverá ser feito pelo NSU que será sequencial, sendo este de responsabilidade do ERP. Esta informação será obrigatória no momento da chamada através da tag <ultNSU>.
A chamada é formada também pelo token <token> que é obrigatário, baseado nele o WSConsultarIntegracao deverá retornar documentos referentes a uma tabela de integração cujo o token pertence. Este é gerado através do cadastro de integrações via banco de dados;
E também o identificador <identificador>, sendo este opcional e correspondente ao jobkey cadastrado nas configurações do job. Quando informado trará as informações especificas para o JOB, quando não informado será retornados os dados da tabela de integração porém de todos os JOBs a ela vinculados.
Para que a tag <identificador> funcione retornado os dados do jobkey especifico é necessário utilizar a dll de integração própria do Web Service. Quando utilizada a dll de integração do Web Service, é necessário criar uma nova coluna na tabela de integração: ORACLE adicionando no script de criação da tabela: [JOBKEY] [varchar](60) NULL, ORACLE com a tabela já existente, inserindo apenas a coluna: call CREATECOLUMN('nomeTabelaDeIntegracao', 'JOBKEY', 'varchar(60)', 'NULL')
SQL adicionando no script de criação da tabela: [JOBKEY] [varchar](60) NULL, SQL com a tabela já existente inserindo apenas a coluna: execute createcolumn 'nomeTabelaDeIntegracao', 'JOBKEY', 'varchar(60)', 'null' |
Para efetuar o download do schema xsd clique aqui!
Exemplo XML de Consulta |
<eformsConsultarIntegracao xmlns="http://www.nddigital.com.br/connector" xmlns:ds="http://www.w3.org/2000/09/xmldsig#"> <identificador>nddjob</identificador> <token>865938827468620530</token> <ultNSU>1</ultNSU> </eformsConsultarIntegracao> |
Detalhamento do schema eformsConsultarStatus |
WSConsultarIntegracao |
||||||||
# |
pai |
Campo |
Descrição |
Tipo |
Obrigatório |
Ocorrências |
Tamanho |
Observações |
1 |
|
identificador |
jobkey |
C |
N |
1 |
1..60 |
Nome configurado na aba de conversão do job referente ao JOBKEY |
2 |
|
token |
token gerado através da integração |
C |
S |
1 |
18 |
Código numérico gerado através da integração via banco de dados. |
3 |
2 |
ultNSU |
NSU de consulta |
N |
S |
1 |
|
Este deverá ser controlado pelo cliente, e informado na chamada conforme a necessidade da consulta. |