Ad em Pie Re

Manual do usuário
Adempiere 3.6.0
OSeB
Objetivo
O objetivo deste manual é fornecer uma visão geral das funcionalidades do software Adempiere, assim
como a customização para atender as necessidades do Brasil, o projeto AdempiereLBR/OSeB. O
Adempiere é um projeto open-source derivado do software Compiere. O Adempiere possui
funcionalidades CRM e ERP e é bem flexível para ser customizado e atender empresas de segmentos
variados.
Referências:
Este manual foi elaborado com base em informações extraídas dos links abaixo. Os fóruns contém muita
informação e é uma excelente maneira de tirar suas dúvidas.
Página oficial do Adempiere
Página do projeto Adempiere
Página do projeto OseB
Fórum OSeB
Fórum Kenos (AdempiereLBR)
Manual Adempiere (portugês-portugal)
Página com cursos on-line do Adempiere 3.4
Mais informações para usar o Adempiere
Histórico de versões
Data Versão Usuário Histórico
08/16/2010 1 Rogerio Bettini Criação do documento
10/05/10 2 Rogerio Bettini Primeira revisão do documento
Índice
1.Instalação AdempiereLBR ........................................................................................................................6
1.1.Instalação JDK....................................................................................................................................6
1.2.Instalação PostgreSQL........................................................................................................................6
1.3.Adempiere 3.6.0..................................................................................................................................6
1.3.1.Configurar as variáveis de ambiente - Windows.........................................................................6
1.3.2.Arquivos OSEB 3.6.0 (customização para o Brasil)...................................................................6
1.3.3.Copiar os arquivos do Adempiere...............................................................................................7
1.3.4.Configurar o Adempiere (primeira execução).............................................................................7
1.3.4.1.Criar o banco de dados e o usuário adempiere....................................................................7
1.3.4.2.Configurar o Adempiere......................................................................................................7
1.3.4.3.Inicializar o banco de dados do adempiere:.........................................................................7
1.3.4.4.Atualizar o banco de dados com os scripts (patches)..........................................................7
1.3.5.Cliente Web.................................................................................................................................7
1.3.6.Cliente Desktop...........................................................................................................................7
1.4.Atualização..........................................................................................................................................8
2.Conceitos gerais..........................................................................................................................................8
2.1.Login...................................................................................................................................................8
2.1.1.Usuários pré-definidos.................................................................................................................8
2.2.Tela principal.......................................................................................................................................9
2.2.1.Menu..........................................................................................................................................10
2.2.1.1.Ícones do menu..................................................................................................................10
2.3.Janelas...............................................................................................................................................11
2.3.1.Ícones da barra de ferramentas..................................................................................................11
2.3.2.Funções especiais nas janelas....................................................................................................12
2.3.2.1.Preferência de valor (valor padrão)...................................................................................12
2.3.2.2.Novo registro.....................................................................................................................12
2.3.2.3.Zoom..................................................................................................................................12
2.3.2.4.Atualizar.............................................................................................................................13
2.3.2.5.Pesquisa.............................................................................................................................13
2.3.2.6.Informação sobre registros.................................................................................................13
2.4.Fluxo de trabalho (workflow)...........................................................................................................13
2.5.Ajuda.................................................................................................................................................14
2.6.Preferência.........................................................................................................................................14
3.Implementação e definições básicas.........................................................................................................14
3.1.Criando nova empresa (setup inicial)................................................................................................14
3.2.Seguindo o fluxo de trabalho para configurar o cliente....................................................................15
3.2.1.Empresa.....................................................................................................................................15
3.2.2.Organização...............................................................................................................................16
3.2.3.Papel (Função)...........................................................................................................................16
3.2.4.Usuário......................................................................................................................................16
3.2.5.Período e Ano Civil...................................................................................................................16
4.Parceiro de negócios.................................................................................................................................17
4.1.Fluxo de trabalho...............................................................................................................................17
4.1.1.Grupo de parceiro de negócios..................................................................................................18
4.1.2.Saudação....................................................................................................................................18
4.1.3.Condição de pagamento.............................................................................................................18
4.1.4.Programação de faturamento.....................................................................................................19
4.1.5.Cobrança....................................................................................................................................19
4.1.6.Importação de parceiro de negócios..........................................................................................19
4.2.Manutenção parceiro de negócios.....................................................................................................19
4.2.1.Cliente........................................................................................................................................20
4.2.2.Fornecedor.................................................................................................................................20
4.2.3.Funcionário................................................................................................................................20
4.2.4.Conta Bancária..........................................................................................................................20
4.2.5.Localização................................................................................................................................20
5.Impostos (Brasil).......................................................................................................................................20
5.1.Grupo de tributação...........................................................................................................................21
5.2.Categoria de Imposto........................................................................................................................21
5.3.Grupo de Impostos (Nota Fiscal)......................................................................................................21
5.4.Impostos............................................................................................................................................21
5.5.Alíquota de Imposto..........................................................................................................................21
5.6.Configuração de Impostos.................................................................................................................22
5.7.CFOP.................................................................................................................................................23
5.8.NCM..................................................................................................................................................23
5.9.Mensagem legal.................................................................................................................................23
5.10.Nota Fiscal Eletrônica (Nfe) - configuração...................................................................................23
5.10.1.Empresa...................................................................................................................................23
5.10.2.Certificados..............................................................................................................................24
5.10.3.Organização.............................................................................................................................24
5.10.4.Sequência de Documento........................................................................................................24
5.10.5.Tipo de Documento.................................................................................................................24
6.Produto......................................................................................................................................................25
6.1.Fluxo de trabalho do produto............................................................................................................25
6.1.1.Armazém e Localizadores.........................................................................................................26
6.1.2.Unidade de Medida....................................................................................................................26
6.1.3.Categoria de Produto.................................................................................................................26
6.1.4.Categoria de Impostos...............................................................................................................26
6.2.Manutenção do Produto....................................................................................................................27
6.2.1.Produto......................................................................................................................................27
6.2.2.BOM ou LDM...........................................................................................................................27
6.2.3.Substituto...................................................................................................................................28
6.2.4.Compras.....................................................................................................................................28
6.2.5.Parceiro de Negócios.................................................................................................................28
6.2.6.Preço..........................................................................................................................................28
6.2.7.Transações.................................................................................................................................28
7.Listas de preço..........................................................................................................................................28
7.1.Fluxo de trabalho da lista de preço....................................................................................................28
7.1.1.Esquema de Lista de Preço........................................................................................................29
7.1.2.Lista de preços...........................................................................................................................29
7.1.3.Esquema de desconto.................................................................................................................30
8.Compra......................................................................................................................................................31
8.1.Requisição.........................................................................................................................................31
8.2.SdC – Solicitação de Cotação...........................................................................................................32
8.3.Pedido de Compra.............................................................................................................................32
8.4.Recebimento de material...................................................................................................................33
8.5.Fatura(fornecedor).............................................................................................................................33
9.Venda.........................................................................................................................................................34
9.1.Ordem de venda................................................................................................................................34
9.2.Remessa.............................................................................................................................................36
9.3.Fatura(cliente)...................................................................................................................................36
9.4.Nota Fiscal Eletrônica (Nfe) - emissão.............................................................................................37
10.Financeiro...............................................................................................................................................37
10.1.Contas Bancárias.............................................................................................................................37
10.2.Contas à Pagar e Receber................................................................................................................38
10.3.Caixa................................................................................................................................................38
10.3.1.Livro-Caixa(Cashbook)...........................................................................................................38
10.3.2.Diário de Caixa........................................................................................................................38
10.4.Pagamento.......................................................................................................................................39
11.Dicionário de Aplicação (AD)................................................................................................................39
11.1.Elemento do sistema........................................................................................................................39
11.2.Referência........................................................................................................................................40
11.3.Regras de Validação Dinâmica........................................................................................................40
11.4.Tabelas e colunas.............................................................................................................................41
11.5.Janela, aba e campo.........................................................................................................................42
11.6.Formulário.......................................................................................................................................43
11.7.Mensagem.......................................................................................................................................43
12.Exemplo de customização AD - novas colunas......................................................................................44
12.1.Modificar a Tabela e Coluna...........................................................................................................44
12.2.Modificar a Janela...........................................................................................................................45
12.3.Sincronizar Terminologia................................................................................................................46
12.4.Verificar a customização.................................................................................................................46
13.Exemplo de customização AD - nova janela..........................................................................................46
13.1.Criar Tabela.....................................................................................................................................46
13.1.1.Criar tabela no BD...................................................................................................................46
13.1.2.Criar tabela e colunas no AD...................................................................................................46
13.1.3.Refinar dados das colunas.......................................................................................................47
13.2.Criar janela Cor do Produto............................................................................................................48
13.3.Modificar a janela Produto..............................................................................................................49
13.4.Criar Item Menu..............................................................................................................................49
13.5.Sincronizar Terminologia................................................................................................................50
13.6.Verificar customização....................................................................................................................50
14.Configurar o ambiente de desenvolvimento...........................................................................................50
14.1.Perparando o ambiente....................................................................................................................50
14.1.1.Instale o Subclipse...................................................................................................................51
14.2.Baixar e criar os projetos Adempiere e OSeB.................................................................................51
14.2.1.Repositório Adempiere............................................................................................................51
14.2.2.Repositório OSeB....................................................................................................................51
14.2.3.Projeto Adempiere...................................................................................................................51
14.2.4.Projeto OSeB...........................................................................................................................52
14.2.5.Atualizar o projeto com o Subclipse........................................................................................52
14.3.Gerando o customization.jar...........................................................................................................52
14.4.Utilizando o novo customization.jar...............................................................................................52
1. Instalação AdempiereLBR
Pré-requisitos
• JDK
• PostgresSQL
1.1. Instalação JDK

link: http://www.oracle.com/technetwork/java/javase/downloads/index.html
• Selecione uma versão disponível do JDK (Ex.: JDK 6.0 update 21), faça o download e conclua a
instalação.
1.2. Instalação PostgreSQL

link: http://www.postgresql.org/download/
• Escolha o sistema operacional e a versão (Ex.: 8.4.4);
• Faça o download e inicie a instalação;
• Como senha para o superuser use postgres;
• porta 5432
Após o termino da instalação, abra o arquivo pg_hba.conf (Ex.: C:\Arq...\PostgreSQL\8.4\data) e altere o
METHOD de md5 para trust como no exemplo abaixo:
# TYPE DATABASE USER CIDR-ADDRESS METHOD
# IPv4 local connections:

host all all 127.0.0.1/32 trust
1.3. Adempiere 3.6.0

link(já compilado): Adempiere_360LTS.zip
Faça download do Adempiere 3.6.0 a partir do link acima.
Crie uma nova pasta para instalar o arquivos do Adempire(Ex.: C:\Adempiere).
1.3.1. Configurar as variáveis de ambiente - Windows

Vá em Meu computador → Propriedades → Avançado → Variáveis de Ambiente e adicione as seguintes
varáveis de ambiente:
• ADEMPIERE_HOME (pasta criada para os arquivo Adempiere. Ex.: C:\Adempiere)
• JAVA_HOME (caminho JDK. Ex.: C:\Arquivos de programas\Java\jdk1.6.0_21 )
• JRE_HOME (caminho JRE. Ex.: C:\Arquivos de programas\Java\jre6 )
• CLASSPATH (lib JDK e JRE. Ex.: C:\Arquivos de programas\Java\jdk1.6.0_21\lib; C:\Arquivos
de programas\Java\jre6\lib)
• Edite o Path e acrescente JDK\bin, e Postgres\bin (Ex.: ;C:\Arquivos de
programas\Java\jdk1.6.0_21\bin;C:\Arquivos de programas\PostgreSQL\8.4\bin )
1.3.2. Arquivos OSEB 3.6.0 (customização para o Brasil)

Faça download dos seguintes arquivos clicando nos links abaixo:
• Última versão do Customization.jar (Ex.: customization090910.jar )
◦ Importante: Renomear o arquivo para customization.jar
• Script base para PostgreSQL
◦ Importante: Extrair o arquivo ExpDat.dmp
• Scripts de atualização PostgreSQL (formato do nome dos aquivos: patchesDDMMAA_pgsql.sql)
• AccountingBR.csv
1.3.3. Copiar os arquivos do Adempiere
• Descompacte o Adempiere360.zip na pasta criada para o Adempiere (Ex. C:\Adempiere);
• Copie o Customization.jar para lib (Ex. C:\Adempiere\lib)
• Copie o ExpDat.dmp (script base para postgresSQL) em data (Ex.: C:\Adempiere\data)
• Copie Accouting_BR.csv para data\import (Ex.: C:\Adempiere\data\import)
1.3.4. Configurar o Adempiere (primeira execução)
1.3.4.1. Criar o banco de dados e o usuário adempiere

• Execute o utlitário pgAdmin3 e conecte-se ao servidor PostgreSQL;
• Crie o usuário(Login Role) adempiere com a senha adempiere;
• Crie o banco de dados com nome adempiere definindo o owner do BD como usuário adempiere.
1.3.4.2. Configurar o Adempiere

• Execute o Run_Setup (Ex.: C:\Adempiere\Run_Setup.bat) e defina os parâmetros:
◦ Databaseserver = localhost (ou IP do servidor)
◦ Databasetype = postgresql
◦ Databasename = adempiere
◦ DB Admin passowrd = adempiere
• Clique em “Test” para verificar se os parâmetros estão OK. Se der tudo certo, clique em Salvar,
confirme as próximas telas e aguarde o término da configuração(demora alguns minutos).
1.3.4.3. Inicializar o banco de dados do adempiere:

• Execute o Run_DBRestore em Utils (Ex. C:\Adempiere\Utils\Run_DBRestore.bat)
1.3.4.4. Atualizar o banco de dados com os scripts (patches)

• aplicar todos os scripts (patches) do PostgreSQL (pode ser feito pelo utilitário PgAdmin3)
1.3.5. Cliente Web

• Inicar o servidor com Run_Server2 em \Utils;
• Em um browser, digite: http://<nomeservidor>
• Clique no botão azul (start now)
1.3.6. Cliente Desktop

• Para iniciar o Adempiere, execute o Run_Adempiere (Ex. C:\Adempiere\Run_Adempiere.bat)
1.4. Atualização
Quando for disponibilizado novas versões do customization.jar no site do projeto OSeB (ou você mesmo
compilar) e/ou novos scripts (patches) para o banco de dados, executar os seguintes passos:
• sobrescrever o antigo customization.jar na pasta \lib com o novo arquivo (Ex. C:\Adempiere\lib);
• executar o Run_silentsetup (Ex. C:\Adempiere\Run_silentsetup.bat);
• aplicar todos os scripts (patches) do PostgreSQL (pode ser feito pelo utilitário PgAdmin3)
Link para checar as últimas versões disponibilizadas no site do projeto: OSeB 3.6.0
2. Conceitos gerais
2.1. Login
• Na primeira tela, informe o Usuário e Senha para acessar o sistema (case-sensitive)

• Na segunda tela, a Regra(ou Função/Papel), o Cliente(ou Empresa) e a Organização devem ser
informados
◦ A Regra(ou Função/Papel) define as permissões do usuário no sistema.
2.1.1. Usuários pré-definidos

O Adempiere possui controle de acesso onde, as permissões de acesso às funcionalidades são definidas
por grupos(Regra, Papel/Função). Com a instalação inicial são criados 4 usuários listados a seguir:
System (senha: System):
• Tem permissão de administração do sistema mas não tem acesso aos dados das empresas. Deve
ser usado para criação de janelas, tabs e campos.
SuperUser (senha: System):
• Tem as mesmas permissões do usuário System porém pode acessar dados das empresas.
GardenAdmin (senha: GardenAdmin):
• Usuário administrador da empresa GardenWorld, que é criada na instalação padrão do Adempiere.
Pode criar usuários para GardenWorld e definir permissões. Além do acesso às funcionalidades do
Adempiere.
• Observação: a empresa GardenWorld é criada automaticamente com alguns dados para
testes e avaliação do sistema.
GardenUser (senha: GardenUser):
• Esse usuário tem acesso restrito às funcionalidades do sistema, dentro da empresa GardenWorld.
2.2. Tela principal
Depois de fazer o login, temos a tela principal do sistema dividida da seguinte forma:
• No título da janela do aplicativo será informado o nome do Usuário, Empresa, Organização e os
dados da conexão que estão sendo usados;
• Na parte superior temos a barra de menu do sistema (Arquivo, Visualizar, Ajuda, etc...);
• Logo abaixo temos um painel com algumas tabs (Desempenho, Menu, Atividades de fluxo de
trabalho e Fluxo de trabalho).
◦ Na aba Desempenho, os indicadores de desempenho serão mostradas caso tenham sido
configurados;
◦ A aba Menu apresenta todas as opções disponíveis para a Regra escolhida no login;
• Abaixo temos dois botões (Aviso e Solicitação) - mostram o número atual de avisos e solicitações
para o usuário - e uma barra que informa o quantia de memória usada;
• Na última parte está a barra de status da janela, onde informações de erro e instruções são
exibidas.
2.2.1. Menu
Selecionando a tab Menu, os itens de menu disponíveis serão mostrados em um painel do lado direito.
Você pode navegar pelo menu expandindo as categorias (ex.: Da cotação à Fatura) e então clicando na
janela ou processo desejado. Basta clicar uma vez no item para abri-lo.
Do lado esquerdo, existe uma barra de atalhos que pode ser customizada. As janelas ou processos mais
usados podem ser adicionados nesta barra. Basta selecionar o item desejado no menu e, com o botão
direito do mouse, selecionar a opção Adicionar à barra.
Abaixo do menu, do lado direito, existe o campo Procurar onde é possível pesquisar itens do menu.
Digite o texto que deseja procurar e pressione enter. Continue pressionando enter para repetir a pesquisa.
2.2.1.1. Ícones do menu

Ícone Função Descrição
Janela Abre uma janela
Processo Executa um processo

Fluxo Abre um fluxo de trabalho (workflow)
trabalho
Relatório Executa um relatório

2.3. Janelas
Todas as janelas do Adempiere tem a mesma aparência. A barra de ferramentas e menus apresentam
funções semelhantes em todas as telas.
2.3.1. Ícones da barra de ferramentas

Ícone Função Descrição
Desfazer
Desfaz alterações feitas após a última gravação.
alterações
Ajuda Abre a tela de ajuda.

Novo Cria um novo registro. Campos obrigatórios terão o fundo vermelho e se
registro tornam azul quando preenchidos.
Exclui Exclui registro atual.
registro
Exclui Abre uma caixa de diálog para selecionar os registros e excluí-los.
seleção
Grava alterações feitas no registro atual. Movendo de um registro para outro,
Gravar
movendo entre as tabs ou fechando a janela, a gravação é feita
alterações
automaticamente.
Atualiza
Refaz uma pesquisa de acordo com o critério de busca.
pesquisa
Abre uma caixa de diálogo para definir critério de pesquisa da tab atual.
Procurar
Podem ser feitas pesquisas simples usando campos comuns ou pesquisas
registro
avançadas usando compandos complexos.
Anexo Anexa arquivos ao registro.

Bate-papo
Permite ao usuário guardar notas com data e horário para cada registro.
(Chat )
Tabela Alterna o modo de exibição dos dados para tabela (múltiplos registros)
Alterna o modo de exibição dos dados para formulário (único registro
Formulário
detalhado)
Histórico Exibe o histórico do registro.
Início Mostra a janela principal do sistema.

Registro
Mostra o registro mestre ou pai.
mestre/pai
Registro
Mostra o registro detalhe.
detalhe
Primeiro Move para o primeiro registro.
registro
Registro
Move para o registro anterior.
anterior
Próximo
Move para o próximo registro.
registro
Último
Move para o último registro.
registro
Relatório Configura um relatório baseado no registro atual.
Documentos
e relatórios Visualiza relatórios ou documentos arquivados para o registro.
arquivados
Visualiza
Visualiza um formato pré-definido.
impressão
Imprimir Imprime um relatório pré-definido.
Zoom Zoom para registros relacionados em outras tabelas. Por exemplo, zoom para
através pagamentos de faturamento.
Fluxo de
trabalho Abre o fluxo de trabalho relacionado ao registro.
(workflow)
Verificar
Verifica ou cria solicitação para serviços.
solicitação
Informação
Abre tela de produtos com informações sobre preço e disponibilidade.
do produto
Fecha a janela atual. Os estado da janela é salvo e caso a janela seja aberta
Fechar janela
novamente na mesma sessão, o registro e tab atual serão mostrados.
2.3.2. Funções especiais nas janelas
2.3.2.1. Preferência de valor (valor padrão)

Para definir um valor padrão para o campo de uma janela, digite o valor desejado no campo e depois
clique com o botão direito e escolha Perefência de valor. Sempre que criar um novo registro, o valor
padrão será utilizado.
2.3.2.2. Novo registro

Em alguns casos, por exemplo, na tela de Ordem de venda, para criar um novo Parceiro de
Negócios(cliente) de forma rápida e resumida, clique com o botão direito no campo Parceiro de Negócios
e selecione a opção Novo registro. Será mostrada uma tela pedindo informações resumidas. Os dados
completos podem ser editados mais tarde.
2.3.2.3. Zoom
Abre a janela com os detalhes do campo em questão. Por exemplo, na tela de Ordem de venda, se clicar
com o botão direito no campo Armazém → Zoom, a janela de Armazém será mostrada.
2.3.2.4. Atualizar
Para atualizar dados que foram alterados em outras janelas (através da opção Zoom, por exemplo),
usamos a opção Atualizar (botão direito no campo e Atualizar) .
2.3.2.5. Pesquisa
Alguns campos como Parceiro de Negócios ou Produto tem um botão de pesquisa de registros. Clicando
neste botão, será aberta uma tela para pesquisa do registro.
2.3.2.6. Informação sobre registros
No canto inferior direito de cada janela, é mostrado a posição do registro atual e o número total de
registros que existem na tabela (posição/total). O caracter + ou * também pode ser exibido. O caracter +
indica que uma inclusão está ocorrendo, enquanto o caracter * indica que o registro sofreu uma
alteração(quando a gravação da alteração ocorre, este indicador desaparece).
Clicando duas vezes neste ponto(canto inferior direito), é exibida uma tela com o nome, data, hora e o
usuário que criou e/ou alterou o registro.
2.4. Fluxo de trabalho (workflow)

Os Fluxo de trabalho definem uma série de passos que devem ser executados de forma sequencial.
Funciona como um guia para executar determinadas funções.
No Adempiere, existe mais de um tipo de fluxo de trabalho:
• Geral: mostra um guia e instruções passo-a-passo para realizar uma tarefa. É iniciado pelo usuário
a partir do menu e identificado pelo seguinte ícone: . Na parte superior deste tipo de fluxo de
trabalho, vemos de forma gráfica, todos os passos que devemos executar. É possível abrir e
executar os passos clicando diretamente nos passos mostrados. Na parte inferior, temos uma
explicação de cada passo a ser realizado. Um exemplo é o fluxo de Configuração de Parceiro de
Negócios localizado em:
◦ Relacionamento com Parceiros de Negócios → Regras de Parceiros de Negócios →
Configuração de Parceiros de Negócios
• Processar Documentos: Iniciado quando estiver processando algum documento, por exemplo,
quando concluímos uma Ordem de Venda, clicamos no botão Completo e selecionamos uma Ação
para executar (Completo, Preparar, Anular, etc...). Podemos customizar os passos deste tipo de
fluxo de trabalho. Exemplo: Pedir aprovação de Ordem de Venda ao departamento financeiro
sempre que o valor do pedido for maior que R$100,00.
• Valor do Documento: Fluxo iniciado automaticamente quando condições definidas pelo usuário
são satisfeitas. Exemplo: Requisitar análise de crédito ao setor financeiro para todo
cliente(Parceiro de Negócio) novo.
2.5. Ajuda
É exibida pressionado F1 ou selecionando o menu Ajuda → Ajuda.
A tela mostra uma descrição(ajuda) da janela em que o usuário se encontra e detalhes sobre os campos.
Os comentários de ajuda são definidos no Dicionário de Aplicação.
2.6. Preferência
Para acessar a janela de preferência, acesse na barra de menu superior: Ferramentas → Preferência
Alguns parâmetros de utilização que podem ser configurados:
• Sempre Visualizar a Impressão: quando clicar no botão imprimir relatório, será exibida a
visualização do mesmo;
• Log Migration Script: gera um script das alterações feita nos dados do sistema. Útil para aplicar as
modificações de um ambiente de teste no cliente, por exemplo.
• A aba Erros, exibe os erros registrados pelo sistema. Existe a possibilidade de gravar o log de
erros em arquivo para análise posterior.
3. Implementação e definições básicas

3.1. Criando nova empresa (setup inicial)
Para usar o Adempiere é preciso definir pelo menos uma Empresa e uma Organização. Uma Empresa
pode ter mais de uma organização conectado a ela. O sistema vem com a empresa GardenWorld
configurado com alguns dados para avaliação e testes. Para criar uma nova Empresa, execute os passos
abaixo:
• Faça login com System ou SuperUser (senha System) usando a regra System Administrator;
• Vá em Administardor do Sistema → Regras da Empresa → Initial Client Setup Process e preencha
os dados;
◦ Defina o nome da Empresa(campo Client Name) e Organização (Ex.client e org) - pequenas
empresas podem usar o mesmo nome para os dois campos. Empresas grandes podem ter mais
de uma Organização conectada à Empresa. As demais organizações são definidas em outra
tela.
◦ Defina o nome do administrador que é usado para configurar os dados da Empresa (Ex.:
clientAdim) e do usuário com acesso a todos os dados e processos (Ex.: clientUser) . A senha
de ambos será igual ao nome escolhido;
◦ No campo País, escolha Brasil;
◦ No campo Chart of Accounts, selecione o arquivo Accouting_BR.csv para importar o plano de
contas;
• Depois de preencher todos os dados, clique no botão Iniciar. O processo demora alguns minutos.
3.2. Seguindo o fluxo de trabalho para configurar o cliente

Depois de criar a nova empresa, faça login usando os dados do administrador da empresa e abra o fluxo
de trabalho abaixo para completar todos os passos de criação de uma nova empresa:
• Menu: Administardor do Sistema → Regras da Empresa → Revisão da Configuração Inicial da
Empresa
3.2.1. Empresa
Alguns detalhes sobre a empresa podem ser editados/configurados.
Obs.: É importante que o campo idioma tenha o valor Portuguese(Brazil) para que as configurações do
AdempiereLBR/OSeB sejam exibidas e a customização funcione corretamente.
3.2.2. Organização
Menu: Administrador do Sistema → Regras da Organização → Organização
No setup inicial da Empresa, é criada uma organização. Para definir outras organizações para a empresa
ou configurar parâmetros da organização, use esta tela.
Note que na aba Informações da Organização, vemos as configurações específicas para o Brasil no
separador Adempiere LBR.
3.2.3. Papel (Função)
Menu: Administrador do Sistema → Regras Gerais → Segurança → Papel(Função)
Função do usuário no sistema. O papel ou função (também chamado de regra no login) é como um grupo
de usuários que possui determinadas permissões à janelas e relatórios. Por exemplo, você pode fazer uma
configuração de forma que usuários associados ao papel Vendedor não tenham acesso ao caixa que é
permitido somente aos usuários do papel Financeiro.
Cada papel é associado a uma organização ou à empresa (todas as organizações da empresa).
Cada usuário do sistema deve ter pelo menos um papel definido para ele.
O campo Nível do Usuário, determina se os usuários do papel terão acesso a dados a nível do Sistema, da
Organização, da Empresa, ou a nível da Empresa e da Organização.
Nas abas de controle de acesso (Ex.: Acesso a Janelas), é feita a definição do que o papel pode acessar ou
não. Cada opção inclui o campo:
• Ativo que determina se o item estará disponível ao papel;
• Escrita e Leitura que quando ativada permite que o usuário faça alteração de dados;
Lembre-se de definir a(s) organização que usuário terá acesso na aba Acesso Org.
3.2.4. Usuário
Menu: Administrador do Sistema → Regras Gerais → Segurança → Usuário
O usuário está associado a um Parceiro de Negócios. Ao criar um usuário, defina pelo menos os seguintes
campos:
• Nome;
• Senha;
• Parceiro de Negócios: conecta um usuário a um parceiro de negócios (pode ser um funcionário,
cliente ou fornecedor);
• Funções de Usuários: papel/função. Atribua pelo menos um papel ao usuário.
3.2.5. Período e Ano Civil

Menu: Análise de Desempenho → Regras Contábeis → Período e Ano Civil
Todo ano é necessário criar um novo período contábil. Para criar um novo período, clique na aba Ano,
adicione um novo registro e:
• Preencha o campo Ano;
• Clique no botão Criar períodos.
Clique na aba Período(Ano Fiscal):
• Clique em Abrir/Fechar tudo;
• Selecione Período aberto.
4. Parceiro de negócios
Menu: Relacionamento com Parceiro de Negócios → Regras de Parceiro de Negócios → Parceiro de
Negócios
Um parceiro de negócios é uma entidade, pessoa ou organização que está relacionada com a empresa.
Existem três tipos básicos de parceiro de negócios: cliente, fornecedor e funcionário. Todos esses tipos
básicos estão agrupados na mesma janela(Parceiro de Negócios) e possuem abas com os campos
específicos para cada tipo.
O parceiro de negócio pode:
• pertencer a mais de um tipo básico simultaneamente;
• ter mais de uma localização ou contato;
• ter transações ou relações entre eles (Ex.: uma ordem de venda pode ser enviada a um segundo
parceiro, faturada a um terceiro e paga por outro).
4.1. Fluxo de trabalho

Menu: Relacionamento com Parceiro de Negócios → Regras de Parceiro de Negócios → Configuração
de Parceiro de Negócios
4.1.1. Grupo de parceiro de negócios

Permite definir parâmetros comuns a grupos de parceiro de negócios(Ex.: cliente, fornecedor,
funcionário).
Cada parceiro de negócio será associado a um grupo.
4.1.2. Saudação
Saudação ou tratamento para o parceiro de negócio (Ex.: Sr.)
4.1.3. Condição de pagamento

Permite configurar diversas formas de pagamento(Ex.: à vista, antecipado, parcelado 30/60 dias) e
associar ao Parceiro de Negócio. A ajuda da janela possui informações completas sobre os campos.
Seguem alguns campos abaixo:
• Dias líquidos: dias úteis para o vencimento;
• Data Fixa de Vencimento: as faturas que usam esta condição vencem em um dia específico do mês
◦ Dia fixo do mês: dia do mês em que as faturas vencem;
◦ Corte fixo do mês: número máximo de dias até a data de vencimento;
◦ Descolamento fixo do mês: caso o dia do vencimento não seja no mês corrente. Indicar o
número de meses que deve-se somar ao mês corrente.
• Próximo dia útil: o pagamento vence no próximo dia útil(caso o vencimento não seja um dia útil);
• Após entrega: quando selecionado, indica que o pagamento é devido após a entrega em vez do
faturamento;
• Dias de desconto: indica o número de dias dentro do qual o pagamento deve ser recebido para ter
direito ao desconto;
◦ Desconto %: indica a porcentagem de desconto que será aplicada;
• Dias de carência: define o número de dias após a data de vencimento para enviar a primeira carta
de cobrança;
Na aba Programação, informe os parâmetros das parcelas da condição de pagamento:
• Porcentagem: porcentagem do valor total que corresponde a parcela;
• Dias líquidos: define o número de dias após a data da fatura para que o pagamento seja efetuado;
Depois de configurar todos os itens, clique em Validar. Se o campo Válido aparecer marcado, indica que a
forma de pagamento está configurada corretamente.
4.1.4. Programação de faturamento

Define frequências e datas para gerar faturas. É usado quando um cliente exige uma fatura única para
múltiplas entregas.
4.1.5. Cobrança
Configuração de cartas de cobrança. Permite configurar itens como:
• enviar carta após um determinado número de dias do vencimento da fatura;
• intervalo entre cartas de cobrança;
• texto, notas e formato da carta;
• cancelar crédito do parceiro de negócios.
4.1.6. Importação de parceiro de negócios

Permite importação de dados de outros sistemas no Adempiere.
4.2. Manutenção parceiro de negócios
Lembrando que um cliente, fornecedor ou funcionário é antes de mais nada, um Parceiro de Negócio.
Para incluir um cliente, fornecedor ou funcionário, adicione um registro e defina os campos principais:
• Nome;
• Grupo de Parceiros;
• Tipo de Parceiro (separador Adempiere LBR);
◦ Note que aqui definimos configurações específicas para o Brasil como o CPF ou CNPJ e
também informações referente aos impostos;
Depois selecione uma das abas específicas(Ex.: Cliente) e defina os campos relativos ao parceiro de
negócios.
4.2.1. Cliente
Selecione a aba Cliente e marque a opção Cliente. Isto torna o parceiro de negócios um cliente e mais
campos se tornam disponíveis para edição. Exemplo:
• Programação de faturamento;
• Regra de entrega: pedido completo;
• Via de entrega: retira, entrega, transportadora;
• Lista de preço;
• Esquema de descontos;
• Condição de pagamento;
• Representante de vendas: vendedor;
• Cobrança: carta de cobrança;
• Limite de crédito;
• Observação Nota Fiscal (separador AdempiereLBR)
4.2.2. Fornecedor
Selecione a aba Fornecedor e marque a opção Fornecedor. Isto torna o parceiro de negócios um
fornecedor e mais campos se tornam disponíveis para edição.
4.2.3. Funcionário
Selecione a aba Funcionário e marque a opção Funcionário.
Marque o campo Representante de Vendas caso o funcionário seja um vendedor.
4.2.4. Conta Bancária

Esta aba permite definir informações bancárias do parceiro de negócios. Estas informações são utilizadas
para processar pagamentos e remessas de valores. O parceiro pode ter várias contas definidas.
4.2.5. Localização
São as informações para contato ou entrega (telefone e endereço). O parceiro pode ter múltiplos registros
de localização atribuídos a ele – por exemplo: endereço de entrega e endereço de cobrança.
5. Impostos (Brasil)
Menu: Localização Brasil → Fiscal → Impostos
Os impostos são associados a produtos e despesas.
Lembrete: o campo Idioma na janela Empresa deve estar configurado para Portuguese(Brazil).
5.1. Grupo de tributação

Menu: Localização Brasil → Fiscal → Impostos → Grupo de Tributação (Produto / Parceiro de
Negócios)
O Grupo de Tributação consiste em um cadastro para o agrupamento de produtos, clientes e fornecedores,
conforme suas características de tributação.
5.2. Categoria de Imposto

Menu: Análise de Desempenho → Regras Contábeis → Categoria de Imposto
5.3. Grupo de Impostos (Nota Fiscal)

Menu: Localização Brasil → Fiscal → Nota Fiscal → Grupo de Impostos (Nota Fiscal)
5.4. Impostos
Menu: Localização Brasil → Fiscal → Impostos → Imposto (Brasil)
Nesta janela, o usuário pode definir os impostos de produto, serviço (quando selecionado serviço, o
usuário pode definir se o mesmo possui retenção e qual o seu limiar e frequência) e substituição tributária
(quando selecionado substituição tributária, o usuário deve definir o imposto a ser substituído).
Na aba Fórmula, o usuário pode definir as fórmulas para determinar a base de cálculo para cada tipo de
transação, respeitando sempre as seguintes regras:
@AMT@ - Valor da Linha
@NOMEDOIMPOSTO@ - Alíquota do Imposto
Exemplo: (@AMT@*(1+(@PISPROD@+@COFINSPROD@)/(1-(@PISPROD@+@COFINSPROD@)-
@ICMSPROD@)))/(1-@ICMSPROD@)
O usuário deve definir duas fórmulas de cálculo nos seguintes campos:
• Fórmula: para o cálculo do imposto, onde a lista de preço não possui imposto incluso, ou seja, o
valor líquido.
• Fórmula Valor Líquido: para o cálculo do valor líquido, onde a lista de preço possui imposto
incluso, ou seja, o valor bruto.
5.5. Alíquota de Imposto

Menu: Análise de Desempenho → Regras Contábeis → Alíquota de Imposto
Após o cadastro dos impostos brasileiros, é preciso definir suas as alíquotas no ADempiere.
No exemplo abaixo, criamos uma alíquota com Nome PRODUTO e Categoria PRODUTO de Nível de
Resumo. (OBS: O cálculo de imposto só é feito na Ordem ou Fatura, quando selecionado um imposto de
nível resumo).
É possível criar e atribuir outras alíquotas de impostos para um Imposto Pai. Neste outro exemplo,
criamos a alíquota PISPROD, informando que o Imposto Pai é o PRODUTO e que o Imposto LBR é o
PISPROD e o Grupo de impostos (Nota Fiscal) é o PIS.
Na janela de cadastro de Alíquota de Impostos padrão do ADempiere, é onde definimos como será feita a
contabilização dos impostos, por isso a necessidade de outro cadastro.
5.6. Configuração de Impostos

Menu: Localização Brasil → Fiscal → Impostos → Configuração de Impostos
A grande dificuldade do sistema tributário brasileiro é o alto número de exceções para seus impostos. Para
facilitar este processo, foi criada uma matriz de decisões que permite criar estas exceções em apenas uma
tela.
Depois de informar qual é o Tipo de Exceção (Produto, Grupo de Tributação ou nenhuma), novas abas se
tornam disponíveis dependendo da seleção.
Por exemplo, selecionando Grupo de Tributação, a aba Grupo Produto é mostrada. Nesta aba
configuramos o PIS com alíquota de 7% conforme figura abaixo:
Também é possível adicionar exceção na aba Grupo Parceiro de Negócios.
5.7. CFOP
Menu: Localização Brasil → Fiscal → CFOP → CFOP
5.8. NCM
Menu: Localização Brasil → Fiscal → NCM
5.9. Mensagem legal

Menu: Localização Brasil → Fiscal → Nota Fiscal → Mensagem legal
5.10. Nota Fiscal Eletrônica (Nfe) - configuração

5.10.1. Empresa
Menu: Administrador do Sistema → Regras Gerais → Regras da Empresa → Empresa
Certifique-se que o campo Idioma está setado para Portuguese(Brazil).
5.10.2. Certificados
Menu: Localização Brasil → Certificado Digital
É preciso cadastrar pelos menos dois certificados: um para a empresa e outro para o webservice da Sefaz.
Campos:
• Nome: identificação para o certificado
• Tipo de Certificado: PKCS#12 (certificado .pfx da empresa) ou Java Key Store (webservice da
Sefaz);
• Pseudônimo: alias do certificado
• Senha: senha do certificado
Importante: para cada registro de certificado, é necessário anexar o arquivo correspondente ao certificado
digital: arquivo .pfx para a empresa ou arquivo .jks no caso do webservice da Sefaz.
Para obter os arquivos .pfx e .jks, procure por informações detalhadas na internet ou veja o arquivo Nfe
do projeto AdempiereLBR.
5.10.3. Organização
Menu: Administrador do Sistema → Regras da Organização → Regras da Organização → Organização
Preencha os seguintes dados na aba Informações da Organização:
• Endereço da Organização;
• Certificado da Organização: indicar o certificado cadastrado com o arquivo .pfx da empresa;
• Certificado da Transmissão: indicar o certificado cadastrado com o arquivo .jks do webservice da
Sefaz;
• Ambiente da NFe: Homologação (para testes) ou Produção (ambiente real);
5.10.4. Sequência de Documento

Menu: Análise de Desempenho → Regras Contábeis → Sequência de Documento
Crie uma nova sequência para a nota fiscal:
• Nome: Exemplo: NFe;
• Auto-numeração: deixe marcado para incrementar o número da NF;
• Incremento: 1;
• Próximo Número: número da última NF emitida + 1;
5.10.5. Tipo de Documento

Menu: Análise de Desempenho → Regras Contábeis → Tipo de Documento
Crie um novo Tipo de Documento e defina:
• Nome: Exemplo: NFe;
• Texto de Impressão: igual ao nome;
• Categoria de Razão Geral: None;
• Tipo de Base de Documento: Nota Fiscal Brasil;
• Sequencia de Documento: procure pela sequência que definiu no passo anterior;
• Documento é controlado numericamente: deixe marcado;
• Modelo da NF: 55;
• Série da NF: informe a série do documento da sua nota fiscal;
• Ambiente da NFe: Homologação ou Produção
• Formato da DANFE: Paisagem ou Retrato;
6. Produto
A definição de produto para o Adempiere é algo que se vende e/ou se compra, que tem um preço e que
pode ser armazenado. Um produto, deve estar guardado em um armazém que pode ter várias prateleiras
ou outras formas de identificação. O produto também possui medidas (Kg, L, m) e pode existir a
necessidade de se converter de uma medida para outra.
Os produtos, também podem ser agrupados através da categorias de produtos. A vantagem em definir
categoria de produtos é associar os impostos ou as definições de contabilidade à essas categorias em vez
de fazer esta definição produto por produto.
Basicamente existem dois tipos de produtos:
• itens que são bens tangíveis e que por isso necessitam de manutenção e serviços;
• itens que são recursos ilimitados, e que não podem ser armazenados.
Os “produtos indiretos” são os recursos e despesas que serão definidos na opção correspondente e não em
conjunto com os produtos.
6.1. Fluxo de trabalho do produto

Menu: Administração de Materiais → Regras de Administração de Materiais → Configuração do Produto
6.1.1. Armazém e Localizadores
Uma empresa pode ter vários armazéns. Mas, cada armazém não representa necessariamente um espaço
físico delimitado. Por exemplo, podemos ter um espaço comum para entrada e saída de produtos e defini-
los no Adempiere como se fossem lugares distintos.
Na aba Localizador, definimos o corredor e prateleira. Cada armazém pode ter vários localizadores.
6.1.2. Unidade de Medida

Informe as unidades de medida que serão usadas nos produtos.
Na aba Conversão, definimos conversão entre unidades de medida cadastradas.
6.1.3. Categoria de Produto

Tem o objetivo de agrupar os produtos para facilitar sua manutenção.
6.1.4. Categoria de Impostos

Também faz parte da definição dos impostos. Tem o objetivo de agrupar os impostos para facilitar a
manutenção.
6.2. Manutenção do Produto
Menu: Administração de Materiais → Regras de Administração de Materiais → Produto
Segue descrição das seguintes abas:
6.2.1. Produto
Campos principais do produto:
• Nome;
• Categoria do Produto;
• UDM: unidade de medida;
• Tipo de Produto: item, recurso, despesa;
• Localizador;
• Lista de Materiais: este campo não pode ser alterado. Quando selecionado, indica que este
produto consiste de uma lista de materiais e os itens abaixo são exibidos;
◦ Verificar LDM: botão que executa o processo de verificar os componentes da lista de
materiais;
◦ Verificado: indica se a lista de materiais foi verificada e é consistente;
• Separador AdemiereLBR
◦ Origem do Produto: Nacional, Importado;
◦ NCM, CFOP, Grupo de tributação
6.2.2. BOM ou LDM

Usamos a aba BOM (build of materials ou lista de materiais - LDM) para configurar produtos que são
comprados de uma forma, sofrem algum tipo de transformação e são vendidos ou, produtos que são
fabricados a partir de outros produtos.
Exemplo de uso para LDM para o produto Suco de laranja:
• Primeiro crie todos os componentes e o produto final na aba Produto:
◦ Suco de laranja;
◦ Água;
◦ Laranja;
◦ Embalagem;
• Selecione o produto final(Suco de laranja) e depois a aba BOM:
◦ Crie um novo registro e no campo Produto, escolha o produto final (Suco de laranja);
◦ Preencha os campos necessários e grave os dados;
• No separador Components
◦ Crie um novo registro e informe um componente(água, laranja, embalagem) no campo
Produto;
◦ Preencha os dados necessários (campo Quantity por exemplo) e grave os dados;
◦ repita o processo para todos os componentes do produto final;
• Depois de preencher todos os dados, quando voltar na aba Produto, perceba que o checkbox Lista
de Materiais está selecionado e que o botão Verificar LDM é exibido;
6.2.3. Substituto
Definição de produtos que podem ser usados como alternativas para o produto selecionado.
6.2.4. Compras
Define os preços e regras de compra (quantidades por pacote, quantidade mínima) para o produto.
6.2.5. Parceiro de Negócios

Pode ser cadastrado o(s) fornecedor(es) do produto.
6.2.6. Preço
Define os valores do produto para as diversas Listas de preço (veja próximo capítulo). Em cada lista de
preço, três valores devem ser informados:
• Preço de lista;
• Preço padrão;
• Preço limite (mínimo);
6.2.7. Transações
Exibe as transações feitas com este produto.
7. Listas de preço
Menu: Administração de Materiais → Regras de Administração de Materiais → Lista de Preço
As Listas de preço podem ser usadas para diferenciar os preços dos produtos. Por exemplo, sua empresa
pode criar várias listas de preço por tipo de cliente ou por períodos do ano. Os esquemas de desconto
permitem estipular descontos sobre os valores definidos nas listas de preços.
7.1. Fluxo de trabalho da lista de preço

Menu: Administração de Materiais → Regras de Administração de Materiais → Configuração de Lista de
Preço
7.1.1. Esquema de Lista de Preço
Define as regras para cálculo da Lista de Preço.
Inclua um novo esquema definindo o nome na aba Esquema de Lista de Preço, e as regras na aba Linha
de Esquema.
7.1.2. Lista de preços

Em cada versão da lista de preço, um produto terá apenas um registo com três preços associados:
• preço de lista: usado para clientes que recebem descontos;
• preço padrão: preço padrão do produto;
• preço limite: caso tente vender um produto abaixo desse preço, é exibido um aviso mas, esta
situação não impede a venda com o preço escolhido.
Principais campos de uma Lista de Preço:
• Nome
• Moeda
• Precisão do preço: arrendondamento de casas decimais
• Lista de Preço de Vendas: indica se é uma lista usada para Ordem de Venda
• Preço inclui imposto: caso a lista de preços já inclua impostos (preço bruto)
• Impor Limite de Preço: não permite que o preço seja menor que o preço limite em ordem de
venda.
Na aba Versão, definimos as diferentes versões da lista de preço. Cada lista de preço terá pelo menos uma
versão. Campos principais:
• Nome: nome da versão da lista
• Esquema de Lista de preço
• Lista de preço base: lista de preços usada como base(fonte) na criação da atual versão (pode ser
deixado em branco);
• Válido desde: data a partir da qual a versão será válida;
• Botão Criar Lista de Preços: cria a nova versão da lista de preços;
Na aba Produto, os respectivos produtos e preços são listados e/ou definidos. Os preços dos produtos
também podem ser especificados diretamente na janela Produto, aba Preço.
7.1.3. Esquema de desconto

Menu: Administração de Materiais → Regras de Administração de Materiais → Esquema de Descontos
Configuração de descontos sobre as listas de preços. No aba Esquema de Desconto, defina os campos:
• Nome;
• Tipo de desconto: define se o desconto será por uma percentagem fixa ou levará em conta a
quantidade de produtos comprados.
◦ Porcentagem fixa:
▪ Desconto Raso do P.Negócios: usar o desconto definido no Parceiro de Negócios;
▪ Desconto Fixo %: percentual de desconto a ser aplicado;
◦ Quebras
▪ Nível de Acumulação: Linha
▪ Botão Renumerar: ??
A aba Incremento de Desconto é exibida somente quando o Tipo de Desconto é igual à Quebra:
• Sequencia: ordem/numeração do registro;
• Categoria do produto: aplica este esquema à categoria de produto selecionada
• Produto: aplica este esquema ao produto selecionado – habilitado quando não seleciona Categoria
do Produto e vice-versa;
• Ponto de inflexão: a partir desta quantidade será aplicado o desconto
• Desconto Raso do P.Negócios: usar o desconto definido no Parceiro de Negócios;
• Desconto Incremental %: porcentagem de desconto a ser aplicado.
8. Compra
Menu: Da Requisição à Fatura
O processo de compra de materiais é formado pelos seguintes documentos e na ordem apresentada:
• Requisição ou
◦ Solicitação de Cotação (SdC)
• Pedido de Compra (PC)
• Recebimento de Material
• Fatura
Nenhum destes documentos é obrigatório, por exemplo, podemos definir uma Fatura sem um Pedido de
Compra mas podemos gerar uma Fatura ou Recebimento de Material com os dados já informados no
Pedido de Compra.
8.1. Requisição
Menu: Da Requisição à Fatura → Requisição
Na Requisição, o usuário registra o produto e quantidade que precisa ser comprado. O PC pode ser gerado
com os dados informados na Requisição sem a necessidade de digitar tudo novamente.
Na aba Requisição, o usuário deve digitar:
• Tipo de Documento: Purchase Requisition (Requisição de Compra);
• Usuário/Contato: pode ser quem está pedindo o material ou o contato do Parceiro de Negócios;
• Prioridade: prioridade desta requisição;
• Data exigida: necessário receber o material até esta data
• Armazém: Local onde o produto será armazenado;
• Lista de Preço
O material requisitado para compra, deve ser digitado na aba Linha de Requisição:
• Linha Número: ordem dos itens ou exibição das linhas;
• Parceiro de Negócios: fornecedor;
• Produto;
• Quantidade: quantidade do material para compra;
• Preço unitário: preço unitário para compra;
• Linha do Pedido de Compra: exibido quando este item estiver associado a um PC.
A aba Pedidos de Compra, mostra os PCs associados a esta requisição;
Quando terminar de digitar a Requisição, volte na primeira aba e clique no botão Completo. Será exibida
uma tela para selecionar a ação que pretende executar com a Requisição. Escolha Completo. Observe que
o campo Estado do Documento muda de Esboçado para Completado e que agora existe o botão Fechar.
8.2. SdC – Solicitação de Cotação

Menu: Da Requisição à Fatura → SdC
Funciona como a Requisão porém de uma forma mais completa. A SdC fornece mecanismos para
comparar diferentes cotações e condições de fornecimento para o material que precisa ser comprado.
Deve-se escolher entre a Requisição ou SdC de acordo com suas necessidades. O PC de compra também
pode ser gerado com os dados digitados na SdC.
8.3. Pedido de Compra

Menu: Da Requisição à Fatura → Pedido de Compra
Especifica o que vai ser comprado, quantidades e valores, condição de pagamento, etc. Não gera
lançamento contábil. Pode ser gerado a partir de uma Requisição ou SdC.
Na aba Pedido de Compra temos os campos:
• Tipo de documento alvo: Purchase Order (ordem de compra)
• Data da Pedido;
• Data Prometida;
• Localização do Parceiro: endereço do fornecedor;
• Usuário/contato: contato do parceiro de negócios;
• Contato da Fatura: contato do Parceiro para fatura;
• Armazém: local onde os produtos são armazenados;
• Prioridade: prioridade deste PC;
• Lista de Preço: lista usada nesta compra;
• Agente da Companhia: funcionário encarregado da compra
Botões:
• Criar Linhas do Pedido: permite usar os dados digitados de uma Requisição para preencher este
PC;
• Copiar Linhas: copia dados (linhas) de outros PC;
• Completo: Altera o status do PC para Completado;
Na aba Linha de PC, os itens de compra são definidos:

• Linha número: número ou ordem do item na lista;
• Produto;
• Quantidade: quantidade do material para compra;
• Preço de Lista: preço de tabela (calcula o campo Desconto %)
• Valor da Linha: valor total do item
Quando terminar de digitar todos os dados, clique no botão Completo na aba Pedido de Compra e
selecione Completo como ação para executar.
8.4. Recebimento de material

Menu: Da Requisição à Fatura → Recebimento de Material
Indica o recebimento de material de um Fornecedor. Pode ser digitado manualmente ou a partir de um
Pedido de Compra. Este documento atualiza as informações de estoque.
Na Aba Recebimento de Material, digite os dados principais como:
• Data da Movimentação: indica a data de entrada de material no estoque;
• Data da Conta: data para documentos fiscais;
• Regra de Custo de Frete;
• Prioridade.
Botões:
• Criar Linhas a partir de: Cria as linhas a partir de um Pedido de Compra;
• Criar Confirmação: cria documentos para confirmação de recebimento. Estes documentos devem
ser confirmados em Menu: Administração de Materiais → Confirmação de Envio/Recebimento.
• Completo: Processa o recebimento e atualiza estoque;
• Gerar Fatura a partir do Recibo: gera a Fatura a partir deste documento (Recebimento de
Material)
8.5. Fatura(fornecedor)
Menu: Da Requisição a Fatura --> Fatura (Fornecedor)
Documento financeiro que fecha a transação de compra. Cria o título no cantas à pagar. Pode ser digitado
manualmente ou a partir do PC ou de um Recebimento de Material.
Os campos da Fatura são muito semelhantes aos da Ordem de Compra.
• Tipo de documento alvo: Fatura AP
• Data Faturada;
• Data da Conta: para lançamento contábil;
• Lista de Preço: lista usada nesta compra;
• Condição de Pagamento;
• Agente da Companhia: funcionário encarregado da compra
Botões:
• Criar Linhas a partir de: permite usar os dados de um PC ou Recebimento para preencher a
fatura;
• Completo: Altera o status da Fatura para Completado;
Na aba Linha de Fatura, os itens da fatura são definidos:

• Linha número: número ou ordem do item na lista;
• Produto;
• Quantidade: quantidade do item a faturar;
• Preço de Lista: preço de tabela (calcula o campo Desconto %)
• Valor da Linha: valor total do item
9. Venda
Menu: Da Cotação à Fatura
Os documentos do processo do Venda são os seguintes e na ordem que segue:
• Ordem de Venda;
• Remessa;
• Fatura(Cliente);
O sistema permite criar um orçamento e depois convertê-lo numa ordem de venda que, por sua vez, pode
gerar uma fatura ou uma remessa. A criação destes documentos não é obrigatória podendo, por exemplo,
existir uma fatura ou remessa sem existir uma ordem de venda.
9.1. Ordem de venda

Menu: Da Cotação a Fatura → Pedidos de Venda → Ordem de venda
Especifica o parceiro de negócios(cliente), material que será vendido, condição de pagamento, etc.
Na aba Pedido temos os campos:
• Tipo de Transação: Utilizado para definir o CFOP e a forma de cálculo dos impostos;
• Tipo de Documento Alvo: Proposta, Pedido Padrão;
• Data do Pedido;
• Data Prometida;
• Parceiro de Negócios: cliente;
• Usuário/contato: contato do parceiro de negócios (cliente);
• Parceiro da Fatura: a quem deve ser faturado a venda;
• Localização do Parceiro: endereço do parceiro de negócio(cliente);
• Regra de Entrega;
• Prioridade: útil quando não existe estoque suficiente para atender todos as vendas;
• Armazém: onde os produtos estão armazenados;
• Via de Entrega: Retirar, Transportadora;
• Regra de Custo de Frete: método para cobrar pelo frete;
• Regra de Fatura: modo e frequência de emissão de faturas para o cliente;
• Lista de Preço: lista usada para determinar o preço e descontos aplicados;
• Representante de Vendas: vendedor (funcionário);
• Condição de Pagamento;
• Imprimir Descontos (checkbox): indica se os descontos serão impressos no documento.
Botões:
• Forma de Pagamento: localizado em Fatura, abaixo do Representante de Vendas (Em crédito,
Cheque, Dinheiro, etc...);
• Copiar Linhas: copia linhas de outra Ordem de Venda;
• Criar Linhas a partir de: Cria linhas a partir de outro documento indicado pelo usuário;
• Completo: Altera o Estado do Documento.
Na aba Linha de Pedido, os itens a serem vendidos são definidos:

• Linha Número: número ou ordem do item na lista;
• Produto;
• Despesa: a ordem de venda pode se referir a uma despesa em vez do produto;
• Quantidade: quantidade do produto encomendado;
• UDM: unidade de medida;
• Preço;
• Preço Unitário;
• Preço de Lista: preço oficial do produto na lista de preços;
• Desconto %: porcentagem de desconto obtida
• Taxa: imposto aplicável na linha de ordem de venda;
• Valor da linha: Quantidade X Preço sem despesas adicionais ou frete.
• Separador Imposto: referente a tributação brasileira;
◦ CFOP;
◦ Imposto Brasileiro;
◦ Mensagem Legal;
◦ Situação Tributária(ICMS);
A aba Imposto do Pedido, mostra o total de impostos associados à venda.
Quando terminar de digitar todos os dados, clique no botão 'Completo' na aba Pedido e informe
'Completo' como Ação do documento.
Ainda que uma ordem de venda esteja fechada, a mesma pode ser alterada. Para isso, selecione a ordem
de venda desejada e, na aba Pedido, clique no botão Completo. Selecione a opção Reativar. Faça as
alterações necessárias e depois clique novamente no botão Completo e selecione 'Completo'.
9.2. Remessa
Menu: Da Cotação a Fatura → Entregas → Gerar Remessas (Manual)
Com base na Ordem de Venda, pode-se gerar este documento que atualiza as informações de estoque.
Para criar uma remessa abra o item Gerar Remessas(Manual) no menu e escolha um Armazém:
• A seguir, as Ordens de Venda disponíveis para o Armazém selecionado serão mostradas. Selecione
as que deseja;
• Selecione a Ação do Documento (Completo);
• Confirme a criação das Remessas;
• Selecione se deseja imprimir as Remessas;
Os documentos de Remessa podem ser verificados em Menu: Da Cotação a Fatura → Entregas →
Expedição (Clientes)
9.3. Fatura(cliente)
Menu: Da Cotação a Fatura → Faturas de Vendas → Gerar Faturas / Notas Fiscais (Manual)
Documento financeiro que fecha a transação de venda e cria o título no contas à receber.
Para criar uma Fatura:
• Abra o item Gerar Faturas / Notas Fiscais (Manual);
• Selecione uma Organização e/ou Parceiro de Negócios e/ou Tipo de Documento (Pedido):
• A seguir, as Ordens de Venda serão exibidas de acordo com as opções do passo anterior. Selecione
as Ordens de Venda que deseja criar a Fatura;
• Selecione a Ação do Documento (Preparar ou Competo);
• Selecione se deseja ou não imprimir a Fatura;
As Faturas podem ser verificadas em Menu: Da Cotação a Fatura → Faturas de Vendas → Fatura
(Cliente)
Complemente as informações necessárias na Fatura nas seguintes abas:
• Fatura: define os dados gerais da fatura;
• Linha de Fatura: itens ou despesas da fatura;
• Imposto da Fatura: mostra o total de impostos baseado nas Linhas de Fatura;
• Programação de Pagamentos: define os valores e datas das parcelas da fatura.
Quando terminar de digitar todos os dados, clique no botão Completo na aba Fatura e selecione
Completo como ação do documento.
9.4. Nota Fiscal Eletrônica (Nfe) - emissão

Menu: Localização Brasil → Fiscal → Nota Fiscal (Saída) ou Nota Fiscal (Entrada)
Depois de criar uma Fatura de cliente ou fornecedor no Adempiere, acesse a nota fiscal correspondente -
Nota Fiscal (Saída) ou Nota Fiscal (Entrada) - na Localização Brasil.
Verifique as informações da Nota Fiscal e clique no botão Generate NFe XML para gerar e enviar o
arquivo da NFe para a Sefaz. Confira a chave gerada depois do retorno da Sefaz no campo NFe ID.
10. Financeiro
10.1. Contas Bancárias
Menu: Administração do Sistema → Regras da Organização → Banco
Define bancos e contas que serão associadas à Organização ou Parceiro de Negócios.
Na aba Banco, as instituições bancárias são definidas (Ex.: Banco do Brasil, Bradesco, etc...)
• Nome;
• Número de Rastreio: código do Banco.
Na aba Conta, informe as contas que possui no banco selecionado:
• Número da conta;
• Moeda;
• Tipo de Conta Bancária.
10.2. Contas à Pagar e Receber

Menu: Itens em Aberto → Itens em Aberto
Permite visualizar faturas em aberto de clientes e fornecedores. Basta informar:
• Parceiro de Negócios: cliente ou fornecedor. Pode não ser preenchido para listar todas as faturas;
• Transação de Vendas: deixe marcado se quiser visualizar somente faturas em aberto de clientes.
10.3. Caixa
Os lançamentos do caixa são feitos nas janelas:
• Diário de Caixa: geralmente usado para pequenos pagamentos não relacionado à títulos no contas;
• Pagamento: registra o recebimento ou pagamento de títulos (contas à pagar ou receber);
10.3.1. Livro-Caixa(Cashbook)
Menu: Administração do Sistema → Regras da Organização → Livro-Caixa (Cashbook)
Antes de fazer lançamentos no Diário de Caixa, é necessário cadastrar pelo menos um Livro-Caixa nesta
janela. Cada caixa é constituído de várias folhas - Diário de Caixa(Cash Journal).
Na aba Livro-Caixa, informe:
• Nome;
• Moeda;
10.3.2. Diário de Caixa

Menu: Itens em Aberto → Diário de Caixa (Cash Journal)
Usado para digitar as folhas do caixa. Na aba principal(Diário de Caixa) informe os seguintes dados:
• Nome;
• Data de Extrato: data do caixa;
• Data da Conta: data contábil;
• Saldo Inicial: saldo antes de iniciar o caixa;
Informe os lançamentos do caixa na aba Linha de Caixa:
• Linha número: número do lançamento do caixa;
• Descrição: histórico do lançamento;
• Tipo de Numerário: tipo de lançamento;
• Valor.
Depois de fazer todos lançamentos, volte na aba principal e verifique o montante do movimento no
campo Diferença de Declaração e o Saldo Final. Se estiver tudo Ok, feche o caixa clicando no botão
Completo.
10.4. Pagamento
Menu: Itens em Aberto → Pagamento
Permite processar pagamento ou recebimento de títulos(fatura). Na aba Pagamento informe:
• Tipo de Documento: Recibo(recebimento) ou Pagamento;
• Conta bancária;
• Data da Transação;
• Data da Conta: data contábil;
• Parceiro de Negócios: cliente ou fornecedor;
• Pedido ou Fatura: informe aqui se apenas uma fatura ou um pedido, caso contrário, informe todas
as faturas recebidas ou pagas na aba Alocar;
• Valor do pagamento;
• Moeda;
• Tipo de Pagamento: Cheque, Débito ou Depósito Direto, Cartão de Crédito, etc...;
Clique no botão Completo para finalizar o recebimento ou pagamento;
11. Dicionário de Aplicação (AD)
O Dicionário de Aplicação ou AD, é um conjunto de dados que representa quase todos os elementos do
sistema como tabelas e suas colunas. Desta maneira fica mais fácil fazer manutenção ou customização do
Adempiere sem precisar alterar o código fonte.
Sempre que precisar fazer manutenção no AD, utilize o a Regra System Administrator (usuário System ou
SuperUser).
Nos itens abaixo, onde estiver escrito campo, entenda coluna de uma tabela.
Em alguns dos itens abaixo, existe a aba Tradução. Esta aba permite traduzir itens como o nome, texto de
impressão ou comentário/ajuda do elemento selecionado. Digite o texto traduzido nos campos
correspondentes, marque a opção Traduzida e grave a alteração. Para habilitar as abas de tradução,
selecione o item Mostrar abas de Tradução em Ferramentas → Preferência.
11.1. Elemento do sistema

Menu: Dicionario de Aplicação → Elemento
Principal componente do AD. Define os campos usados no sistema.
Na aba Elemento, os campos principais são:
• Nome da Coluna BD: nome da coluna como está definido no BD;
• Nome;
• Texto de impressão;
• Tipo de Entidade: Adempiere, Dictionary, AdempiereLBR;
• Campos PC são utilizados na tela Pedido de Compra.
Aba Usado na coluna mostra onde o elemento é usado.
11.2. Referência
Menu: Dicionário de Aplicação → Referência
As referências são usadas na janela Tabela e Coluna. Aqui são definidos como os campos são validados.
Na aba Referência, defina os dados principais:
• Nome;
• Descrição;
• Comentário/Ajuda: este texto será exibido na tela de ajuda;
• Tipo de Validação:
◦ Tipo de Dados: nenhuma validação definida;
◦ Lista de Validação: define uma lista de dados para usar como valor na coluna. Exemplo:
C_Order DeliveryRule usado no campo Regra de Entrega de uma Ordem de Venda;
◦ Formato do Valor: define uma máscara para formatar a entrada de dados;
◦ Tabela de Validação: define tabelas, campos e condições que serão usados para validar a
entrada de dados. Exemplo: AD_User usado no campo Usuário/Contato na Ordem de Venda.
A aba Lista de Validação, é usada para definir a lista de itens que será usada para validar o dado digitado
pelo usuário:
• Nome: valor que será exibido para o usuário;
• Chave de busca: valor que será gravado no BD;
A aba Tabela de Validação, define tabelas, campos e condições para validar os dados:
• Tabela: define a tabela utilizada na validação;
• Coluna Chave: coluna para ser usada como chave. O conteúdo desta coluna será gravado no BD;
• Mostra Coluna: o conteúdo desta coluna será exibido para o usuário;
• SQL WHERE: Sql usada para seleção dos registros da tabela;
• SQL ORDER BY: Sql para ordenar a exibição dos dados;
11.3. Regras de Validação Dinâmica

Menu: Dicionário de Aplicação → Regras de Validação
A validação dinâmica é utilizada na janela Tabela e Coluna no campo Validação Dinâmica. Define regras
dinâmicas usadas durante a manutenção de colunas. Por exemplo, pode-se definir uma regra para exibir
apenas os armazéns da própria Organização selecionada ao invés de exibir os armazéns de todas as
Organizações cadastradas. Campos principais:
• Nome;
• Tipo: SQL, Linguagem Java, Script Java
• Código de Validação: é o código de validação de acordo com a linguagem(Tipo) escolhido;
11.4. Tabelas e colunas

Menu: Dicionario de Aplicação → Tabela e Coluna
Informação de todas as tabelas e colunas do sistema.
Observação:
• A chave primária de qualquer tabela deve ter o seguinte formato de nome: <nome_da_tabela>_ID
• Caso necessite criar tabelas no Adempiere, as seguintes colunas são padrão em qualquer tabela:
AD_CLIENT_ID NUMERIC(10) NOT NULL,
AD_ORG_ID NUMERIC(10) NOT NULL,
ISACTIVE character(1) DEFAULT 'Y' NOT NULL,
CREATED timestamp without time zone DEFAULT now() NOT NULL,
CREATEDBY NUMERIC(10) NOT NULL,
UPDATED timestamp without time zone DEFAULT now() NOT NULL,
UPDATEDBY NUMERIC(10) NOT NULL,
Campos da aba Tabela:

• Nome da Tabela no BD: nome da tabela exatamente como está no banco de dados;
• Nome;
• Exibir: apenas exibir ou visualizar os dados, não permite alteração dos dados da tabela;
• Nível de Acesso de Dados: nível de acesso para esta tabela: Todos, Somente Cliente, Somente
Sistema;
• Gerenciamento de Registro de Alterações: mantém um log de alterações na tabela;
• Janela: indica em qual janela esta tabela é utilizada;
• Registros Excluíveis: permite excluir dados;
• Alto volume (de dados): exibe uma tela de pesquisa quando a janela correspondente a esta tabela
for aberta.
Botões:
• Criar colunas a partir do Banco de Dados: quando a tabela é criada no BD, podemos importar as
colunas do BD sem precisar informar os dados das colunas manualmente;
• Copiar colunas de: copiar colunas de outra tabela;
Campos da aba Coluna:
• Nome da Coluna BD: nome da coluna exatamente como está no banco de dados;
• Coluna SQL: colunas virtuais que não existem no BD. Exemplo: soma de dois campos;
• Elemento do sistema;
• Nome;
• Versão: versão da definição da tabela ou campo;
• Comprimento: tamanho da coluna como definido no BD;
• Referência: tipo de exibição ou validação da coluna (Ex.: Tabela Direta, Sim-Não, Data+Hora);
• Validação Dinâmica: regra de validação dinâmica. Usado em colunas com referência do tipo
Tabela, Tabela Direta, Lista ou Procurar.
• Chave de referencia: indica onde buscar os valores de referência Ex.: AD_User. Este campo é
exibido quando a referência é do tipo Tabela.
• Lógica padrão: valor padrão(default);
• Obrigatório: valor não pode ser nulo(em branco). Na janela onde é usado, o campo obrigatório é
exibido com o fundo vermelho quando nulo e com fundo azul depois que algum dado é digitado;
• Atualizável: o conteúdo do campo pode ser editado pelo usuário;
• Identificador: indica que a coluna faz parte da chave primária.
11.5. Janela, aba e campo

Menu: Dicionario de Aplicação → Janela, Aba & Campo
Configura a apresentação de tabelas e campos dentro das janelas do sistema.
A aba Janela, define as Janelas existentes no sistema. Campos principais:
• Nome;
• Comentário/Ajuda;
• Tipo de Janela
◦ Manutenção: tipo de janela padrão que permite visualizar e alterar dados;
◦ Somente Questionar: os campos na Janela não ficam disponíveis para edição;
◦ Transação: janelas que processam transações (pedido de venda, pagamento, etc...)
A aba Acesso, define quais Papel(Função) que podem acessar a janela em questão e se o acesso é apenas
leitura ou permite alteração dos dados.
Na aba Aba, todas as abas disponíveis na janela são configuradas. Campos principais:
• Nome;
• Tabela: define a tabela que será usada para apresentar os dados na aba selecionada;
• Sequência: ordem de exibição da aba;
• Nível da Aba: 0 é o primeiro nível. Nível 1 depende dos dados do nível 0 e assim por diante;
• Lógica de Visualização: expressão que será validada para determinar se a aba será exibida ou não;
• Sql WHERE: SQL a ser usada na seleção de registros;
• Sql ORDER BY: SQL para ordenar os registros;
Botões:
• Criar Campos: cria campos (aba Campo) inexistentes a partir da tabela selecionada;
• Copiar Campos de Abas: copia campos de outras abas.
A aba Sequência de Campo, define a ordem de exibição dos campos dentro de uma aba.
Na aba Campo, os campos e seus atributos para exibição configurados. Normalmente os campos são
criados através do botão Criar Campos na aba Aba. Principais campos:
• Nome;
• Coluna: coluna do BD associada à este campo;
• Mostrado: indica se o campo será exibido na aba;
• Somente Leitura: quando marcado não permite alteração de dados;
• Lógica de Visualização: quando Mostrado está marcado, permite validar uma expressão para
determinar se o campo será exibido ou não;
• Sequência: ordem de exibição dos campos;
• Mesma Linha: o campo será exibido na mesma linha que o anterior.
11.6. Formulário
Menu: Dicionário de Aplicação → Formulário
Define janelas que não são geradas automaticamente pelo sistema. Neste caso é precido alterar o código
fonte do Adempiere para criar a janela. Exemplo: Abrir LDM.
Na aba Formulário, defina os seguintes campos:
• Nome;
• Nível de Acesso de Dados: nível de acesso desta janela (Organização, Empresa+Organização,
Sistema+Empresa);
• Classname: indica a classe Java codificada para o formulário.
Na aba Acesso, defina o Papel(Função) que pode acessar a janela:
• Papel(Função): define quem tem acesso ao formulário;
• Escrita e Leitura: permite alteração de dados.
11.7. Mensagem
Menu: Dicionário de Aplicação → Mensagem
Utilizado para definir mensagens de texto e dicas(“tips”) geradas pelo sistema.
Definir os campos na aba Mensagem:
• Tipo de Mensagem: Erro, Informação e Menu
• Texto de Mensagem: texto que será exibido;
12. Exemplo de customização AD - novas colunas

Exemplo para adicionar dois campos à aba Funcionário(Parceiro de Negócios): Data de admissão e
Situação.
12.1. Modificar a Tabela e Coluna
1)Abra a janela Tabela e Coluna em Menu: Dicionário de Aplicação → Tabela e Coluna;
2)Procure pela Tabela Buisiness Partner (Parceiro de Negócios). O nome da Tabela no BD é C_BPartner;
3)Vá na aba Coluna e crie a nova coluna HireDate(Data de admissão) preenchendo:
• Nome da Coluna BD: HireDate.
• Elemento do Sistema: deve ter o mesmo nome que o Nome da Coluna BD. Para criar o novo
elemento:
◦ Clique com o botão direito neste campo e selecione Zoom;
◦ Crie um novo elemento com o Nome da Coluna BD, Nome e Texto de Impressão igual à
HireDate;
◦ Clique na aba Tradução, preencha o Nome e Texto de Impressão com Data de Admissão;
◦ Marque a opção Traduzida, grave os dados e retorne à janela Tabela e Coluna;
◦ Clique com o botão direito e selecione Atualizar;
◦ Selecione o novo item HireDate no campo Elemento de Sistema;
• Nome: Hire Date;
• Versão: 1;
• Comprimento: 7;
• Referência: Data;
• Atualizável: permite alteração no valor do campo;
4)Grave os dados e clique no botão Sincronizar Coluna para criar a coluna no BD;
5)Agora crie a nova coluna HR_Status(Situação) preenchendo:
• Nome da Coluna BD: HR_Status.
• Elemento do Sistema: deve ter o mesmo nome que o Nome da Coluna BD. Para criar o novo
elemento:
◦ Crie um novo elemento com o Nome da Coluna BD, Nome e Texto de Impressão como
HR_Status;
◦ Clique na aba Tradução, preencha o Nome e Texto de Impressão com Situação;
◦ Clique com o botão direito e selecione Atualizar;
◦ Selecione o novo item HR_Status no campo Elemento de Sistema;
• Nome: HR Status
• Versão: 1;
• Comprimento: 1;
• Referência: Lista;
• Chave de Referência:
◦ Clique com o botão direito e selecione Zoom para abrir a janela de Referência;
◦ Crie uma nova referência com o Nome HR_Status e Tipo Lista de Validação;
◦ Clique na aba Lista de Validação e crie os itens da lista:
▪ Chave de Busca: A; Nome: Ativo;
▪ Chave de Busca: L; Nome: Licença;
▪ Chave de Busca: D; Nome: Desligado;
◦ Salve os dados e retorne à janela Tabela e Coluna;
◦ Selecione a Refêrencia recém-criada(talvez seja necessário atualizar o campo para que a nova
Referência seja mostrada);
• Lógica Padrão: A (chave de busca da lista de validação)
• Atualizável: marcado - permite alteração no valor do campo;
• Obrigatório: marcado - indica que o campo sempre deve ser preenchido;
6)Grave os dados e clique no botão Sincronizar Coluna para criar a coluna no BD.
12.2. Modificar a Janela

1)Abra a janela Janela, Aba & Campo em Menu: Dicionário de Aplicação → Janela, Aba & Campo;
2)Procure pela janela Buisiness Partner (Parceiro de Negócios);
3)Clique na aba Aba, procure e selecione Employee(Funcionário).
4)Podemos adicionar os novos campos clicando no botão Criar Campos ou selecionando a aba Campo e
adicionando os campos manualmente. Crie um novo campo manualmente e preencha os dados para o
HireDate:
• Nome: Hire date
• Coluna: HireDate_HireDate.
5)Crie outro campo manualmente e preencha os dados para o HR_Status:
• Nome: HR Status
• Coluna: HR_Status_HR_Status
• Mesma Linha: deixe marcado para que os dois campos aparecerem na mesma linha.
6)Clique na aba Sequência de Campo e ajuste a posição dos dois novos campos para depois da coluna
Ativo na lista Sequência. Observação: você pode selecionar mais de um campo com a tecla Shift ou Ctrl e
então movê-los.
7)Grave as atleraçãoes.
12.3. Sincronizar Terminologia

Menu: Administração do Sistema → Regras Gerais → Sincronização de Terminologia.
Execute o processo Sincronização de Terminologia. Este processo faz a sincronia das abas de tradução
dos campos com a tradução do Elemento do Sistema.
Retorne na janela Janela, Aba & Campo, procure pelos novos campos que acabou de criar e verifique que
na aba Tradução de Campos, a tradução foi gerada como informado no Elemento do Sistema.
12.4. Verificar a customização

Verifique a customização na janela Parceiro de Negócios, aba Funcionário.
Os novos campos Data de Admissão e Situação são exibidos depois do campo Ativo.
Note que ao lado do campo Data de Admissão, aparece um botão que abre um calendário para selecionar
a data desejada.
Quanto ao campo Situação, ele tem o fundo azul, indicando que é um campo obrigatório e quando
clicado, uma lista é exibida com os valores pré-definidos.
13. Exemplo de customização AD - nova janela

Exemplo para criar uma nova janela no Adempiere usando o AD, ou seja, sem programação.
Neste exemplo vamos criar a tabela Cor associá-la em novo campo na tabela de produtos.
13.1. Criar Tabela

13.1.1. Criar tabela no BD
Para criar a nova tabela do exemplo, utilize o script SQL abaixo e execute-o a partir do processo: Menu:
Administrador do Sistema → Regras Gerais → Processo SQL
CREATE TABLE X_M_COLOR (
X_M_COLOR_ID NUMERIC(10) NOT NULL,
AD_CLIENT_ID NUMERIC(10) NOT NULL,
AD_ORG_ID NUMERIC(10) NOT NULL,
ISACTIVE CHARACTER(1) DEFAULT 'y' NOT NULL,
CREATED TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT NOW(),
CREATEDBY NUMERIC(10) NOT NULL,
UPDATED TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT NOW(),
UPDATEDBY NUMERIC(10) NOT NULL,
NAME CHARACTER VARYING(60) NOT NULL );
ALTER TABLE ADEMPIERE.X_M_COLOR ADD PRIMARY KEY(X_M_COLOR_ID);
13.1.2. Criar tabela e colunas no AD

• Abra a janela Tabela e Coluna em Menu: Dicionário de Aplicação → Tabela e Coluna;
• Crie um novo registro e preencha os seguintes dados na aba Tabela:
◦ Nome da Tabela no BD: X_M_COLOR
◦ Nome: X_M_COLOR;
◦ Nível de Acesso ao Sistema: Empresa+Organização
◦ Registros Excluíveis: deixe marcado;
• Clique na aba Tradução de Tabelas e informe:
◦ Nome: Cor do Produto;
◦ Traduzida: marque esta opção e grave as alterações;
• Volte na aba Tabela e clique no botão Criar Colunas a partir do Bando de Dados e como Tipo de
Entidade, selecione User mainted.
13.1.3. Refinar dados das colunas

As colunas foram criadas conforme o BD e a referência é associada automaticamente quando possível ou
uma nova referência é criada.
1)Selecione a aba Coluna referente à tabela recém-criada (X_M_COLOR) e faça as seguintes
modificações:
• Na coluna AD_CLIENT_ID:
◦ Lógica Padrão: @AD_CLIENT_ID@;
◦ Validação Dinâmica: AD_CLIENT Trx Security Validation;
• Na coluna AD_ORG_ID:
◦ Lógica Padrão: @AD_ORG_ID@;
◦ Validação Dinâmica: AD_ORG Trx Security Validation;
• Na coluna ISACTIVE:
◦ Lógica Padrão: Y;
2)Procure pela tabela M_PRODUCT;
3)Abra a aba Coluna e crie uma nova coluna como abaixo:
• Nome da Coluna BD: X_M_COLOR_ID.
• Elemento do Sistema: X_M_COLOR_ID. Já deve estar criado mas faça a tradução:
◦ Preencha o Nome e Texto de Impressão como Product Color;
◦ Clique na aba Tradução, preencha o Nome e Texto de Impressão com Cor do Produto;
• Nome: Product Color;
• Comprimento: 10;
• Referência: Procurar;
• Chave de Referência:
◦ Clique com o botão direito e selecione Zoom para abrir a janela de Referência;
◦ Crie uma nova referência com o Nome Product Color e Tipo Tabela de Validação;
◦ Clique na aba Tabela de Validação e adicione um novo registro:
▪ Tabela: X_M_COLOR_Cor_do_Produto;
▪ Coluna Chave: X_M_COLOR_ID;
▪ Mostra Coluna: Name;
◦ Salve os dados e retorne à janela Tabela e Coluna;
◦ Selecione a Refêrencia recém-criada(talvez seja necessário atualizar o campo para que a nova
Referência seja mostrada);
• Atualizável: permite alteração no valor do campo;
4)Grave os dados e clique no botão Sincronizar Coluna para criar a coluna no BD;
13.2. Criar janela Cor do Produto

1)Abra a janela Janela, Aba & Campo em Menu: Dicionário de Aplicação → Janela, Aba e Campo;
2)Crie um novo registro e informe:
• Na aba Janela:
◦ Nome: Product Color;
◦ Transação de Vendas: desmarque;
• Clique na aba Tradução de Janela e informe:
3)Crie uma nova aba, clicando na aba Aba:
◦ Nome: Color;
◦ Tabela: X_M_COLOR;
• Clique na aba Tradução de Abas e informe:
◦ Nome: Cor;
4)Volte na aba Aba e clique no botão Criar Campos para que os campos seja criados a partir do BD;
5)Clique na aba Campos e verifique os dados criados. Modifique os dados de layout como quiser. Por
exemplo:
• Clique na aba Sequência de Campos e ordene os campos: Cliente, Organization, Active, Product
Color e Name;
• Marque a opção Mesma Linha para os campos Organization e Name;
• Crie um novo Grupo de Campo com nome Product Color e define-o nos campos Product Color e
Name:
• Posicione no campo Product color;
• clique com o botão direito no campo Grupo de Campo e selecione Zoom;
• Crie um novo registro e defina: Nome = Color;
• Clique na aba Tradução e digite: Nome = Cor;
• Grave as alterações, volte na aba Campos da janela Janela, Aba & Campo;
• Clique com o botão direito no campo Grupo de Campo e selecione Atualizar;
• Selecione o Grupo de Campo Cor;
• Posicione no campo Name e selecione o Grupo de Campo Cor;
6)Para utilizar a função Zoom quando estiver utilizando a janela Produto, faça a seguinte modificação na
tabela X_M_COLOR (janela Tabela e Coluna, aba Tabela):
• Janela: Cor do Produto;
13.3. Modificar a janela Produto

1)Procure pela janela Product (Producto);
2)Clique na aba Aba, procure e selecione Product.
3)Adicionar o novo campo clicando no botão Criar Campos;
4)Clique na aba Sequência de Campo. Verifique que o campo Product Color foi criado. Ajuste sua
posição na aba conforme desejar.
5)Grave os dados;
13.4. Criar Item Menu

1)Vá em Menu: Administrador do Sistema → Regras Gerais → Regras do Sistema → Menu
2)Crie um novo registro informando:
◦ Nome: Product Color;
◦ Ação: Janela;
◦ Janela: Cor do Produto;
• Na aba Tradução:
3)Do lado esquerdo da janela, você verá que o novo item foi criado na raiz do menu. Você pode clicar
nele e arrastá-lo para onde desejar. Por exemplo, dentro de Administração de Materiais.
13.5. Sincronizar Terminologia
Depois de criar a tabela, janelas e item de menu, é necessário rodar o processo Sincronizar Terminologia
para sincronizar a tradução dos itens.
Faça isso em Menu: Administrador do Sistema → Regras Gerais → Sincronização de Terminologia
13.6. Verificar customização

Faça login novamente, vá até o item de menu onde deixou a nova janela Cor do Produto e abra a janela.
Verifique o layout da tela e entre com alguns dados.
Vá até a janela Produto, e verifique o novo campo Cor do Produto.
Observe que no final do campo, existe um botão que executa o processo de pesquisa do registro. Isto foi
configurado quando definimos no campo X_M_COLOR_ID, a Referência como Procurar e adicionamos
uma Chave de Referência do tipo Tabela de Validação. Os campos que tem o Identificador marcado, são
mostrados como opção para pesquisa.
14. Configurar o ambiente de desenvolvimento

Em algumas circunstâncias, será necessário, alterar o código fonte para que o Adempiere atenda suas
necessidades. Para que o Adempiere consiga usar estas implementações, elas devem ser agrupadas no
arquivo customization.jar.
Este capítulo trata da configuração do ambiente de programação e como gerar o arquivo
customization.jar. Como exemplo, será usado o projeto OSeB.
14.1. Perparando o ambiente

Faça download e instale os seguintes componentes:
• JAVA (Exemplo: JDK 1.6)
• Eclipse (Eclipse para Java)
• PostgreSQL
14.1.1. Instale o Subclipse

No Eclipse, vá em Help → Install new software
◦ No campo work with, digite: http://subclipse.tigris.org/update_1.6.x
• Selecione as 3 opções (Core SVNKit, JNA Library, Subclipse) ;
• Clique em Next e prossiga até finalizar a instalação.
14.2. Baixar e criar os projetos Adempiere e OSeB

Selecione a perspecitva SVN Repository Exploring no menu:
• Window → Open Perspective → Other → SVN Repository Exploring
14.2.1. Repositório Adempiere

• Botão direito do mouse em SVN Repository Exploring e selecione New → Repository location
• Digite a url do projeto Adempiere: https://adempiere.svn.sourceforge.net/svnroot/adempiere
• Abra a árvore de repositórios, selecione trunk;
• Clique com o botão direito e selecione Checkout;
• Informe o nome do projeto (Adempiere) e Finish.
14.2.2. Repositório OSeB

• Botão direito do mouse em SVN Repository Exploring e selecione New → Repository location
• Digite a url do projeto AdempiereLBR/OSeB: https://oseb.svn.sourceforge.net/svnroot/oseb
• Abra a árvore de repositórios, selecione trunk, clique com o botão direito e selecione Checkout;
• Informe o nome do projeto (OSeB) e Finish.
14.2.3. Projeto Adempiere

Verifique antes se o Eclipse criou o projeto depois do Checkout:
• Vá em Window → Open Perspective → Other → Java
• Verifique se o projeto Adempiere está na aba Package Explorer;
Caso o projeto não tenha sido criado:
• Vá em File → New → Java Project;
• Digite o nome do projeto (Adempiere);
• Selecione "Create project from existing source";
• Clique em Browse para selecionar o diretório que contém o projeto (arquivo .project);
• Clique em Next e Finish.
14.2.4. Projeto OSeB

Verifique antes se o Eclipse criou o projeto depois do Checkout:
• Vá em Window → Open Perspective → Other → Java
• Verifique se o projeto OSeB está na aba Package Explorer;
• Importante: adicione o projeto Admpiere ao projeto OseB:
◦ Abra as propriedades do projeto OseB;
◦ Selecione a opção Java Build Path;
◦ Na aba Projects, clique em Add e selecione o projeto Adempiere;
Caso o projeto não tenha sido criado:
• Vá em File → New → Java Project;
• Digite o nome do projeto (OSeB);
• Selecione "Create project from existing source";
• Next e selecione a aba Projects;
• Clique em Add, selecione o projeto Adempiere que foi criado no passo anterior e clique em Ok;
• Finish
14.2.5. Atualizar o projeto com o Subclipse

• Selecione o projeto desejado (Adempiere ou OSeB) na aba Package Explorer;
• Botão direito e selecione Team → Synchronize with Repository
14.3. Gerando o customization.jar

• Abra o projeto OseB e selecione o arquivo build.xml
• Clique com o botão direito e Run As → Ant Build
O arquivo customization.jar será criado na pasta do projeto OseB.
14.4. Utilizando o novo customization.jar

• Copie o novo customization.jar para a pasta lib do Adempiere (Ex.:
C:\adempiere\lib\customization.jar) substituindo o arquivo antigo;
• Rode o RUN_SilentSetup para que o novo arquivo seja assinado (levando em consideração que
você já tenha o Adempiere configurado e funcionando antes de aplicar no novo customization.jar)

Ad em Pie Re

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Ad em Pie Re

Enviado por

Direitos autorais:

Formatos disponíveis

Manual do usuário

1.1. Instalação JDK

1.2. Instalação PostgreSQL

# TYPE DATABASE USER CIDR-ADDRESS METHOD

# IPv4 local connections:

1.3. Adempiere 3.6.0

1.3.1. Configurar as variáveis de ambiente - Windows

1.3.2. Arquivos OSEB 3.6.0 (customização para o Brasil)

1.3.4. Configurar o Adempiere (primeira execução)

1.3.4.1. Criar o banco de dados e o usuário adempiere

1.3.4.2. Configurar o Adempiere

1.3.4.3. Inicializar o banco de dados do adempiere:

1.3.4.4. Atualizar o banco de dados com os scripts (patches)

1.3.5. Cliente Web

1.3.6. Cliente Desktop

• Na primeira tela, informe o Usuário e Senha para acessar o sistema (case-sensitive)

2.1.1. Usuários pré-definidos

2.2.1.1. Ícones do menu

Processo Executa um processo

Relatório Executa um relatório

2.3.1. Ícones da barra de ferramentas

Ajuda Abre a tela de ajuda.

Anexo Anexa arquivos ao registro.

Início Mostra a janela principal do sistema.

2.3.2. Funções especiais nas janelas

2.3.2.1. Preferência de valor (valor padrão)

2.3.2.2. Novo registro

2.3.2.6. Informação sobre registros

2.4. Fluxo de trabalho (workflow)

3. Implementação e definições básicas

3.2. Seguindo o fluxo de trabalho para configurar o cliente

3.2.5. Período e Ano Civil

4.1. Fluxo de trabalho

4.1.1. Grupo de parceiro de negócios

4.1.3. Condição de pagamento

4.1.4. Programação de faturamento

4.1.6. Importação de parceiro de negócios

4.2.4. Conta Bancária

5.1. Grupo de tributação

5.2. Categoria de Imposto

5.3. Grupo de Impostos (Nota Fiscal)

5.5. Alíquota de Imposto

5.6. Configuração de Impostos

Também é possível adicionar exceção na aba Grupo Parceiro de Negócios.

5.9. Mensagem legal

5.10. Nota Fiscal Eletrônica (Nfe) - configuração

5.10.4. Sequência de Documento

5.10.5. Tipo de Documento

6.1. Fluxo de trabalho do produto

6.1.2. Unidade de Medida

6.1.3. Categoria de Produto

6.1.4. Categoria de Impostos

6.2.2. BOM ou LDM

6.2.5. Parceiro de Negócios

7.1. Fluxo de trabalho da lista de preço

7.1.2. Lista de preços

7.1.3. Esquema de desconto

8.2. SdC – Solicitação de Cotação

8.3. Pedido de Compra

Na aba Linha de PC, os itens de compra são definidos:

8.4. Recebimento de material

Na aba Linha de Fatura, os itens da fatura são definidos:

9.1. Ordem de venda