# 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](/produto/data-stores.md).

## 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tunnelhub.io/produto/conversion-tables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.