CT Medição de Itens de Contrato - Bilhetagem

De CIGAM WIKI

Finanças > Contratos > Rotinas > EDI > Recebe > Medição de Itens de Contrato - Bilhetagem

Medição de Itens de Contrato - Bilhetagem


Bilhetagemmedicao.png


Descrição

A rotina Medição de Itens de Contrato - Bilhetagem (CG03275) permite importar medições de itens de contrato ou de materiais a partir de um arquivo texto externo, processando-os em lote diretamente no módulo de Contratos do CIGAM ERP.

O processamento suporta dois modos:

  • Por Contrato (tipo 01): a medição é vinculada a um contrato existente.
  • Por Material (tipo 02): a medição é vinculada a um material específico.

Localização no sistema

Finanças → Contratos → Rotinas → EDI → Recebe → Medição de Itens de Contrato - Bilhetagem

Como utilizar

1. Preparar o arquivo de importação

O arquivo deve ser texto (.TXT), delimitado por ponto-e-vírgula (;), codificação Windows-1252 (ANSI), uma medição por linha.

Após o processamento bem-sucedido, o programa renomeia o arquivo original para a extensão .ABZ como confirmação de leitura, evitando reprocessamento acidental.

2. Selecionar o arquivo

Na tela da rotina, utilize o botão de seleção para localizar o arquivo .TXT no sistema de arquivos.

3. Opção de aglutinação

Marque a opção Aglutinar Material/Contratos caso deseje que o sistema some quantidades e valores de linhas com o mesmo contrato/material antes de efetuar o lançamento.

4. Confirmar

Clique em Confirmar para iniciar o processamento. O sistema exibirá mensagens de erro por linha caso alguma validação falhe.

Layout do arquivo de importação

O arquivo é delimitado por ponto-e-vírgula (;), com os campos na seguinte ordem:

# Campo Variável Tipo Tam. Máscara Observação
1 Tipo de Registro v_tipo Alpha 2 UUA 01=Contrato / 02=Material. Obrigatório.
2 Código do Contrato/Material v_codigoContratoOuMaterial Alpha 20 20A Código do contrato (quando tipo=01) ou do material (quando tipo=02). Pontos são removidos automaticamente pelo sistema.
3 Tipo de Operação v_tipoDeOperacao Alpha 6 6A Código do Tipo de Operação. Deve estar cadastrado no sistema.
4 Quantidade v_quantidade Numérico 11 N11CA Quantidade inteira (máx. 11 dígitos). Deve ser maior que zero. Separador de milhar aceito.
5 Desconto (%) v_desconto Numérico 8 N3.2%A Percentual de desconto. Até 3 inteiros e 2 decimais. O símbolo % não é enviado no arquivo. Ex: 5.00
6 Valor do Desconto v_valorDesconto Numérico 18 N15.2CA Valor monetário do desconto. Até 15 inteiros e 2 decimais.
7 Preço Unitário v_precoUnitario Numérico 11 N9.2CA Até 9 inteiros e 2 decimais. Ex: 00001250.00
8 Data de Competência v_dataCompetencia Data 8 DD/MM/YY Formato com barras e ano de 2 dígitos. Ex: 01/07/25. Obrigatório. O contrato deve possuir competência cadastrada para esta data.
9 Reduzido Gerencial v_reduzidoGerencial Alpha 6 6A Código reduzido gerencial.
10 Contábil v_contabil Alpha 6 6A Código contábil.
11 ISS (%) v_percIss Numérico 8 N3.2%A Percentual de ISS. Até 3 inteiros e 2 decimais. Ex: 5.00
12 Repetições/Parcelas v_repeticao Numérico 4 4A Número de repetições ou parcelas.
13 Documento Inicial v_documentoinicial Alpha 8 8A Documento inicial.
14 Documento Final v_documentoFinal Alpha 2 2A Sufixo/identificação do documento final.
15 Bloqueia Quantidade v_bloqQtde Numérico 1 1 0=não bloqueia / 1=bloqueia.
16 Quantidade Original v_quantidadeOriginal Numérico 20 N17.2CA Quantidade original antes de ajustes. Até 17 inteiros e 2 decimais.
17 Data Inicial v_dataInicial Data 8 DD/MM/YY Data inicial do período. Formato com barras e ano de 2 dígitos. Ex: 01/07/25
18 Data Final v_dataFinal Data 8 DD/MM/YY Data final do período. Formato com barras e ano de 2 dígitos. Ex: 31/07/25
19 Descrição/Histórico v_descricao Alpha 201 201A Texto livre, até 201 caracteres.

Observação sobre percentuais: os campos Desconto (%) e ISS (%) usam máscara N3.2%A. O símbolo % é apenas visual — não deve ser incluído no arquivo.

Exemplo de linha

01;       CTR-MANUT-001;1101A;00000000001;    0.00;              0.00;00001250.00;01/07/25;000001;000001;    0.00;0001;00000001;NF;0;   00000000000000001;01/07/25;31/07/25;Servico de manutencao predial julho 2025

Validações realizadas pelo sistema

O programa executa as seguintes validações antes de gravar:

  • Contrato/Material inexistente: o código informado deve existir no cadastro do sistema.
  • Quantidade zero ou negativa: o campo quantidade deve ser maior que zero.
  • Competência não cadastrada: o contrato deve possuir competência para a data informada em Data Competência.
  • Parcela inicial excede total de parcelas: validação de consistência de parcelas.
  • Tipo de Operação inválido: o Tipo de Operação informado deve existir e ser compatível com o contrato.
  • Periodicidade por item: contratos com configuração de periodicidade por item são validados.
Disponível em "https://www.cigam.com.br/wiki/index.php?title=CT_Medição_de_Itens_de_Contrato_-_Bilhetagem&oldid=158118"