# Identificadores externos

Relacione códigos de outros sistemas aos cadastros do Askora, com validade opcional.

Versão 1.0.0

Em **Integrações → Identificadores**, o Master mantém correspondências para Colaboradores, Parceiros, Organizações e Suborganizações. O código externo referencia um cadastro existente; não renomeia nem troca seu ID interno.

## Cadastrar uma correspondência

1. Escolha a aba do tipo correto.
2. Informe **Identificador externo** como texto e selecione o cadastro em **Identificador interno**.
3. Se Validade estiver habilitada, confira Início e Fim opcionais.
4. Salve e confira a correspondência antes de utilizá-la na integração.

São até 150 caracteres, sem espaços ou caracteres de controle. Zeros iniciais e maiúsculas são preservados: 001, 1, ABC e abc são códigos diferentes. Vários códigos podem apontar ao mesmo cadastro. Um código pode existir em tipos diferentes sem representar a mesma pessoa.

## Validade e conflito

Validade começa desativada. Sem início, não há limite inicial; sem fim, não há limite final. No mesmo tipo e empresa, associações ativas do mesmo código não podem sobrepor datas, inclusive os limites.

Com validade ativa, a resolução exige a data do negócio. Sem ela, apenas uma associação ativa pode existir para o código. Não é possível desligar Validade enquanto reutilizações por período tornarem a resolução ambígua. Ocultar datas não apaga o histórico.

Se código e ID interno forem enviados juntos, precisam corresponder. Cadastro interno inativo ou fora da empresa não resolve uma referência válida. Código não encontrado exige corrigir a correspondência, não escolher alguém pelo nome semelhante.

## Manutenção e limites

A tabela oferece filtros, paginação, cadastro rápido/completo, seleção, edição e arquivos JSON. Inativar preserva a associação histórica; versão desatualizada exige recarregar. Cada lote enviado é transacional.

Essas referências a pessoas/organizações são diferentes do código durável de um próprio registro importado. Uma venda, por exemplo, é identificada pelo Pedido e pode referenciar o colaborador por seu código externo com validade.

## Disponibilidade

Administração no web, exclusiva do Master. Integrações autorizadas podem resolver as referências nos destinos compatíveis. O aplicativo não oferece editor nativo de Identificadores; cadastros manuais continuam usando as referências internas autorizadas.