ERP - WebServices - Como ocorre o controle da finalização de registros a serem exportados por um WebService
Dúvida
Como ocorre o controle da finalização de registros a serem exportados por um WebService?
Solução
A tabela E000CIX armazena os registros de exportação, vinculado a cada sistema integrado e tipo de informação.
Quando é efetuada uma chamada de um WebService de exportação, o Gestão Empresarial | ERP retorna um campo de finalizaramRegistros (este campo pode ter um nome um pouco diferente, dependendo de cada WebService). Esse campo serve para indicar se, para o mesmo sistema integrado, empresa, filial e tipo de informação ainda existem mais registros pendentes de exportação além dos registros presentes no lote que foi exportado (lembrando que a quantidade de registros a ser exportado a cada lote é definida na requisição do WebService).
Então:
- Se o retorno do WebService for de finalizaramRegistros igual a "N", na próxima chamada do WebService o Gestão Empresarial | ERP irá devolver os próximos registros ainda não exportados;
- Se o retorno for de finalizaramRegistros igual a "S", isso indicará ao sistema integrado que terminaram os registros a serem exportados.
Atenção
Se for solicitada uma integração do tipo T-Todos, o Gestão Empresarial | ERP irá marcar todos os registros do tipo de informação para o sistema integrado aptos a serem exportados como P-Pendentes na tabela E000CIX.
Enquanto que não foi concluída a exportação dos registros, mesmo que a chamada da integração seja como T-Todos e o campo finalizaramRegistros for retornado como "N", o Gestão Empresarial | ERP devolverá nas próximas chamadas apenas os registros que ainda estiverem P-Pendentes.
Porém, se a partir do momento em que o Gestão Empresarial | ERP retornar campo finalizaramRegistros igual a "S" e o sistema integrado fizer uma nova chamada do tipo T-Todos, o Gestão Empresarial | ERP voltará a marcar todos os registros como P-Pendentes, fazendo novamente a exportação de todos os registros.
Por isso é importante que, quando utiliza-se a chamada de integração do tipo T-Todos, ao ser retornado pelo Gestão Empresarial | ERP o campo finalizaramRegistros igual a "S" não se efetue nova chamada do tipo T-Todos e passe a fazer a chamada como A-Somente Alterados, porque nesse caso, terminou-se a carga de todos os registros e a partir de agora, deseja-se integrar apenas os novos registros alterados depois da carga.
Observação
Para mais informações sobre os WebServices do Gestão Empresarial | ERP, consulte o artigo ERP - WebServices - Onde é possível encontrar informações diversas sobre processo de integração via WebServices (índice).