Ordem entre integrações (Depende de)

Quando o destino recusa um registro que cita outro ainda não processado (produto com fornecedor novo, produto × loja com loja nova), declare a ordem na integração que depende.

Como configurar

Na edição da integração, em Depende de:

1. Integração: a que precisa ir antes (mesma empresa e mesmo ambiente).
2. Campo de ligação: o campo do registro desta integração cujo valor é o número do documento (docnum) enviado pela outra — por exemplo, o código do fornecedor no produto. As sugestões vêm das últimas mensagens.
3. Se a outra nunca enviou o documento: segurar até chegar (padrão) ou enviar mesmo assim.
4. Prévia da ligação: antes de salvar, mostra quantos valores das últimas mensagens já estão confirmados, aguardando, com falha ou não enviados pela outra. Se nenhum casa, o campo provavelmente não traz o docnum dela.

O que acontece

• Cada registro é conferido: se o documento correspondente da outra integração ainda não foi confirmado pelo destino (inclusive o recibo pela fila, quando a conexão usa), a mensagem do registro fica segurada no Monitor, com o motivo.
• Quando o destino confirma o documento da outra, os registros que esperavam saem sozinhos. Se ela falhou, eles esperam a correção.
• Num envio de um registro por mensagem, só o registro que espera fica segurado; os outros seguem.
• Registro sem valor no campo de ligação não espera nada.
• Mudar a política (na própria linha da dependência) ou remover a dependência devolve à fila o que estava segurado por ela: o registro é conferido de novo pela regra de agora.

Por que "nunca enviado" segura por padrão

Na carga inicial a outra integração pode simplesmente ainda não ter rodado. O agendador cuida disso: enquanto a outra não concluiu a carga inicial (ou tem documentos que registros desta já esperam a caminho da confirmação), esta integração espera alguns minutos antes de ler a origem — assim a outra roda primeiro. A espera tem teto de 30 minutos: depois disso esta integração roda e o que depende de documento não confirmado fica segurado com o motivo. O que mesmo assim nascer antes fica segurado e sai na confirmação. Use enviar mesmo assim só quando o destino aceita o registro sem o outro.

Os ambientes são isolados: a dependência e a conferência valem só dentro do ambiente da integração (DEV, QAS ou PRD).