Manual do usurio

Adempiere 3.6.0 OSeB

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 08/16/2010 10/05/10 Verso Usurio 1 Rogerio Bettini 2 Rogerio Bettini Histrico Criao do documento Primeira reviso do documento

ndice1.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 11.Dicionrio de Aplicao (AD)................................................................................................................39 11.1.Elemento do sistema........................................................................................................................39 11.2.Referncia........................................................................................................................................40

11.3.Regras de Validao Dinmica........................................................................................................40 11.4.Tabelas e colunas.............................................................................................................................41 11.5.Janela, aba e campo.........................................................................................................................42 11.6.Formulrio.......................................................................................................................................43 11.7.Mensagem.......................................................................................................................................43 12.Exemplo de customizao 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 customizao.................................................................................................................46 13.Exemplo de customizao 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 customizao....................................................................................................................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.Repositrio Adempiere............................................................................................................51 14.2.2.Repositrio 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. Instalao AdempiereLBRPr-requisitos JDK PostgresSQL

1.1. Instalao JDKlink: 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.

1.2. Instalao PostgreSQLlink: 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 127.0.0.1/32 METHOD trust

# IPv4 local connections: host all all

1.3. Adempiere 3.6.0link(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).

1.3.1. Configurar as variveis de ambiente - WindowsV em Meu computador Propriedades Avanado Variveis de Ambiente e adicione as seguintes varveis de ambiente: ADEMPIERE_HOME (pasta criada para os arquivo Adempiere. Ex.: C:\Adempiere) JAVA_HOME (caminho JDK. Ex.: C:\Arquivos de programas\Java\jdk1.6.0_21 ) JRE_HOME (caminho JRE. Ex.: C:\Arquivos de programas\Java\jre6 ) CLASSPATH (lib JDK e JRE. Ex.: C:\Arquivos de programas\Java\jdk1.6.0_21\lib; C:\Arquivos de programas\Java\jre6\lib) Edite o Path e acrescente JDK\bin, e Postgres\bin (Ex.: ;C:\Arquivos de programas\Java\jdk1.6.0_21\bin;C:\Arquivos de programas\PostgreSQL\8.4\bin )

1.3.2. Arquivos OSEB 3.6.0 (customizao para o Brasil)Faa download dos seguintes arquivos clicando nos links abaixo: ltima verso do Customization.jar (Ex.: customization090910.jar ) Importante: Renomear o arquivo para customization.jar Script base para PostgreSQL Importante: Extrair o arquivo ExpDat.dmp Scripts de atualizao PostgreSQL (formato do nome dos aquivos: patchesDDMMAA_pgsql.sql) AccountingBR.csv

1.3.3. Copiar os arquivos do Adempiere Descompacte o Adempiere360.zip na pasta criada para o Adempiere (Ex. C:\Adempiere); Copie o Customization.jar para lib (Ex. C:\Adempiere\lib) Copie o ExpDat.dmp (script base para postgresSQL) em data (Ex.: C:\Adempiere\data) Copie Accouting_BR.csv para data\import (Ex.: C:\Adempiere\data\import)

1.3.4. Configurar o Adempiere (primeira execuo)1.3.4.1. Criar o banco de dados e o usurio adempiere

Execute o utlitrio pgAdmin3 e conecte-se ao servidor PostgreSQL; Crie o usurio(Login Role) adempiere com a senha adempiere; Crie o banco de dados com nome adempiere definindo o owner do BD como usurio adempiere.

1.3.4.2. Configurar o Adempiere

Execute o Run_Setup (Ex.: C:\Adempiere\Run_Setup.bat) e defina os parmetros: Databaseserver = localhost (ou IP do servidor) Databasetype = postgresql Databasename = adempiere DB Admin passowrd = adempiere Clique em Test para verificar se os parmetros esto OK. Se der tudo certo, clique em Salvar, confirme as prximas telas e aguarde o trmino da configurao(demora alguns minutos).

1.3.4.3. Inicializar o banco de dados do adempiere:

Execute o Run_DBRestore em Utils (Ex. C:\Adempiere\Utils\Run_DBRestore.bat)

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

aplicar todos os scripts (patches) do PostgreSQL (pode ser feito pelo utilitrio PgAdmin3)

1.3.5. Cliente Web Inicar o servidor com Run_Server2 em \Utils; Em um browser, digite: http:// Clique no boto azul (start now)

1.3.6. Cliente Desktop Para iniciar o Adempiere, execute o Run_Adempiere (Ex. C:\Adempiere\Run_Adempiere.bat)

1.4. AtualizaoQuando 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

2. Conceitos gerais2.1. Login

Na primeira tela, informe o Usurio e Senha para acessar o sistema (case-sensitive) Na segunda tela, a Regra(ou Funo/Papel), o Cliente(ou Empresa) e a Organizao devem ser informados A Regra(ou Funo/Papel) define as permisses do usurio no sistema.

2.1.1. Usurios pr-definidosO Adempiere possui controle de acesso onde, as permisses de acesso s funcionalidades so definidas por grupos(Regra, Papel/Funo). Com a instalao inicial so criados 4 usurios listados a seguir: System (senha: System): Tem permisso de administrao do sistema mas no tem acesso aos dados das empresas. Deve ser usado para criao de janelas, tabs e campos.

SuperUser (senha: System): Tem as mesmas permisses do usurio System porm pode acessar dados das empresas. GardenAdmin (senha: GardenAdmin): Usurio administrador da empresa GardenWorld, que criada na instalao padro do Adempiere. Pode criar usurios para GardenWorld e definir permisses. Alm do acesso s funcionalidades do Adempiere. Observao: a empresa GardenWorld criada automaticamente com alguns dados para testes e avaliao do sistema. GardenUser (senha: GardenUser): Esse usurio tem acesso restrito s funcionalidades do sistema, dentro da empresa GardenWorld.

2.2. Tela principal

Depois de fazer o login, temos a tela principal do sistema dividida da seguinte forma: No 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.

2.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.

2.2.1.1. cones do menucone Funo Janela Processo Fluxo trabalho Relatrio Abre uma janela Executa um processo Abre um fluxo de trabalho (workflow) Executa um relatrio Descrio

2.3. JanelasTodas as janelas do Adempiere tem a mesma aparncia. A barra de ferramentas e menus apresentam funes semelhantes em todas as telas.

2.3.1. cones da barra de ferramentascone Funo Desfazer alteraes Ajuda Novo registro Exclui registro Exclui seleo Gravar alteraes Atualiza pesquisa Procurar registro Anexo Bate-papo (Chat ) Tabela Formulrio Histrico Incio Registro mestre/pai Registro detalhe Primeiro Descrio Desfaz alteraes feitas aps a ltima gravao. Abre a tela de ajuda. Cria um novo registro. Campos obrigatrios tero o fundo vermelho e se tornam azul quando preenchidos. Exclui registro atual. Abre uma caixa de dilog para selecionar os registros e exclu-los. Grava alteraes feitas no registro atual. Movendo de um registro para outro, movendo entre as tabs ou fechando a janela, a gravao feita automaticamente. Refaz uma pesquisa de acordo com o critrio de busca. 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. Anexa arquivos ao registro. Permite ao usurio guardar notas com data e horrio para cada registro. Alterna o modo de exibio dos dados para tabela (mltiplos registros) Alterna o modo de exibio dos dados para formulrio (nico registro detalhado) Exibe o histrico do registro. Mostra a janela principal do sistema. Mostra o registro mestre ou pai. Mostra o registro detalhe. Move para o primeiro registro.

registro Registro anterior Prximo registro ltimo registro Relatrio Move para o registro anterior. Move para o prximo registro. Move para o ltimo registro. Configura um relatrio baseado no registro atual.

Documentos e relatrios Visualiza relatrios ou documentos arquivados para o registro. arquivados Visualiza impresso Imprimir Zoom atravs Fluxo de trabalho (workflow) Verificar solicitao Informao do produto Fechar janela Visualiza um formato pr-definido. Imprime um relatrio pr-definido. Zoom para registros relacionados em outras tabelas. Por exemplo, zoom para pagamentos de faturamento. Abre o fluxo de trabalho relacionado ao registro. Verifica ou cria solicitao para servios. Abre tela de produtos com informaes sobre preo e disponibilidade. 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.

2.3.2. Funes especiais nas janelas2.3.2.1. Preferncia de valor (valor padro)

Para definir um valor padro para o campo de uma janela, digite o valor desejado no campo e depois clique com o boto direito e escolha Perefncia de valor. Sempre que criar um novo registro, o valor padro ser utilizado.2.3.2.2. Novo registro

Em alguns casos, por exemplo, na tela de Ordem de venda, para criar um novo Parceiro de 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.2.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.

2.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) .2.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.2.3.2.6. Informao sobre registros

No canto inferior direito de cada janela, mostrado a posio do registro atual e o nmero total de registros que existem na tabela (posio/total). O caracter + ou * tambm pode ser exibido. O caracter + indica que uma incluso est ocorrendo, enquanto o caracter * indica que o registro sofreu uma alterao(quando a gravao da alterao ocorre, este indicador desaparece). Clicando duas vezes neste ponto(canto inferior direito), exibida uma tela com o nome, data, hora e o usurio que criou e/ou alterou o registro.

2.4. Fluxo de trabalho (workflow)Os Fluxo de trabalho definem uma srie de passos que devem ser executados de forma sequencial. Funciona como um guia para executar determinadas funes. No Adempiere, existe mais de um tipo de fluxo de trabalho: 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.

2.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.

2.6. PrefernciaPara 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.

3. Implementao e definies bsicas3.1. Criando nova empresa (setup inicial)Para usar o Adempiere preciso definir pelo menos uma Empresa e uma Organizao. Uma Empresa pode ter mais de uma organizao conectado a ela. O sistema vem com a empresa GardenWorld configurado com alguns dados para avaliao e testes. Para criar uma nova Empresa, execute os passos abaixo: Faa login com System ou SuperUser (senha System) usando a regra System Administrator; V em Administardor do Sistema Regras da Empresa Initial Client Setup Process e preencha os dados; Defina o nome da Empresa(campo Client Name) e Organizao (Ex.client e org) - pequenas empresas podem usar o mesmo nome para os dois campos. Empresas grandes podem ter mais de uma Organizao conectada Empresa. As demais organizaes so definidas em outra tela. Defina o nome do administrador que usado para configurar os dados da Empresa (Ex.: clientAdim) e do usurio com acesso a todos os dados e processos (Ex.: clientUser) . A senha de ambos ser igual ao nome escolhido; No campo Pas, escolha Brasil; No campo Chart of Accounts, selecione o arquivo Accouting_BR.csv para importar o plano de contas; Depois de preencher todos os dados, clique no boto Iniciar. O processo demora alguns minutos.

3.2. Seguindo o fluxo de trabalho para configurar o clienteDepois de criar a nova empresa, faa login usando os dados do administrador da empresa e abra o fluxo de trabalho abaixo para completar todos os passos de criao de uma nova empresa:

Menu: Administardor do Sistema Regras da Empresa Reviso da Configurao Inicial da Empresa

3.2.1. EmpresaAlguns 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.

3.2.2. OrganizaoMenu: 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.

3.2.3. Papel (Funo)Menu: Administrador do Sistema Regras Gerais Segurana Papel(Funo) 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: Ativo que determina se o item estar disponvel ao papel; 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.

3.2.4. UsurioMenu: 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; Parceiro de Negcios: conecta um usurio a um parceiro de negcios (pode ser um funcionrio, cliente ou fornecedor); Funes de Usurios: papel/funo. Atribua pelo menos um papel ao usurio.

3.2.5. Perodo e Ano CivilMenu: Anlise de Desempenho Regras Contbeis Perodo e Ano Civil Todo ano necessrio criar um novo perodo contbil. Para criar um novo perodo, clique na aba Ano, adicione um novo registro e: Preencha o campo Ano; Clique no boto Criar perodos. Clique em Abrir/Fechar tudo; Selecione Perodo aberto.

Clique na aba Perodo(Ano Fiscal):

4. Parceiro de negciosMenu: 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: pertencer a mais de um tipo bsico simultaneamente; ter mais de uma localizao ou contato; 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).

4.1. Fluxo de trabalhoMenu: Relacionamento com Parceiro de Negcios Regras de Parceiro de Negcios Configurao de Parceiro de Negcios

4.1.1. Grupo de parceiro de negciosPermite definir parmetros comuns a grupos de parceiro de negcios(Ex.: cliente, fornecedor, funcionrio). Cada parceiro de negcio ser associado a um grupo.

4.1.2. SaudaoSaudao ou tratamento para o parceiro de negcio (Ex.: Sr.)

4.1.3. Condio de pagamentoPermite configurar diversas formas de pagamento(Ex.: vista, antecipado, parcelado 30/60 dias) e associar ao Parceiro de Negcio. A ajuda da janela possui informaes completas sobre os campos. Seguem alguns campos abaixo: Dias lquidos: dias teis para o vencimento; 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; Porcentagem: porcentagem do valor total que corresponde a parcela; Dias lquidos: define o nmero de dias aps a data da fatura para que o pagamento seja efetuado;

Na aba Programao, informe os parmetros das parcelas da condio de pagamento:

Depois de configurar todos os itens, clique em Validar. Se o campo Vlido aparecer marcado, indica que a forma de pagamento est configurada corretamente.

4.1.4. Programao de faturamentoDefine frequncias e datas para gerar faturas. usado quando um cliente exige uma fatura nica para mltiplas entregas.

4.1.5. CobranaConfigurao de cartas de cobrana. Permite configurar itens como: enviar carta aps um determinado nmero de dias do vencimento da fatura; intervalo entre cartas de cobrana; texto, notas e formato da carta; cancelar crdito do parceiro de negcios.

4.1.6. Importao de parceiro de negciosPermite importao de dados de outros sistemas no Adempiere.

4.2. Manuteno parceiro de negciosLembrando que um cliente, fornecedor ou funcionrio antes de mais nada, um Parceiro de Negcio. Para incluir um cliente, fornecedor ou funcionrio, adicione um registro e defina os campos principais: Nome; Grupo de Parceiros; Tipo de Parceiro (separador Adempiere LBR); Note que aqui definimos configuraes especficas para o Brasil como o CPF ou CNPJ e tambm informaes referente aos impostos; Depois selecione uma das abas especficas(Ex.: Cliente) e defina os campos relativos ao parceiro de negcios.

4.2.1. ClienteSelecione 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; Regra de entrega: pedido completo; Via de entrega: retira, entrega, transportadora; Lista de preo; Esquema de descontos; Condio de pagamento; Representante de vendas: vendedor; Cobrana: carta de cobrana; Limite de crdito; Observao Nota Fiscal (separador AdempiereLBR)

4.2.2. FornecedorSelecione a aba Fornecedor e marque a opo Fornecedor. Isto torna o parceiro de negcios um fornecedor e mais campos se tornam disponveis para edio.

4.2.3. FuncionrioSelecione a aba Funcionrio e marque a opo Funcionrio. Marque o campo Representante de Vendas caso o funcionrio seja um vendedor.

4.2.4. Conta BancriaEsta aba permite definir informaes bancrias do parceiro de negcios. Estas informaes so utilizadas para processar pagamentos e remessas de valores. O parceiro pode ter vrias contas definidas.

4.2.5. LocalizaoSo 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.

5. 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).

5.1. Grupo de tributaoMenu: 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.

5.2. Categoria de ImpostoMenu: Anlise de Desempenho Regras Contbeis Categoria de Imposto

5.3. Grupo de Impostos (Nota Fiscal)Menu: Localizao Brasil Fiscal Nota Fiscal Grupo de Impostos (Nota Fiscal)

5.4. ImpostosMenu: 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@)

O usurio deve definir duas frmulas de clculo nos seguintes campos: 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.

5.5. Alquota de ImpostoMenu: 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.

5.6. Configurao de ImpostosMenu: 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.

5.7. CFOPMenu: Localizao Brasil Fiscal CFOP CFOP

5.8. NCMMenu: Localizao Brasil Fiscal NCM

5.9. Mensagem legalMenu: Localizao Brasil Fiscal Nota Fiscal Mensagem legal

5.10. Nota Fiscal Eletrnica (Nfe) - configurao5.10.1. EmpresaMenu: Administrador do Sistema Regras Gerais Regras da Empresa Empresa

Certifique-se que o campo Idioma est setado para Portuguese(Brazil).

5.10.2. CertificadosMenu: Localizao Brasil Certificado Digital preciso cadastrar pelos menos dois certificados: um para a empresa e outro para o webservice da Sefaz. Campos: Nome: identificao para o certificado Tipo de Certificado: PKCS#12 (certificado .pfx da empresa) ou Java Key Store (webservice da Sefaz); Pseudnimo: alias do certificado Senha: senha do certificado

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.

5.10.3. OrganizaoMenu: Administrador do Sistema Regras da Organizao Regras da Organizao Organizao Preencha os seguintes dados na aba Informaes da Organizao: Endereo da Organizao; Certificado da Organizao: indicar o certificado cadastrado com o arquivo .pfx da empresa; Certificado da Transmisso: indicar o certificado cadastrado com o arquivo .jks do webservice da Sefaz; Ambiente da NFe: Homologao (para testes) ou Produo (ambiente real);

5.10.4. Sequncia de DocumentoMenu: Anlise de Desempenho Regras Contbeis Sequncia de Documento Crie uma nova sequncia para a nota fiscal: Nome: Exemplo: NFe; Auto-numerao: deixe marcado para incrementar o nmero da NF; Incremento: 1; Prximo Nmero: nmero da ltima NF emitida + 1;

5.10.5. Tipo de DocumentoMenu: Anlise de Desempenho Regras Contbeis Tipo de Documento Crie um novo Tipo de Documento e defina: Nome: Exemplo: NFe; Texto de Impresso: igual ao nome; Categoria de Razo Geral: None; Tipo de Base de Documento: Nota Fiscal Brasil; Sequencia de Documento: procure pela sequncia que definiu no passo anterior;

Documento controlado numericamente: deixe marcado; Modelo da NF: 55; Srie da NF: informe a srie do documento da sua nota fiscal; Ambiente da NFe: Homologao ou Produo Formato da DANFE: Paisagem ou Retrato;

6. ProdutoA 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; itens que so recursos ilimitados, e que no podem ser armazenados.

Os produtos indiretos so os recursos e despesas que sero definidos na opo correspondente e no em conjunto com os produtos.

6.1. Fluxo de trabalho do produtoMenu: Administrao de Materiais Regras de Administrao de Materiais Configurao do Produto

6.1.1. Armazm e LocalizadoresUma empresa pode ter vrios armazns. Mas, cada armazm no representa necessariamente um espao fsico delimitado. Por exemplo, podemos ter um espao comum para entrada e sada de produtos e definilos no Adempiere como se fossem lugares distintos. Na aba Localizador, definimos o corredor e prateleira. Cada armazm pode ter vrios localizadores.

6.1.2. Unidade de MedidaInforme as unidades de medida que sero usadas nos produtos. Na aba Converso, definimos converso entre unidades de medida cadastradas.

6.1.3. Categoria de ProdutoTem o objetivo de agrupar os produtos para facilitar sua manuteno.

6.1.4. Categoria de ImpostosTambm faz parte da definio dos impostos. Tem o objetivo de agrupar os impostos para facilitar a manuteno.

6.2. Manuteno do ProdutoMenu: Administrao de Materiais Regras de Administrao de Materiais Produto Segue descrio das seguintes abas:

6.2.1. ProdutoCampos principais do produto: Nome; Categoria do Produto; UDM: unidade de medida; Tipo de Produto: item, recurso, despesa; 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

6.2.2. BOM ou LDMUsamos a aba BOM (build of materials ou lista de materiais - LDM) para configurar produtos que so comprados de uma forma, sofrem algum tipo de transformao e so vendidos ou, produtos que so fabricados a partir de outros produtos. Exemplo de uso para LDM para o produto Suco de laranja: Primeiro crie todos os componentes e o produto final na aba Produto: Suco de laranja; gua; Laranja; Embalagem; Selecione o produto final(Suco de laranja) e depois a aba BOM: Crie um novo registro e no campo Produto, escolha o produto final (Suco de laranja); Preencha os campos necessrios e grave os dados; No separador Components Crie um novo registro e informe um componente(gua, laranja, embalagem) no campo Produto; Preencha os dados necessrios (campo Quantity por exemplo) e grave os dados; repita o processo para todos os componentes do produto final; Depois de preencher todos os dados, quando voltar na aba Produto, perceba que o checkbox Lista de Materiais est selecionado e que o boto Verificar LDM exibido;

6.2.3. SubstitutoDefinio de produtos que podem ser usados como alternativas para o produto selecionado.

6.2.4. ComprasDefine os preos e regras de compra (quantidades por pacote, quantidade mnima) para o produto.

6.2.5. Parceiro de NegciosPode ser cadastrado o(s) fornecedor(es) do produto.

6.2.6. PreoDefine 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; Preo limite (mnimo);

6.2.7. TransaesExibe as transaes feitas com este produto.

7. Listas de preoMenu: 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.

7.1. Fluxo de trabalho da lista de preoMenu: Administrao de Materiais Regras de Administrao de Materiais Configurao de Lista de Preo

7.1.1. Esquema de Lista de PreoDefine as regras para clculo da Lista de Preo. Inclua um novo esquema definindo o nome na aba Esquema de Lista de Preo, e as regras na aba Linha de Esquema.

7.1.2. Lista de preosEm cada verso da lista de preo, um produto ter apenas um registo com trs preos associados: preo de lista: usado para clientes que recebem descontos; preo padro: preo padro do produto; 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 Preciso do preo: arrendondamento de casas decimais 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.

Principais campos de uma Lista de Preo:

Na aba Verso, definimos as diferentes verses da lista de preo. Cada lista de preo ter pelo menos uma verso. Campos principais: Nome: nome da verso da lista Esquema de Lista de preo Lista de preo base: lista de preos usada como base(fonte) na criao da atual verso (pode ser deixado em branco); Vlido desde: data a partir da qual a verso ser vlida; Boto Criar Lista de Preos: cria a nova verso da lista de preos;

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.

7.1.3. Esquema de descontoMenu: Administrao de Materiais Regras de Administrao de Materiais Esquema de Descontos Configurao de descontos sobre as listas de preos. No aba Esquema de Desconto, defina os campos: Nome; Tipo de desconto: define se o desconto ser por uma percentagem fixa ou levar em conta a quantidade de produtos comprados. Porcentagem fixa: Desconto Raso do P.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: Sequencia: ordem/numerao do registro; Categoria do produto: aplica este esquema categoria de produto selecionada Produto: aplica este esquema ao produto selecionado habilitado quando no seleciona Categoria do Produto e vice-versa; Ponto de inflexo: a partir desta quantidade ser aplicado o desconto Desconto Raso do P.Negcios: usar o desconto definido no Parceiro de Negcios; Desconto Incremental %: porcentagem de desconto a ser aplicado.

8. CompraMenu: Da Requisio Fatura O processo de compra de materiais formado pelos seguintes documentos e na ordem apresentada: Requisio ou Solicitao de Cotao (SdC) Pedido de Compra (PC)

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.

8.1. RequisioMenu: 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: Tipo de Documento: Purchase Requisition (Requisio de Compra); Usurio/Contato: pode ser quem est pedindo o material ou o contato do Parceiro de Negcios; Prioridade: prioridade desta requisio; Data exigida: necessrio receber o material at esta data Armazm: Local onde o produto ser armazenado; Lista de Preo Linha Nmero: ordem dos itens ou exibio das linhas; Parceiro de Negcios: fornecedor; Produto; Quantidade: quantidade do material para compra; Preo unitrio: preo unitrio para compra; Linha do Pedido de Compra: exibido quando este item estiver associado a um PC.

O material requisitado para compra, deve ser digitado na aba Linha de Requisio:

A aba Pedidos de Compra, mostra os PCs associados a esta requisio; Quando terminar de digitar a Requisio, volte na primeira aba e clique no boto Completo. Ser exibida uma tela para selecionar a ao que pretende executar com a Requisio. Escolha Completo. Observe que o campo Estado do Documento muda de Esboado para Completado e que agora existe o boto Fechar.

8.2. SdC Solicitao de CotaoMenu: Da Requisio Fatura SdC Funciona como a Requiso porm de uma forma mais completa. A SdC fornece mecanismos para comparar diferentes cotaes e condies de fornecimento para o material que precisa ser comprado. Deve-se escolher entre a Requisio ou SdC de acordo com suas necessidades. O PC de compra tambm pode ser gerado com os dados digitados na SdC.

8.3. Pedido de CompraMenu: 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: Tipo de documento alvo: Purchase Order (ordem de compra)

Data da Pedido; Data Prometida; Parceiro de Negcios: fornecedor; Localizao do Parceiro: endereo do fornecedor; Usurio/contato: contato do parceiro de negcios; Contato da Fatura: contato do Parceiro para fatura; Armazm: local onde os produtos so armazenados; Prioridade: prioridade deste PC; Lista de Preo: lista usada nesta compra; Agente da Companhia: funcionrio encarregado da compra Condio de pagamento; Criar Linhas do Pedido: permite usar os dados digitados de uma Requisio para preencher este PC; Copiar Linhas: copia dados (linhas) de outros PC; Completo: Altera o status do PC para Completado;

Botes:

Na aba Linha de PC, os itens de compra so definidos: Linha nmero: nmero ou ordem do item na lista; Produto; Quantidade: quantidade do material para compra; Preo unitrio: preo unitrio para compra; Preo de Lista: preo de tabela (calcula o campo Desconto %) Valor da Linha: valor total do item

Quando terminar de digitar todos os dados, clique no boto Completo na aba Pedido de Compra e selecione Completo como ao para executar.

8.4. Recebimento de materialMenu: 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: Data da Movimentao: indica a data de entrada de material no estoque; Data da Conta: data para documentos fiscais; Parceiro de Negcios: fornecedor; Localizao do Parceiro: endereo do fornecedor; Regra de Custo de Frete; Prioridade.

Botes:

Criar Linhas a partir de: Cria as linhas a partir de um Pedido de Compra; Criar Confirmao: cria documentos para confirmao de recebimento. Estes documentos devem ser confirmados em Menu: Administrao de Materiais Confirmao de Envio/Recebimento. Completo: Processa o recebimento e atualiza estoque; Gerar Fatura a partir do Recibo: gera a Fatura a partir deste documento (Recebimento de Material)

8.5. Fatura(fornecedor)Menu: Da 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. Tipo de documento alvo: Fatura AP Data Faturada; Data da Conta: para lanamento contbil; Parceiro de Negcios: fornecedor; Localizao do Parceiro: endereo do fornecedor; Lista de Preo: lista usada nesta compra; Condio de Pagamento; Agente da Companhia: funcionrio encarregado da compra Condio de pagamento; 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;

Botes:

Na aba Linha de Fatura, os itens da fatura so definidos: Linha nmero: nmero ou ordem do item na lista; Produto; Quantidade: quantidade do item a faturar; Preo unitrio: preo unitrio para compra; Preo de Lista: preo de tabela (calcula o campo Desconto %) Valor da Linha: valor total do item

9. VendaMenu: 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.

9.1. Ordem de vendaMenu: Da Cotao a Fatura Pedidos de Venda Ordem de venda Especifica o parceiro de negcios(cliente), material que ser vendido, condio de pagamento, etc. Na aba Pedido temos os campos: Tipo de Transao: Utilizado para definir o CFOP e a forma de clculo dos impostos; Tipo de Documento Alvo: Proposta, Pedido Padro; Data do Pedido; Data Prometida; Parceiro de Negcios: cliente; Usurio/contato: contato do parceiro de negcios (cliente); Parceiro da Fatura: a quem deve ser faturado a venda; Localizao do Parceiro: endereo do parceiro de negcio(cliente); Regra de Entrega; Prioridade: til quando no existe estoque suficiente para atender todos as vendas; Armazm: onde os produtos esto armazenados; Via de Entrega: Retirar, Transportadora; Regra de Custo de Frete: mtodo para cobrar pelo frete; Regra de Fatura: modo e frequncia de emisso de faturas para o cliente; Lista de Preo: lista usada para determinar o preo e descontos aplicados; Representante de Vendas: vendedor (funcionrio); Condio de Pagamento; Imprimir Descontos (checkbox): indica se os descontos sero impressos no documento. Forma de Pagamento: localizado em Fatura, abaixo do Representante de Vendas (Em crdito, Cheque, Dinheiro, etc...); Copiar Linhas: copia linhas de outra Ordem de Venda; Criar Linhas a partir de: Cria linhas a partir de outro documento indicado pelo usurio; Completo: Altera o Estado do Documento.

Botes:

Na aba Linha de Pedido, os itens a serem vendidos so definidos: Linha Nmero: nmero ou ordem do item na lista; Produto; Despesa: a ordem de venda pode se referir a uma despesa em vez do produto; Quantidade: quantidade do produto encomendado;

UDM: unidade de medida; Preo; Preo Unitrio; Preo de Lista: preo oficial do produto na lista de preos; Desconto %: porcentagem de desconto obtida Taxa: imposto aplicvel na linha de ordem de venda; Valor da linha: Quantidade X Preo sem despesas adicionais ou frete. Separador Imposto: referente a tributao brasileira; CFOP; Imposto Brasileiro; Mensagem Legal; Situao Tributria(ICMS);

A aba Imposto do Pedido, mostra o total de impostos associados venda. Quando terminar de digitar todos os dados, clique no boto 'Completo' na aba Pedido e informe 'Completo' como Ao do documento. Ainda que uma ordem de venda esteja fechada, a mesma pode ser alterada. Para isso, selecione a ordem de venda desejada e, na aba Pedido, clique no boto Completo. Selecione a opo Reativar. Faa as alteraes necessrias e depois clique novamente no boto Completo e selecione 'Completo'.

9.2. RemessaMenu: Da Cotao a Fatura Entregas Gerar Remessas (Manual) Com base na Ordem de Venda, pode-se gerar este documento que atualiza as informaes de estoque. Para criar uma remessa abra o item Gerar Remessas(Manual) no menu e escolha um Armazm: A seguir, as Ordens de Venda disponveis para o Armazm selecionado sero mostradas. Selecione as que deseja; Selecione a Ao do Documento (Completo); Confirme a criao das Remessas; Selecione se deseja imprimir as Remessas;

Os documentos de Remessa podem ser verificados em Menu: Da Cotao a Fatura Entregas Expedio (Clientes)

9.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: Abra o item Gerar Faturas / Notas Fiscais (Manual); 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; Selecione a Ao do Documento (Preparar ou Competo); Selecione se deseja ou no imprimir 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: 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; Programao de Pagamentos: define os valores e datas das parcelas da fatura.

Quando terminar de digitar todos os dados, clique no boto Completo na aba Fatura e selecione Completo como ao do documento.

9.4. Nota Fiscal Eletrnica (Nfe) - emissoMenu: 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.

10. Financeiro10.1. Contas BancriasMenu: Administrao do Sistema Regras da Organizao Banco Define bancos e contas que sero associadas Organizao ou Parceiro de Negcios. Na aba Banco, as instituies bancrias so definidas (Ex.: Banco do Brasil, Bradesco, etc...) Nome; Nmero de Rastreio: cdigo do Banco. Nmero da conta; Moeda; Tipo de Conta Bancria.

Na aba Conta, informe as contas que possui no banco selecionado:

10.2. Contas Pagar e ReceberMenu: Itens em Aberto Itens em Aberto Permite visualizar faturas em aberto de clientes e fornecedores. Basta informar: 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.

10.3. CaixaOs lanamentos do caixa so feitos nas janelas: Dirio de Caixa: geralmente usado para pequenos pagamentos no relacionado ttulos no contas;

Pagamento: registra o recebimento ou pagamento de ttulos (contas pagar ou receber);

10.3.1. Livro-Caixa(Cashbook)Menu: Administrao do Sistema Regras da Organizao Livro-Caixa (Cashbook) Antes de fazer lanamentos no Dirio de Caixa, necessrio cadastrar pelo menos um Livro-Caixa nesta janela. Cada caixa constitudo de vrias folhas - Dirio de Caixa(Cash Journal). Na aba Livro-Caixa, informe: Nome; Moeda;

10.3.2. Dirio de CaixaMenu: Itens em Aberto Dirio de Caixa (Cash Journal) Usado para digitar as folhas do caixa. Na aba principal(Dirio de Caixa) informe os seguintes dados: Nome; Data de Extrato: data do caixa; Data da Conta: data contbil; Saldo Inicial: saldo antes de iniciar o caixa; Linha nmero: nmero do lanamento do caixa; Descrio: histrico do lanamento; Tipo de Numerrio: tipo de lanamento; Valor.

Informe os lanamentos do caixa na aba Linha de Caixa:

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.

10.4. PagamentoMenu: Itens em Aberto Pagamento Permite processar pagamento ou recebimento de ttulos(fatura). Na aba Pagamento informe: Tipo de Documento: Recibo(recebimento) ou Pagamento; Conta bancria; Data da Transao; Data da Conta: data contbil; Parceiro de Negcios: cliente ou fornecedor; 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; Tipo de Pagamento: Cheque, Dbito ou Depsito Direto, Carto de Crdito, etc...;

Clique no boto Completo para finalizar o recebimento ou pagamento;

11. Dicionrio de Aplicao (AD)O Dicionrio de Aplicao ou AD, um conjunto de dados que representa quase todos os elementos do sistema como tabelas e suas colunas. Desta maneira fica mais fcil fazer manuteno ou customizao do Adempiere sem precisar alterar o cdigo fonte. Sempre que precisar fazer manuteno no AD, utilize o a Regra System Administrator (usurio System ou SuperUser). Nos itens abaixo, onde estiver escrito campo, entenda coluna de uma tabela. Em alguns dos itens abaixo, existe a aba Traduo. Esta aba permite traduzir itens como o nome, texto de impresso ou comentrio/ajuda do elemento selecionado. Digite o texto traduzido nos campos correspondentes, marque a opo Traduzida e grave a alterao. Para habilitar as abas de traduo, selecione o item Mostrar abas de Traduo em Ferramentas Preferncia.

11.1. Elemento do sistemaMenu: Dicionario de Aplicao Elemento Principal componente do AD. Define os campos usados no sistema. Na aba Elemento, os campos principais so: Nome da Coluna BD: nome da coluna como est definido no BD; Nome; Texto de impresso; Tipo de Entidade: Adempiere, Dictionary, AdempiereLBR; Campos PC so utilizados na tela Pedido de Compra.

Aba Usado na coluna mostra onde o elemento usado.

11.2. RefernciaMenu: Dicionrio de Aplicao Referncia As referncias so usadas na janela Tabela e Coluna. Aqui so definidos como os campos so validados. Na aba Referncia, defina os dados principais: Nome; Descrio; Comentrio/Ajuda: este texto ser exibido na tela de ajuda; 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: Nome: valor que ser exibido para o usurio; Chave de busca: valor que ser gravado no BD;

A aba Tabela de Validao, define tabelas, campos e condies para validar os dados: Tabela: define a tabela utilizada na validao; Coluna Chave: coluna para ser usada como chave. O contedo desta coluna ser gravado no BD; Mostra Coluna: o contedo desta coluna ser exibido para o usurio; SQL WHERE: Sql usada para seleo dos registros da tabela; SQL ORDER BY: Sql para ordenar a exibio dos dados;

11.3. Regras de Validao DinmicaMenu: Dicionrio de Aplicao Regras de Validao A validao dinmica utilizada na janela Tabela e Coluna no campo Validao Dinmica. Define regras dinmicas usadas durante a manuteno de colunas. Por exemplo, pode-se definir uma regra para exibir apenas os armazns da prpria Organizao selecionada ao invs de exibir os armazns de todas as Organizaes cadastradas. Campos principais: Nome; Tipo: SQL, Linguagem Java, Script Java Cdigo de Validao: o cdigo de validao de acordo com a linguagem(Tipo) escolhido;

11.4. Tabelas e colunasMenu: Dicionario de Aplicao Tabela e Coluna Informao de todas as tabelas e colunas do sistema. Observao: A chave primria de qualquer tabela deve ter o seguinte formato de nome: _ID Caso necessite criar tabelas no Adempiere, as seguintes colunas so padro em qualquer tabela:

AD_CLIENT_ID NUMERIC(10) NOT NULL, AD_ORG_ID NUMERIC(10) NOT NULL, ISACTIVE character(1) DEFAULT 'Y' NOT NULL, CREATED timestamp without time zone DEFAULT now() NOT NULL, CREATEDBY NUMERIC(10) NOT NULL, UPDATED timestamp without time zone DEFAULT now() NOT NULL, UPDATEDBY NUMERIC(10) NOT NULL,

Campos da aba Tabela: Nome da Tabela no BD: nome da tabela exatamente como est no banco de dados; Nome; Exibir: apenas exibir ou visualizar os dados, no permite alterao dos dados da tabela; Nvel de Acesso de Dados: nvel de acesso para esta tabela: Todos, Somente Cliente, Somente Sistema; Gerenciamento de Registro de Alteraes: mantm um log de alteraes na tabela; Janela: indica em qual janela esta tabela utilizada; Registros Excluveis: permite excluir dados; Alto volume (de dados): exibe uma tela de pesquisa quando a janela correspondente a esta tabela for aberta. 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;

Botes:

Copiar colunas de: copiar colunas de outra tabela; 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; Verso: verso da definio da tabela ou campo; Comprimento: tamanho da coluna como definido no BD; 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. Lgica padro: valor padro(default); 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; Atualizvel: o contedo do campo pode ser editado pelo usurio; Identificador: indica que a coluna faz parte da chave primria.

Campos da aba Coluna:

11.5. Janela, aba e campoMenu: Dicionario de Aplicao Janela, Aba & Campo Configura a apresentao de tabelas e campos dentro das janelas do sistema. A aba Janela, define as Janelas existentes no sistema. Campos principais: 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; Sequncia: ordem de exibio da aba; 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; Sql WHERE: SQL a ser usada na seleo de registros; Sql ORDER BY: SQL para ordenar os registros;

Botes: Criar Campos: cria campos (aba Campo) inexistentes a partir da tabela selecionada; Copiar Campos de Abas: copia campos de outras abas.

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; Coluna: coluna do BD associada este campo; Mostrado: indica se o campo ser exibido na aba; Somente Leitura: quando marcado no permite alterao de dados; Lgica de Visualizao: quando Mostrado est marcado, permite validar uma expresso para determinar se o campo ser exibido ou no; Sequncia: ordem de exibio dos campos; Mesma Linha: o campo ser exibido na mesma linha que o anterior.

11.6. FormulrioMenu: Dicionrio de Aplicao Formulrio Define janelas que no so geradas automaticamente pelo sistema. Neste caso precido alterar o cdigo fonte do Adempiere para criar a janela. Exemplo: Abrir LDM. Na aba Formulrio, defina os seguintes campos: Nome; Nvel de Acesso de Dados: nvel de acesso desta janela (Organizao, Empresa+Organizao, Sistema+Empresa); Classname: indica a classe Java codificada para o formulrio. Papel(Funo): define quem tem acesso ao formulrio; Escrita e Leitura: permite alterao de dados.

Na aba Acesso, defina o Papel(Funo) que pode acessar a janela:

11.7. MensagemMenu: Dicionrio de Aplicao Mensagem Utilizado para definir mensagens de texto e dicas(tips) geradas pelo sistema. Definir os campos na aba Mensagem: Tipo de Mensagem: Erro, Informao e Menu Texto de Mensagem: texto que ser exibido;

12. Exemplo de customizao AD - novas colunasExemplo para adicionar dois campos aba Funcionrio(Parceiro de Negcios): Data de admisso e Situao.

12.1. Modificar a Tabela e Coluna1)Abra a janela Tabela e Coluna em Menu: Dicionrio de Aplicao Tabela e Coluna; 2)Procure pela Tabela Buisiness Partner (Parceiro de Negcios). O nome da Tabela no BD C_BPartner; 3)V na aba Coluna e crie a nova coluna HireDate(Data de admisso) preenchendo: Nome da Coluna BD: HireDate. Elemento do Sistema: deve ter o mesmo nome que o Nome da Coluna BD. Para criar o novo elemento: Clique com o 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; Nome: Hire Date; Verso: 1; Comprimento: 7; Referncia: Data; Atualizvel: permite alterao no valor do campo;

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.

12.2. Modificar a Janela1)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. Nome: HR Status Coluna: HR_Status_HR_Status Mesma Linha: deixe marcado para que os dois campos aparecerem na mesma linha.

5)Crie outro campo manualmente e preencha os dados para o HR_Status:

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.

12.3. Sincronizar TerminologiaMenu: Administrao do Sistema Regras Gerais Sincronizao de Terminologia. Execute o processo Sincronizao de Terminologia. Este processo faz a sincronia das abas de traduo dos campos com a traduo do Elemento do Sistema. Retorne na janela Janela, Aba & Campo, procure pelos novos campos que acabou de criar e verifique que na aba Traduo de Campos, a traduo foi gerada como informado no Elemento do Sistema.

12.4. Verificar a customizaoVerifique a customizao na janela Parceiro de Negcios, aba Funcionrio.

Os novos campos Data de Admisso e Situao so exibidos depois do campo Ativo. Note que ao lado do campo Data de Admisso, aparece um boto que abre um calendrio para selecionar a data desejada. Quanto ao campo Situao, ele tem o fundo azul, indicando que um campo obrigatrio e quando

clicado, uma lista exibida com os valores pr-definidos.

13. Exemplo de customizao AD - nova janelaExemplo para criar uma nova janela no Adempiere usando o AD, ou seja, sem programao. Neste exemplo vamos criar a tabela Cor associ-la em novo campo na tabela de produtos.

13.1. Criar Tabela13.1.1. Criar tabela no BDPara 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 SQLCREATE TABLE X_M_COLOR ( X_M_COLOR_ID NUMERIC(10) NOT NULL, AD_CLIENT_ID NUMERIC(10) NOT NULL, AD_ORG_ID NUMERIC(10) NOT NULL, ISACTIVE CHARACTER(1) DEFAULT 'y' NOT NULL, CREATED TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT NOW(), CREATEDBY NUMERIC(10) NOT NULL, UPDATED TIMESTAMP WITHOUT TIME ZONE NOT NULL DEFAULT NOW(), UPDATEDBY NUMERIC(10) NOT NULL, NAME CHARACTER VARYING(60) NOT NULL ); ALTER TABLE ADEMPIERE.X_M_COLOR ADD PRIMARY KEY(X_M_COLOR_ID);

13.1.2. Criar tabela e colunas no AD Abra a janela Tabela e Coluna em Menu: Dicionrio de Aplicao Tabela e Coluna; Crie um novo registro e preencha os seguintes dados na aba Tabela: Nome da Tabela no BD: X_M_COLOR Nome: X_M_COLOR; Nvel de Acesso ao Sistema: Empresa+Organizao Registros Excluveis: deixe marcado; Clique na aba Traduo de Tabelas e informe: Nome: Cor do Produto; Traduzida: marque esta opo e grave as alteraes; Volte na aba Tabela e clique no boto Criar Colunas a partir do Bando de Dados e como Tipo de Entidade, selecione User mainted.

13.1.3. Refinar dados das colunasAs colunas foram criadas conforme o BD e a referncia associada automaticamente quando possvel ou uma nova referncia criada. 1)Selecione a aba Coluna referente tabela recm-criada (X_M_COLOR) e faa as seguintes modificaes: 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;

2)Procure pela tabela M_PRODUCT; 3)Abra a aba Coluna e crie uma nova coluna como abaixo: Nome da Coluna BD: X_M_COLOR_ID. Elemento do Sistema: X_M_COLOR_ID. J deve estar criado mas faa a traduo: Clique com o boto direito neste campo e selecione Zoom; Preencha o Nome e Texto de Impresso como Product Color; Clique na aba Traduo, preencha o Nome e Texto de Impresso com Cor do Produto; Marque a opo Traduzida, grave os dados e retorne janela Tabela e Coluna; Nome: Product Color; 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;

13.2. Criar janela Cor do Produto1)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; Clique na aba Traduo de Janela e informe: Nome: Cor do Produto; Traduzida: marque esta opo e grave as alteraes; 3)Crie uma nova aba, clicando na aba Aba: Nome: Color; Tabela: X_M_COLOR;

Clique na aba Traduo de Abas e informe: Nome: Cor; Traduzida: marque esta opo e grave as alteraes;

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; Marque a opo Mesma Linha para os campos Organization e Name; Crie um novo Grupo de Campo com nome Product Color e define-o nos campos Product Color e Name: Posicione no campo Product color; clique com o 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;

13.3. Modificar a janela Produto1)Procure pela janela Product (Producto); 2)Clique na aba Aba, procure e selecione Product. 3)Adicionar o novo campo clicando no boto Criar Campos; 4)Clique na aba Sequncia de Campo. Verifique que o campo Product Color foi criado. Ajuste sua posio na aba conforme desejar. 5)Grave os dados;

13.4. Criar Item Menu1)V em Menu: Administrador do Sistema Regras Gerais Regras do Sistema Menu 2)Crie um novo registro informando: Nome: Product Color; Ao: Janela; Janela: Cor do Produto; Na aba Traduo: Nome: Cor do Produto; Traduzida: marque esta opo e grave as alteraes; 3)Do lado esquerdo da janela, voc ver que o novo item foi criado na raiz do menu. Voc pode clicar nele e arrast-lo para onde desejar. Por exemplo, dentro de Administrao de Materiais.

13.5. Sincronizar TerminologiaDepois 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

13.6. Verificar customizaoFaa login novamente, v at o item de menu onde deixou a nova janela Cor do Produto e abra a janela. Verifique o layout da tela e entre com alguns dados.

V at a janela Produto, e verifique o novo campo Cor do Produto.

Observe que no final do campo, existe um 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.

14. Configurar o ambiente de desenvolvimentoEm algumas circunstncias, ser necessrio, alterar o cdigo fonte para que o Adempiere atenda suas necessidades. Para que o Adempiere consiga usar estas implementaes, elas devem ser agrupadas no arquivo customization.jar. Este captulo trata da configurao do ambiente de programao e como gerar o arquivo customization.jar. Como exemplo, ser usado o projeto OSeB.

14.1. Perparando o