Escolar Documentos
Profissional Documentos
Cultura Documentos
Adempiere 3.6.0
OSeB
1.
Objetivo
O objetivo deste manual fornecer uma viso geral das funcionalidades do software Adempiere, assim
como a customizao 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 flexvel para ser customizado e atender empresas de segmentos
variados.
Referncias:
Este manual foi elaborado com base em informaes extradas dos links abaixo. Os fruns contm muita
informao e uma excelente maneira de tirar suas dvidas.
Pgina oficial do Adempiere
Pgina do projeto Adempiere
Pgina do projeto OseB
Frum OSeB
Frum Kenos (AdempiereLBR)
Manual Adempiere (portugs-portugal)
Pgina com cursos on-line do Adempiere 3.4
Mais informaes para usar o Adempiere
Histrico de verses
Data
Verso Usurio
Histrico
16/08/2010
1 Rogerio Bettini
Criao do documento
05/10/10
2 Rogerio Bettini
ndice
1.Instalao AdempiereLBR ........................................................................................................................6
1.1.Instalao JDK....................................................................................................................................6
1.2.Instalao PostgreSQL........................................................................................................................6
1.3.Adempiere 3.6.0..................................................................................................................................6
1.3.1.Configurar as variveis de ambiente - Windows.........................................................................6
1.3.2.Arquivos OSEB 3.6.0 (customizao para o Brasil)...................................................................6
1.3.3.Copiar os arquivos do Adempiere...............................................................................................7
1.3.4.Configurar o Adempiere (primeira execuo).............................................................................7
1.3.4.1.Criar o banco de dados e o usurio 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.Atualizao..........................................................................................................................................8
2.Conceitos gerais..........................................................................................................................................8
2.1.Login...................................................................................................................................................8
2.1.1.Usurios 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.Funes especiais nas janelas....................................................................................................12
2.3.2.1.Preferncia de valor (valor padro)...................................................................................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.Informao sobre registros.................................................................................................13
2.4.Fluxo de trabalho (workflow)...........................................................................................................13
2.5.Ajuda.................................................................................................................................................14
2.6.Preferncia.........................................................................................................................................14
3.Implementao e definies bsicas.........................................................................................................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.Organizao...............................................................................................................................16
3.2.3.Papel (Funo)...........................................................................................................................16
3.2.4.Usurio......................................................................................................................................16
3.2.5.Perodo e Ano Civil...................................................................................................................16
4.Parceiro de negcios.................................................................................................................................17
4.1.Fluxo de trabalho...............................................................................................................................17
4.1.1.Grupo de parceiro de negcios..................................................................................................18
4.1.2.Saudao....................................................................................................................................18
4.1.3.Condio de pagamento.............................................................................................................18
4.1.4.Programao de faturamento.....................................................................................................19
4.1.5.Cobrana....................................................................................................................................19
4.1.6.Importao de parceiro de negcios..........................................................................................19
4.2.Manuteno parceiro de negcios.....................................................................................................19
4.2.1.Cliente........................................................................................................................................20
4.2.2.Fornecedor.................................................................................................................................20
4.2.3.Funcionrio................................................................................................................................20
4.2.4.Conta Bancria..........................................................................................................................20
4.2.5.Localizao................................................................................................................................20
5.Impostos (Brasil).......................................................................................................................................20
5.1.Grupo de tributao...........................................................................................................................21
5.2.Categoria de Imposto........................................................................................................................21
5.3.Grupo de Impostos (Nota Fiscal)......................................................................................................21
5.4.Impostos............................................................................................................................................21
5.5.Alquota de Imposto..........................................................................................................................21
5.6.Configurao de Impostos.................................................................................................................22
5.7.CFOP.................................................................................................................................................23
5.8.NCM..................................................................................................................................................23
5.9.Mensagem legal.................................................................................................................................23
5.10.Nota Fiscal Eletrnica (Nfe) - configurao...................................................................................23
5.10.1.Empresa...................................................................................................................................23
5.10.2.Certificados..............................................................................................................................24
5.10.3.Organizao.............................................................................................................................24
5.10.4.Sequncia de Documento........................................................................................................24
5.10.5.Tipo de Documento.................................................................................................................24
6.Produto......................................................................................................................................................25
6.1.Fluxo de trabalho do produto............................................................................................................25
6.1.1.Armazm 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.Manuteno 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 Negcios.................................................................................................................28
6.2.6.Preo..........................................................................................................................................28
6.2.7.Transaes.................................................................................................................................28
7.Listas de preo..........................................................................................................................................28
7.1.Fluxo de trabalho da lista de preo....................................................................................................28
7.1.1.Esquema de Lista de Preo........................................................................................................29
7.1.2.Lista de preos...........................................................................................................................29
7.1.3.Esquema de desconto.................................................................................................................30
8.Compra......................................................................................................................................................31
8.1.Requisio.........................................................................................................................................31
8.2.SdC Solicitao de Cotao...........................................................................................................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 Eletrnica (Nfe) - emisso.............................................................................................37
10.Financeiro...............................................................................................................................................37
10.1.Contas Bancrias.............................................................................................................................37
10.2.Contas Pagar e Receber................................................................................................................38
10.3.Caixa................................................................................................................................................38
10.3.1.Livro-Caixa(Cashbook)...........................................................................................................38
10.3.2.Dirio de Caixa........................................................................................................................38
10.4.Pagamento.......................................................................................................................................39
2. Instalao AdempiereLBR
Pr-requisitos
JDK
PostgresSQL
2.1.Instalao JDK
link: http://www.oracle.com/technetwork/java/javase/downloads/index.html
Selecione uma verso disponvel do JDK (Ex.: JDK 6.0 update 21), faa o download e conclua a
instalao.
2.2.Instalao PostgreSQL
link: http://www.postgresql.org/download/
Escolha o sistema operacional e a verso (Ex.: 8.4.4);
Faa o download e inicie a instalao;
Como senha para o superuser use postgres;
porta 5432
Aps o termino da instalao, 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
127.0.0.1/32
trust
2.3.Adempiere 3.6.0
link(j compilado): Adempiere_360LTS.zip
Faa download do Adempiere 3.6.0 a partir do link acima.
Crie uma nova pasta para instalar o arquivos do Adempire(Ex.: C:\Adempiere).
2.3.4.2.Configurar o Adempiere
aplicar todos os scripts (patches) do PostgreSQL (pode ser feito pelo utilitrio PgAdmin3)
2.4.Atualizao
Quando for disponibilizado novas verses 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 utilitrio PgAdmin3)
Link para checar as ltimas verses disponibilizadas no site do projeto: OSeB 3.6.0
3. Conceitos gerais
3.1.Login
Tem permisso de administrao do sistema mas no tem acesso aos dados das empresas. Deve
ser usado para criao de janelas, tabs e campos.
3.2.Tela principal
Depois de fazer o login, temos a tela principal do sistema dividida da seguinte forma:
No ttulo da janela do aplicativo ser informado o nome do Usurio, Empresa, Organizao e os
dados da conexo que esto 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 sero mostradas caso tenham sido
configurados;
A aba Menu apresenta todas as opes disponveis para a Regra escolhida no login;
Abaixo temos dois botes (Aviso e Solicitao) - mostram o nmero atual de avisos e solicitaes
para o usurio - e uma barra que informa o quantia de memria usada;
Na ltima parte est a barra de status da janela, onde informaes de erro e instrues so
exibidas.
3.2.1. Menu
Selecionando a tab Menu, os itens de menu disponveis sero mostrados em um painel do lado direito.
Voc pode navegar pelo menu expandindo as categorias (ex.: Da cotao Fatura) e ento 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 boto
direito do mouse, selecionar a opo Adicionar barra.
Abaixo do menu, do lado direito, existe o campo Procurar onde possvel pesquisar itens do menu.
Digite o texto que deseja procurar e pressione enter. Continue pressionando enter para repetir a pesquisa.
3.2.1.1.cones do menu
cone
Funo
Janela
Descrio
Abre uma janela
Processo
Executa um processo
Fluxo
trabalho
Relatrio
Executa um relatrio
3.3.Janelas
Todas as janelas do Adempiere tem a mesma aparncia. A barra de ferramentas e menus apresentam
Funo
Desfazer
alteraes
Ajuda
Descrio
Desfaz alteraes feitas aps a ltima gravao.
Abre a tela de ajuda.
Novo
registro
Exclui
registro
Exclui
seleo
Gravar
alteraes
Atualiza
pesquisa
Procurar
registro
Abre uma caixa de dilogo para definir critrio de pesquisa da tab atual.
Podem ser feitas pesquisas simples usando campos comuns ou pesquisas
avanadas usando compandos complexos.
Anexo
Bate-papo
(Chat )
Permite ao usurio guardar notas com data e horrio para cada registro.
Tabela
Formulrio
Histrico
Incio
Registro
mestre/pai
Registro
detalhe
Primeiro
registro
Registro
anterior
Prximo
registro
ltimo
registro
Relatrio
Documentos
e relatrios Visualiza relatrios ou documentos arquivados para o registro.
arquivados
Visualiza
impresso
Imprimir
Zoom
atravs
Zoom para registros relacionados em outras tabelas. Por exemplo, zoom para
pagamentos de faturamento.
Fluxo de
trabalho
(workflow)
Verificar
solicitao
Informao
do produto
Fechar janela
Fecha a janela atual. Os estado da janela salvo e caso a janela seja aberta
novamente na mesma sesso, o registro e tab atual sero mostrados.
3.3.2.2.Novo registro
Em alguns casos, por exemplo, na tela de Ordem de venda, para criar um novo Parceiro de
Negcios(cliente) de forma rpida e resumida, clique com o boto direito no campo Parceiro de Negcios
e selecione a opo Novo registro. Ser mostrada uma tela pedindo informaes resumidas. Os dados
completos podem ser editados mais tarde.
3.3.2.3.Zoom
Abre a janela com os detalhes do campo em questo. Por exemplo, na tela de Ordem de venda, se clicar
com o boto direito no campo Armazm Zoom, a janela de Armazm ser mostrada.
3.3.2.4.Atualizar
Para atualizar dados que foram alterados em outras janelas (atravs da opo Zoom, por exemplo),
usamos a opo Atualizar (boto direito no campo e Atualizar) .
3.3.2.5.Pesquisa
Alguns campos como Parceiro de Negcios ou Produto tem um boto de pesquisa de registros. Clicando
neste boto, ser aberta uma tela para pesquisa do registro.
Geral: mostra um guia e instrues passo-a-passo para realizar uma tarefa. iniciado pelo usurio
a partir do menu e identificado pelo seguinte cone: . Na parte superior deste tipo de fluxo de
trabalho, vemos de forma grfica, todos os passos que devemos executar. possvel abrir e
executar os passos clicando diretamente nos passos mostrados. Na parte inferior, temos uma
explicao de cada passo a ser realizado. Um exemplo o fluxo de Configurao de Parceiro de
Negcios localizado em:
Relacionamento com Parceiros de Negcios Regras de Parceiros de Negcios
Configurao de Parceiros de Negcios
Processar Documentos: Iniciado quando estiver processando algum documento, por exemplo,
quando conclumos uma Ordem de Venda, clicamos no boto Completo e selecionamos uma Ao
para executar (Completo, Preparar, Anular, etc...). Podemos customizar os passos deste tipo de
fluxo de trabalho. Exemplo: Pedir aprovao 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 condies definidas pelo usurio
so satisfeitas. Exemplo: Requisitar anlise de crdito ao setor financeiro para todo
cliente(Parceiro de Negcio) novo.
3.5.Ajuda
exibida pressionado F1 ou selecionando o menu Ajuda Ajuda.
A tela mostra uma descrio(ajuda) da janela em que o usurio se encontra e detalhes sobre os campos.
Os comentrios de ajuda so definidos no Dicionrio de Aplicao.
3.6.Preferncia
Para acessar a janela de preferncia, acesse na barra de menu superior: Ferramentas Preferncia
Alguns parmetros de utilizao que podem ser configurados:
Sempre Visualizar a Impresso: quando clicar no boto imprimir relatrio, ser exibida a
visualizao do mesmo;
Log Migration Script: gera um script das alteraes feita nos dados do sistema. til para aplicar as
modificaes 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 anlise posterior.
Faa login com System ou SuperUser (senha System) usando a regra System Administrator;
Depois de preencher todos os dados, clique no boto Iniciar. O processo demora alguns minutos.
4.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 configuraes do
AdempiereLBR/OSeB sejam exibidas e a customizao funcione corretamente.
4.2.2. Organizao
Menu: Administrador do Sistema Regras da Organizao Organizao
No setup inicial da Empresa, criada uma organizao. Para definir outras organizaes para a empresa
ou configurar parmetros da organizao, use esta tela.
Note que na aba Informaes da Organizao, vemos as configuraes especficas para o Brasil no
separador Adempiere LBR.
Funo do usurio no sistema. O papel ou funo (tambm chamado de regra no login) como um grupo
de usurios que possui determinadas permisses janelas e relatrios. Por exemplo, voc pode fazer uma
configurao de forma que usurios associados ao papel Vendedor no tenham acesso ao caixa que
permitido somente aos usurios do papel Financeiro.
Cada papel associado a uma organizao ou empresa (todas as organizaes da empresa).
Cada usurio do sistema deve ter pelo menos um papel definido para ele.
O campo Nvel do Usurio, determina se os usurios do papel tero acesso a dados a nvel do Sistema, da
Organizao, da Empresa, ou a nvel da Empresa e da Organizao.
Nas abas de controle de acesso (Ex.: Acesso a Janelas), feita a definio do que o papel pode acessar ou
no. Cada opo inclui o campo:
Escrita e Leitura que quando ativada permite que o usurio faa alterao de dados;
Lembre-se de definir a(s) organizao que usurio ter acesso na aba Acesso Org.
4.2.4. Usurio
Menu: Administrador do Sistema Regras Gerais Segurana Usurio
O usurio est associado a um Parceiro de Negcios. Ao criar um usurio, defina pelo menos os seguintes
campos:
Nome;
Senha;
5. Parceiro de negcios
Menu: Relacionamento com Parceiro de Negcios Regras de Parceiro de Negcios Parceiro de
Negcios
Um parceiro de negcios uma entidade, pessoa ou organizao que est relacionada com a empresa.
Existem trs tipos bsicos de parceiro de negcios: cliente, fornecedor e funcionrio. Todos esses tipos
bsicos esto agrupados na mesma janela(Parceiro de Negcios) e possuem abas com os campos
especficos para cada tipo.
O parceiro de negcio pode:
ter transaes ou relaes entre eles (Ex.: uma ordem de venda pode ser enviada a um segundo
parceiro, faturada a um terceiro e paga por outro).
5.1.Fluxo de trabalho
Menu: Relacionamento com Parceiro de Negcios Regras de Parceiro de Negcios Configurao
de Parceiro de Negcios
5.1.2. Saudao
Saudao ou tratamento para o parceiro de negcio (Ex.: Sr.)
Data Fixa de Vencimento: as faturas que usam esta condio vencem em um dia especfico do ms
Dia fixo do ms: dia do ms em que as faturas vencem;
Corte fixo do ms: nmero mximo de dias at a data de vencimento;
Descolamento fixo do ms: caso o dia do vencimento no seja no ms corrente. Indicar o
nmero de meses que deve-se somar ao ms corrente.
Prximo dia til: o pagamento vence no prximo dia til(caso o vencimento no seja um dia til);
Aps entrega: quando selecionado, indica que o pagamento devido aps a entrega em vez do
faturamento;
Dias de desconto: indica o nmero 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 carncia: define o nmero de dias aps a data de vencimento para enviar a primeira carta
de cobrana;
Dias lquidos: define o nmero de dias aps a data da fatura para que o pagamento seja efetuado;
Depois de configurar todos os itens, clique em Validar. Se o campo Vlido aparecer marcado, indica que a
forma de pagamento est configurada corretamente.
5.1.5. Cobrana
Configurao de cartas de cobrana. Permite configurar itens como:
Nome;
Grupo de Parceiros;
Depois selecione uma das abas especficas(Ex.: Cliente) e defina os campos relativos ao parceiro de
negcios.
5.2.1. Cliente
Selecione a aba Cliente e marque a opo Cliente. Isto torna o parceiro de negcios um cliente e mais
campos se tornam disponveis para edio. Exemplo:
Programao de faturamento;
Lista de preo;
Esquema de descontos;
Condio de pagamento;
Limite de crdito;
5.2.2. Fornecedor
Selecione a aba Fornecedor e marque a opo Fornecedor. Isto torna o parceiro de negcios um
fornecedor e mais campos se tornam disponveis para edio.
5.2.3. Funcionrio
Selecione a aba Funcionrio e marque a opo Funcionrio.
Marque o campo Representante de Vendas caso o funcionrio seja um vendedor.
5.2.5. Localizao
So as informaes para contato ou entrega (telefone e endereo). O parceiro pode ter mltiplos registros
de localizao atribudos a ele por exemplo: endereo de entrega e endereo de cobrana.
6. Impostos (Brasil)
Menu: Localizao Brasil Fiscal Impostos
Os impostos so associados a produtos e despesas.
Lembrete: o campo Idioma na janela Empresa deve estar configurado para Portuguese(Brazil).
6.1.Grupo de tributao
Menu: Localizao Brasil Fiscal Impostos Grupo de Tributao (Produto / Parceiro de
Negcios)
O Grupo de Tributao consiste em um cadastro para o agrupamento de produtos, clientes e fornecedores,
conforme suas caractersticas de tributao.
6.2.Categoria de Imposto
Menu: Anlise de Desempenho Regras Contbeis Categoria de Imposto
6.4.Impostos
Menu: Localizao Brasil Fiscal Impostos Imposto (Brasil)
Nesta janela, o usurio pode definir os impostos de produto, servio (quando selecionado servio, o
usurio pode definir se o mesmo possui reteno e qual o seu limiar e frequncia) e substituio tributria
(quando selecionado substituio tributria, o usurio deve definir o imposto a ser substitudo).
Na aba Frmula, o usurio pode definir as frmulas para determinar a base de clculo para cada tipo de
transao, respeitando sempre as seguintes regras:
@AMT@ - Valor da Linha
@NOMEDOIMPOSTO@ - Alquota do Imposto
Exemplo:
(@AMT@*(1+(@PISPROD@+@COFINSPROD@)/(1-(@PISPROD@+@COFINSPROD@)@ICMSPROD@)))/(1-@ICMSPROD@)
Frmula: para o clculo do imposto, onde a lista de preo no possui imposto incluso, ou seja, o
valor lquido.
Frmula Valor Lquido: para o clculo do valor lquido, onde a lista de preo possui imposto
incluso, ou seja, o valor bruto.
6.5.Alquota de Imposto
Menu: Anlise de Desempenho Regras Contbeis Alquota de Imposto
Aps o cadastro dos impostos brasileiros, preciso definir suas as alquotas no ADempiere.
No exemplo abaixo, criamos uma alquota com Nome PRODUTO e Categoria PRODUTO de Nvel de
Resumo. (OBS: O clculo de imposto s feito na Ordem ou Fatura, quando selecionado um imposto de
nvel resumo).
possvel criar e atribuir outras alquotas de impostos para um Imposto Pai. Neste outro exemplo,
criamos a alquota 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 Alquota de Impostos padro do ADempiere, onde definimos como ser feita a
contabilizao dos impostos, por isso a necessidade de outro cadastro.
6.6.Configurao de Impostos
Menu: Localizao Brasil Fiscal Impostos Configurao de Impostos
A grande dificuldade do sistema tributrio brasileiro o alto nmero de excees para seus impostos. Para
facilitar este processo, foi criada uma matriz de decises que permite criar estas excees em apenas uma
tela.
Depois de informar qual o Tipo de Exceo (Produto, Grupo de Tributao ou nenhuma), novas abas se
tornam disponveis dependendo da seleo.
Por exemplo, selecionando Grupo de Tributao, a aba Grupo Produto mostrada. Nesta aba
configuramos o PIS com alquota de 7% conforme figura abaixo:
Tambm possvel adicionar exceo na aba Grupo Parceiro de Negcios.
6.7.CFOP
Menu: Localizao Brasil Fiscal CFOP CFOP
6.8.NCM
Menu: Localizao Brasil Fiscal NCM
6.9.Mensagem legal
Menu: Localizao Brasil Fiscal Nota Fiscal Mensagem legal
6.10.
6.10.1.
Empresa
6.10.2.
Certificados
Tipo de Certificado: PKCS#12 (certificado .pfx da empresa) ou Java Key Store (webservice da
Sefaz);
Importante: para cada registro de certificado, necessrio 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 informaes detalhadas na internet ou veja o arquivo Nfe
do projeto AdempiereLBR.
6.10.3.
Organizao
Endereo da Organizao;
6.10.4.
Sequncia de Documento
Incremento: 1;
6.10.5.
Tipo de Documento
7. Produto
A definio de produto para o Adempiere algo que se vende e/ou se compra, que tem um preo e que
pode ser armazenado. Um produto, deve estar guardado em um armazm que pode ter vrias prateleiras
ou outras formas de identificao. O produto tambm possui medidas (Kg, L, m) e pode existir a
necessidade de se converter de uma medida para outra.
Os produtos, tambm podem ser agrupados atravs da categorias de produtos. A vantagem em definir
categoria de produtos associar os impostos ou as definies de contabilidade essas categorias em vez
de fazer esta definio produto por produto.
Basicamente existem dois tipos de produtos:
itens que so bens tangveis e que por isso necessitam de manuteno e servios;
7.2.Manuteno do Produto
Menu: Administrao de Materiais Regras de Administrao de Materiais Produto
Segue descrio das seguintes abas:
7.2.1. Produto
Campos principais do produto:
Nome;
Categoria do Produto;
Localizador;
Lista de Materiais: este campo no pode ser alterado. Quando selecionado, indica que este
produto consiste de uma lista de materiais e os itens abaixo so exibidos;
Verificar LDM: boto 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 tributao
No separador Components
Depois de preencher todos os dados, quando voltar na aba Produto, perceba que o checkbox Lista
de Materiais est selecionado e que o boto Verificar LDM exibido;
7.2.3. Substituto
Definio de produtos que podem ser usados como alternativas para o produto selecionado.
7.2.4. Compras
Define os preos e regras de compra (quantidades por pacote, quantidade mnima) para o produto.
7.2.6. Preo
Define os valores do produto para as diversas Listas de preo (veja prximo captulo). Em cada lista de
preo, trs valores devem ser informados:
Preo de lista;
Preo padro;
7.2.7. Transaes
Exibe as transaes feitas com este produto.
8. Listas de preo
Menu: Administrao de Materiais Regras de Administrao de Materiais Lista de Preo
As Listas de preo podem ser usadas para diferenciar os preos dos produtos. Por exemplo, sua empresa
pode criar vrias listas de preo por tipo de cliente ou por perodos do ano. Os esquemas de desconto
permitem estipular descontos sobre os valores definidos nas listas de preos.
preo limite: caso tente vender um produto abaixo desse preo, exibido um aviso mas, esta
situao no impede a venda com o preo escolhido.
Nome
Moeda
Lista de Preo de Vendas: indica se uma lista usada para Ordem de Venda
Preo inclui imposto: caso a lista de preos j inclua impostos (preo bruto)
Impor Limite de Preo: no permite que o preo seja menor que o preo limite em ordem de
venda.
Na aba Verso, definimos as diferentes verses da lista de preo. Cada lista de preo ter pelo menos uma
verso. Campos principais:
Lista de preo base: lista de preos usada como base(fonte) na criao da atual verso (pode ser
deixado em branco);
Na aba Produto, os respectivos produtos e preos so listados e/ou definidos. Os preos dos produtos
tambm podem ser especificados diretamente na janela Produto, aba Preo.
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.Negcios: usar o desconto definido no Parceiro de Negcios;
Desconto Fixo %: percentual de desconto a ser aplicado;
Quebras
Nvel de Acumulao: Linha
Boto Renumerar: ??
A aba Incremento de Desconto exibida somente quando o Tipo de Desconto igual Quebra:
Produto: aplica este esquema ao produto selecionado habilitado quando no seleciona Categoria
do Produto e vice-versa;
9. Compra
Menu: Da Requisio Fatura
O processo de compra de materiais formado pelos seguintes documentos e na ordem apresentada:
Requisio ou
Solicitao de Cotao (SdC)
Recebimento de Material
Fatura
Nenhum destes documentos obrigatrio, 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.
9.1.Requisio
Menu: Da Requisio Fatura Requisio
Na Requisio, o usurio registra o produto e quantidade que precisa ser comprado. O PC pode ser gerado
com os dados informados na Requisio sem a necessidade de digitar tudo novamente.
Na aba Requisio, o usurio deve digitar:
Usurio/Contato: pode ser quem est pedindo o material ou o contato do Parceiro de Negcios;
Lista de Preo
O material requisitado para compra, deve ser digitado na aba Linha de Requisio:
Produto;
Linha do Pedido de Compra: exibido quando este item estiver associado a um PC.
9.3.Pedido de Compra
Menu: Da Requisio Fatura Pedido de Compra
Especifica o que vai ser comprado, quantidades e valores, condio de pagamento, etc. No gera
lanamento contbil. Pode ser gerado a partir de uma Requisio ou SdC.
Na aba Pedido de Compra temos os campos:
Data da Pedido;
Data Prometida;
Condio de pagamento;
Botes:
Criar Linhas do Pedido: permite usar os dados digitados de uma Requisio para preencher este
PC;
Produto;
Quando terminar de digitar todos os dados, clique no boto Completo na aba Pedido de Compra e
selecione Completo como ao para executar.
9.4.Recebimento de material
Menu: Da Requisio 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 informaes de estoque.
Na Aba Recebimento de Material, digite os dados principais como:
Prioridade.
Botes:
Criar Confirmao: cria documentos para confirmao de recebimento. Estes documentos devem
ser confirmados em Menu: Administrao de Materiais Confirmao de Envio/Recebimento.
Gerar Fatura a partir do Recibo: gera a Fatura a partir deste documento (Recebimento de
Material)
9.5.Fatura(fornecedor)
Menu: Da Requisio a Fatura --> Fatura (Fornecedor)
Documento financeiro que fecha a transao de compra. Cria o ttulo no cantas pagar. Pode ser digitado
manualmente ou a partir do PC ou de um Recebimento de Material.
Os campos da Fatura so muito semelhantes aos da Ordem de Compra.
Data Faturada;
Condio de Pagamento;
Condio de pagamento;
Botes:
Criar Linhas a partir de: permite usar os dados de um PC ou Recebimento para preencher a
fatura;
Produto;
10. Venda
Menu: Da Cotao Fatura
Os documentos do processo do Venda so os seguintes e na ordem que segue:
Ordem de Venda;
Remessa;
Fatura(Cliente);
O sistema permite criar um oramento e depois convert-lo numa ordem de venda que, por sua vez, pode
gerar uma fatura ou uma remessa. A criao destes documentos no obrigatria podendo, por exemplo,
existir uma fatura ou remessa sem existir uma ordem de venda.
10.1.
Ordem de venda
Tipo de Transao: Utilizado para definir o CFOP e a forma de clculo dos impostos;
Data do Pedido;
Data Prometida;
Regra de Entrega;
Prioridade: til quando no existe estoque suficiente para atender todos as vendas;
Condio de Pagamento;
Botes:
Criar Linhas a partir de: Cria linhas a partir de outro documento indicado pelo usurio;
Produto;
Preo;
Preo Unitrio;
10.2.
Remessa
A seguir, as Ordens de Venda disponveis para o Armazm selecionado sero mostradas. Selecione
as que deseja;
10.3.
Fatura(cliente)
Menu: Da Cotao a Fatura Faturas de Vendas Gerar Faturas / Notas Fiscais (Manual)
Documento financeiro que fecha a transao de venda e cria o ttulo no contas receber.
Para criar uma Fatura:
Selecione uma Organizao e/ou Parceiro de Negcios e/ou Tipo de Documento (Pedido):
A seguir, as Ordens de Venda sero exibidas de acordo com as opes do passo anterior. Selecione
as Ordens de Venda que deseja criar a Fatura;
As Faturas podem ser verificadas em Menu: Da Cotao a Fatura Faturas de Vendas Fatura
(Cliente)
Complemente as informaes necessrias na Fatura nas seguintes abas:
Quando terminar de digitar todos os dados, clique no boto Completo na aba Fatura e selecione
Completo como ao do documento.
10.4.
Menu: Localizao Brasil Fiscal Nota Fiscal (Sada) ou Nota Fiscal (Entrada)
Depois de criar uma Fatura de cliente ou fornecedor no Adempiere, acesse a nota fiscal correspondente Nota Fiscal (Sada) ou Nota Fiscal (Entrada) - na Localizao Brasil.
Verifique as informaes da Nota Fiscal e clique no boto 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.
11. Financeiro
11.1.
Contas Bancrias
Nome;
Nmero da conta;
Moeda;
11.2.
Parceiro de Negcios: cliente ou fornecedor. Pode no ser preenchido para listar todas as faturas;
Transao de Vendas: deixe marcado se quiser visualizar somente faturas em aberto de clientes.
11.3.
Caixa
Dirio de Caixa: geralmente usado para pequenos pagamentos no relacionado ttulos no contas;
11.3.1.
Livro-Caixa(Cashbook)
Nome;
Moeda;
11.3.2.
Dirio de Caixa
Nome;
Valor.
Depois de fazer todos lanamentos, volte na aba principal e verifique o montante do movimento no
campo Diferena de Declarao e o Saldo Final. Se estiver tudo Ok, feche o caixa clicando no boto
Completo.
11.4.
Pagamento
Conta bancria;
Data da Transao;
Pedido ou Fatura: informe aqui se apenas uma fatura ou um pedido, caso contrrio, informe todas
as faturas recebidas ou pagas na aba Alocar;
Valor do pagamento;
Moeda;
12.1.
Elemento do sistema
Nome;
Texto de impresso;
12.2.
Referncia
Nome;
Descrio;
Tipo de Validao:
Tipo de Dados: nenhuma validao definida;
Lista de Validao: 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 mscara para formatar a entrada de dados;
Tabela de Validao: define tabelas, campos e condies que sero usados para validar a
entrada de dados. Exemplo: AD_User usado no campo Usurio/Contato na Ordem de Venda.
A aba Lista de Validao, usada para definir a lista de itens que ser usada para validar o dado digitado
pelo usurio:
A aba Tabela de Validao, define tabelas, campos e condies para validar os dados:
Coluna Chave: coluna para ser usada como chave. O contedo desta coluna ser gravado no BD;
12.3.
Nome;
12.4.
Tabelas e colunas
A chave primria de qualquer tabela deve ter o seguinte formato de nome: <nome_da_tabela>_ID
Caso necessite criar tabelas no Adempiere, as seguintes colunas so padro em qualquer tabela:
Nome da Tabela no BD: nome da tabela exatamente como est no banco de dados;
Nome;
Exibir: apenas exibir ou visualizar os dados, no permite alterao dos dados da tabela;
Nvel de Acesso de Dados: nvel de acesso para esta tabela: Todos, Somente Cliente, Somente
Sistema;
Alto volume (de dados): exibe uma tela de pesquisa quando a janela correspondente a esta tabela
for aberta.
Botes:
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;
Nome da Coluna BD: nome da coluna exatamente como est no banco de dados;
Coluna SQL: colunas virtuais que no existem no BD. Exemplo: soma de dois campos;
Elemento do sistema;
Nome;
Referncia: tipo de exibio ou validao da coluna (Ex.: Tabela Direta, Sim-No, Data+Hora);
Validao Dinmica: regra de validao dinmica. Usado em colunas com referncia do tipo
Tabela, Tabela Direta, Lista ou Procurar.
Chave de referencia: indica onde buscar os valores de referncia Ex.: AD_User. Este campo
exibido quando a referncia do tipo Tabela.
Obrigatrio: valor no pode ser nulo(em branco). Na janela onde usado, o campo obrigatrio
exibido com o fundo vermelho quando nulo e com fundo azul depois que algum dado digitado;
12.5.
Nome;
Comentrio/Ajuda;
Tipo de Janela
Manuteno: tipo de janela padro que permite visualizar e alterar dados;
Somente Questionar: os campos na Janela no ficam disponveis para edio;
Transao: janelas que processam transaes (pedido de venda, pagamento, etc...)
A aba Acesso, define quais Papel(Funo) que podem acessar a janela em questo e se o acesso apenas
leitura ou permite alterao dos dados.
Na aba Aba, todas as abas disponveis na janela so configuradas. Campos principais:
Nome;
Comentrio/Ajuda;
Tabela: define a tabela que ser usada para apresentar os dados na aba selecionada;
Nvel da Aba: 0 o primeiro nvel. Nvel 1 depende dos dados do nvel 0 e assim por diante;
Lgica de Visualizao: expresso que ser validada para determinar se a aba ser exibida ou no;
Botes:
Criar Campos: cria campos (aba Campo) inexistentes a partir da tabela selecionada;
A aba Sequncia de Campo, define a ordem de exibio dos campos dentro de uma aba.
Na aba Campo, os campos e seus atributos para exibio configurados. Normalmente os campos so
criados atravs do boto Criar Campos na aba Aba. Principais campos:
Nome;
Comentrio/Ajuda;
Lgica de Visualizao: quando Mostrado est marcado, permite validar uma expresso para
determinar se o campo ser exibido ou no;
12.6.
Formulrio
Nome;
12.7.
Mensagem
13.1.
Elemento do Sistema: deve ter o mesmo nome que o Nome da Coluna BD. Para criar o novo
elemento:
Clique com o boto direito neste campo e selecione Zoom;
Crie um novo elemento com o Nome da Coluna BD, Nome e Texto de Impresso igual
HireDate;
Clique na aba Traduo, preencha o Nome e Texto de Impresso com Data de Admisso;
Marque a opo Traduzida, grave os dados e retorne janela Tabela e Coluna;
Clique com o boto direito e selecione Atualizar;
Selecione o novo item HireDate no campo Elemento de Sistema;
Verso: 1;
Comprimento: 7;
Referncia: Data;
4)Grave os dados e clique no boto Sincronizar Coluna para criar a coluna no BD;
5)Agora crie a nova coluna HR_Status(Situao) 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:
Clique com o boto direito neste campo e selecione Zoom;
Crie um novo elemento com o Nome da Coluna BD, Nome e Texto de Impresso como
HR_Status;
Clique na aba Traduo, preencha o Nome e Texto de Impresso com Situao;
Marque a opo Traduzida, grave os dados e retorne janela Tabela e Coluna;
Clique com o boto direito e selecione Atualizar;
Selecione o novo item HR_Status no campo Elemento de Sistema;
Nome: HR Status
Verso: 1;
Comprimento: 1;
Referncia: Lista;
Chave de Referncia:
Clique com o boto direito e selecione Zoom para abrir a janela de Referncia;
Crie uma nova referncia com o Nome HR_Status e Tipo Lista de Validao;
Clique na aba Lista de Validao e crie os itens da lista:
Chave de Busca: A; Nome: Ativo;
Chave de Busca: L; Nome: Licena;
Chave de Busca: D; Nome: Desligado;
Salve os dados e retorne janela Tabela e Coluna;
Selecione a Refrencia recm-criada(talvez seja necessrio atualizar o campo para que a nova
Referncia seja mostrada);
Lgica Padro: A (chave de busca da lista de validao)
Atualizvel: marcado - permite alterao no valor do campo;
Obrigatrio: marcado - indica que o campo sempre deve ser preenchido;
6)Grave os dados e clique no boto Sincronizar Coluna para criar a coluna no BD.
13.2.
Modificar a Janela
1)Abra a janela Janela, Aba & Campo em Menu: Dicionrio de Aplicao Janela, Aba & Campo;
2)Procure pela janela Buisiness Partner (Parceiro de Negcios);
3)Clique na aba Aba, procure e selecione Employee(Funcionrio).
4)Podemos adicionar os novos campos clicando no boto 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.
6)Clique na aba Sequncia de Campo e ajuste a posio dos dois novos campos para depois da coluna
Ativo na lista Sequncia. Observao: voc pode selecionar mais de um campo com a tecla Shift ou Ctrl e
ento mov-los.
7)Grave as atleraoes.
13.3.
Sincronizar Terminologia
13.4.
Verificar a customizao
Neste exemplo vamos criar a tabela Cor associ-la em novo campo na tabela de produtos.
14.1.
Criar Tabela
14.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);
14.1.2.
Volte na aba Tabela e clique no boto Criar Colunas a partir do Bando de Dados e como Tipo de
Entidade, selecione User mainted.
14.1.3.
Na coluna AD_CLIENT_ID:
Lgica Padro: @AD_CLIENT_ID@;
Validao Dinmica: AD_CLIENT Trx Security Validation;
Na coluna AD_ORG_ID:
Lgica Padro: @AD_ORG_ID@;
Validao Dinmica: AD_ORG Trx Security Validation;
Na coluna ISACTIVE:
Lgica Padro: Y;
Comprimento: 10;
Referncia: Procurar;
Chave de Referncia:
Clique com o boto direito e selecione Zoom para abrir a janela de Referncia;
Crie uma nova referncia com o Nome Product Color e Tipo Tabela de Validao;
Clique na aba Tabela de Validao 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 Refrencia recm-criada(talvez seja necessrio atualizar o campo para que a nova
Referncia seja mostrada);
Atualizvel: permite alterao no valor do campo;
4)Grave os dados e clique no boto Sincronizar Coluna para criar a coluna no BD;
14.2.
1)Abra a janela Janela, Aba & Campo em Menu: Dicionrio de Aplicao Janela, Aba e Campo;
2)Crie um novo registro e informe:
Na aba Janela:
Nome: Product Color;
Transao de Vendas: desmarque;
4)Volte na aba Aba e clique no boto 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 Sequncia de Campos e ordene os campos: Cliente, Organization, Active, Product
Color 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 boto direito no campo Grupo de Campo e selecione Zoom;
Crie um novo registro e defina: Nome = Color;
Clique na aba Traduo e digite: Nome = Cor;
Grave as alteraes, volte na aba Campos da janela Janela, Aba & Campo;
Clique com o boto 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 funo Zoom quando estiver utilizando a janela Produto, faa a seguinte modificao na
tabela X_M_COLOR (janela Tabela e Coluna, aba Tabela):
Janela: Cor do Produto;
14.3.
14.4.
14.5.
Sincronizar Terminologia
Depois de criar a tabela, janelas e item de menu, necessrio rodar o processo Sincronizar Terminologia
para sincronizar a traduo dos itens.
Faa isso em Menu: Administrador do Sistema Regras Gerais Sincronizao de Terminologia
14.6.
Verificar customizao
Faa 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.
Observe que no final do campo, existe um boto que executa o processo de pesquisa do registro. Isto foi
configurado quando definimos no campo X_M_COLOR_ID, a Referncia como Procurar e adicionamos
uma Chave de Referncia do tipo Tabela de Validao. Os campos que tem o Identificador marcado, so
mostrados como opo para pesquisa.
15.1.
Perparando o ambiente
PostgreSQL
15.1.1.
Instale o Subclipse
15.2.
15.2.1.
Repositrio Adempiere
Boto direito do mouse em SVN Repository Exploring e selecione New Repository location
15.2.2.
Repositrio OSeB
Boto direito do mouse em SVN Repository Exploring e selecione New Repository location
Abra a rvore de repositrios, selecione trunk, clique com o boto direito e selecione Checkout;
15.2.3.
Projeto Adempiere
Clique em Browse para selecionar o diretrio que contm o projeto (arquivo .project);
15.2.4.
Projeto OSeB
Clique em Add, selecione o projeto Adempiere que foi criado no passo anterior e clique em Ok;
Finish
15.2.5.
15.3.
Gerando o customization.jar
15.4.
Copie
o novo
customization.jar
para
a pasta
lib
C:\adempiere\lib\customization.jar) substituindo o arquivo antigo;
do
Adempiere
(Ex.:
Rode o RUN_SilentSetup para que o novo arquivo seja assinado (levando em considerao que
voc j tenha o Adempiere configurado e funcionando antes de aplicar no novo customization.jar)