Atualizado em 19/09/2026
O que você vai aprender #
Quais tags (campos) o GTI-Plug substitui automaticamente ao imprimir uma etiqueta, organizadas por tipo de etiqueta, com a sintaxe e as funções de formatação.
Como usar uma tag #
No corpo do template, escreva a tag no formato:
${NOME_DA_TAG}
Exemplo: ${PRODUTO_NOME} é trocado pelo nome do produto no momento da impressão.
- Maiúsculas/minúsculas não importam (
${produto_nome} = ${PRODUTO_NOME}).
- Se a tag não se aplica ao tipo de etiqueta impresso (ex.: uma tag de recebimento numa etiqueta de expedição), ela é substituída por vazio.
- Muitas tags têm apelidos (aliases) mais curtos — veja a coluna “Apelido”.
Tags por tipo de etiqueta #
Cada tipo de etiqueta tem acesso a um conjunto de grupos de tags:
| Tipo de etiqueta |
Grupos de tags disponíveis |
| Produto (identificação do item) |
Genéricas · Produto · Dados Complementares · Códigos · Armazém/Endereço |
| Recebimento |
Genéricas · Produto · Dados Complementares · Códigos · Armazém · Recebimento |
| Expedição |
Genéricas · Produto · Dados Complementares · Códigos · Armazém · Expedição |
| Agrupador de Fracionados |
Genéricas · Produto · Agrupador · Operação (Receb./Exp.) |
| Empacotamento (Volume) |
Genéricas · Empacotamento · Unidade de Movimentação · Expedição (destinatário) |
Catálogo de tags #
Genéricas (todas as etiquetas)
| Tag |
Descrição |
Apelido |
${DATA_IMPRESSAO} |
Data e hora da impressão (dd/MM/aaaa HH:mm) |
— |
Produto
| Tag |
Descrição |
Apelido |
${PRODUTO_NOME} |
Nome do produto |
${NOME_PRODUTO}, ${PRODUTO} |
${PRODUTO_DESCRICAO} |
Descrição do produto |
${DESCRICAO} |
${PRODUTO_ID_EXTERNO} |
Código externo (SKU/integração) |
${IDEXTERNO}, ${ID_EXTERNO} |
${PRODUTO_ID_EXTERNO_NOME} |
Código externo + nome |
${NAME} |
${PRODUTO_QTDE_FRACAO} |
Quantidade de frações |
${QTDEFRACAO}, ${PRODUTO_QTDE} |
${GTI} |
Identificador interno do ativo (GTI#) |
— |
${PRODUTO_DATA_PRIMEIRA_IMPRESSAO} |
Data da primeira impressão do ativo |
${DATA_CRIACAO} |
Dados Complementares (lote, série, validade…)
| Tag |
Descrição |
Apelido |
${PRODUTO_NUMERO_SERIE} |
Número de série |
${SNUMBER} |
${PRODUTO_LOTE} |
Lote |
${PNUMBER} |
${PRODUTO_DATA_VALIDADE} |
Data de validade |
${DT_VAL} |
${PRODUTO_DATA_FABRICACAO} |
Data de fabricação |
${DT_FAB} |
${PRODUTO_PESO} |
Peso |
${PESO} |
${PRODUTO_VALOR} |
Valor |
${VALOR} |
${PRODUTO_LIVRE1} |
Campo livre 1 |
${LIVRE_1} |
${PRODUTO_LIVRE2} |
Campo livre 2 |
${LIVRE_2} |
Códigos de barras do produto
| Tag |
Descrição |
Apelido |
${PRODUTO_CODIGO_EAN13} |
Código EAN-13 |
${CODIGO_EAN13}, ${PRODUTO_EAN} |
${PRODUTO_CODIGO_DUN14} |
Código DUN-14 |
${CODIGO_DUN14} |
${PRODUTO_CODIGO_PERSONALIZADO1} |
Código personalizado 1 |
${CODIGO_PERSONALIZADO1} |
${PRODUTO_CODIGO_PERSONALIZADO2} |
Código personalizado 2 |
${CODIGO_PERSONALIZADO2} |
${PRODUTO_ANVISA} |
Código ANVISA |
${ANVISA} |
Armazém e Endereço
| Tag |
Descrição |
Apelido |
${ARMAZEM_NOME} |
Nome do armazém |
${ARMAZEM} |
${ARMAZEM_ENDERECAMENTO} |
Descrição do endereçamento |
${ENDERECAMENTO} |
${ARMAZEM_ENDERECO} |
Endereço formatado do ativo |
${ADDRESS} |
${ARMAZEM_ENDERECO_ALIAS} |
Alias do endereço |
${ADDRESS_ALIAS}, ${ADDRESS_OR_ALIAS} |
Recebimento
| Tag |
Descrição |
${RECEBIMENTO_NUMERO} |
Número do recebimento |
${RECEBIMENTO_ID_EXTERNO} |
Código externo do recebimento |
${RECEBIMENTO_ETAPA_ID} · ${RECEBIMENTO_NUMERO_ETAPA} |
Identificação da etapa |
${RECEBIMENTO_NUMERO_PEDIDO} |
Número do pedido |
${RECEBIMENTO_NUMERO_NF} |
Número da nota fiscal |
${RECEBIMENTO_DATA_AGENDAMENTO} · ${RECEBIMENTO_DATA_EXECUCAO} |
Datas |
${RECEBIMENTO_OBSERVACAO} |
Observação |
${RECEBIMENTO_REMETENTE_NOME} |
Nome do remetente (${REMETENTE_NOME}) |
${RECEBIMENTO_REMETENTE_CPF_CNPJ} |
CPF/CNPJ do remetente |
${RECEBIMENTO_REMETENTE_ENDERECO_CEP} … _RUA _NUMERO _COMPLEMENTO _BAIRRO _CIDADE _ESTADO _PAIS |
Endereço do remetente |
${RECEBIMENTO_TRANSPORTADORA_NOME} · _CPF_CNPJ · _ENDERECO_CEP |
Transportadora |
Expedição
| Tag |
Descrição |
${EXPEDICAO_NUMERO} |
Número da expedição (${IDOPERACAO}, ${IDEXPEDICAO}) |
${EXPEDICAO_ID_EXTERNO} |
Código externo |
${EXPEDICAO_ETAPA_ID} · ${EXPEDICAO_ETAPA_NUMERO} |
Etapa (${IDETAPA}) |
${EXPEDICAO_NUMERO_PEDIDO} |
Número do pedido (${NUMEROPEDIDO}, ${EXP_NUMERO_PEDIDO}) |
${EXPEDICAO_NUMERO_NF} |
Número da NF (${NUMERONF}, ${EXP_NF}) |
${EXPEDICAO_DATA_AGENDAMENTO} · ${EXPEDICAO_DATA_EXECUCAO} |
Datas |
${EXPEDICAO_OBSERVACAO} |
Observação |
${EXPEDICAO_DESTINATARIO_NOME} |
Nome do destinatário (${DESTINATARIO}, ${DESTINATARIO_NOME}) |
${EXPEDICAO_DESTINATARIO_CPF_CNPJ} |
CPF/CNPJ do destinatário |
${EXPEDICAO_DESTINATARIO_ENDERECO_CEP} … _RUA _NUMERO _COMPLEMENTO _BAIRRO _CIDADE _ESTADO _PAIS |
Endereço do destinatário |
${EXPEDICAO_TRANSPORTADORA_NOME} · _CPF_CNPJ · _ENDERECO_CEP |
Transportadora |
Agrupador de Fracionados
| Tag |
Descrição |
${AGRUPADOR_CODIGO} |
Código do agrupador (${CODIGO}) |
Empacotamento (Volume)
| Tag |
Descrição |
${EMPACOTAMENTO_NUMERO} |
Número do empacotamento (${PACKING_ID}) |
${EMPACOTAMENTO_ID_EXTERNO} |
Código externo |
${EMPACOTAMENTO_VOLUME_ID} |
ID do volume (${PACKING_VOLUME_ID}) |
${EMPACOTAMENTO_VOLUME_NUMERO} |
Número do volume (${PACKING_VOLUME}) |
${EMPACOTAMENTO_VOLUME_TOTAL} |
Total de volumes (${PACKING_TOTAL}) |
Unidade de Movimentação (no empacotamento)
| Tag |
Descrição |
${UNIDADE_MOVIMENTACAO_CODIGO} |
Código da unidade de movimentação |
${UNIDADE_MOVIMENTACAO_QTDE_ETIQUETAS_VINCULADAS} |
Qtd. de etiquetas vinculadas |
${UNIDADE_MOVIMENTACAO_PRODUTO_NOME} · _ID_EXTERNO · _ID_EXTERNO_NOME |
Produto da unidade |
${UNIDADE_MOVIMENTACAO_PRODUTO_NUMERO_SERIE} · _LOTE |
Série / Lote |
${UNIDADE_MOVIMENTACAO_PRODUTO_PESO} · _VALOR |
Peso / Valor |
${UNIDADE_MOVIMENTACAO_PRODUTO_DATA_FABRICACAO} · _DATA_VALIDADE |
Datas |
${UNIDADE_MOVIMENTACAO_PRODUTO_LIVRE1} · _LIVRE2 |
Campos livres |
Funções de formatação #
Além de inserir a tag, você pode formatar o valor com funções, no formato #[funcao(argumentos)]. O primeiro argumento pode ser uma tag ${...}; os demais são literais (entre aspas quando texto).
| Função |
Para que serve |
Exemplo |
#[substr(texto, início, fim)] |
Recorta um trecho do texto |
#[substr(${PRODUTO_NOME},0,10)] |
#[fill(texto, caractere, tamanho)] |
Completa o texto até um tamanho |
#[fill(${PRODUTO_LOTE},"0",8)] |
#[truncate(texto, qtd)] |
Remove caracteres do texto |
#[truncate(${PRODUTO_DESCRICAO},5)] |
#[split(texto, divisor, índice)] |
Divide o texto e pega uma parte (aceita divisores especiais como ENTER, TAB) |
#[split(${ARMAZEM_ENDERECO},"-",0)] |
#[replace(texto, de, para)] |
Substitui um trecho por outro |
#[replace(${PRODUTO_NOME}," ","_")] |
#[replace_fill(texto, de, para, caractere, tamanho)] |
Substitui e depois completa o tamanho |
#[replace_fill(${PRODUTO_LOTE},"/","","0",10)] |
💡 As funções são úteis para caber o valor no espaço da etiqueta (recortar/preencher) e para gerar códigos de barras com tamanho fixo.
Boas práticas #
- Teste com dados reais após montar o template (veja Configurar Templates de Etiqueta).
- Use as tags do tipo certo: numa etiqueta de expedição, use as tags
EXPEDICAO_*; numa de recebimento, as RECEBIMENTO_*.
- Prefira os nomes completos das tags (mais legíveis); os apelidos existem por compatibilidade.
Artigos Relacionados #
