# Tabelas de conversão

Tabelas de conversão, também chamadas de de/para, permitem traduzir valores entre origem e destino sem mudar o código da integração.

No modelo atual do produto, esse recurso deve ser entendido como um caso comum de [Tabelas De/Para](https://docs.tunnelhub.io/produto/data-stores).

## Quando usar

Use tabelas de conversão quando houver necessidade de mapear:

* códigos internos para códigos externos;
* status de um sistema para outro;
* siglas para identificadores completos;
* regras de classificação controladas pelo negócio.

## Estrutura

Uma tabela de conversão normalmente possui:

* um cabeçalho com código externo e descrição;
* itens contendo o valor de origem e o valor de destino.

Na maioria dos cenários, isso aparece como `externalCode` no cabeçalho e pares `fromValue`/`toValue` nos itens.

## Uso no SDK

O SDK expõe utilitários para leitura de Tabelas De/Para e consulta a itens de conversão durante a execução.

Isso permite que a regra fique no produto, e não embutida no código.

Quando o cenário evolui além de um simples de/para, prefira pensar no recurso como Tabela De/Para e documentar o contexto funcional daquele conjunto de dados.

## Boas práticas

* use códigos claros e estáveis;
* mantenha ownership funcional definido;
* trate tabelas como configuração de negócio, não como área de testes improvisados;
* revise itens obsoletos periodicamente.