Códigos de Território e Códigos Completos

Q: Eu preciso digitar o código completo?

Não. Você só define o código de território curto (e o pai, se for um território filho). A REDA constrói o código completo a partir desses dados — apenas o código para um território de nível superior, ou Pai-Filho para um sub-território — e o mantém atualizado automaticamente.

Administrador 7 min de leitura Atualizado em junho de 2026

Um território tem dois códigos que funcionam juntos — o código curto que você escolhe, e o código completo que o sistema constrói a partir dele. O código completo é então copiado para todos os registros para que possa controlar o acesso aos dados. Este artigo explica como cada um é formado e como ele se propaga pela aplicação. Para o panorama geral, comece por Entendendo os Territórios.

Como chegar lá. O código e o código completo de um território são definidos no próprio território — abra o Iniciador de aplicativos (o ícone de grade no canto superior esquerdo de qualquer página) → REDA Financials Admin → a guia Territórios.
Acesso necessário. Qualquer conjunto de permissões da REDA Financials pode visualizar os códigos de um território; definir o código do território (e o pai) requer o conjunto de permissões Accounting Admin v2 ou Accounting Controller v2.

O código do território

O código do território é o identificador curto que você define ao criar um território — por exemplo, US para os Estados Unidos ou CA para a Califórnia. Algumas regras se aplicam:

Pode ter até 10 caracteres.
Não pode ser alterado depois de salvo — porque ele acaba marcado em registros por toda a aplicação, e alterá-lo quebraria esse vínculo.
Não pode conter um traço (-), porque o traço é reservado como separador entre um território pai e um território filho no código completo.

O código completo — como ele é construído

O código completo é gerado automaticamente — você nunca o digita. A forma como ele é construído depende do nível do território:

O código completo de um território de nível superior é simplesmente o próprio código. Estados Unidos → US.
O código completo de um território filho é o código do pai, um traço, e então o próprio código. O código do pai é prefixado ao do filho. Califórnia (código CA) sob Estados Unidos (código US) → US-CA.

Juntando tudo para uma hierarquia simples nos EUA:

Território	Código	Pai	Código completo
Estados Unidos	`US`	—	`US`
Califórnia	`CA`	Estados Unidos	`US-CA`
Texas	`TX`	Estados Unidos	`US-TX`

É por isso que o código não pode conter um traço O traço é a junção entre o código pai e o código filho. Se um código de território em si contivesse um traço, o código completo se tornaria ambíguo — por isso a REDA o reserva. É também por isso que o código completo é somente leitura: ele é sempre derivado do código e do pai, então não há nada a editar.

Como o código chega aos seus registros

O código completo não vive apenas no território — ele é copiado para todos os registros principais na aplicação: entidades, livros razão, faturas, contas a pagar, recebimentos, pagamentos, lançamentos contábeis, ativos, contas bancárias e outros. Cada registro carrega um campo Territory Full Code contendo o código completo do seu território.

A cópia acontece automaticamente, seguindo a estrutura dos registros:

O código completo de um território é marcado em suas entidades e livros razão.
Quando você cria um documento (uma fatura, um pagamento, um lançamento contábil…), a REDA lê o código completo da entidade (ou do livro razão) à qual o documento pertence e o copia para o documento.
Se a entidade ou o livro razão de um registro for alterado, o código completo é remarcado para permanecer correto.

Por exemplo: uma entidade atribuída ao território da Califórnia carrega o código completo US-CA. Toda fatura de venda, fatura de compra e pagamento dessa entidade também é automaticamente marcado com US-CA — ninguém precisa defini-lo.

O Territory Full Code é mantido pelo sistema Ele é preenchido automaticamente e nunca deve ser editado manualmente. Permanece em branco apenas quando um registro não tem território a herdar — por exemplo, uma entidade sem território atribuído. É um valor realmente armazenado (não uma fórmula ao vivo) de propósito — regras de compartilhamento baseadas em critérios só conseguem avaliar campos reais, que é exatamente para isso que esse código serve.

Quais registros carregam o código de território

O Territory Full Code é marcado em todas as partes principais da aplicação — de dados mestres a transações, passando por registros de fechamento de período e automação. Aqui está a lista completa de onde você o encontrará:

Área	Registros que carregam o Territory Full Code
Configuração e dados mestres	Entidades, Livros razão, Contas contábeis, Produtos, Contas bancárias, Clientes e Fornecedores (o registro da conta)
Vendas e contas a receber	Faturas de venda (e Notas de crédito), Recebimentos
Compras e contas a pagar	Ordens de compra, Faturas de compra (e Notas de crédito de fornecedor), Desembolsos, Lotes de desembolso, Listas de rateio de despesas
Livro razão	Lançamentos contábeis, Transações contábeis (os lançamentos já contabilizados no livro razão)
Ativos	Ativos imobilizados, Fichas de ativos
Orçamentos	Orçamentos, Lançamentos orçamentários
Bancos	Depósitos bancários, Conciliações bancárias
Automação e fechamento de período	Modelos recorrentes, documentos da Caixa de entrada de OCR, Instantâneos de aging

Essa abrangência é o ponto central: como o código está em todo registro de nível superior, um único conjunto de regras de compartilhamento baseadas em território pode governar o acesso a todo o seu conjunto de dados financeiros de forma consistente.

E os itens de linha e os extratos bancários? Você não verá o Territory Full Code em registros de detalhe — como linhas de fatura, linhas de lançamento contábil, ou extratos bancários e suas linhas — e isso é proposital. Esses são registros filhos de um pai que já carrega o código: uma linha de fatura pertence à sua fatura, e um extrato bancário pertence à sua conta bancária (que é marcada). Registros como esses são “controlados pelo pai”, então herdam automaticamente o acesso baseado em território do pai. Marcar o pai cobre seus filhos também — então nada fica desprotegido.

Como o código completo de um filho começa com o código do seu pai, a estrutura de prefixo torna o acesso hierárquico natural. Uma regra de compartilhamento escrita para o código do pai alcança os filhos automaticamente:

Uma regra que concede acesso onde o código completo do território começa com US cobre US, US-CA e US-TX — toda a hierarquia dos Estados Unidos.
Uma regra que concede acesso onde ele é igual a US-CA cobre apenas a Califórnia.

Assim, você pode dar a uma equipe nacional acesso a tudo dentro de um país com uma única regra, ao mesmo tempo em que consegue restringir uma equipe regional apenas ao seu sub-território. Para entender como isso se encaixa no modelo de dados geral, consulte Entendendo os Territórios → Controlando quem vê o quê.

O que vem a seguir

Entendendo os Territórios — os conceitos por trás dos territórios.
Criando e gerenciando territórios — construa sua hierarquia.
Entendendo os valores padrão de contabilidade — o que os territórios controlam.
Configurando os valores padrão de contabilidade — defina valores padrão por território.

Perguntas frequentes

Não. Você só define o código de território curto (e o pai, se for um território filho). A REDA constrói o código completo a partir desses dados — apenas o código para um território de nível superior, ou Pai-Filho para um sub-território — e o mantém atualizado automaticamente.

O traço é reservado para unir um código pai e um código filho no código completo (por exemplo, US-CA). Permitir um traço dentro de um código tornaria o código completo ambíguo, por isso a REDA o bloqueia.

A entidade (ou o livro razão) do registro não tem um território atribuído — não há nada a herdar. Atribua o território na entidade ou no livro razão, e os registros novos e atualizados passarão a ser marcados automaticamente a partir daí.

Não — ele é mantido pelo sistema e nunca deve ser editado manualmente. Ele sempre reflete o território da entidade ou do livro razão do registro, e é remarcado automaticamente se isso mudar.

Não enquanto a entidade estiver ativa — o sistema bloqueia essa ação: “O Território não pode ser alterado em uma entidade ativa. Desative a entidade primeiro para alterar o território; observe que a alteração não migra períodos nem transações existentes.” O posicionamento do território é uma decisão estrutural, então é importante acertá-lo ao criar a entidade.

Isso foi útil?