Orientações para importação/exportação de dados de Emendas

1. Estrutura padrão do arquivo de importação

O arquivo de importação deve ser um arquivo texto com extensão .CSV, mas, o separador das colunas de dados deve ser o caracter “|” (pipe).

O arquivo possui dois tipos de linhas:

Linha de cabeçalho: é a primeira linha do arquivo é a linha de cabeçalho, que identifica a estrutura das colunas de dados;

Linha de dados: são as demais linhas do arquivo, com os dados para importação, que identificam os registros a serem alterados.

As linhas de dados funcionam de acordo com a operação desejada, para operações de inclusão ou exclusão de dados, basta uma linha de dados. Já no caso de uma operação de alteração de dados, será necessário um par de linhas de dados, cada par identifica um registro a ser alterado e devem sempre estar dispostas na seguinte ordem:

Linha de identificação dos dados originais (LINHA “DE”): primeira linha do registro a ser alterado, essa linha deve conter as informações necessárias para identificação do registro a ser alterado;

Linha de Definição dos novos dados (LINHA “PARA”): segunda linha do registro a ser alterado, essa linha deve conter as informações necessárias para atualização do registro a ser alterado.

Segue a estrutura das colunas das linhas do arquivo, lembrando que na linha de cabeçalho serão apresentados os nomes das colunas e nas linhas de dados, os valores, como orientado abaixo:

NRO:	Número qualquer, sendo que todos os de/para de um mesmo pedido devem ter o mesmo número. Se a planilha tiver mais de um pedido, cada pedido tem que ter um número diferente.
DE-PARA:	Orienta o mapeamento das alterações desejadas. Indica se linha se refere ao valor original “De” ou desejado “Para”.
EXERCÍCIO:	9999
AUTOR:	9999
CÓDIGO:	99999999
FUNCIONAL:	99.99999.99.999.9999.XXXX.9999
DOTAÇÃO:	9999.9.999.9999.9
CNPJ:	CNPJ do beneficiário, somente números
IMPEDIMENTO:	Código do tipo de impedimento
JUSTIFICATIVA:	Texto da justificativa
VALOR:	Somente números, sem centavos

2. Tabela de operações de importação de dados possíveis

As operações de importação foram divididas em duas categorias:

Operações específicas com beneficiários: inclusão e alteração de beneficiários ou inclusão e alteração de impedimentos.

Operações de remanejamento de dotações: operações de troca de modalidade, de GND ou de programação orçamentária.

Atenção! Recomendamos, fortemente, que cada planilha utilizada para importação, contenha apenas uma das categorias de operações, apresentadas acima. Dessa forma, operações específicas com beneficiários, não devem ser incluídas em planilhas que possuam operações de remanejamento de dotações e vice-versa, pois uma categoria de operação pode impactar na execução da outra. Caso seja necessário realizar operações de importação das duas categorias, devem ser realizadas primeiro as operações específicas com beneficiários. Portanto deve ser “carregada” primeiro a planilha com as operações específicas com beneficiários e depois deve ser carregada a planilha com as operações de remanejamento de dotação.

2.1. Operações específicas com beneficiários (incluir e alterar beneficiário; incluir e remover impedimentos):

Operação	LINHA “DE”	LINHA “PARA”
Adicionar beneficiário	Omitir essa linha.	Preencher dados até a coluna “CNPJ” e também a coluna “VALOR”.
Alterar valor de um beneficiário	Preencher dados até a coluna “CNPJ”.	Preencher com mesmos dados da linha “DE”, acrescentando o novo valor na coluna “VALOR”.
Adicionar impedimento	Omitir essa linha	Preencher os campos até a coluna “IMPEDIMENTO”, e preencher também a coluna “VALOR” com o valor impedido.
Retirar um impedimento	Preencher dados até a coluna “IMPEDIMENTO”.	Omitir essa linha.

2.2. Operações de remanejamento de dotações (troca de modalidade, GND e programação):

Operação	LINHA “DE”	LINHA “PARA”
Trocar MODALIDADE e/ou GND e/ou FUNCIONAL	Preencher dados até a coluna “DOTAÇÃO”.	Preencher dados até a coluna “DOTAÇÃO”, com as novas informações de MODALIDADE e/ou GND e/ou FUNCIONAL.
Trocar MODALIDADE e/ou GND e/ou FUNCIONAL de um beneficiário específico	Preencher dados até a coluna “CNPJ”.	Preencher dados até a coluna “CNPJ”, com as novas informações de MODALIDADE e/ou GND e/ou FUNCIONAL.
Trocar parcialmente MODALIDADE e/ou GND e/ou FUNCIONAL de um beneficiário específico	Preencher dados até a coluna “CNPJ”.	Preencher dados até a coluna “CNPJ”, com as novas informações de MODALIDADE e/ou GND e/ou FUNCIONAL e o valor parcial a transferir.
Trocar funcional-programática da emenda	Preencher dados até a coluna “DOTAÇÃO”.	Preencher dados até a coluna “DOTAÇÃO”, agora com a nova dotação.

3. Exemplo de modelo de arquivo de importação

O exemplo abaixo, trata-se de uma alteração do valor indicado para o beneficiário. Nesse caso, temos a linha de cabeçalho e um par de linhas de dados.

Nro	De-Para	Exercício	Autor	Código	Funcional	Dotação	CNPJ	Impedimento	Justificativa	Valor
10	De	2017	1773	17730010	20.52121.05.301.2108.2E74.7136	9999.0.188.44900000.6	70000280000032	251402
10	Para	2017	1773	17730010	20.52121.05.301.2108.2E74.7136	9999.0.188.44300000.6	70000280000032	308764

O arquivo correspondente às informações apresentadas acima, seria:

Nro|De-Para|Exercício|Autor|Código|Funcional|Dotação|CNPJ|Impedimento|Justificativa|Valor
10|De|2017|1773|17730010|20.52121.05.301.2108.2E74.7136|9999.0.188.44900000.6|70000280000032|||251402
10|Para|2017|1773|17730010|20.52121.05.301.2108.2E74.7136|9999.0.188.44300000.6|70000280000032|||308764