LG Nuvem

Infraestrutura e segurança

Antes de iniciar a integração, é importante validar:

Se há alguma restrição de acesso para construção de VPN entre um ambiente externo e os pontos de conexão disponibilizados.
Se haverá uma comunicação fluida e facilitada com o time dedicado à segurança e infraestrutura, principalmente se eles não operarem no Brasil.
Se existe alguma restrição na criação de diretório, servidor SFTP ou conta de e-mail que será acessada por um serviço externo.
Se há entraves gerados a partir da LGPD que a integração deve atender.
Se os padrões de segurança permitam a criação de usuário com permissão de escrita nas tabelas que serão utilizadas.

Autenticação

A LG nuvem possui todos os seus serviços disponíveis utilizando o protocolo de transporte SOAP.
Não é necessário realizar fechamento com VPN.
Necessário ter o token, usuário, senha, GuidTenant, Ambiente (código dentro do ContextoAmbiente) e uma versão preenchida com dados válidos desse XML para que seja possível testar a conectividade com envio teste de admissão. Esses dados devem ser fornecidos para ambientes de HML e PROD, pois são endpoints diferentes.

Conectividade

Não há nenhuma especificidade relacionada à conectividade da LG, no entanto é altamente recomendável um consultor durante todo o processo, devido à obrigatoriedade de campos que é alterada de acordo com o que é passado no XML.

Pode ser necessário consultar algumas informações obrigatórias nos endpoints fornecidos pela LG.

APIs para consulta

Informações obrigatórias atreladas ao código de posição em homologação
Informações obrigatórias atreladas ao código de posição em produção
Listagem de dependentes em homologação
Listagem de dependentes em produção
Código das informações de município e país de nascença e residência em homologação
Código das informações de município e país de nascença e residência em produção

Padronizações

Protocolo: HTTP 1.1
Charset: UTF-8
Data: YYYY-MM-DD

Fluxo de Integração

Webhook pre-employee.moved da Gupy é recebido;
Os dados são filtrados de acordo com o admission.status, coletando informações apenas dos candidatos que estão na etapa definida como gatilho.
Utilização dos dados do webhook para realizar enriquecimento de dados com consultas a API da Gupy.
Realização de/para e transformações de dados.
Consulta aos endpoints da LG para enriquecimento dos dados
Montagem do XML e postagem no endpoint disponibilizado para envio da admissão para a LG.
Validação do retorno do envio (status 200) para finalizar.

Envio das informações

A LG espera receber um arquivo XML como o que está neste link tanto para homologação quanto para produção. Algumas informações sobre as tags do XML:

A ordem das tags não pode ser alterada. Necessário seguir exatamente o modelo acima.
Tags vazias devem ser apagadas ou comentadas antes do seu envio
Observe que ocorre o agrupamento de informações no XML, portanto temos diversas vezes a TAG Codigo mas em diferentes agrupamentos, isso é um ponto crucial no entendimento e montagem desse XML.
Ao realizarmos uma admissão completa, os dados serão inseridos diretamente na tela de colaboradores da LG, sem parar na aba de admissões “pendentes”. Para que a requisição pare nessa tela e o time de DP valide é necessário realizar uma admissão parcial (tem uma TAG no XML apenas para indicar qual o tipo de admissão a ser realizada).
Quando passamos a TAG PossuiDependentes com algum valor diferente de 0 ou nulo, quer dizer que o pré-colaborador possui dependentes e portanto passa a ser obrigatório o envio de alguns dados dos dependentes.
Podemos realizar o envio de um array de dependentes como um loop dentro do endpoint da admissão ou realizar o envio através de um endpoint destinado apenas a dependentes (https://prd-api1.lg.com.br/v2/ServicoDeDependente), porém para utilizar esse endpoint apenas destinado à dependentes é obrigatório que o tipo da admissão seja completa e não parcial, pois é necessário ter a matrícula do funcionário. Admissões parciais não geram a matrícula e portanto tornam inviável a utilização desse endpoint.
Cada cliente possui uma configuração na LG, o que pode tornar alguns campos obrigatórios ou não, além de algumas opções constarem ativas em alguns ambientes e em outros não. O que determina o que tem configurado para o cliente é o GuidTenant dele.
A LG realiza uma validação quanto à agência bancária que foi enviada, ela precisa constar na base do sistema para a admissão ocorrer com sucesso.
Quando o colaborador utilizar CTPS Digital o número da carteira deve ser o mesmo CPF do colaborador. Existe uma TAG que informa se a admissão está contemplando CTPS Digital ou não.
É possível receber um status 200 e a admissão não ter sido inserida no ambiente da LG, a mensagem virá no corpo do response dentro da propriedade “Tipo”, seguindo o padrão abaixo:
- 0 - Sucesso. Esse status é obtido quando a operação é executada sem nenhum problema. Em alguns casos o usuário pode fazer uma consulta e ela não retorna nada o que pode levá-lo a acreditar que a API talvez esteja com problema, entretanto se o "Tipo" for igual a zero significa que a consulta foi executada com sucesso, mas sem registros para retorno.
  1 - Inconsistência. Esse status é obtido quando é identificada alguma inconsistência nos parâmetros informados para consumir o recurso. Nesse caso sempre haverá uma mensagem indicando o problema.
  2 - Erro. Esse status é obtido quando um erro inesperado acontece durante a execução do recurso. Nesse caso reúna todas as informações que está utilizando como o nome do serviço, nome da capacidade, os parâmetros que estão sendo utilizados, "prints" do retorno e entre em contato com o suporte da LG lugar de gente.

Possíveis erros

Envio de tag vazia

Ocorrerá um erro caso seja enviada uma tag vazia ou com “?”

Item não cadastrado, não permitido para o seu nível de visibilidade ou não habilitado para a empresa selecionada

Quando é enviada uma informação que não está de acordo com o que está cadastrado ou habilitado no ambiente da LG (Ex: Código de faixa salarial inexistente)

Ultrapassar limite de caracteres

A LG valida se a quantidade de caracteres que foi passada na TAG ultrapassa o limite determinado para o campo.