Informações de Guia de Trânsito e Defensivos Agrícolas (GTA)¶
Movimentações > Vendas e Devoluções > botão Guia (janela auxiliar)
O que é¶
Janela auxiliar acionada dentro da tela de Vendas e Devoluções para preencher dados obrigatórios da NF-e quando a operação envolve transporte de animais (GTA — Guia de Trânsito Animal e outros documentos de trânsito) ou defensivos agrícolas (agrotóxicos com receituário). Esses dados são exigidos pela legislação fiscal e devem constar no XML da NF-e.
Como acessar¶
- Na tela de Vendas e Devoluções, com uma nota em edição, clique no botão Guia (visível na barra de botões da venda).
- A janela
Informações da Guia e Defensivosé aberta. - Preencha os campos desejados e feche — os dados são gravados automaticamente na venda ao fechar.
Onde os dados são armazenados¶
Todos os campos desta janela são gravados na tabela VENDAS (registro da venda aberta), campos do cabeçalho da nota:
| Campo na tela | Tabela.Campo | Descrição |
|---|---|---|
| Tipo da Guia | VENDAS.VE_TPGUIA |
Código do tipo de guia de trânsito |
| UF da Guia | VENDAS.VE_UFGUIA |
Estado emissor da guia |
| Número da Guia | VENDAS.VE_NGUIA |
Número do documento de trânsito |
| Série | VENDAS.VE_SERIEGUIA |
Série do documento de trânsito |
| Número do Receituário | VENDAS.VE_NRECEITUARIO |
Número do receituário agronômico (defensivos) |
| CPF do Resp. Técnico | VENDAS.VE_CPFRESPTEC |
CPF do responsável técnico pelo receituário |
Abas da janela¶
Aba — Guia de Trânsito¶
Preencher quando a venda envolve transporte de animais ou produtos agropecuários com exigência de guia de trânsito.
| Campo | Valores possíveis | Observações |
|---|---|---|
| Tipo da Guia | 1 - GTA, 2 - TTA, 3 - DTA, 4 - ATV, 5 - PTV, 6 - GTV, 7 - Guia Florestal |
Deixar em branco se não aplicável |
| UF da Guia | Lista de UFs brasileiras (AC, AL, AM … TO) | Estado emissor do documento |
| Número da Guia | Texto livre | Número do documento de trânsito emitido pelo órgão competente |
| Série | Texto livre | Série do documento |
Tipos de guia: - GTA — Guia de Trânsito Animal (MAPA) - TTA — Termo de Trânsito de Animais - DTA — Documento de Trânsito de Animais - ATV — Atestado de Trânsito de Vegetal - PTV — Permissão de Trânsito de Vegetais (MAPA) - GTV — Guia de Trânsito de Vegetais - Guia Florestal — Documento de origem florestal (DOF/SINAFLOR)
Aba — Defensivos Agrícolas¶
Preencher quando a venda inclui agrotóxicos ou defensivos que exigem receituário agronômico.
| Campo | Banco | Observações |
|---|---|---|
| Número do Receituário | VENDAS.VE_NRECEITUARIO |
Número do receituário emitido pelo engenheiro agrônomo |
| CPF do Resp. Técnico | VENDAS.VE_CPFRESPTEC |
CPF do responsável técnico; validado ao sair do campo — CPF inválido exibe mensagem de erro e mantém o foco no campo |
Regras de negócio¶
Validação do CPF do Responsável Técnico¶
Ao sair do campo CPF do Resp. Técnico (edtCPFRespTecExit):
- Remove a máscara e valida o dígito verificador via ValidaCPF.
- Se inválido: exibe "O CPF do Responsável Técnico informado é inválido. Por favor, verifique a digitação." e retorna o foco ao campo.
- CPF em branco é aceito (campo não obrigatório pela tela — obrigatoriedade depende do tipo de produto na NF-e).
Gravação automática ao fechar¶
Ao fechar a janela (FormClose), o sistema executa automaticamente:
1. dsVendas.DataSet.Post — confirma a edição do registro de venda.
2. DM_Vend.cdsVendas.ApplyUpdates(0) — persiste no banco de dados.
Portanto, não há botão Gravar nesta janela; basta fechar.
Perguntas frequentes do suporte¶
"Onde preencho os dados da GTA na venda?" → Na tela de Vendas e Devoluções, clique no botão Guia na barra superior. A janela abre para informar o tipo, UF, número e série do documento de trânsito.
"O sistema validou o CPF do responsável técnico como inválido mas o CPF está correto" → Verifique se o CPF foi digitado corretamente com todos os 11 dígitos. O sistema remove a máscara e valida o dígito verificador. Se o CPF for genuinamente válido mas a validação falhar, verifique se não há espaços extras.
"Os dados da guia aparecem na NF-e?"
→ Sim. Os campos VE_TPGUIA, VE_UFGUIA, VE_NGUIA e VE_SERIEGUIA são incluídos no XML da NF-e no grupo de informações adicionais / transporte conforme a legislação vigente para operações agropecuárias.