You are on page 1of 46

Manual do usurio

Adempiere 3.6.0
OSeB
1.
Objetivo
O objetivo deste manual fornecer uma viso eral das funcionalidades do soft!are Adempiere" assim
como a customi#a$o para atender as necessidades do Brasil" o projeto Adempiere%B&'OSeB. O
Adempiere um projeto open(source derivado do soft!are )ompiere. O Adempiere possui
funcionalidades )&M e *&+ e bem fle,-vel para ser customi#ado e atender empresas de sementos
variados.
Referncias:
*ste manual foi elaborado com base em informa$.es e,tra-das dos lin/s abai,o. Os f0runs contm muita
informa$o e uma e,celente maneira de tirar suas d1vidas.
+ina oficial do Adempiere
+ina do projeto Adempiere
+ina do projeto OseB
20rum OSeB
20rum 3enos 4Adempiere%B&5
Manual Adempiere 4portu6s(portual5
+ina com cursos on(line do Adempiere 3.7
Mais informa$.es para usar o Adempiere
Histrico de verses
8ata 9erso :surio ;ist0rico
<6'0='>0<0 < &oerio Bettini )ria$o do documento
0?'<0'<0 > &oerio Bettini +rimeira reviso do documento
ndice
<.@nstala$o Adempiere%B& ........................................................................................................................6
<.<.@nstala$o A83....................................................................................................................................6
<.>.@nstala$o +ostreSB%........................................................................................................................6
<.3.Adempiere 3.6.0..................................................................................................................................6
<.3.<.)onfiurar as variveis de ambiente ( Cindo!s.........................................................................6
<.3.>.ArDuivos OS*B 3.6.0 4customi#a$o para o Brasil5...................................................................6
<.3.3.)opiar os arDuivos do Adempiere...............................................................................................E
<.3.7.)onfiurar o Adempiere 4primeira e,ecu$o5.............................................................................E
<.3.7.<.)riar o banco de dados e o usurio adempiere....................................................................E
<.3.7.>.)onfiurar o Adempiere......................................................................................................E
<.3.7.3.@niciali#ar o banco de dados do adempiereF.........................................................................E
<.3.7.7.Atuali#ar o banco de dados com os scripts 4patcGes5..........................................................E
<.3.?.)liente Ceb.................................................................................................................................E
<.3.6.)liente 8es/top...........................................................................................................................E
<.7.Atuali#a$o..........................................................................................................................................=
>.)onceitos erais..........................................................................................................................................=
>.<.%oin...................................................................................................................................................=
>.<.<.:surios pr(definidos.................................................................................................................=
>.>.Hela principal.......................................................................................................................................I
>.>.<.Menu..........................................................................................................................................<0
>.>.<.<.Jcones do menu..................................................................................................................<0
>.3.Aanelas...............................................................................................................................................<<
>.3.<.Jcones da barra de ferramentas..................................................................................................<<
>.3.>.2un$.es especiais nas janelas....................................................................................................<>
>.3.>.<.+refer6ncia de valor 4valor padro5...................................................................................<>
>.3.>.>.Kovo reistro.....................................................................................................................<>
>.3.>.3.Loom..................................................................................................................................<>
>.3.>.7.Atuali#ar.............................................................................................................................<3
>.3.>.?.+esDuisa.............................................................................................................................<3
>.3.>.6.@nforma$o sobre reistros.................................................................................................<3
>.7.2lu,o de trabalGo 4!or/flo!5...........................................................................................................<3
>.?.Ajuda.................................................................................................................................................<7
>.6.+refer6ncia.........................................................................................................................................<7
3.@mplementa$o e defini$.es bsicas.........................................................................................................<7
3.<.)riando nova empresa 4setup inicial5................................................................................................<7
3.>.Seuindo o flu,o de trabalGo para confiurar o cliente....................................................................<?
3.>.<.*mpresa.....................................................................................................................................<?
3.>.>.Orani#a$o...............................................................................................................................<6
3.>.3.+apel 42un$o5...........................................................................................................................<6
3.>.7.:surio......................................................................................................................................<6
3.>.?.+er-odo e Ano )ivil...................................................................................................................<6
7.+arceiro de ne0cios.................................................................................................................................<E
7.<.2lu,o de trabalGo...............................................................................................................................<E
7.<.<.Mrupo de parceiro de ne0cios..................................................................................................<=
7.<.>.Sauda$o....................................................................................................................................<=
7.<.3.)ondi$o de paamento.............................................................................................................<=
7.<.7.+rorama$o de faturamento.....................................................................................................<I
7.<.?.)obran$a....................................................................................................................................<I
7.<.6.@mporta$o de parceiro de ne0cios..........................................................................................<I
7.>.Manuten$o parceiro de ne0cios.....................................................................................................<I
7.>.<.)liente........................................................................................................................................>0
7.>.>.2ornecedor.................................................................................................................................>0
7.>.3.2uncionrio................................................................................................................................>0
7.>.7.)onta Bancria..........................................................................................................................>0
7.>.?.%ocali#a$o................................................................................................................................>0
?.@mpostos 4Brasil5.......................................................................................................................................>0
?.<.Mrupo de tributa$o...........................................................................................................................><
?.>.)ateoria de @mposto........................................................................................................................><
?.3.Mrupo de @mpostos 4Kota 2iscal5......................................................................................................><
?.7.@mpostos............................................................................................................................................><
?.?.Al-Duota de @mposto..........................................................................................................................><
?.6.)onfiura$o de @mpostos.................................................................................................................>>
?.E.)2O+.................................................................................................................................................>3
?.=.K)M..................................................................................................................................................>3
?.I.Mensaem leal.................................................................................................................................>3
?.<0.Kota 2iscal *letrNnica 4Kfe5 ( confiura$o...................................................................................>3
?.<0.<.*mpresa...................................................................................................................................>3
?.<0.>.)ertificados..............................................................................................................................>7
?.<0.3.Orani#a$o.............................................................................................................................>7
?.<0.7.SeDu6ncia de 8ocumento........................................................................................................>7
?.<0.?.Hipo de 8ocumento.................................................................................................................>7
6.+roduto......................................................................................................................................................>?
6.<.2lu,o de trabalGo do produto............................................................................................................>?
6.<.<.Arma#m e %ocali#adores.........................................................................................................>6
6.<.>.:nidade de Medida....................................................................................................................>6
6.<.3.)ateoria de +roduto.................................................................................................................>6
6.<.7.)ateoria de @mpostos...............................................................................................................>6
6.>.Manuten$o do +roduto....................................................................................................................>E
6.>.<.+roduto......................................................................................................................................>E
6.>.>.BOM ou %8M...........................................................................................................................>E
6.>.3.Substituto...................................................................................................................................>=
6.>.7.)ompras.....................................................................................................................................>=
6.>.?.+arceiro de Ke0cios.................................................................................................................>=
6.>.6.+re$o..........................................................................................................................................>=
6.>.E.Hransa$.es.................................................................................................................................>=
E.%istas de pre$o..........................................................................................................................................>=
E.<.2lu,o de trabalGo da lista de pre$o....................................................................................................>=
E.<.<.*sDuema de %ista de +re$o........................................................................................................>I
E.<.>.%ista de pre$os...........................................................................................................................>I
E.<.3.*sDuema de desconto.................................................................................................................30
=.)ompra......................................................................................................................................................3<
=.<.&eDuisi$o.........................................................................................................................................3<
=.>.Sd) O Solicita$o de )ota$o...........................................................................................................3>
=.3.+edido de )ompra.............................................................................................................................3>
=.7.&ecebimento de material...................................................................................................................33
=.?.2atura4fornecedor5.............................................................................................................................33
I.9enda.........................................................................................................................................................37
I.<.Ordem de venda................................................................................................................................37
I.>.&emessa.............................................................................................................................................36
I.3.2atura4cliente5...................................................................................................................................36
I.7.Kota 2iscal *letrNnica 4Kfe5 ( emisso.............................................................................................3E
<0.2inanceiro...............................................................................................................................................3E
<0.<.)ontas Bancrias.............................................................................................................................3E
<0.>.)ontas P +aar e &eceber................................................................................................................3=
<0.3.)ai,a................................................................................................................................................3=
<0.3.<.%ivro()ai,a4)asGboo/5...........................................................................................................3=
<0.3.>.8irio de )ai,a........................................................................................................................3=
<0.7.+aamento.......................................................................................................................................3I
<<.8icionrio de Aplica$o 4A85................................................................................................................3I
<<.<.*lemento do sistema........................................................................................................................3I
<<.>.&efer6ncia........................................................................................................................................70
<<.3.&eras de 9alida$o 8inQmica........................................................................................................70
<<.7.Habelas e colunas.............................................................................................................................7<
<<.?.Aanela" aba e campo.........................................................................................................................7>
<<.6.2ormulrio.......................................................................................................................................73
<<.E.Mensaem.......................................................................................................................................73
<>.*,emplo de customi#a$o A8 ( novas colunas......................................................................................77
<>.<.Modificar a Habela e )oluna...........................................................................................................77
<>.>.Modificar a Aanela...........................................................................................................................7?
<>.3.Sincroni#ar Herminoloia................................................................................................................76
<>.7.9erificar a customi#a$o.................................................................................................................76
<3.*,emplo de customi#a$o A8 ( nova janela..........................................................................................76
<3.<.)riar Habela.....................................................................................................................................76
<3.<.<.)riar tabela no B8...................................................................................................................76
<3.<.>.)riar tabela e colunas no A8...................................................................................................76
<3.<.3.&efinar dados das colunas.......................................................................................................7E
<3.>.)riar janela )or do +roduto............................................................................................................7=
<3.3.Modificar a janela +roduto..............................................................................................................7I
<3.7.)riar @tem Menu..............................................................................................................................7I
<3.?.Sincroni#ar Herminoloia................................................................................................................?0
<3.6.9erificar customi#a$o....................................................................................................................?0
<7.)onfiurar o ambiente de desenvolvimento...........................................................................................?0
<7.<.+erparando o ambiente....................................................................................................................?0
<7.<.<.@nstale o Subclipse...................................................................................................................?<
<7.>.Bai,ar e criar os projetos Adempiere e OSeB.................................................................................?<
<7.>.<.&eposit0rio Adempiere............................................................................................................?<
<7.>.>.&eposit0rio OSeB....................................................................................................................?<
<7.>.3.+rojeto Adempiere...................................................................................................................?<
<7.>.7.+rojeto OSeB...........................................................................................................................?>
<7.>.?.Atuali#ar o projeto com o Subclipse........................................................................................?>
<7.3.Merando o customi#ation.jar...........................................................................................................?>
<7.7.:tili#ando o novo customi#ation.jar...............................................................................................?>
2. Instalao Ademiere!"R
#r$%re&'isitos
A83
+ostresSB%
2.1. Instalao ()*
lin/F GttpF''!!!.oracle.com'tecGnet!or/'java'javase'do!nloads'inde,.Gtml
Selecione uma verso dispon-vel do A83 4*,.F A83 6.0 update ><5" fa$a o do!nload e conclua a
instala$o.
2.2. Instalao #ost+re,-!
lin/F GttpF''!!!.postresDl.or'do!nload'
*scolGa o sistema operacional e a verso 4*,.F =.7.75R
2a$a o do!nload e inicie a instala$oR
)omo senGa para o superuser use postgres;
porta ?73>
Ap0s o termino da instala$o" abra o arDuivo pg_hba.conf 4*,.F )FSArD...S+ostreSB%S=.7Sdata5 e altere o
M*H;O8 de md5 para trust como no e,emplo abai,oF
# TYPE DATABASE USER CIDR-ADDRESS METHOD
# IPv4 local connections:
host all all !"#$#$#%&! trust
2... Ademiere ../.0
lin/4j compilado5F Adempiere_360LTS.zip
2a$a do!nload do Adempiere 3.6.0 a partir do lin/ acima.
)rie uma nova pasta para instalar o arDuivos do Adempire4*,.F )FSAdempiere5.
2...1. 1onfi+'rar as vari2veis de ambiente % 3indo4s
9 em Meu computador T +ropriedades T Avan$ado T 9ariveis de Ambiente e adicione as seuintes
varveis de ambienteF
A8*M+@*&*U;OM* 4pasta criada para os arDuivo Adempiere. *,.F )FSAdempiere5
AA9AU;OM* 4caminGo A83. *,.F )FSArDuivos de proramasSAavaSjd/<.6.0U>< 5
A&*U;OM* 4caminGo A&*. *,.F )FSArDuivos de proramasSAavaSjre6 5
)%ASS+AH; 4lib A83 e A&*. *,.F )FSArDuivos de proramasSAavaSjd/<.6.0U><SlibR )FSArDuivos
de proramasSAavaSjre6Slib5
*dite o +atG e acrescente A83Sbin" e +ostresSbin 4*,.F R)FSArDuivos de
proramasSAavaSjd/<.6.0U><SbinR)FSArDuivos de proramasS+ostreSB%S=.7Sbin 5
2...2. Ar&'ivos O,5" ../.0 6c'stomi7ao ara o "rasil8
2a$a do!nload dos seuintes arDuivos clicando nos lin/s abai,oF
Vltima verso do )ustomi#ation.jar 4*,.F customi#ation0I0I<0.jar 5
Imortante: &enomear o arDuivo para customi#ation.jar
Script base para +ostreSB%
Imortante: *,trair o arDuivo *,p8at.dmp
Scripts de atuali#a$o +ostreSB% 4formato do nome dos aDuivosF patcGes88MMAAUpsDl.sDl5
AccountinB&.csv
2..... 1oiar os ar&'ivos do Ademiere
8escompacte o Adempiere360.zip na pasta criada para o Adempiere 4*,. )FSAdempiere5R
)opie o Customization.jar para lib 4*,. )FSAdempiereSlib5
)opie o Ep!at.dmp 4script base para postresSB%5 em data 4*,.F )FSAdempiereSdata5
)opie Accouting_"#.cs$ para data%import 4*,.F )FSAdempiereSdataSimport5
2...9. 1onfi+'rar o Ademiere 6rimeira e:ec'o8
2.3.4.1. Criar o banco de dados e o usurio adempiere
*,ecute o utlitrio pgAdmin3 e conecte(se ao servidor +ostreSB%R
)rie o usurio4%oin &ole5 adempiere com a senGa adempiere;
)rie o banco de dados com nome adempiere definindo o o!ner do B8 como usurio adempiere.
2.3.4.2. Configurar o Adempiere
*,ecute o #un_&etup 4*,.F )FSAdempiereS&unUSetup.bat5 e defina os parQmetrosF
8atabaseserver W localGost 4ou @+ do servidor5
8atabasetXpe W postresDl
8atabasename W adempiere
8B Admin passo!rd W adempiere
)liDue em '(est) para verificar se os parQmetros esto O3. Se der tudo certo" cliDue em &al$ar"
confirme as pr0,imas telas e auarde o trmino da confiura$o4demora aluns minutos5.
2.3.4.3. Inicializar o banco de dados do adempiere:
*,ecute o #un_!"#estore em :tils 4*,. )FSAdempiereS:tilsS&unU8B&estore.bat5
2.3.4.4. Atualizar o banco de dados com os scripts (patches
aplicar todos os scripts 4patcGes5 do +ostreSB% 4pode ser feito pelo utilitrio *gAdmin35
2...;. 1liente 3eb
@nicar o servidor com #un_&er$er+ em S:tilsR
*m um bro!ser" diiteF GttpF''YnomeservidorZ
)liDue no boto a#ul 4start no!5
2.../. 1liente )es<to
+ara iniciar o Adempiere" e,ecute o #un_Adempiere 4*,. )FSAdempiereS&unUAdempiere.bat5
2.9. At'ali7ao
Buando for disponibili#ado novas vers.es do customization.jar no site do projeto OSeB 4ou voc6 mesmo
compilar5 e'ou novos scripts 4patcGes5 para o banco de dados" e,ecutar os seuintes passosF
sobrescrever o antio customization.jar na pasta Slib com o novo arDuivo 4*,. )FSAdempiereSlib5R
e,ecutar o #un_silentsetup 4*,. )FSAdempiereS&unUsilentsetup.bat5R
aplicar todos os scripts 4patcGes5 do +ostreSB% 4pode ser feito pelo utilitrio *gAdmin35
%in/ para cGecar as 1ltimas vers.es disponibili#adas no site do projetoF OSeB 3.6.0
.. 1onceitos +erais
..1. !o+in
Ka primeira tela" informe o ,su-rio e &enha para acessar o sistema 4case(sensitive5
Ka seunda tela" a #egra.ou /un01o2*apel3" o Cliente.ou Empresa3 e a 4rganiza01o devem ser
informados
A #egra.ou /un01o2*apel3 define as permiss.es do usurio no sistema.
..1.1. =s'2rios r$%definidos
O Adempiere possui controle de acesso onde" as permiss.es de acesso Ps funcionalidades so definidas
por rupos4&era" +apel'2un$o5. )om a instala$o inicial so criados 7 usurios listados a seuirF
,>stem 4senGaF SXstem5F
Hem permisso de administra$o do sistema mas no tem acesso aos dados das empresas. 8eve
ser usado para cria$o de janelas" tabs e campos.
,'er=ser 4senGaF SXstem5F
Hem as mesmas permiss.es do usurio SXstem porm pode acessar dados das empresas.
?ardenAdmin 4senGaF MardenAdmin5F
:surio administrador da empresa MardenCorld" Due criada na instala$o padro do Adempiere.
+ode criar usurios para MardenCorld e definir permiss.es. Alm do acesso Ps funcionalidades do
Adempiere.
4bser$a01oF a empresa MardenCorld criada automaticamente com aluns dados para
testes e avalia$o do sistema.
?arden=ser 4senGaF Marden:ser5F
*sse usurio tem acesso restrito Ps funcionalidades do sistema" dentro da empresa MardenCorld.
..2. @ela rincial
8epois de fa#er o loin" temos a tela principal do sistema dividida da seuinte formaF
Ko t-tulo da janela do aplicativo ser informado o nome do ,surio" Empresa" 4rganiza01o e os
dados da cone,o Due esto sendo usadosR
Ka parte superior temos a barra de menu do sistema 4ArDuivo" 9isuali#ar" Ajuda" etc...5R
%oo abai,o temos um painel com alumas tabs 48esempenGo" Menu" Atividades de flu,o de
trabalGo e 2lu,o de trabalGo5.
Ka aba !esempenho5 os indicadores de desempenGo sero mostradas caso tenGam sido
confiuradosR
A aba 6enu apresenta todas as op$.es dispon-veis para a #egra escolGida no loinR
Abai,o temos dois bot.es 4A$iso e &olicita01o5 ( mostram o n1mero atual de avisos e solicita$.es
para o usurio ( e uma barra Due informa o Duantia de mem0ria usadaR
Ka 1ltima parte est a barra de status da janela" onde informa$.es de erro e instru$.es so
e,ibidas.
..2.1. Aen'
Selecionando a tab 6enu" os itens de menu dispon-veis sero mostrados em um painel do lado direito.
9oc6 pode navear pelo menu e,pandindo as cateorias 4e,.F !a cota01o 7 /atura5 e ento clicando na
janela ou processo desejado. Basta clicar uma ve# no item para abri(lo.
8o lado esDuerdo" e,iste uma barra de atalGos Due pode ser customi#ada. 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 op$o Adicionar 7 barra.
Abai,o do menu" do lado direito" e,iste o campo *rocurar onde poss-vel pesDuisar itens do menu.
8iite o te,to Due deseja procurar e pressione enter. )ontinue pressionando enter para repetir a pesDuisa.
3.2.1.1. !cones do menu
Bcone C'no )escrio
Aanela
Abre uma janela
+rocesso *,ecuta um processo
2lu,o
trabalGo
Abre um flu,o de trabalGo 4!or/flo!5
&elat0rio
*,ecuta um relat0rio
.... (anelas
Hodas as janelas do Adempiere tem a mesma apar6ncia. A barra de ferramentas e menus apresentam
fun$.es semelGantes em todas as telas.
....1. Bcones da barra de ferramentas
Bcone C'no )escrio
8esfa#er
altera$.es
8esfa# altera$.es feitas ap0s a 1ltima rava$o.
Ajuda Abre a tela de ajuda.
Kovo
reistro
)ria um novo reistro. )ampos obriat0rios tero o fundo vermelGo e se
tornam a#ul Duando preencGidos.
*,clui
reistro
*,clui reistro atual.
*,clui
sele$o
Abre uma cai,a de dilo para selecionar os reistros e e,clu-(los.
Mravar
altera$.es
Mrava altera$.es feitas no reistro atual. Movendo de um reistro para outro"
movendo entre as tabs ou fecGando a janela" a rava$o feita
automaticamente.
Atuali#a
pesDuisa
&efa# uma pesDuisa de acordo com o critrio de busca.

+rocurar
reistro
Abre uma cai,a de diloo para definir critrio de pesDuisa da tab atual.
+odem ser feitas pesDuisas simples usando campos comuns ou pesDuisas
avan$adas usando compandos comple,os.
Ane,o Ane,a arDuivos ao reistro.
Bate(papo
4)Gat 5
+ermite ao usurio uardar notas com data e Gorrio para cada reistro.
Habela Alterna o modo de e,ibi$o dos dados para tabela 4m1ltiplos reistros5
2ormulrio
Alterna o modo de e,ibi$o dos dados para formulrio 41nico reistro
detalGado5
;ist0rico *,ibe o Gist0rico do reistro.
@n-cio Mostra a janela principal do sistema.
&eistro
mestre'pai
Mostra o reistro mestre ou pai.
&eistro
detalGe
Mostra o reistro detalGe.
+rimeiro
reistro
Move para o primeiro reistro.
&eistro
anterior
Move para o reistro anterior.
+r0,imo
reistro
Move para o pr0,imo reistro.
Vltimo Move para o 1ltimo reistro.
reistro
&elat0rio )onfiura um relat0rio baseado no reistro atual.
8ocumentos
e relat0rios
arDuivados
9isuali#a relat0rios ou documentos arDuivados para o reistro.
9isuali#a
impresso
9isuali#a um formato pr(definido.
@mprimir @mprime um relat0rio pr(definido.
Loom
atravs
Loom para reistros relacionados em outras tabelas. +or e,emplo" #oom para
paamentos de faturamento.
2lu,o de
trabalGo
4!or/flo!5
Abre o flu,o de trabalGo relacionado ao reistro.
9erificar
solicita$o
9erifica ou cria solicita$o para servi$os.
@nforma$o
do produto
Abre tela de produtos com informa$.es sobre pre$o e disponibilidade.
2ecGar janela
2ecGa a janela atual. Os estado da janela salvo e caso a janela seja aberta
novamente na mesma sesso" o reistro e tab atual sero mostrados.
....2. C'nes eseciais nas janelas
3.3.2.1. "refer#ncia de $alor ($alor padr%o
+ara definir um valor padro para o campo de uma janela" diite o valor desejado no campo e depois
cliDue com o boto direito e escolGa *eref8ncia de $alor. Sempre Due criar um novo reistro" o valor
padro ser utili#ado.
3.3.2.2. &o$o registro
*m aluns casos" por e,emplo" na tela de 4rdem de $enda5 para criar um novo *arceiro de
9eg:cios4cliente5 de forma rpida e resumida" cliDue com o boto direito no campo *arceiro de 9eg:cios
e selecione a op$o 9o$o registro. Ser mostrada uma tela pedindo informa$.es resumidas. Os dados
completos podem ser editados mais tarde.
3.3.2.3. 'oom
Abre a janela com os detalGes do campo em Duesto. +or e,emplo" na tela de 4rdem de $enda5 se clicar
com o boto direito no campo Armaz;m T <oom" a janela de Armaz;m ser mostrada.
3.3.2.4. Atualizar
+ara atuali#ar dados Due foram alterados em outras janelas 4atravs da op$o <oom" por e,emplo5"
usamos a op$o Atualizar 4boto direito no campo e Atualizar5 .
3.3.2.(. "es)uisa
Aluns campos como *arceiro de 9eg:cios ou *roduto tem um boto de pesDuisa de reistros. )licando
neste boto" ser aberta uma tela para pesDuisa do reistro.
3.3.2.*. Informa+%o sobre registros
Ko canto inferior direito de cada janela" mostrado a posi$o do reistro atual e o n1mero total de
reistros Due e,istem na tabela 4posi$o'total5. O caracter [ ou \ tambm pode ser e,ibido. O caracter [
indica Due uma incluso est ocorrendo" enDuanto o caracter \ indica Due o reistro sofreu uma
altera$o4Duando a rava$o da altera$o ocorre" este indicador desaparece5.
)licando duas ve#es neste ponto4canto inferior direito5" e,ibida uma tela com o nome" data" Gora e o
usurio Due criou e'ou alterou o reistro.
..9. Cl':o de trabalDo 64or<flo48
Os /luo de trabalho definem uma srie de passos Due devem ser e,ecutados de forma seDuencial.
2unciona como um uia para e,ecutar determinadas fun$.es.
Ko Adempiere" e,iste mais de um tipo de flu,o de trabalGoF
=eralF mostra um uia e instru$.es passo(a(passo para reali#ar uma tarefa. ] iniciado pelo usurio
a partir do menu e identificado pelo seuinte -coneF . Ka parte superior deste tipo de flu,o de
trabalGo" vemos de forma rfica" todos os passos Due devemos e,ecutar. ] poss-vel abrir e
e,ecutar os passos clicando diretamente nos passos mostrados. Ka parte inferior" temos uma
e,plica$o de cada passo a ser reali#ado. :m e,emplo o flu,o de Configura01o de *arceiro de
9eg:cios locali#ado emF
&elacionamento com +arceiros de Ke0cios T &eras de +arceiros de Ke0cios T
)onfiura$o de +arceiros de Ke0cios
*rocessar !ocumentosF @niciado Duando estiver processando alum documento" por e,emplo"
Duando conclu-mos uma 4rdem de >enda" clicamos no boto Completo e selecionamos uma A$o
para e,ecutar 4)ompleto" +reparar" Anular" etc...5. +odemos customi#ar os passos deste tipo de
flu,o de trabalGo. *,emploF +edir aprova$o de Ordem de 9enda ao departamento financeiro
sempre Due o valor do pedido for maior Due &^<00"00.
>alor do !ocumentoF 2lu,o iniciado automaticamente Duando condi$.es definidas pelo usurio
so satisfeitas. *,emploF &eDuisitar anlise de crdito ao setor financeiro para todo
cliente4*arceiro de 9eg:cio5 novo.
..;. Aj'da
] e,ibida pressionado 2< ou selecionando o menu Ajuda T Ajuda.
A tela mostra uma descri$o4ajuda5 da janela em Due o usurio se encontra e detalGes sobre os campos.
Os comentrios de ajuda so definidos no !icion-rio de Aplica01o.
../. #referncia
+ara acessar a janela de prefer6ncia" acesse na barra de menu superiorF 2erramentas T +refer6ncia
Aluns parQmetros de utili#a$o Due podem ser confiuradosF
&empre >isualizar a ?mpress1o@ Duando clicar no boto imprimir relat0rio" ser e,ibida a
visuali#a$o do mesmoR
Aog 6igration &cript@ era um script das altera$.es feita nos dados do sistema. Vtil para aplicar as
modifica$.es de um ambiente de teste no cliente" por e,emplo.
A aba Erros" e,ibe os erros reistrados pelo sistema. *,iste a possibilidade de ravar o lo de
erros em arDuivo para anlise posterior.
Imlementao e definies b2sicas
..E. 1riando nova emresa 6set' inicial8
+ara usar o Adempiere preciso definir pelo menos uma Empresa e uma Organiza01o. :ma Empresa
pode ter mais de uma organiza01o conectado a ela. O sistema vem com a empresa MardenCorld
confiurado com aluns dados para avalia$o e testes. +ara criar uma nova Empresa" e,ecute os passos
abai,oF
2a$a loin com &Bstem ou &uper,ser .senGa &Bstem3 usando a rera &Bstem AdministratorR
9 em Administardor do Sistema T &eras da *mpresa T @nitial )lient Setup +rocess e preencGa
os dadosR
8efina o nome da Empresa4campo )lient Kame5 e 4rganiza01o .*,.client e org3 ( peDuenas
empresas podem usar o mesmo nome para os dois campos. *mpresas randes podem ter mais
de uma 4rganiza01o conectada P Empresa. As demais orani#a$.es so definidas em outra
tela.
8efina o nome do administrador Due usado para confiurar os dados da Empresa 4*,.F
clientAdim5 e do usurio com acesso a todos os dados e processos 4*,.F client,ser5 . A senGa
de ambos ser iual ao nome escolGidoR
Ko campo *aCs" escolGa "rasilR
Ko campo Chart of Accounts" selecione o arDuivo Accouting_"#.cs$ para importar o plano de
contasR
8epois de preencGer todos os dados" cliDue no boto ?niciar. O processo demora aluns minutos.
..F. ,e+'indo o fl':o de trabalDo ara confi+'rar o cliente
8epois de criar a nova empresa" fa$a loin usando os dados do administrador da empresa e abra o flu,o
de trabalGo abai,o para completar todos os passos de cria$o de uma nova empresaF
MenuF Administardor do Sistema T &eras da *mpresa T &eviso da )onfiura$o @nicial da
*mpresa
..F.1. 5mresa
Aluns detalGes sobre a empresa podem ser editados'confiurados.
Obs.F ] importante Due o campo idioma tenGa o valor *ortuguese."razil3 para Due as confiura$.es do
Adempiere%B&'OSeB sejam e,ibidas e a customi#a$o funcione corretamente.
..F.2. Or+ani7ao
MenuF Administrador do Sistema T &eras da Orani#a$o T Orani#a$o
Ko setup inicial da Empresa" criada uma orani#a$o. +ara definir outras orani#a$.es para a empresa
ou confiurar parQmetros da orani#a$o" use esta tela.
Kote Due na aba ?nforma0Des da 4rganiza01o" vemos as confiura$.es espec-ficas para o Brasil no
separador Adempiere A"#.
..F... #ael 6C'no8
MenuF Administrador do Sistema T &eras Merais T Seuran$a T +apel42un$o5
2un$o do usurio no sistema. O papel ou fun01o 4tambm cGamado de regra no loin5 como um rupo
de usurios Due possui determinadas permiss.es P janelas e relat0rios. +or e,emplo" voc6 pode fa#er uma
confiura$o de forma Due usurios associados ao papel 9endedor no tenGam acesso ao cai,a Due
permitido somente aos usurios do papel 2inanceiro.
)ada papel associado a uma organiza01o ou P empresa 4todas as orani#a$.es da empresa5.
)ada usurio do sistema deve ter pelo menos um papel definido para ele.
O campo 9C$el do ,su-rio" determina se os usurios do papel tero acesso a dados a n-vel do Sistema" da
Orani#a$o" da *mpresa" ou a n-vel da *mpresa e da Orani#a$o.
Kas abas de controle de acesso 4*,.F Acesso a Eanelas5" feita a defini$o do Due o papel pode acessar ou
no. )ada op$o inclui o campoF
Ati$o Due determina se o item estar dispon-vel ao papelR
Escrita e Aeitura Due Duando ativada permite Due o usurio fa$a altera$o de dadosR
%embre(se de definir a4s5 orani#a$o Due usurio ter acesso na aba Acesso 4rg.
..F.9. =s'2rio
MenuF Administrador do Sistema T &eras Merais T Seuran$a T :surio
O usu-rio est associado a um *arceiro de 9eg:cios. Ao criar um usurio" defina pelo menos os seuintes
camposF
9omeR
&enhaR
*arceiro de 9eg:ciosF conecta um usurio a um parceiro de ne0cios 4pode ser um funcionrio"
cliente ou fornecedor5R
/un0Des de ,su-rios@ papel'fun$o. Atribua pelo menos um papel ao usurio.
..F.;. #erGodo e Ano 1ivil
MenuF Anlise de 8esempenGo T &eras )ontbeis T +er-odo e Ano )ivil
Hodo ano necessrio criar um novo per-odo contbil. +ara criar um novo per-odo" cliDue na aba Ano"
adicione um novo reistro eF
+reencGa o campo AnoR
)liDue no boto Criar perCodos.
)liDue na aba *erCodo.Ano /iscal3F
)liDue em Abrir2/echar tudoR
Selecione *erCodo aberto.
9. #arceiro de ne+cios
MenuF &elacionamento com +arceiro de Ke0cios T &eras de +arceiro de Ke0cios T +arceiro de
Ke0cios
:m parceiro de ne0cios uma entidade" pessoa ou orani#a$o Due est relacionada com a empresa.
*,istem tr6s tipos bsicos de parceiro de ne0ciosF cliente" fornecedor e funcionrio. Hodos esses tipos
bsicos esto arupados na mesma janela4+arceiro de Ke0cios5 e possuem abas com os campos
espec-ficos para cada tipo.
O parceiro de ne0cio podeF
pertencer a mais de um tipo bsico simultaneamenteR
ter mais de uma locali#a$o ou contatoR
ter transa$.es ou rela$.es entre eles 4*,.F uma ordem de venda pode ser enviada a um seundo
parceiro" faturada a um terceiro e paa por outro5.
9.1. Cl':o de trabalDo
MenuF &elacionamento com +arceiro de Ke0cios T &eras de +arceiro de Ke0cios T )onfiura$o
de +arceiro de Ke0cios
9.1.1. ?r'o de arceiro de ne+cios
+ermite definir parQmetros comuns a rupos de parceiro de ne0cios4*,.F cliente" fornecedor"
funcionrio5.
)ada parceiro de ne0cio ser associado a um rupo.
9.1.2. ,a'dao
Sauda$o ou tratamento para o parceiro de ne0cio 4*,.F Sr.5
9.1... 1ondio de a+amento
+ermite confiurar diversas formas de paamento4*,.F P vista" antecipado" parcelado 30'60 dias5 e
associar ao +arceiro de Ke0cio. A ajuda da janela possui informa$.es completas sobre os campos.
Seuem aluns campos abai,oF
!ias lCFuidos@ dias 1teis para o vencimentoR
!ata /ia de >encimentoF as faturas Due usam esta condi$o vencem em um dia espec-fico do m6s
!ia fio do m8sF dia do m6s em Due as faturas vencemR
Corte fio do m8sF n1mero m,imo de dias at a data de vencimentoR
!escolamento fio do m8sF caso o dia do vencimento no seja no m6s corrente. @ndicar o
n1mero de meses Due deve(se somar ao m6s corrente.
*r:imo dia GtilF o paamento vence no pr0,imo dia 1til4caso o vencimento no seja um dia 1til5R
Ap:s entregaF Duando selecionado" indica Due o paamento devido ap0s a entrea em ve# do
faturamentoR
!ias de descontoF indica o n1mero de dias dentro do Dual o paamento deve ser recebido para ter
direito ao descontoR
!esconto HF indica a porcentaem de desconto Due ser aplicadaR
!ias de car8nciaF define o n1mero de dias ap0s a data de vencimento para enviar a primeira carta
de cobran$aR
Ka aba *rograma01o" informe os parQmetros das parcelas da condi$o de paamentoF
*orcentagemF porcentaem do valor total Due corresponde a parcelaR
!ias lCFuidosF define o n1mero de dias ap0s a data da fatura para Due o paamento seja efetuadoR
8epois de confiurar todos os itens" cliDue em >alidar. Se o campo >-lido aparecer marcado" indica Due a
forma de paamento est confiurada corretamente.
9.1.9. #ro+ramao de fat'ramento
8efine freDu6ncias e datas para erar faturas. ] usado Duando um cliente e,ie uma fatura 1nica para
m1ltiplas entreas.
9.1.;. 1obrana
)onfiura$o de cartas de cobran$a. +ermite confiurar itens comoF
enviar carta ap0s um determinado n1mero de dias do vencimento da faturaR
intervalo entre cartas de cobran$aR
te,to" notas e formato da cartaR
cancelar crdito do parceiro de ne0cios.
9.1./. Imortao de arceiro de ne+cios
+ermite importa$o de dados de outros sistemas no Adempiere.
9.2. Aan'teno arceiro de ne+cios
%embrando Due um cliente" fornecedor ou funcionrio antes de mais nada" um *arceiro de 9eg:cio.
+ara incluir um cliente" fornecedor ou funcionrio" adicione um reistro e defina os campos principaisF
9omeR
=rupo de *arceirosR
(ipo de *arceiro 4separador Adempiere %B&5R
Kote Due aDui definimos confiura$.es espec-ficas para o Brasil como o C*/ ou C9*E e
tambm informa$.es referente aos impostosR
8epois selecione uma das abas espec-ficas4*,.F )liente5 e defina os campos relativos ao parceiro de
ne0cios.
9.2.1. 1liente
Selecione a aba Cliente e marDue a op$o Cliente. @sto torna o parceiro de ne0cios um cliente e mais
campos se tornam dispon-veis para edi$o. *,emploF
*rograma01o de faturamentoR
#egra de entregaF pedido completoR
>ia de entrega@ retira" entrea" transportadoraR
Aista de pre0oR
EsFuema de descontosR
Condi01o de pagamentoR
#epresentante de $endasF vendedorR
Cobran0aF carta de cobran$aR
Aimite de cr;ditoR
4bser$a01o 9ota /iscal 4separador Adempiere%B&5
9.2.2. Cornecedor
Selecione a aba /ornecedor e marDue a op$o /ornecedor. @sto torna o parceiro de ne0cios um
fornecedor e mais campos se tornam dispon-veis para edi$o.
9.2... C'ncion2rio
Selecione a aba /uncion-rio e marDue a op$o /uncion-rio.
MarDue o campo #epresentante de >endas caso o funcionrio seja um vendedor.
9.2.9. 1onta "anc2ria
*sta aba permite definir informa$.es bancrias do parceiro de ne0cios. *stas informa$.es so utili#adas
para processar paamentos e remessas de valores. O parceiro pode ter vrias contas definidas.
9.2.;. !ocali7ao
So as informa$.es para contato ou entrea 4telefone e endere$o5. O parceiro pode ter m1ltiplos reistros
de locali#a$o atribu-dos a ele O por e,emploF endere$o de entrea e endere$o de cobran$a.
;. Imostos 6"rasil8
MenuF %ocali#a$o Brasil T 2iscal T @mpostos
Os impostos so associados a produtos e despesas.
AembreteF o campo ?dioma na janela Empresa deve estar confiurado para *ortuguese."razil3.
;.1. ?r'o de trib'tao
MenuF %ocali#a$o Brasil T 2iscal T @mpostos T Mrupo de Hributa$o 4+roduto ' +arceiro de
Ke0cios5
O Mrupo de Hributa$o consiste em um cadastro para o arupamento de produtos" clientes e fornecedores"
conforme suas caracter-sticas de tributa$o.
;.2. 1ate+oria de Imosto
MenuF Anlise de 8esempenGo T &eras )ontbeis T )ateoria de @mposto
;... ?r'o de Imostos 6Hota Ciscal8
MenuF %ocali#a$o Brasil T 2iscal T Kota 2iscal T Mrupo de @mpostos 4Kota 2iscal5
;.9. Imostos
MenuF %ocali#a$o Brasil T 2iscal T @mpostos T @mposto 4Brasil5
Kesta janela" o usurio pode definir os impostos de produto" servi$o 4Duando selecionado servi$o" o
usurio pode definir se o mesmo possui reten$o e Dual o seu limiar e freDu6ncia5 e substitui$o tributria
4Duando selecionado substitui$o tributria" o usurio deve definir o imposto a ser substitu-do5.
Ka aba /:rmula" o usurio pode definir as f0rmulas para determinar a base de clculo para cada tipo de
transa$o" respeitando sempre as seuintes rerasF
_AMH_ ( 9alor da %inGa
_KOM*8O@M+OSHO_ ( Al-Duota do @mposto
*,emploF '(AMT()'*'(PISPROD(*(CO+I,SPROD(-%'-'(PISPROD(*(CO+I,SPROD(--
(ICMSPROD(---%'-(ICMSPROD(-
O usurio deve definir duas f0rmulas de clculo nos seuintes camposF
/:rmula@ para o clculo do imposto" onde a lista de pre$o no possui imposto incluso" ou seja" o
valor l-Duido.
/:rmula >alor ACFuido@ para o clculo do valor l-Duido" onde a lista de pre$o possui imposto
incluso" ou seja" o valor bruto.
;.;. AlG&'ota de Imosto
MenuF Anlise de 8esempenGo T &eras )ontbeis T Al-Duota de @mposto
Ap0s o cadastro dos impostos brasileiros" preciso definir suas as al-Duotas no A8empiere.
Ko e,emplo abai,o" criamos uma al-Duota com 9ome +&O8:HO e Categoria +&O8:HO de 9C$el de
#esumo. 4OBSF O clculo de imposto s0 feito na Ordem ou 2atura" Duando selecionado um imposto de
n-vel resumo5.
] poss-vel criar e atribuir outras al-Duotas de impostos para um ?mposto *ai. Keste outro e,emplo"
criamos a al-Duota +@S+&O8" informando Due o ?mposto *ai o +&O8:HO e Due o ?mposto A"# o
+@S+&O8 e o =rupo de impostos .9ota /iscal3 o +@S.
Ka janela de cadastro de AlCFuota de ?mpostos padro do A8empiere" onde definimos como ser feita a
contabili#a$o dos impostos" por isso a necessidade de outro cadastro.
;./. 1onfi+'rao de Imostos
MenuF %ocali#a$o Brasil T 2iscal T @mpostos T )onfiura$o de @mpostos
A rande dificuldade do sistema tributrio brasileiro o alto n1mero de e,ce$.es para seus impostos. +ara
facilitar este processo" foi criada uma matri# de decis.es Due permite criar estas e,ce$.es em apenas uma
tela.
8epois de informar Dual o (ipo de Ece01o 4+roduto" Mrupo de Hributa$o ou nenGuma5" novas abas se
tornam dispon-veis dependendo da sele$o.
+or e,emplo" selecionando Mrupo de Hributa$o" a aba Mrupo +roduto mostrada. Kesta aba
confiuramos o +@S com al-Duota de E` conforme fiura abai,oF
Hambm poss-vel adicionar e,ce$o na aba =rupo *arceiro de 9eg:cios.
;.E. 1CO#
MenuF %ocali#a$o Brasil T 2iscal T )2O+ T )2O+
;.F. H1A
MenuF %ocali#a$o Brasil T 2iscal T K)M
;.I. Aensa+em le+al
MenuF %ocali#a$o Brasil T 2iscal T Kota 2iscal T Mensaem leal
;.10. Hota Ciscal 5letrJnica 6Hfe8 % confi+'rao
;.10.1. 5mresa
MenuF Administrador do Sistema T &eras Merais T &eras da *mpresa T *mpresa
)ertifiDue(se Due o campo ?dioma est setado para +ortuuese4Bra#il5.
;.10.2. 1ertificados
MenuF %ocali#a$o Brasil T )ertificado 8iital
] preciso cadastrar pelos menos dois certificadosF um para a empresa e outro para o !ebservice da Sefa#.
)amposF
9omeF identifica$o para o certificado
(ipo de CertificadoF +3)Sa<> 4certificado .pf, da empresa5 ou Aava 3eX Store 4!ebservice da
Sefa#5R
*seudInimoF alias do certificado
&enhaF senGa do certificado
?mportanteF para cada reistro de certificado" necessrio ane,ar o arDuivo correspondente ao certificado
diitalF arDuivo .pf, para a empresa ou arDuivo .j/s no caso do !ebservice da Sefa#.
+ara obter os arDuivos .pf, e .j/s" procure por informa$.es detalGadas na internet ou veja o arDuivo Kfe
do projeto Adempiere%B&.
;.10... Or+ani7ao
MenuF Administrador do Sistema T &eras da Orani#a$o T &eras da Orani#a$o T Orani#a$o
+reencGa os seuintes dados na aba @nforma$.es da Orani#a$oF
Endere0o da 4rganiza01oR
Certificado da 4rganiza01oF indicar o certificado cadastrado com o arDuivo .pf, da empresaR
Certificado da (ransmiss1oF indicar o certificado cadastrado com o arDuivo .j/s do !ebservice da
Sefa#R
Ambiente da 9/eF ;omoloa$o 4para testes5 ou +rodu$o 4ambiente real5R
;.10.9. ,e&'ncia de )oc'mento
MenuF Anlise de 8esempenGo T &eras )ontbeis T SeDu6ncia de 8ocumento
)rie uma nova seDu6ncia para a nota fiscalF
9ome@ *,emploF K2eR
AutoJnumera01oF dei,e marcado para incrementar o n1mero da K2R
?ncrementoF <R
*r:imo 9GmeroF n1mero da 1ltima K2 emitida [ <R
;.10.;. @io de )oc'mento
MenuF Anlise de 8esempenGo T &eras )ontbeis T Hipo de 8ocumento
)rie um novo (ipo de !ocumento e definaF
9ome@ *,emploF K2e;
(eto de ?mpress1oF iual ao nomeR
Categoria de #az1o =eralF KoneR
(ipo de "ase de !ocumentoF Kota 2iscal BrasilR
&eFuencia de !ocumentoF procure pela seDu6ncia Due definiu no passo anteriorR
!ocumento ; controlado numericamenteF dei,e marcadoR
6odelo da 9/F ??R
&;rie da 9/F informe a srie do documento da sua nota fiscalR
Ambiente da 9/eF ;omoloa$o ou +rodu$o
/ormato da !A9/EF +aisaem ou &etratoR
/. #rod'to
A defini$o de produto para o Adempiere alo Due se vende e'ou se compra" Due tem um pre$o e Due
pode ser arma#enado. :m produto" deve estar uardado em um arma#m Due pode ter vrias prateleiras
ou outras formas de identifica$o. O produto tambm possui medidas 43" %" m5 e pode e,istir a
necessidade de se converter de uma medida para outra.
Os produtos" tambm podem ser arupados atravs da cateorias de produtos. A vantaem em definir
cateoria de produtos associar os impostos ou as defini$.es de contabilidade P essas cateorias em ve#
de fa#er esta defini$o produto por produto.
Basicamente e,istem dois tipos de produtosF
itens Due so bens tan-veis e Due por isso necessitam de manuten$o e servi$osR
itens Due so recursos ilimitados" e Due no podem ser arma#enados.
Os bprodutos indiretosc so os recursos e despesas Due sero definidos na op$o correspondente e no em
conjunto com os produtos.
/.1. Cl':o de trabalDo do rod'to
MenuF Administra$o de Materiais T &eras de Administra$o de Materiais T )onfiura$o do +roduto
/.1.1. Arma7$m e !ocali7adores
:ma empresa pode ter vrios arma#ns. Mas" cada arma#m no representa necessariamente um espa$o
f-sico delimitado. +or e,emplo" podemos ter um espa$o comum para entrada e sa-da de produtos e defini(
los no Adempiere como se fossem luares distintos.
Ka aba Aocalizador" definimos o corredor e prateleira. )ada arma#m pode ter vrios locali#adores.
/.1.2. =nidade de Aedida
@nforme as unidades de medida Due sero usadas nos produtos.
Ka aba Con$ers1o" definimos converso entre unidades de medida cadastradas.
/.1... 1ate+oria de #rod'to
Hem o objetivo de arupar os produtos para facilitar sua manuten$o.
/.1.9. 1ate+oria de Imostos
Hambm fa# parte da defini$o dos impostos. Hem o objetivo de arupar os impostos para facilitar a
manuten$o.
/.2. Aan'teno do #rod'to
MenuF Administra$o de Materiais T &eras de Administra$o de Materiais T +roduto
Seue descri$o das seuintes abasF
/.2.1. #rod'to
)ampos principais do produtoF
9omeR
Categoria do *rodutoR
,!6F unidade de medidaR
(ipo de *rodutoF item" recurso" despesaR
AocalizadorR
Aista de 6ateriaisF este campo no pode ser alterado. Buando selecionado" indica Due este
produto consiste de uma lista de materiais e os itens abai,o so e,ibidosR
>erificar A!6F boto Due e,ecuta o processo de verificar os componentes da lista de
materiaisR
>erificadoF indica se a lista de materiais foi verificada e consistenteR
Separador Ademiere%B&
4rigem do *rodutoF Kacional" @mportadoR
9C6" C/4*" =rupo de tributa01o
/.2.2. "OA o' !)A
:samos a aba BOM 4build of materials ou lista de materiais ( %8M5 para confiurar produtos Due so
comprados de uma forma" sofrem alum tipo de transforma$o e so vendidos ou" produtos Due so
fabricados a partir de outros produtos.
*,emplo de uso para %8M para o produto Suco de laranjaF
+rimeiro crie todos os componentes e o produto final na aba *rodutoF
Suco de laranjaR
duaR
%aranjaR
*mbalaemR
Selecione o produto final4Suco de laranja5 e depois a aba "46F
)rie um novo reistro e no campo *roduto" escolGa o produto final 4Suco de laranja5R
+reencGa os campos necessrios e rave os dadosR
Ko separador Components
)rie um novo reistro e informe um componente4ua" laranja" embalaem5 no campo
*roduto;
+reencGa os dados necessrios 4campo KuantitB por e,emplo5 e rave os dadosR
repita o processo para todos os componentes do produto finalR
8epois de preencGer todos os dados" Duando voltar na aba *roduto" perceba Due o cGec/bo, Aista
de 6ateriais est selecionado e Due o boto >erificar A!6 e,ibidoR
/.2... ,'bstit'to
8efini$o de produtos Due podem ser usados como alternativas para o produto selecionado.
/.2.9. 1omras
8efine os pre$os e reras de compra 4Duantidades por pacote" Duantidade m-nima5 para o produto.
/.2.;. #arceiro de He+cios
+ode ser cadastrado o4s5 fornecedor4es5 do produto.
/.2./. #reo
8efine os valores do produto para as diversas %istas de pre$o 4veja pr0,imo cap-tulo5. *m cada lista de
pre$o" tr6s valores devem ser informadosF
+re$o de listaR
+re$o padroR
+re$o limite 4m-nimo5R
/.2.E. @ransaes
*,ibe as transa$.es feitas com este produto.
E. !istas de reo
MenuF Administra$o de Materiais T &eras de Administra$o de Materiais T %ista de +re$o
As %istas de pre$o podem ser usadas para diferenciar os pre$os dos produtos. +or e,emplo" sua empresa
pode criar vrias listas de pre$o por tipo de cliente ou por per-odos do ano. Os esDuemas de desconto
permitem estipular descontos sobre os valores definidos nas listas de pre$os.
E.1. Cl':o de trabalDo da lista de reo
MenuF Administra$o de Materiais T &eras de Administra$o de Materiais T )onfiura$o de %ista de
+re$o
E.1.1. 5s&'ema de !ista de #reo
8efine as reras para clculo da %ista de +re$o.
@nclua um novo esDuema definindo o nome na aba EsFuema de Aista de *re0o" e as reras na aba Ainha
de EsFuema.
E.1.2. !ista de reos
*m cada verso da lista de pre$o" um produto ter apenas um reisto com tr6s pre$os associadosF
pre$o de listaF usado para clientes Due recebem descontosR
pre$o padroF pre$o padro do produtoR
pre$o limiteF caso tente vender um produto abai,o desse pre$o" e,ibido um aviso mas" esta
situa$o no impede a venda com o pre$o escolGido.
+rincipais campos de uma %ista de +re$oF
9ome
6oeda
*recis1o do pre0oF arrendondamento de casas decimais
Aista de *re0o de >endasF indica se uma lista usada para Ordem de 9enda
*re0o inclui impostoF caso a lista de pre$os j inclua impostos 4pre$o bruto5
?mpor Aimite de *re0oF no permite Due o pre$o seja menor Due o pre$o limite em ordem de
venda.
Ka aba >ers1o" definimos as diferentes vers.es da lista de pre$o. )ada lista de pre$o ter pelo menos uma
verso. )ampos principaisF
9omeF nome da verso da lista
EsFuema de Aista de pre0o
Aista de pre0o baseF lista de pre$os usada como base4fonte5 na cria$o da atual verso 4pode ser
dei,ado em branco5R
>-lido desdeF data a partir da Dual a verso ser vlidaR
Boto Criar Aista de *re0osF cria a nova verso da lista de pre$osR
Ka aba *roduto" os respectivos produtos e pre$os so listados e'ou definidos. Os pre$os dos produtos
tambm podem ser especificados diretamente na janela *roduto" aba *re0o.
E.1... 5s&'ema de desconto
MenuF Administra$o de Materiais T &eras de Administra$o de Materiais T *sDuema de 8escontos
)onfiura$o de descontos sobre as listas de pre$os. Ko aba EsFuema de !esconto" defina os camposF
9omeR
(ipo de descontoF define se o desconto ser por uma percentaem fi,a ou levar em conta a
Duantidade de produtos comprados.
+orcentaem fi,aF
!esconto #aso do *.9eg:cios@ usar o desconto definido no *arceiro de 9eg:ciosR
!esconto /io HF percentual de desconto a ser aplicadoR
Buebras
9C$el de Acumula01o@ Ainha
Boto #enumerar@ ee
A aba ?ncremento de !esconto e,ibida somente Duando o (ipo de !esconto iual P Kuebra@
&eFuenciaF ordem'numera$o do reistroR
Categoria do produto@ aplica este esDuema P cateoria de produto selecionada
*rodutoF aplica este esDuema ao produto selecionado O Gabilitado Duando no seleciona Categoria
do *roduto e vice(versaR
*onto de infle1oF a partir desta Duantidade ser aplicado o desconto
!esconto #aso do *.9eg:cios@ usar o desconto definido no *arceiro de 9eg:ciosR
!esconto ?ncremental HF porcentaem de desconto a ser aplicado.
F. 1omra
MenuF 8a &eDuisi$o P 2atura
O processo de compra de materiais formado pelos seuintes documentos e na ordem apresentadaF
#eFuisi01o ou
&olicita01o de Cota01o .&dC3
*edido de Compra .*C3
#ecebimento de 6aterial
/atura
KenGum destes documentos obriat0rio" por e,emplo" podemos definir uma /atura sem um *edido de
Compra mas podemos erar uma /atura ou #ecebimento de 6aterial com os dados j informados no
*edido de Compra.
F.1. Re&'isio
MenuF 8a &eDuisi$o P 2atura T &eDuisi$o
Ka #eFuisi01o" o usurio reistra o produto e Duantidade Due precisa ser comprado. O +) pode ser erado
com os dados informados na #eFuisi01o sem a necessidade de diitar tudo novamente.
Ka aba #eFuisi01o" o usurio deve diitarF
(ipo de !ocumentoF +urcGase &eDuisition 4&eDuisi$o de )ompra5R
,su-rio2ContatoF pode ser Duem est pedindo o material ou o contato do +arceiro de Ke0ciosR
*rioridadeF prioridade desta reDuisi$oR
!ata eigidaF necessrio receber o material at esta data
Armaz;mF %ocal onde o produto ser arma#enadoR
Aista de *re0o
O material reDuisitado para compra" deve ser diitado na aba Ainha de #eFuisi01oF
Ainha 9GmeroF ordem dos itens ou e,ibi$o das linGasR
*arceiro de 9eg:ciosF fornecedorR
*rodutoR
KuantidadeF Duantidade do material para compraR
*re0o unit-rioF pre$o unitrio para compraR
Ainha do *edido de CompraF e,ibido Duando este item estiver associado a um +).
A aba *edidos de Compra5 mostra os +)s associados a esta reDuisi$oR
Buando terminar de diitar a #eFuisi01o" volte na primeira aba e cliDue no boto Completo. Ser e,ibida
uma tela para selecionar a a$o Due pretende e,ecutar com a #eFuisi01o. *scolGa Completo. Observe Due
o campo Estado do !ocumento muda de Esbo0ado para Completado e Due aora e,iste o boto /echar.
F.2. ,d1 K ,olicitao de 1otao
MenuF 8a &eDuisi$o P 2atura T Sd)
2unciona como a #eFuis1o porm de uma forma mais completa. A &dC fornece mecanismos para
comparar diferentes cota$.es e condi$.es de fornecimento para o material Due precisa ser comprado.
8eve(se escolGer entre a #eFuisi01o ou &dC de acordo com suas necessidades. O +) de compra tambm
pode ser erado com os dados diitados na &dC.
F... #edido de 1omra
MenuF 8a &eDuisi$o P 2atura T +edido de )ompra
*specifica o Due vai ser comprado" Duantidades e valores" condi$o de paamento" etc. Ko era
lan$amento contbil. +ode ser erado a partir de uma #eFuisi01o ou &dC.
Ka aba *edido de Compra temos os camposF
(ipo de documento al$o@ +urcGase Order 4ordem de compra5
!ata da *edido;
!ata *rometida;
*arceiro de 9eg:ciosF fornecedorR
Aocaliza01o do *arceiroF endere$o do fornecedorR
,su-rio2contatoF contato do parceiro de ne0ciosR
Contato da /aturaF contato do +arceiro para faturaR
Armaz;mF local onde os produtos so arma#enadosR
*rioridadeF prioridade deste +)R
Aista de *re0oF lista usada nesta compraR
Agente da Companhia@ funcionrio encarreado da compra
Condi01o de pagamento;
Bot.esF
Criar Ainhas do *edidoF permite usar os dados diitados de uma #eFuisi01o para preencGer este
+)R
Copiar AinhasF copia dados 4linGas5 de outros +)R
CompletoF Altera o status do +) para )ompletadoR
Ka aba Ainha de *C" os itens de compra so definidosF
Ainha nGmeroF n1mero ou ordem do item na listaR
*rodutoR
KuantidadeF Duantidade do material para compraR
*re0o unit-rioF pre$o unitrio para compraR
*re0o de AistaF pre$o de tabela 4calcula o campo 8esconto `5
>alor da Ainha@ valor total do item
Buando terminar de diitar todos os dados" cliDue no boto Completo na aba *edido de Compra e
selecione Completo como a$o para e,ecutar.
F.9. Recebimento de material
MenuF 8a &eDuisi$o P 2atura T &ecebimento de Material
@ndica o recebimento de material de um 2ornecedor. +ode ser diitado manualmente ou a partir de um
*edido de Compra. *ste documento atuali#a as informa$.es de estoDue.
Ka Aba #ecebimento de 6aterial" diite os dados principais comoF
!ata da 6o$imenta01oF indica a data de entrada de material no estoDueR
!ata da ContaF data para documentos fiscaisR
*arceiro de 9eg:ciosF fornecedorR
Aocaliza01o do *arceiroF endere$o do fornecedorR
#egra de Custo de /reteR
*rioridade.
Bot.esF
Criar Ainhas a partir deF )ria as linGas a partir de um +edido de )ompraR
Criar Confirma01oF cria documentos para confirma$o de recebimento. *stes documentos devem
ser confirmados em MenuF Administra$o de Materiais T )onfirma$o de *nvio'&ecebimento.
CompletoF +rocessa o recebimento e atuali#a estoDueR
=erar /atura a partir do #eciboF era a /atura a partir deste documento 4#ecebimento de
6aterial5
F.;. Cat'ra6fornecedor8
MenuF 8a &eDuisi$o a 2atura ((Z 2atura 42ornecedor5
8ocumento financeiro Due fecGa a transa$o de compra. )ria o t-tulo no cantas P paar. +ode ser diitado
manualmente ou a partir do +) ou de um #ecebimento de 6aterial.
Os campos da /atura so muito semelGantes aos da Ordem de )ompra.
(ipo de documento al$o@ 2atura A+
!ata /aturada;
!ata da Conta@ para lan$amento contbilR
*arceiro de 9eg:ciosF fornecedorR
Aocaliza01o do *arceiroF endere$o do fornecedorR
Aista de *re0oF lista usada nesta compraR
Condi01o de *agamentoR
Agente da Companhia@ funcionrio encarreado da compra
Condi01o de pagamento;
Bot.esF
Criar Ainhas a partir deF permite usar os dados de um +) ou &ecebimento para preencGer a
faturaR
CompletoF Altera o status da /atura para )ompletadoR
Ka aba Ainha de /atura" os itens da fatura so definidosF
Ainha nGmeroF n1mero ou ordem do item na listaR
*rodutoR
KuantidadeF Duantidade do item a faturarR
*re0o unit-rioF pre$o unitrio para compraR
*re0o de AistaF pre$o de tabela 4calcula o campo 8esconto `5
>alor da Ainha@ valor total do item
I. Lenda
MenuF 8a )ota$o P 2atura
Os documentos do processo do 9enda so os seuintes e na ordem Due seueF
Ordem de 9endaR
&emessaR
2atura4)liente5R
O sistema permite criar um or$amento e depois convert6(lo numa ordem de venda Due" por sua ve#" pode
erar uma fatura ou uma remessa. A cria$o destes documentos no obriat0ria podendo" por e,emplo"
e,istir uma fatura ou remessa sem e,istir uma ordem de venda.
I.1. Ordem de venda
MenuF 8a )ota$o a 2atura T +edidos de 9enda T Ordem de venda
*specifica o parceiro de ne0cios4cliente5" material Due ser vendido" condi$o de paamento" etc.
Ka aba *edido temos os camposF
(ipo de (ransa01o@ :tili#ado para definir o )2O+ e a forma de clculo dos impostosR
(ipo de !ocumento Al$oF +roposta" +edido +adroR
!ata do *edido;
!ata *rometida;
*arceiro de 9eg:ciosF clienteR
,su-rio2contatoF contato do parceiro de ne0cios 4cliente5R
*arceiro da /aturaF a Duem deve ser faturado a vendaR
Aocaliza01o do *arceiroF endere$o do parceiro de ne0cio4cliente5R
#egra de Entrega;
*rioridade@ 1til Duando no e,iste estoDue suficiente para atender todos as vendas;
Armaz;mF onde os produtos esto arma#enadosR
>ia de EntregaF &etirar" HransportadoraR
#egra de Custo de /reteF mtodo para cobrar pelo freteR
#egra de /aturaF modo e freDu6ncia de emisso de faturas para o clienteR
Aista de *re0oF lista usada para determinar o pre$o e descontos aplicadosR
#epresentante de >endasF vendedor 4funcionrio5R
Condi01o de *agamento;
?mprimir !escontos 4cGec/bo,5F indica se os descontos sero impressos no documento.
Bot.esF
2orma de +aamentoF locali#ado em /atura" abai,o do #epresentante de >endas 4*m crdito"
)GeDue" 8inGeiro" etc...5R
Copiar AinhasF copia linGas de outra Ordem de 9endaR
Criar Ainhas a partir deF )ria linGas a partir de outro documento indicado pelo usurioR
CompletoF Altera o Estado do !ocumento.
Ka aba Ainha de *edido" os itens a serem vendidos so definidosF
Ainha 9GmeroF n1mero ou ordem do item na listaR
*roduto;
!espesaF a ordem de venda pode se referir a uma despesa em ve# do produtoR
KuantidadeF Duantidade do produto encomendadoR
,!6F unidade de medidaR
*re0oR
*re0o ,nit-rio;
*re0o de AistaF pre$o oficial do produto na lista de pre$osR
!esconto HF porcentaem de desconto obtida
(aaF imposto aplicvel na linGa de ordem de vendaR
>alor da linhaF Buantidade f +re$o sem despesas adicionais ou frete.
Separador ?mpostoF referente a tributa$o brasileiraR
C/4*R
?mposto "rasileiro;
6ensagem Aegal;
&itua01o (ribut-ria.?C6&3;
A aba ?mposto do *edido" mostra o total de impostos associados P venda.
Buando terminar de diitar todos os dados" cliDue no boto gCompletog na aba *edido e informe
gCompletoL como A$o do documento.
Ainda Due uma ordem de venda esteja fecGada" a mesma pode ser alterada. +ara isso" selecione a ordem
de venda desejada e" na aba *edido" cliDue no boto Completo. Selecione a op$o #eati$ar. 2a$a as
altera$.es necessrias e depois cliDue novamente no boto Completo e selecione gCompletog.
I.2. Remessa
MenuF 8a )ota$o a 2atura T *ntreas T Merar &emessas 4Manual5
)om base na 4rdem de >enda" pode(se erar este documento Due atuali#a as informa$.es de estoDue.
+ara criar uma remessa abra o item =erar #emessas.6anual3 no menu e escolGa um Armaz;m@
A seuir" as 4rdens de >enda dispon-veis para o Armaz;m selecionado sero mostradas. Selecione
as Due desejaR
Selecione a A01o do !ocumento 4)ompleto5R
)onfirme a cria$o das &emessasR
Selecione se deseja imprimir as #emessasR
Os documentos de #emessa podem ser verificados em MenuF 8a )ota$o a 2atura T *ntreas T
*,pedi$o 4)lientes5
I... Cat'ra6cliente8
MenuF 8a )ota$o a 2atura T 2aturas de 9endas T Merar 2aturas ' Kotas 2iscais 4Manual5
8ocumento financeiro Due fecGa a transa$o de venda e cria o t-tulo no contas P receber.
+ara criar uma 2aturaF
Abra o item =erar /aturas 2 9otas /iscais .6anual3;
Selecione uma 4rganiza01o e'ou *arceiro de 9eg:cios e'ou (ipo de !ocumento 4+edido5F
A seuir" as 4rdens de >enda sero e,ibidas de acordo com as op$.es do passo anterior. Selecione
as 4rdens de >enda Due deseja criar a /aturaR
Selecione a A01o do !ocumento 4+reparar ou )ompeto5R
Selecione se deseja ou no imprimir a 2aturaR
As 2aturas podem ser verificadas em MenuF 8a )ota$o a 2atura T 2aturas de 9endas T 2atura
4)liente5
)omplemente as informa$.es necessrias na /atura nas seuintes abasF
/aturaF define os dados erais da faturaR
Ainha de /aturaF itens ou despesas da faturaR
?mposto da /aturaF mostra o total de impostos baseado nas %inGas de 2aturaR
*rograma01o de *agamentosF define os valores e datas das parcelas da fatura.
Buando terminar de diitar todos os dados" cliDue no boto Completo na aba /atura e selecione
Completo como a$o do documento.
I.9. Hota Ciscal 5letrJnica 6Hfe8 % emisso
MenuF %ocali#a$o Brasil T 2iscal T Kota 2iscal 4Sa-da5 ou Kota 2iscal 4*ntrada5
8epois de criar uma /atura de cliente ou fornecedor no Adempiere" acesse a nota fiscal correspondente (
Kota 2iscal 4Sa-da5 ou Kota 2iscal 4*ntrada5 ( na %ocali#a$o Brasil.
9erifiDue as informa$.es da 9ota /iscal e cliDue no boto =enerate 9/e M6A para erar e enviar o
arDuivo da K2e para a Sefa#. )onfira a cGave erada depois do retorno da Sefa# no campo K2e @8.
10. Cinanceiro
10.1. 1ontas "anc2rias
MenuF Administra$o do Sistema T &eras da Orani#a$o T Banco
8efine bancos e contas Due sero associadas P 4rganiza01o ou *arceiro de 9eg:cios.
Ka aba "anco" as institui$.es bancrias so definidas 4*,.F Banco do Brasil" Bradesco" etc...5
9omeR
9Gmero de #astreioF c0dio do Banco.
Ka aba Conta" informe as contas Due possui no banco selecionadoF
9Gmero da contaR
6oedaR
(ipo de Conta "anc-ria.
10.2. 1ontas M #a+ar e Receber
MenuF @tens em Aberto T @tens em Aberto
+ermite visuali#ar faturas em aberto de clientes e fornecedores. Basta informarF
*arceiro de 9eg:ciosF cliente ou fornecedor. +ode no ser preencGido para listar todas as faturasR
(ransa01o de >endasF dei,e marcado se Duiser visuali#ar somente faturas em aberto de clientes.
10... 1ai:a
Os lan$amentos do cai,a so feitos nas janelasF
!i-rio de CaiaF eralmente usado para peDuenos paamentos no relacionado P t-tulos no contasR
*agamentoF reistra o recebimento ou paamento de t-tulos 4contas P paar ou receber5R
10...1. !ivro%1ai:a61asDboo<8
MenuF Administra$o do Sistema T &eras da Orani#a$o T %ivro()ai,a 4)asGboo/5
Antes de fa#er lan$amentos no !i-rio de Caia" necessrio cadastrar pelo menos um Ai$roJCaia nesta
janela. )ada cai,a constitu-do de vrias folGas ( !i-rio de Caia4)asG Aournal5.
Ka aba Ai$roJCaia" informeF
9omeR
6oedaR
10...2. )i2rio de 1ai:a
MenuF @tens em Aberto T 8irio de )ai,a 4)asG Aournal5
:sado para diitar as folGas do cai,a. Ka aba principal4!i-rio de Caia5 informe os seuintes dadosF
9omeR
!ata de EtratoF data do cai,aR
!ata da ContaF data contbilR
&aldo ?nicialF saldo antes de iniciar o cai,aR
@nforme os lan$amentos do cai,a na aba Ainha de CaiaF
Ainha nGmeroF n1mero do lan$amento do cai,aR
!escri01oF Gist0rico do lan$amentoR
(ipo de 9umer-rioF tipo de lan$amentoR
>alor.
8epois de fa#er todos lan$amentos" volte na aba principal e verifiDue o montante do movimento no
campo !iferen0a de !eclara01o e o &aldo /inal. Se estiver tudo O/" fecGe o cai,a clicando no boto
Completo.
10.9. #a+amento
MenuF @tens em Aberto T +aamento
+ermite processar paamento ou recebimento de t-tulos4fatura5. Ka aba *agamento informeF
(ipo de !ocumento@ &ecibo4recebimento5 ou +aamentoR
Conta banc-riaR
!ata da (ransa01oR
!ata da ContaF data contbilR
*arceiro de 9eg:ciosF cliente ou fornecedorR
*edido ou /aturaF informe aDui se apenas uma fatura ou um pedido" caso contrrio" informe todas
as faturas recebidas ou paas na aba AlocarR
>alor do pagamentoR
6oedaR
(ipo de *agamentoF )GeDue" 8bito ou 8ep0sito 8ireto" )arto de )rdito" etc...R
)liDue no boto Completo para finali#ar o recebimento ou paamentoR
11. )icion2rio de Alicao 6A)8
O !icion-rio de Aplica01o ou A8" um conjunto de dados Due representa Duase todos os elementos do
sistema como tabelas e suas colunas. 8esta maneira fica mais fcil fa#er manuten$o ou customi#a$o do
Adempiere sem precisar alterar o c0dio fonte.
Sempre Due precisar fa#er manuten$o no A8" utili#e o a &era &Bstem Administrator 4usurio &Bstem ou
&uper,ser5.
Kos itens abai,o" onde estiver escrito campo" entenda coluna de uma tabela.
*m aluns dos itens abai,o" e,iste a aba (radu01o. *sta aba permite tradu#ir itens como o nome" te,to de
impresso ou comentrio'ajuda do elemento selecionado. 8iite o te,to tradu#ido nos campos
correspondentes" marDue a op$o (raduzida e rave a altera$o. +ara Gabilitar as abas de tradu$o"
selecione o item 6ostrar abas de (radu01o em 2erramentas T +refer6ncia.
11.1. 5lemento do sistema
MenuF 8icionario de Aplica$o T *lemento
+rincipal componente do A8. 8efine os campos usados no sistema.
Ka aba *lemento" os campos principais soF
9ome da Coluna "!F nome da coluna como est definido no B8R
9omeR
(eto de impress1oR
(ipo de EntidadeF Adempiere" 8ictionarX" Adempiere%B&R
)ampos +) so utili#ados na tela *edido de Compra.
Aba ,sado na coluna mostra onde o elemento usado.
11.2. Referncia
MenuF 8icionrio de Aplica$o T &efer6ncia
As refer6ncias so usadas na janela (abela e Coluna. ADui so definidos como os campos so validados.
Ka aba #efer8ncia" defina os dados principaisF
9omeR
!escri01oR
Coment-rio2AjudaF este te,to ser e,ibido na tela de ajudaR
(ipo de >alida01oF
Hipo de 8adosF nenGuma valida$o definidaR
%ista de 9alida$oF define uma lista de dados para usar como valor na coluna. *,emploF
C_4rder !eli$erB#ule usado no campo #egra de Entrega de uma 4rdem de >endaR
2ormato do 9alorF define uma mscara para formatar a entrada de dadosR
Habela de 9alida$oF define tabelas" campos e condi$.es Due sero usados para validar a
entrada de dados. *,emploF A!_,ser usado no campo ,su-rio2Contato na Ordem de 9enda.
A aba Aista de >alida01o" usada para definir a lista de itens Due ser usada para validar o dado diitado
pelo usurioF
9omeF valor Due ser e,ibido para o usurioR
Cha$e de buscaF valor Due ser ravado no B8R
A aba (abela de >alida01o" define tabelas" campos e condi$.es para validar os dadosF
(abelaF define a tabela utili#ada na valida$oR
Coluna Cha$eF coluna para ser usada como cGave. O conte1do desta coluna ser ravado no B8R
6ostra ColunaF o conte1do desta coluna ser e,ibido para o usurioR
&KA NOE#EF SDl usada para sele$o dos reistros da tabelaR
&KA 4#!E# "PF SDl para ordenar a e,ibi$o dos dadosR
11... Re+ras de Lalidao )inNmica
MenuF 8icionrio de Aplica$o T &eras de 9alida$o
A valida$o dinQmica utili#ada na janela (abela e Coluna no campo >alida01o !inQmica. 8efine reras
dinQmicas usadas durante a manuten$o de colunas. +or e,emplo" pode(se definir uma rera para e,ibir
apenas os arma#ns da pr0pria Orani#a$o selecionada ao invs de e,ibir os arma#ns de todas as
Orani#a$.es cadastradas. )ampos principaisF
9omeR
(ipoF SB%" %inuaem Aava" Script Aava
C:digo de >alida01oF o c0dio de valida$o de acordo com a linuaem4(ipo5 escolGidoR
11.9. @abelas e col'nas
MenuF 8icionario de Aplica$o T Habela e )oluna
@nforma$o de todas as tabelas e colunas do sistema.
4bser$a01o@
A cGave primria de DualDuer tabela deve ter o seuinte formato de nomeF YnomeUdaUtabelaZU@8
)aso necessite criar tabelas no Adempiere" as seuintes colunas so padro em DualDuer tabelaF
AD.C/IE,T.ID ,UMERIC'$- ,OT ,U//0
AD.OR1.ID ,UMERIC'$- ,OT ,U//0
ISACTI2E cha3acte3'- DE+AU/T 4Y4 ,OT ,U//0
CREATED ti5esta56 7itho8t ti5e 9one DE+AU/T no7'- ,OT ,U//0
CREATEDBY ,UMERIC'$- ,OT ,U//0
UPDATED ti5esta56 7itho8t ti5e 9one DE+AU/T no7'- ,OT ,U//0
UPDATEDBY ,UMERIC'$- ,OT ,U//0
)ampos da aba (abelaF
9ome da (abela no "!F nome da tabela e,atamente como est no banco de dadosR
9omeR
EibirF apenas e,ibir ou visuali#ar os dados" no permite altera$o dos dados da tabelaR
9C$el de Acesso de !adosF n-vel de acesso para esta tabelaF Hodos" Somente )liente" Somente
SistemaR
=erenciamento de #egistro de Altera0DesF mantm um lo de altera$.es na tabelaR
EanelaF indica em Dual janela esta tabela utili#adaR
#egistros EcluC$eisF permite e,cluir dadosR
Alto $olume 4de dados5F e,ibe uma tela de pesDuisa Duando a janela correspondente a esta tabela
for aberta.
Bot.esF
Criar colunas a partir do "anco de !adosF Duando a tabela criada no B8" podemos importar as
colunas do B8 sem precisar informar os dados das colunas manualmenteR
Copiar colunas deF copiar colunas de outra tabelaR
)ampos da aba ColunaF
9ome da Coluna "!F nome da coluna e,atamente como est no banco de dadosR
Coluna &KAF colunas virtuais Due no e,istem no B8. *,emploF soma de dois camposR
Elemento do sistemaR
9omeR
>ers1o@ verso da defini$o da tabela ou campoR
ComprimentoF tamanGo da coluna como definido no B8R
#efer8nciaF tipo de e,ibi$o ou valida$o da coluna 4*,.F Habela 8ireta" Sim(Ko" 8ata[;ora5R
>alida01o !inQmicaF rera de valida$o dinQmica. :sado em colunas com refer6ncia do tipo
(abela" (abela !ireta" Aista ou *rocurar.
Cha$e de referenciaF indica onde buscar os valores de refer6ncia *,.F A8U:ser. *ste campo
e,ibido Duando a refer6ncia do tipo (abela.
A:gica padr1oF valor padro4default5R
4brigat:rioF valor no pode ser nulo4em branco5. Ka janela onde usado" o campo obriat0rio
e,ibido com o fundo vermelGo Duando nulo e com fundo a#ul depois Due alum dado diitadoR
Atualiz-$elF o conte1do do campo pode ser editado pelo usurioR
?dentificadorF indica Due a coluna fa# parte da cGave primria.
11.;. (anelaO aba e camo
MenuF 8icionario de Aplica$o T Aanela" Aba h )ampo
)onfiura a apresenta$o de tabelas e campos dentro das janelas do sistema.
A aba Eanela" define as Aanelas e,istentes no sistema. )ampos principaisF
9omeR
Coment-rio2AjudaR
(ipo de Eanela
Manuten$oF tipo de janela padro Due permite visuali#ar e alterar dadosR
Somente BuestionarF os campos na Aanela no ficam dispon-veis para edi$oR
Hransa$oF janelas Due processam transa$.es 4pedido de venda" paamento" etc...5
A aba Acesso" define Duais *apel./un01o3 Due podem acessar a janela em Duesto e se o acesso apenas
leitura ou permite altera$o dos dados.
Ka aba Aba" todas as abas dispon-veis na janela so confiuradas. )ampos principaisF
9omeR
Coment-rio2AjudaR
(abelaF define a tabela Due ser usada para apresentar os dados na aba selecionadaR
&eFu8nciaF ordem de e,ibi$o da abaR
9C$el da AbaF 0 o primeiro n-vel. K-vel < depende dos dados do n-vel 0 e assim por dianteR
A:gica de >isualiza01oF e,presso Due ser validada para determinar se a aba ser e,ibida ou noR
&Fl NOE#EF SB% a ser usada na sele$o de reistrosR
&Fl 4#!E# "PF SB% para ordenar os reistrosR
Bot.esF
Criar CamposF cria campos 4aba Campo5 ine,istentes a partir da tabela selecionadaR
Copiar Campos de AbasF copia campos de outras abas.
A aba &eFu8ncia de Campo" define a ordem de e,ibi$o dos campos dentro de uma aba.
Ka aba Campo" os campos e seus atributos para e,ibi$o confiurados. Kormalmente os campos so
criados atravs do boto Criar Campos na aba Aba. +rincipais camposF
9omeR
Coment-rio2AjudaR
ColunaF coluna do B8 associada P este campoR
6ostradoF indica se o campo ser e,ibido na abaR
&omente AeituraF Duando marcado no permite altera$o de dadosR
A:gica de >isualiza01oF Duando 6ostrado est marcado" permite validar uma e,presso para
determinar se o campo ser e,ibido ou noR
&eFu8nciaF ordem de e,ibi$o dos camposR
6esma AinhaF o campo ser e,ibido na mesma linGa Due o anterior.
11./. Corm'l2rio
MenuF 8icionrio de Aplica$o T 2ormulrio
8efine janelas Due no so eradas automaticamente pelo sistema. Keste caso precido alterar o c0dio
fonte do Adempiere para criar a janela. *,emploF Abrir %8M.
Ka aba /ormul-rio" defina os seuintes camposF
9omeR
9C$el de Acesso de !adosF n-vel de acesso desta janela 4Orani#a$o" *mpresa[Orani#a$o"
Sistema[*mpresa5R
ClassnameF indica a classe Aava codificada para o formulrio.
Ka aba Acesso" defina o *apel./un01o3 Due pode acessar a janelaF
*apel./un01o3F define Duem tem acesso ao formulrioR
Escrita e AeituraF permite altera$o de dados.
11.E. Aensa+em
MenuF 8icionrio de Aplica$o T Mensaem
:tili#ado para definir mensaens de te,to e dicas4btipsc5 eradas pelo sistema.
8efinir os campos na aba 6ensagemF
(ipo de 6ensagemF *rro" @nforma$o e Menu
(eto de 6ensagemF te,to Due ser e,ibidoR
12. 5:emlo de c'stomi7ao A) % novas col'nas
*,emplo para adicionar dois campos P aba 2uncionrio4*arceiro de 9eg:cios5F !ata de admiss1o e
&itua01o.
12.1. Aodificar a @abela e 1ol'na
<5Abra a janela (abela e Coluna em MenuF 8icionrio de Aplica$o T Habela e )olunaR
>5+rocure pela Habela Buisiness +artner 4+arceiro de Ke0cios5. O nome da Habela no B8 C_"*artnerR
359 na aba Coluna e crie a nova coluna Oire!ate48ata de admisso5 preencGendoF
9ome da Coluna "!F ;ire8ate.
Elemento do &istemaF deve ter o mesmo nome Due o 9ome da Coluna "!. +ara criar o novo
elementoF
)liDue com o boto direito neste campo e selecione <oomR
)rie um novo elemento com o 9ome da Coluna "!" 9ome e (eto de ?mpress1o iual P
;ire8ateR
)liDue na aba (radu01o" preencGa o 9ome e (eto de ?mpress1o com 8ata de AdmissoR
MarDue a op$o (raduzida" rave os dados e retorne P janela (abela e ColunaR
)liDue com o boto direito e selecione Atuali#arR
Selecione o novo item ;ire8ate no campo Elemento de &istemaR
9omeF ;ire 8ateR
>ers1oF <R
ComprimentoF ER
#efer8nciaF 8ataR
Atualiz-$elF permite altera$o no valor do campoR
75Mrave os dados e cliDue no boto &incronizar Coluna para criar a coluna no B8R
?5Aora crie a nova coluna O#_&tatus4Situa$o5 preencGendoF
9ome da Coluna "!F ;&UStatus.
Elemento do &istemaF deve ter o mesmo nome Due o 9ome da Coluna "!. +ara criar o novo
elementoF
)liDue com o boto direito neste campo e selecione <oomR
)rie um novo elemento com o 9ome da Coluna "!" 9ome e (eto de ?mpress1o como
;&UStatusR
)liDue na aba (radu01o" preencGa o 9ome e (eto de ?mpress1o com Situa$oR
MarDue a op$o (raduzida" rave os dados e retorne P janela (abela e ColunaR
)liDue com o boto direito e selecione AtualizarR
Selecione o novo item ;&UStatus no campo Elemento de &istemaR
9omeF ;& Status
>ers1oF <R
ComprimentoF <R
#efer8nciaF %istaR
Cha$e de #efer8nciaF
)liDue com o boto direito e selecione <oom para abrir a janela de #efer8nciaR
)rie uma nova refer6ncia com o 9ome ;&UStatus e (ipo %ista de 9alida$oR
)liDue na aba Aista de >alida01o e crie os itens da listaF
Cha$e de "uscaF AR 9omeF AtivoR
Cha$e de "uscaF %R 9omeF %icen$aR
Cha$e de "uscaF 8R 9omeF 8esliadoR
Salve os dados e retorne P janela (abela e ColunaR
Selecione a #ef8rencia recm(criada4talve# seja necessrio atuali#ar o campo para Due a nova
&efer6ncia seja mostrada5R
A:gica *adr1oF A 4cGave de busca da lista de valida$o5
Atualiz-$elF marcado ( permite altera$o no valor do campoR
4brigat:rioF marcado ( indica Due o campo sempre deve ser preencGidoR
65Mrave os dados e cliDue no boto &incronizar Coluna para criar a coluna no B8.
12.2. Aodificar a (anela
<5Abra a janela Eanela5 Aba R Campo em MenuF 8icionrio de Aplica$o T Aanela" Aba h )ampoR
>5+rocure pela janela Buisiness +artner 4+arceiro de Ke0cios5R
35)liDue na aba Aba" procure e selecione *mploXee42uncionrio5.
75+odemos adicionar os novos campos clicando no boto Criar Campos ou selecionando a aba Campo e
adicionando os campos manualmente. )rie um novo campo manualmente e preencGa os dados para o
;ire8ateF
9omeF ;ire date
ColunaF ;ire8ateU;ire8ate.
?5)rie outro campo manualmente e preencGa os dados para o ;&UStatusF
9omeF ;& Status
ColunaF ;&UStatusU;&UStatus
6esma AinhaF dei,e marcado para Due os dois campos aparecerem na mesma linGa.
65)liDue na aba &eFu8ncia de Campo e ajuste a posi$o dos dois novos campos para depois da coluna
Ati$o na lista SeDu6ncia. Observa$oF voc6 pode selecionar mais de um campo com a tecla SGift ou )trl e
ento mov6(los.
E5Mrave as atlera$oes.
12... ,incroni7ar @erminolo+ia
MenuF Administra$o do Sistema T &eras Merais T Sincroni#a$o de Herminoloia.
*,ecute o processo &incroniza01o de (erminologia. *ste processo fa# a sincronia das abas de tradu$o
dos campos com a tradu$o do Elemento do &istema.
&etorne na janela Eanela5 Aba R Campo" procure pelos novos campos Due acabou de criar e verifiDue Due
na aba (radu01o de Campos" a tradu$o foi erada como informado no Elemento do &istema.
12.9. Lerificar a c'stomi7ao
9erifiDue a customi#a$o na janela *arceiro de 9eg:cios" aba /uncion-rio.
Os novos campos !ata de Admiss1o e &itua01o so e,ibidos depois do campo Ativo.
Kote Due ao lado do campo !ata de Admiss1o" aparece um boto Due abre um calendrio para selecionar
a data desejada.
Buanto ao campo &itua01o" ele tem o fundo a#ul" indicando Due um campo obriat0rio e Duando
clicado" uma lista e,ibida com os valores pr(definidos.
1.. 5:emlo de c'stomi7ao A) % nova janela
*,emplo para criar uma nova janela no Adempiere usando o A8" ou seja" sem prorama$o.
Keste e,emplo vamos criar a tabela )or associ(la em novo campo na tabela de produtos.
1..1. 1riar @abela
1..1.1. 1riar tabela no ")
+ara criar a nova tabela do e,emplo" utili#e o script SB% abai,o e e,ecute(o a partir do processoF MenuF
Administrador do Sistema T &eras Merais T +rocesso SB%
CREATE TAB/E :.M.CO/OR '
:.M.CO/OR.ID ,UMERIC'$- ,OT ,U//0
AD.C/IE,T.ID ,UMERIC'$- ,OT ,U//0
AD.OR1.ID ,UMERIC'$- ,OT ,U//0
ISACTI2E CHARACTER'- DE+AU/T 4;4 ,OT ,U//0
CREATED TIMESTAMP <ITHOUT TIME =O,E ,OT ,U// DE+AU/T ,O<'-0
CREATEDBY ,UMERIC'$- ,OT ,U//0
UPDATED TIMESTAMP <ITHOUT TIME =O,E ,OT ,U// DE+AU/T ,O<'-0
UPDATEDBY ,UMERIC'$- ,OT ,U//0
,AME CHARACTER 2ARYI,1'>$- ,OT ,U// -?
A/TER TAB/E ADEMPIERE#:.M.CO/OR ADD PRIMARY @EY':.M.CO/OR.ID-?
1..1.2. 1riar tabela e col'nas no A)
Abra a janela (abela e Coluna em MenuF 8icionrio de Aplica$o T Habela e )olunaR
)rie um novo reistro e preencGa os seuintes dados na aba (abelaF
9ome da (abela no "!F fUMU)O%O&
9omeF fUMU)O%O&R
9C$el de Acesso ao &istemaF *mpresa[Orani#a$o
#egistros EcluC$eisF dei,e marcadoR
)liDue na aba (radu01o de (abelas e informeF
9omeF )or do +rodutoR
(raduzidaF marDue esta op$o e rave as altera$.esR
9olte na aba Habela e cliDue no boto Criar Colunas a partir do "ando de !ados e como (ipo de
Entidade" selecione :ser mainted.
1..1... Refinar dados das col'nas
As colunas foram criadas conforme o B8 e a refer6ncia associada automaticamente Duando poss-vel ou
uma nova refer6ncia criada.
<5Selecione a aba Coluna referente P tabela recm(criada 4fUMU)O%O&5 e fa$a as seuintes
modifica$.esF
Ka coluna A8U)%@*KHU@8F
A:gica *adr1oF _A8U)%@*KHU@8_R
>alida01o !inQmicaF A8U)%@*KH Hr, SecuritX 9alidationR
Ka coluna A8UO&MU@8F
A:gica *adr1oF _A8UO&MU@8_R
>alida01o !inQmicaF A8UO&M Hr, SecuritX 9alidationR
Ka coluna @SA)H@9*F
A:gica *adr1oF iR
>5+rocure pela tabela MU+&O8:)HR
35Abra a aba Coluna e crie uma nova coluna como abai,oF
9ome da Coluna "!F fUMU)O%O&U@8.
Elemento do &istemaF fUMU)O%O&U@8. A deve estar criado mas fa$a a tradu$oF
)liDue com o boto direito neste campo e selecione <oomR
+reencGa o 9ome e (eto de ?mpress1o como +roduct )olorR
)liDue na aba (radu01o" preencGa o 9ome e (eto de ?mpress1o com )or do +rodutoR
MarDue a op$o (raduzida" rave os dados e retorne P janela (abela e ColunaR
9omeF +roduct )olorR
ComprimentoF <0R
#efer8nciaF +rocurarR
Cha$e de #efer8nciaF
)liDue com o boto direito e selecione <oom para abrir a janela de #efer8nciaR
)rie uma nova refer6ncia com o 9ome +roduct )olor e (ipo Habela de 9alida$oR
)liDue na aba (abela de >alida01o e adicione um novo reistroF
(abela@ fUMU)O%O&U)orUdoU+rodutoR
Coluna Cha$eF fUMU)O%O&U@8R
6ostra Coluna@ KameR
Salve os dados e retorne P janela (abela e ColunaR
Selecione a #ef8rencia recm(criada4talve# seja necessrio atuali#ar o campo para Due a nova
&efer6ncia seja mostrada5R
Atualiz-$elF permite altera$o no valor do campoR
75Mrave os dados e cliDue no boto &incronizar Coluna para criar a coluna no B8R
1..2. 1riar janela 1or do #rod'to
<5Abra a janela Eanela5 Aba R Campo em MenuF 8icionrio de Aplica$o T Aanela" Aba e )ampoR
>5)rie um novo reistro e informeF
Ka aba EanelaF
9omeF +roduct )olorR
(ransa01o de >endasF desmarDueR
)liDue na aba (radu01o de Eanela e informeF
9omeF )or do +rodutoR
(raduzidaF marDue esta op$o e rave as altera$.esR
35)rie uma nova aba" clicando na aba AbaF
KomeF )olorR
HabelaF fUMU)O%O&R
)liDue na aba (radu01o de Abas e informeF
9omeF )orR
(raduzidaF marDue esta op$o e rave as altera$.esR
759olte na aba Aba e cliDue no boto Criar Campos para Due os campos seja criados a partir do B8R
?5)liDue na aba Campos e verifiDue os dados criados. ModifiDue os dados de laXout como Duiser. +or
e,emploF
)liDue na aba &eFu8ncia de Campos e ordene os camposF )liente" Orani#ation" Active" +roduct
)olor e KameR
MarDue a op$o 6esma Ainha para os campos Orani#ation e KameR
)rie um novo =rupo de Campo com nome +roduct )olor e define(o nos campos +roduct )olor e
KameF
+osicione no campo +roduct colorR
cliDue com o boto direito no campo =rupo de Campo e selecione <oomR
)rie um novo reistro e definaF 9ome W )olorR
)liDue na aba Hradu$o e diiteF 9ome W )orR
Mrave as altera$.es" volte na aba Campos da janela Eanela5 Aba R CampoR
)liDue com o boto direito no campo =rupo de Campo e selecione AtualizarR
Selecione o =rupo de Campo )orR
+osicione no campo Kame e selecione o Mrupo de )ampo )orR
65+ara utili#ar a fun$o <oom Duando estiver utili#ando a janela *roduto" fa$a a seuinte modifica$o na
tabela fUMU)O%O& 4janela (abela e Coluna" aba (abela5F
EanelaF )or do +rodutoR
1.... Aodificar a janela #rod'to
<5+rocure pela janela +roduct 4+roducto5R
>5)liDue na aba Aba" procure e selecione +roduct.
35Adicionar o novo campo clicando no boto Criar Campos;
75)liDue na aba &eFu8ncia de Campo. 9erifiDue Due o campo *roduct Color foi criado. Ajuste sua
posi$o na aba conforme desejar.
?5Mrave os dadosR
1..9. 1riar Item Aen'
<59 em MenuF Administrador do Sistema T &eras Merais T &eras do Sistema T Menu
>5)rie um novo reistro informandoF
9omeF +roduct )olorR
A01oF AanelaR
EanelaF )or do +rodutoR
Ka aba (radu01oF
KomeF )or do +rodutoR
Hradu#idaF marDue esta op$o e rave as altera$.esR
358o lado esDuerdo da janela" voc6 ver Due o novo item foi criado na rai# do menu. 9oc6 pode clicar
nele e arrast(lo para onde desejar. +or e,emplo" dentro de Administra$o de Materiais.
1..;. ,incroni7ar @erminolo+ia
8epois de criar a tabela" janelas e item de menu" necessrio rodar o processo &incronizar (erminologia
para sincroni#ar a tradu$o dos itens.
2a$a isso em MenuF Administrador do Sistema T &eras Merais T Sincroni#a$o de Herminoloia
1../. Lerificar c'stomi7ao
2a$a loin novamente" v at o item de menu onde dei,ou a nova janela Cor do *roduto e abra a janela.
9erifiDue o laXout da tela e entre com aluns dados.
9 at a janela +roduto" e verifiDue o novo campo Cor do *roduto.
Observe Due no final do campo" e,iste um boto Due e,ecuta o processo de pesDuisa do reistro. @sto foi
confiurado Duando definimos no campo fUMU)O%O&U@8" a #efer8ncia como +rocurar e adicionamos
uma Cha$e de #efer8ncia do tipo Habela de 9alida$o. Os campos Due tem o ?dentificador marcado" so
mostrados como op$o para pesDuisa.
19. 1onfi+'rar o ambiente de desenvolvimento
*m alumas circunstQncias" ser necessrio" alterar o c0dio fonte para Due o Adempiere atenda suas
necessidades. +ara Due o Adempiere consia usar estas implementa$.es" elas devem ser arupadas no
arDuivo customization.jar.
*ste cap-tulo trata da confiura$o do ambiente de prorama$o e como erar o arDuivo
customi#ation.jar. )omo e,emplo" ser usado o projeto OSeB.
19.1. #erarando o ambiente
2a$a do!nload e instale os seuintes componentesF
AA9A 4*,emploF A83 <.65
*clipse 4*clipse para Aava5
+ostreSB%
19.1.1. Instale o ,'bclise
Ko *clipse" v em ;elp T @nstall ne! soft!are
Ko campo SorT Sith" diiteF GttpF''subclipse.tiris.or'updateU<.6.,
Selecione as 3 op$.es 4)ore S9K3it" AKA %ibrarX" Subclipse5 R
)liDue em 9et e prossia at finali#ar a instala$o.
19.2. "ai:ar e criar os rojetos Ademiere e O,e"
Selecione a perspecitva &>9 #epositorB Eploring no menuF
Cindo! T Open +erspective T OtGer T S9K &epositorX *,plorin
19.2.1. Reositrio Ademiere
Boto direito do mouse em S9K &epositorX *,plorin e selecione Ke! T &epositorX location
8iite a url do projeto AdempiereF GttpsF''adempiere.svn.sourcefore.net'svnroot'adempiere
Abra a rvore de reposit0rios" selecione trunT;
)liDue com o boto direito e selecione ChecToutR
@nforme o nome do projeto 4Adempiere5 e /inish.
19.2.2. Reositrio O,e"
Boto direito do mouse em S9K &epositorX *,plorin e selecione Ke! T &epositorX location
8iite a url do projeto Adempiere%B&'OSeBF GttpsF''oseb.svn.sourcefore.net'svnroot'oseb
Abra a rvore de reposit0rios" selecione trunT" cliDue com o boto direito e selecione ChecToutR
@nforme o nome do projeto 4OSeB5 e /inish.
19.2... #rojeto Ademiere
9erifiDue antes se o *clipse criou o projeto depois do )Gec/outF
9 em Cindo! T Open +erspective T OtGer T Aava
9erifiDue se o projeto Adempiere est na aba +ac/ae *,plorerR
)aso o projeto no tenGa sido criadoF
9 em 2ile T Ke! T Aava +rojectR
8iite o nome do projeto 4Adempiere5R
Selecione j)reate project from e,istin sourcejR
)liDue em "roSse para selecionar o diret0rio Due contm o projeto 4arDuivo .project5R
)liDue em 9et e /inish.
19.2.9. #rojeto O,e"
9erifiDue antes se o *clipse criou o projeto depois do )Gec/outF
9 em Cindo! T Open +erspective T OtGer T Aava
9erifiDue se o projeto OSeB est na aba +ac/ae *,plorerR
?mportanteF adicione o projeto Admpiere ao projeto OseBF
Abra as propriedades do projeto OseBR
Selecione a op$o Aava Build +atGR
Ka aba +rojects" cliDue em Add e selecione o projeto AdempiereR
)aso o projeto no tenGa sido criadoF
9 em 2ile T Ke! T Aava +rojectR
8iite o nome do projeto 4OSeB5R
Selecione j)reate project from e,istin sourcejR
9et e selecione a aba *rojects;
)liDue em Add5 selecione o projeto Adempiere Due foi criado no passo anterior e cliDue em 4TR
/inish
19.2.;. At'ali7ar o rojeto com o ,'bclise
Selecione o projeto desejado 4Adempiere ou OSeB5 na aba +ac/ae *,plorerR
Boto direito e selecione Heam T SXncGroni#e !itG &epositorX
19... ?erando o c'stomi7ation.jar
Abra o projeto OseB e selecione o arDuivo build.ml
)liDue com o boto direito e #un As U Ant "uild
O arDuivo customi#ation.jar ser criado na pasta do projeto OseB.
19.9. =tili7ando o novo c'stomi7ation.jar
)opie o novo customization.jar para a pasta lib do Adempiere 4*,.F
)FSadempiereSlibScustomi#ation.jar5 substituindo o arDuivo antioR
&ode o #,9_&ilent&etup para Due o novo arDuivo seja assinado 4levando em considera$o Due
voc6 j tenGa o Adempiere confiurado e funcionando antes de aplicar no novo customi#ation.jar5

You might also like