Escolar Documentos
Profissional Documentos
Cultura Documentos
Ad em Pie Re
Ad em Pie Re
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.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
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.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.
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.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.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.
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.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.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.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.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.
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.
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:
5.7. CFOP
Menu: Localização Brasil → Fiscal → CFOP → CFOP
5.8. NCM
Menu: Localização Brasil → Fiscal → NCM
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);
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.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.4. Compras
Define os preços e regras de compra (quantidades por pacote, quantidade mínima) para o 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.
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.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;
• Parceiro de Negócios: fornecedor;
• Localização do Parceiro: endereço do fornecedor;
• Lista de Preço: lista usada nesta compra;
• Condição de Pagamento;
• Agente da Companhia: funcionário encarregado da compra
• Condição de pagamento;
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;
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.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.
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.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.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.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.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;
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.
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.