[19.0][ADD] payroll: document the Net-Empregos and SAPO Emprego job boards

content/applications/payroll.rst

@@ -1,9 +1,9 @@
 :nosearch:
 
-========
-Salários
-========
-Explore mais sobre o nosso add-on de Salários
+=============
+Salários e HR
+=============
+Explore mais sobre o nosso add-on de Salários e Recursos Humanos
 
 .. raw:: html
 
@@ -27,3 +27,4 @@ Explore mais sobre o nosso add-on de Salários
     payroll/relatorio_unico
     payroll/outros_mapas
     payroll/integracoes_odoo
+    payroll/recrutamento

content/applications/payroll/recrutamento.rst

@@ -0,0 +1,303 @@
+:show-content:
+
+============
+Recrutamento
+============
+Explore mais sobre as nossas integrações com os portais de emprego portugueses: publique as vagas
+do Odoo diretamente a partir da app **Recrutamento**, sem ter de repetir o anúncio em cada
+plataforma
+
+.. _payroll_recrutamento_net_empregos:
+
+Net-Empregos
+============
+O `Net-Empregos <https://www.net-empregos.com>`_ é um dos maiores portais de emprego em Portugal.
+O anúncio é publicado, alterado e removido sem sair do Odoo, e cada vaga guarda aquilo com que foi
+anunciada
+
+.. raw:: html
+
+    <div style="text-align: center; margin: 20px 0;">
+        ─── ✦ ───
+    </div>
+
+Configuração
+------------
+
+Chave API
+~~~~~~~~~
+Gere a chave na área de empresa do net-empregos.com, na secção **Chave API**, e cole-a no Odoo: app
+**Recrutamento**, menu :menuselection:`Configuração --> Definições`, secção **Net-Empregos**
+
+.. image:: recrutamento/v19_netempregos_settings.png
+   :align: center
+
+.. important::
+    A chave pertence à empresa em que é introduzida. Numa base de dados multiempresa, coloque-a na
+    empresa a que pertencem as vagas a anunciar: o anúncio sai sempre pela conta Net-Empregos da
+    **empresa da vaga** e, numa vaga sem empresa (partilhada por todas), pela conta da empresa
+    ativa
+
+Listas do Net-Empregos
+~~~~~~~~~~~~~~~~~~~~~~
+O Net-Empregos anuncia cada oferta sob uma zona, uma categoria profissional e um tipo de emprego
+das suas próprias listas. Estas vêm já preenchidas com o módulo e podem ser consultadas no menu
+:menuselection:`Configuração --> Portais de empregos --> Códigos Net-Empregos`
+
+.. image:: recrutamento/v19_netempregos_codes.png
+   :align: center
+
+Valores propostos
+~~~~~~~~~~~~~~~~~
+Para poupar escrita no primeiro anúncio de cada vaga, indique o campo
+:guilabel:`Tipo de Emprego Net-Empregos` uma única vez em
+:menuselection:`Funcionários --> Configuração --> Recrutamento --> Tipos de contratação`. A partir
+daí, as ofertas a tempo inteiro, a tempo parcial e os estágios chegam já com o tipo de emprego
+preenchido
+
+Publicar uma oferta
+-------------------
+Abra a vaga na app **Recrutamento** e carregue em :guilabel:`Publicar em portais de vagas`. No
+assistente, escolha **Net-Empregos** no campo :guilabel:`Portal de empregos`: aparece o separador
+:guilabel:`Net-Empregos` com os três campos sob os quais a oferta é anunciada
+
+.. image:: recrutamento/v19_netempregos_wizard_tab.png
+   :align: center
+
+- :guilabel:`Zona` — a zona do país onde a oferta é anunciada
+- :guilabel:`Categoria` — a categoria profissional da oferta
+- :guilabel:`Tipo de Emprego` — tempo inteiro, part-time, estágio ou teletrabalho
+
+.. tip::
+    Os campos vivem no anúncio e não na vaga, pelo que a vaga se mantém livre de um bloco de campos
+    por cada portal e dois anúncios da mesma vaga podem ser diferentes
+
+.. important::
+    Os três campos são exigidos pelo Net-Empregos, tal como uma descrição com um mínimo de
+    10 caracteres. O Odoo verifica-os antes de publicar e indica o que faltar
+
+O texto do anúncio vem da descrição da vaga, com a ênfase e as ligações que ela tiver. No fim é
+acrescentada uma ligação **Candidate-se**, construída a partir do método de candidatura escolhido
+no assistente — a página da vaga no seu site, no caso do redirecionamento, ou o endereço de e-mail
+indicado
+
+.. note::
+    O Net-Empregos não tem um campo próprio para o endereço de candidatura; o próprio portal indica
+    aos anunciantes que este deve ser escrito no texto da oferta, e é isso que o Odoo faz por si
+
+Segundo anúncio da mesma vaga
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Publicar novamente a mesma vaga parte do **último anúncio publicado nela no Net-Empregos**, pelo que
+só o primeiro anúncio de cada vaga dá trabalho a preencher
+
+Depois de publicar
+------------------
+A publicação fica registada no menu
+:menuselection:`Aplicações --> Publicações no portal de empregos`, com o estado que o Net-Empregos
+devolveu. O separador :guilabel:`Net-Empregos` da publicação mostra a zona, a categoria e o tipo de
+emprego com que a oferta foi anunciada, e é onde se alteram para um novo envio
+
+- :guilabel:`Atualizar` substitui o conteúdo do anúncio no portal
+- :guilabel:`Parar campanhas` remove o anúncio do Net-Empregos
+
+.. _payroll_recrutamento_sapo_emprego:
+
+SAPO Emprego
+============
+O `SAPO Emprego <https://emprego.sapo.pt>`_ é outro dos maiores portais de emprego em Portugal.
+O anúncio é publicado, alterado e retirado das listagens sem sair do Odoo, cada vaga guarda o que
+foi publicado (incluindo o endereço público do anúncio) e as candidaturas regressam ao Odoo como
+candidatos dessa vaga
+
+.. raw:: html
+
+    <div style="text-align: center; margin: 20px 0;">
+        ─── ✦ ───
+    </div>
+
+Configuração
+------------
+
+Token de acesso
+~~~~~~~~~~~~~~~
+O SAPO Emprego dá acesso à sua API em dois passos: primeiro emite um token de **teste** e só depois
+de aprovar um anúncio publicado por essa via é que emite o token de **produção**
+
+Peça o token na área de empresa do portal, na secção **API**, e cole-o no Odoo: app
+**Recrutamento**, menu :menuselection:`Configuração --> Definições`, secção **SAPO Emprego**
+
+.. image:: recrutamento/v19_sapo_settings.png
+   :align: center
+
+- :guilabel:`Ambiente` — **Teste** enquanto usa o token de teste, **Produção** depois de o SAPO
+  aprovar o anúncio
+- :guilabel:`Token API` — o token do ambiente escolhido
+
+O botão :guilabel:`Atualizar a partir do SAPO Emprego` lê a conta e as listas da plataforma. O nome
+da conta, o seu nível e os serviços premium contratados passam a ser apresentados abaixo do token,
+tal como o SAPO Emprego os reporta
+
+.. important::
+    O token pertence à empresa em que é introduzido. Numa base de dados multiempresa, coloque-o na
+    empresa a que pertencem as vagas a anunciar: o anúncio sai sempre pela conta SAPO Emprego da
+    **empresa da vaga** e, numa vaga sem empresa (partilhada por todas), pela conta da empresa ativa
+
+Listas do SAPO Emprego
+~~~~~~~~~~~~~~~~~~~~~~
+O SAPO Emprego só aceita um anúncio descrito pelas suas próprias listas — países, distritos,
+concelhos, categorias profissionais, horários, tipos de contrato, qualificações, experiência
+profissional, escalões salariais e vagas disponíveis. O mesmo botão
+:guilabel:`Atualizar a partir do SAPO Emprego` lê essas dez listas da plataforma e, a partir daí,
+elas atualizam-se sozinhas uma vez por dia
+
+Para as consultar vá ao menu
+:menuselection:`Configuração --> Portais de empregos --> Códigos SAPO Emprego`
+
+.. image:: recrutamento/v19_sapo_codes.png
+   :align: center
+
+.. important::
+    Enquanto esta primeira atualização não for feita não é possível publicar: o SAPO Emprego exige
+    o país, os distritos, as categorias profissionais, o horário e o escalão salarial anual, e sem
+    as listas não há nada para escolher
+
+Alias de e-mail da vaga
+~~~~~~~~~~~~~~~~~~~~~~~
+Sem serviço premium, os candidatos candidatam-se no próprio SAPO Emprego e cada candidatura é
+enviada por e-mail. Para que essa candidatura se transforme sozinha num candidato no Odoo, dê à
+vaga o seu **próprio alias de e-mail**: abra a vaga na app **Recrutamento** e preencha o campo
+:guilabel:`E-mail de candidatura` (é preciso ter um domínio de alias configurado para o poder
+escolher)
+
+.. important::
+    Uma vaga sem alias e sem responsável com e-mail profissional não pode ser publicada no SAPO
+    Emprego, e o Odoo di-lo antes de gastar qualquer chamada à plataforma
+
+Valores propostos
+~~~~~~~~~~~~~~~~~
+Para poupar escrita no primeiro anúncio de cada vaga, os equivalentes SAPO Emprego podem ser
+indicados uma única vez na configuração:
+
+- em :menuselection:`Funcionários --> Configuração --> Recrutamento --> Tipos de contratação`,
+  os campos :guilabel:`Horário SAPO Emprego` e :guilabel:`Tipo de Contrato SAPO Emprego`
+- em :menuselection:`Recrutamento --> Configuração --> Aplicações --> Graus`, o campo
+  :guilabel:`Qualificação SAPO Emprego`
+
+A partir daí, o primeiro anúncio de uma vaga chega já com o horário e o tipo de contrato do tipo de
+contratação da vaga, e com a qualificação do grau esperado
+
+Publicar uma oferta
+-------------------
+Abra a vaga na app **Recrutamento** e carregue em :guilabel:`Publicar em portais de vagas`. No
+assistente, escolha **SAPO Emprego** no campo :guilabel:`Portal de empregos`
+
+.. image:: recrutamento/v19_sapo_wizard_board.png
+   :align: center
+
+Escolher o portal faz aparecer o separador :guilabel:`SAPO Emprego`, que reúne tudo o que a
+plataforma precisa de saber sobre o anúncio
+
+.. image:: recrutamento/v19_sapo_wizard_tab.png
+   :align: center
+
+.. tip::
+    Os campos vivem no anúncio e não na vaga, pelo que a vaga se mantém livre de um bloco de campos
+    por cada portal e dois anúncios da mesma vaga podem ser diferentes
+
+O separador está organizado em cinco blocos:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 25 75
+
+   * - Bloco
+     - O que contém
+   * - **Onde**
+     - O :guilabel:`País`, os :guilabel:`Distritos` e o :guilabel:`Concelho` do anúncio
+   * - **O quê**
+     - As :guilabel:`Categorias Profissionais`, o :guilabel:`Horário`, o
+       :guilabel:`Tipo de Contrato` e o :guilabel:`Modelo de Trabalho` (presencial, híbrido ou
+       remoto)
+   * - **Quem**
+     - A :guilabel:`Qualificação` mínima, a :guilabel:`Experiência Profissional`, o número de
+       :guilabel:`Vagas Disponíveis` e se o :guilabel:`CV` é obrigatório, opcional ou não aceite
+   * - **Como é anunciado**
+     - O :guilabel:`Escalão Salarial Anual` e se o anúncio é :guilabel:`Anónimo` (sem o nome da
+       empresa)
+   * - **Texto do anúncio**
+     - O :guilabel:`Pitch` (a linha sob o título), a :guilabel:`Oferta`, o :guilabel:`Horário` e as
+       :guilabel:`Observações`, cada um a alimentar a secção com o mesmo nome no anúncio
+
+.. important::
+    O SAPO Emprego exige o :guilabel:`País`, os :guilabel:`Distritos`, as
+    :guilabel:`Categorias Profissionais`, o :guilabel:`Horário` e o
+    :guilabel:`Escalão Salarial Anual`, e publica sempre por um período fixo, pelo que a
+    :guilabel:`Duração da campanha` tem de ter data de fim. O Odoo verifica tudo isto antes de
+    publicar e nomeia o que faltar
+
+O que já está no Odoo não é pedido outra vez: a descrição do anúncio vem da descrição da vaga, os
+seus **requisitos** preenchem a secção *Perfil* (um requisito por linha) e as suas **competências**
+preenchem *Competências*
+
+.. note::
+    O SAPO Emprego não publica endereços web nem de e-mail dentro de um anúncio. Os que a descrição
+    da vaga tiver são retirados do texto e indicados na publicação, para que se saiba exatamente o
+    que ficou de fora
+
+Segundo anúncio da mesma vaga
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Publicar novamente a mesma vaga parte do **último anúncio publicado nela no SAPO Emprego**, pelo
+que só o primeiro anúncio de cada vaga dá trabalho a escrever. Esvaziar um dos quatro campos de
+texto retira a respetiva secção do anúncio
+
+Depois de publicar
+------------------
+A publicação fica registada no menu
+:menuselection:`Aplicações --> Publicações no portal de empregos`, com o estado que o SAPO Emprego
+devolveu
+
+.. image:: recrutamento/v19_sapo_post.png
+   :align: center
+
+O campo :guilabel:`Endereço do Anúncio` é o endereço público do anúncio no SAPO Emprego, lido de
+volta da plataforma. É este endereço que o SAPO pede para aprovar o acesso à produção
+
+O separador :guilabel:`SAPO Emprego` da publicação mostra tudo aquilo com que o anúncio foi
+publicado, e é onde se alteram os dados para um novo envio
+
+.. image:: recrutamento/v19_sapo_post_tab.png
+   :align: center
+
+- :guilabel:`Atualizar` envia as alterações para a plataforma
+- :guilabel:`Parar campanhas` retira o anúncio das listagens. O SAPO Emprego não permite apagar um
+  anúncio, apenas colocá-lo em pausa, pelo que é isso que retirar significa aqui — e publicar
+  novamente retoma o mesmo anúncio em vez de pagar um segundo
+
+.. important::
+    O título, o país e os distritos ficam fixos no momento em que o anúncio é criado. Se forem
+    alterados no Odoo depois disso, a publicação avisa que a plataforma continua a mostrar os
+    originais, em vez de a alteração se perder em silêncio
+
+Candidaturas
+------------
+Existem dois caminhos para as candidaturas, e o Odoo usa o que a conta permitir:
+
+- **Sem serviço premium** — os candidatos candidatam-se no próprio SAPO Emprego e cada candidatura
+  é enviada para o alias de e-mail da vaga, onde o Odoo a arquiva como candidato dessa vaga
+- **Com o serviço premium correspondente** — escolhendo o método de candidatura
+  :guilabel:`Redirecionar para o site da empresa`, o anúncio leva os candidatos diretamente à
+  página da vaga no seu site
+
+.. warning::
+    O redirecionamento é um serviço premium do SAPO Emprego. Numa conta sem esse serviço a
+    plataforma aceita o endereço e ignora-o sem avisar, pelo que o Odoo verifica os serviços da
+    conta e, quando o redirecionamento não é possível, diz na publicação qual é a conta em causa e
+    para que endereço as candidaturas chegam realmente
+
+Do teste para a produção
+------------------------
+#. Com o :guilabel:`Ambiente` em **Teste**, publique um anúncio
+#. Envie ao SAPO Emprego o :guilabel:`Endereço do Anúncio` que a publicação mostra
+#. Depois de o SAPO aprovar, peça o token de produção na área de empresa do portal
+#. No Odoo, mude o :guilabel:`Ambiente` para **Produção**, cole o novo token e carregue em
+   :guilabel:`Atualizar a partir do SAPO Emprego`

extensions/exo_theme/layout_templates/homepage.html

@@ -26,7 +26,7 @@ <h5 class="text-dark pt-3 text-uppercase fw_bold">{{ _("Temáticas") }}</h5>
                     </li>
                     <li>
                         <a href="{{ pathto('applications/payroll') }}" class="stretched-link">
-                            {{ _("Salários") }}
+                            {{ _("Salários e HR") }}
                         </a>
                     </li>
                     <li>