CT Medição de Itens de Contrato - Bilhetagem
Finanças > Contratos > Rotinas > EDI > Recebe > Medição de Itens de Contrato - Bilhetagem
Medição de Itens de Contrato - Bilhetagem
[editar]
Descrição
[editar]A rotina Medição de Itens de Contrato - Bilhetagem (CG03275) permite importar medições de itens de contrato a partir de um arquivo texto externo, adicionando novos itens às parcelas do contrato em lote.
Após a importação, o sistema atualiza:
- A parcela padrão do contrato, adicionando o novo item conforme a periodicidade informada.
- As parcelas de previsão ainda não faturadas, a partir da primeira parcela até a parcela informada no arquivo, adicionando o novo item conforme a periodicidade informada.
Os itens importados terão a periodicidade igual a 1 Mensal.
Pré-requisito
[editar]Para utilizar esta rotina é necessário que o Objeto de Contrato vinculado ao contrato possua:
- Opção Controla Periodicidade por Item selecionada.
Localização no sistema
[editar]Finanças → Contratos → Rotinas → EDI → Recebe → Medição de Itens de Contrato - Bilhetagem
Como utilizar
[editar]1. Preparar o arquivo de importação
[editar]O arquivo deve ser texto (.TXT), posicional (largura fixa), codificação Windows-1252 (ANSI), sem delimitador — os campos são identificados pela posição e tamanho de cada coluna.
O arquivo é estruturado em grupos de linhas: cada grupo inicia com uma linha de cabeçalho (tipo 01) identificando o contrato, seguida de uma ou mais linhas de item (tipo 02) com os dados do item a importar. Um mesmo arquivo pode conter múltiplos grupos, importando itens para vários contratos em uma única execução.
Após o processamento bem-sucedido, o arquivo é renomeado para a extensão .ABZ, evitando reprocessamento acidental.
2. Selecionar o arquivo
[editar]Na tela da rotina, utilize o botão de seleção para localizar o arquivo .TXT.
3. Confirmar
[editar]Clique em Confirmar para iniciar o processamento. O sistema exibirá mensagens de erro por linha caso alguma validação falhe.
Estrutura do arquivo
[editar]O arquivo possui dois tipos de linha:
Linha tipo 01 — Cabeçalho do Contrato
[editar]Identifica o contrato ao qual os itens das linhas seguintes (tipo 02) serão vinculados.
| Campo | Formato | Pos. Inicial | Pos. Final | Observação |
|---|---|---|---|---|
| Identificação de Registro | A2 | 1 | 2 | Valor fixo: 01 |
| Código do Contrato | A20 | 4 | 23 | Código do contrato cadastrado no sistema |
Linha tipo 02 — Item
[editar]Define cada item a ser importado para o contrato identificado na linha 01 anterior.
| Campo | Variável | Formato | Pos. Inicial | Pos. Final | Observação |
|---|---|---|---|---|---|
| Identificação de Registro | v_tipo | A2 | 1 | 2 | Valor fixo: 02 |
| Código do Material | v_codigoContratoOuMaterial | A20 | 4 | 23 | Código do material a importar |
| Tipo de Operação | v_tipoDeOperacao | A5 | 25 | 29 | Código do Tipo de Operação. Deve estar cadastrado no sistema. |
| Quantidade | v_quantidade | N11 | 32 | 42 | Quantidade inteira, alinhada à esquerda. Deve ser maior que zero. Separador de milhar: vírgula. |
| Percentual de Desconto | v_desconto | N3,2 | 44 | 51 | Percentual de desconto. Separador decimal: vírgula. Ex: 5,00
|
| Valor do Desconto | v_valorDesconto | N11,2 | 53 | 70 | Valor monetário do desconto. Separador decimal: vírgula. |
| Preço Unitário | v_precoUnitario | N11 | 72 | 82 | Preço unitário. Separador decimal: vírgula. |
| Data de Competência | v_dataCompetencia | ##/##/## | 84 | 91 | Data no formato DD/MM/AA (ano com 2 dígitos). Obrigatório. O contrato deve possuir competência cadastrada para esta data. |
| Reduzido Gerencial | v_reduzidoGerencial | A6 | 93 | 98 | Código reduzido gerencial. |
| Reduzido Contábil | v_contabil | A6 | 100 | 105 | Código contábil. |
| Percentual ISS | v_percIss | N3,2 | 107 | 114 | Percentual de ISS. Separador decimal: vírgula. Ex: 1,57
|
| Parcela Final (item válido até) | v_bloqQtde | N4 | 116 | 119 | Define até qual parcela do contrato o item será válido. Se não informado, valerá para todas as parcelas geradas. |
| Documento | v_documentoinicial | A10 | 121 | 130 | Identificação do documento. |
| Bloquear Quantidade | v_bloqQtde | N1 | 132 | 132 | 0=não bloqueia / 1=bloqueia quantidade. |
| Quantidade Original | v_quantidadeOriginal | N13,2 | 134 | 153 | Quantidade original antes de ajustes. Separador decimal: vírgula. |
| Data Inicial | v_dataInicial | ##/##/## | 155 | 162 | Data de início da cobrança no formato DD/MM/AA. Se não informada, o item valerá para todas as parcelas. No arquivo é obrigatória, pois indica a parcela inicial do item. |
| Data Final | v_dataFinal | ##/##/## | 164 | 171 | Data de encerramento da cobrança no formato DD/MM/AA. Se não informada, o item valerá para todas as parcelas geradas. |
| Descrição | v_descricao | A201 | 173 | 373 | Descrição / histórico do item (texto livre). |
Observações sobre os campos:
- O separador decimal dos campos numéricos é a vírgula (,), padrão brasileiro.
- Os campos alfanuméricos são alinhados à esquerda, preenchidos com espaços à direita.
- Os campos numéricos são alinhados à esquerda, preenchidos com espaços à direita.
- As datas usam formato DD/MM/AA com barras — ano com 2 dígitos.
Exemplos de arquivo
[editar]Exemplo 1 — Um contrato, um item
[editar]01 BIL001 02 001 5101A 10 5,00 100,00 200,00 01/09/26 80009 1,57 3 BILHETAGEM 0 10 01/09/26 30/09/26 LICENCIAMENTO DE USO DO SOFTWARE ERP CIGAM.
Exemplo 2 — Um contrato, dois itens
[editar]01 CTR-MANUT-001 02 MAT-001 NF 1 0,00 0,00 1250,00 01/07/26 000001 000001 0,00 0 MANUTENCAO 0 1 01/07/26 31/07/26 MANUTENCAO PREDIAL JULHO 2026 02 MAT-002 NF 5 5,00 31,25 125,00 01/07/26 000001 000001 0,00 0 MANUTENCAO 0 5 01/07/26 31/07/26 FORNECIMENTO DE INSUMOS JULHO 2026
Exemplo 3 — Dois contratos, com itens distintos
[editar]01 CTR-MANUT-001 02 MAT-001 NF 1 0,00 0,00 1250,00 01/07/26 000001 000001 0,00 0 MANUTENCAO 0 1 01/07/26 31/07/26 MANUTENCAO PREDIAL JULHO 2026 01 CTR-LIMPEZA-002 02 MAT-003 NF 1 0,00 0,00 750,00 01/07/26 000002 000002 0,00 0 LIMPEZA 0 1 01/07/26 31/07/26 SERVICO DE LIMPEZA JULHO 2026 02 MAT-004 NF 10 0,00 0,00 45,00 01/07/26 000002 000002 0,00 0 MATERIAL 0 10 01/07/26 31/07/26 MATERIAL DE LIMPEZA JULHO 2026
Funcionalidades das datas
[editar]- Data Inicial: indica o mês/ano em que o item passa a ser cobrado. No arquivo é obrigatória, pois serve como base para indicar a parcela inicial do item. Se não informada na tela (parcela padrão), o item valerá para todas as parcelas geradas.
- Data Final: define quando o item deixa de ser cobrado. Se não informada, o item valerá para todas as parcelas geradas.
- Parcela Final (item válido até parcela): define até qual parcela do contrato o item será válido.
Validações realizadas pelo sistema
[editar]- Contrato informado na linha tipo 01 deve existir no sistema.
- Material (linha tipo 02) deve existir no cadastro.
- Quantidade deve ser maior que zero.
- O contrato deve possuir competência cadastrada para a data de competência informada.
- Parcela inicial não pode exceder o total de parcelas do contrato.
- Tipo de Operação deve existir e ser compatível com o tipo do contrato.
- O contrato deve ter periodicidade por item configurada.
Observações técnicas
[editar]- Após a leitura, o arquivo é renomeado para .ABZ para evitar reprocessamento.
- Existe a opção de aglutinar medições do mesmo contrato/material, somando quantidades e valores antes de gravar.
