# Moloni

![WordPress Plugin Required PHP Version](https://img.shields.io/badge/php-%3E%3D7.2-blue)
![WordPress Plugin: Tested PHP Version](https://img.shields.io/badge/php-8.1%20tested-blue)
![WordPress Plugin: Required WP Version](https://img.shields.io/badge/WordPress-%3E%3D%205.0-orange)
![WordPress Plugin: Tested WP Version](https://img.shields.io/badge/WordPress-6.7.1%20tested-orange)![WooCommerce: Required Version](https://img.shields.io/badge/WooCommerce-%3E%3D%203.0.0-orange)
![WooCommerce: Tested Version](https://img.shields.io/badge/WooCommerce-9.6.0%20tested-orange)

![WordPress Plugin Downloads](https://img.shields.io/wordpress/plugin/dt/moloni)
![WordPress Plugin Active Installs](https://img.shields.io/wordpress/plugin/installs/moloni)

![GitHub](https://img.shields.io/github/license/moloni-pt/woocommerce)

**Contributors:**      [moloni-pt](https://github.com/moloni-pt)  
**Homepage:**          [https://plugins.moloni.com/woocommerce/](https://plugins.moloni.com/woocommerce/)  
**Tags:**              Invoicing, Orders  
**Requires PHP:**      7.2  
**Tested up to:**      6.7.1  
**WC tested up to**    9.6.0  
**Stable tag:**        5.0.05  
**License:**           GPLv2 or later  
**License URI:**       [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)  

Software de faturação inovador que se adapta ao seu negócio! Destinado a profissionais liberais, micro, pequenas e médias empresas. Sem investimento inicial, completo e intuitivo.

## Descrição
O Moloni é um inovador software de faturação e POS online que inclui acesso a inúmeras ferramentas úteis e funcionais que permitem a cada empresa gerir a sua faturação, controlar stocks, automatizar processos e emitir documentos de forma rápida, simples e intuitiva.

Certificado com o n.º 2860 da Autoridade Tributária, o Moloni está sempre atualizado e de acordo com a lei em vigor!

## Através do plugin é possível:
* Sincronizar artigos e stocks entre as duas plataformas
* Emissão automática ou manual de documentos
* Selecionar o estado dos documentos emitidos
* Selecionar de uma grande variedade de tipos de documentos
* Selecionar o armazém de saída dos artigos
* Envio automático do documento para o cliente
* Criação automática de clientes e artigos
* Personalizar os seus detalhes de faturação
* Aceder aos documentos emitidos sem sair do Wordpress

Todo o suporte técnico e comercial dado aos utilizadores do plugin é prestado pela equipa de Apoio a Clientes do Moloni.

## Perguntas Frequentes (Frequently Asked Questions)

### Existe alguma versão paga do plugin?
Não. O plugin foi desenvolvido e é disponibilizado de forma completamente gratuita pela equipa Moloni.

### Quanto terei que pagar pelo suporte?
À semelhança do software Moloni, todo o suporte é completamente gratuito e prestado inteiramente pela nossa equipa de Apoio a Clientes do Moloni.

### Tenho dúvidas ou sugestões, quem posso contactar?
Para qualquer duvida ou sugestão pode entrar em contacto connosco através do email apoio@moloni.com.

### Os documentos estão a ser emitidos sem contribuinte
Por defeito, o WooCommerce não tem um campo de contribuinte, como tal, o que se costuma fazer é adicionar um plugin para adicionar o contribuinte ao cliente.
Estes plugins criam um custom_field associado à morada de facturação do cliente, como por exemplo `_billing_nif`.
Depois de ter um plugin para o contribuinte instalado, basta selecionar nas configurações do plugin Moloni qual o `custom_field` que corresponde ao contribuinte do cliente.


## Instalação
Este plugin pode ser instalado através de FTP ou utilizando o instalador de plugins do Wordpress.

#### Via FTP
1. Upload dos ficheiros do plugin para o diretório `/wp-content/plugins/moloni`
2. Ativar o plugin através da opção `Plugins` visível no WordPress


## Upgrade Notice
### 5.0.00
* Released plugin version 5.

### 4.0.0
* Released plugin version 4.
* New logging system.
* Multisite support.

### 3.0.0
* Released plugin version 3.
* New plugin version fully re-written


## Changelog
### 5.0.05
* FIX: Melhorias na prevenção de criação de documentos repetidos

### 5.0.04
* FIX: Correção na criação de documentos em massa
 
### 5.0.03
* FIX: Foram escapados elementos HTML do nome dos métodos de pagamento

### 5.0.02
* MINOR: Alteração na apresentação das isenções

### 5.0.01
* MINOR: Correção de alerta PHP

### 5.0.00
* FEATURE: Adicionados Hooks moloni_before_search_customer para alterar a pesquisa de clientes
* MINOR: Melhorias na captação das notas da encomenda

### 4.9.8
* FIX: Adicionada verificação do pedido no fecho de documentos

### 4.9.7
* MINOR: Atualização do serviço de criação de notas de crédito para potenciar o uso dos filtros/hooks
* FEATURE: Adicionada sincronização do EAN com base no "_global_unique_id" (barcode)

### 4.9.6
* FIX: Correção no cálculo dos impostos dos portes de envio
* FIX: Correção na criação de produtos no Moloni, em que o armazém predefinido não era seccionado

### 4.9.5
* FEATURE: Possibilidade de usar prefixo no número dos clientes

### 4.9.4
* FEATURE: Adicionada pesquisa por payload na listagem de registos

### 4.9.3
* MINOR: Acrescentado "throttles" nas ferramentas

### 4.9.2
* MINOR: Testado até à versão 6.7.1 do Wordpress
* MINOR: Testado até à versão 9.6.0 do WooCommerce

### 4.9.1
* FIX: Correção um erro na criação de Documento de transporte + Documento com compostos

### 4.9.0
* FEATURE: Adicionados filtros à criação automática de documentos

### 4.8.5
* FIX: Correção de erros de "cast"

### 4.8.4
* FIX: Correção na razão de isenção usada para as Canárias e Tenerife
* MINOR: Pequenas alterações e correções

### 4.8.2
* FIX: Correção na ligação para criação de documentos

### 4.8.1
* FIX: Melhorias de segurança

### 4.8.0
* FIX: Melhorias de segurança

### 4.7.4
* FIX: Correção de erro com versão do "Psr Logger Interface"

### 4.7.3
* FIX: Correção na pesquisa de clientes por NIF

### 4.7.2
* FIX: Correção na criação de notas de crédito com descontos
* MINOR: Adicionado WooCommerce como dependência
* MINOR: Testado até à versão 6.5.0 do Wordpress
* MINOR: Testado até à versão 8.7.0 do WooCommerce


### 4.7.1
* FEATURE: Adicionados filtros à criação de notas de crédito
* FEATURE: Adicionados novos estados para criação de documentos de forma automática
* MINOR: Testado até à versão 6.4.3 do Wordpress
* MINOR: Testado até à versão 8.6.1 do WooCommerce

### 4.7.0
* FEATURE: Novas páginas de listagem de produtos para importação/exportação de stocks/produtos

### 4.6.1
* FIX: Correção na listagem de encomendas pendentes

### 4.6.0
* FEATURE: Nova definição para limitar encomendas por data
* FEATURE: Nova definição que torna opcional a inclusão das notas da encomenda no documento

### 4.5.2
* FEATURE: Novo visual da página de login e escolha de empresa
* FIX: Correção na pesquisa de clientes sem contribuinte definido
* FIX: Correção de erro fatal na listagem de encomendas pendentes
* MINOR: Adicionado ID das notas de crédito na meta dos reembolsos

### 4.5.1
* FIX: Correção de um erro no uso da razão de isenção

### 4.5.0
* FEATURE: Adicionado filtro moloni_before_product_stock_sync

### 4.4.7
* FIX: Correção no sumário dos produtos nos documentos

### 4.4.6
* FIX: Correção de um erro interno na criação de registos

### 4.4.2
* FEATURE: Adicionado modo DEBUG
* FIX: Correção de erro no cálculo da percentagem de taxas

### 4.4.1
* FEATURE: Adição de nova mensagem de erros quando as séries não estão registadas
* FIX: Correção na inserção de clientes

### 4.4.0
* FEATURE: Adicionada nova razão de isenção para envios para zonas extra comunitárias
* FIX: Correção de um erro na pesquisa de impostos

### 4.3.0
* FEATURE: Adicionado botão para descarregar documentos na página da encomenda na área de cliente
* FEATURE: Adicionado filtro moloni_before_moloni_product_insert
* FEATURE: Adicionado filtro moloni_before_moloni_product_update


### 4.2.2
* FIX: Correção em artigos com descontos na criação de notas de crédito
* FEATURE: Envio via e-mail de erros e alertas durante a criação de notas de crédito

### 4.2.1
* FEATURE: Adicionada criação automática de Notas de crédito

### 4.1.3
* FIX: Correção na criação de documentos
* MINOR: Testado até à versão 6.3 do Wordpress
* MINOR: Testado até à versão 8.0.2 do WooCommerce

### 4.1.2
* FIX: Correção nos portes de envio.

### 4.1.1
* FIX: Correção na criação de encomendas com artigos devolvidos.

### 4.1.0
* FEATURE: Marcar encomendas como geradas em bulk
* UPDATE: Melhorias no sistema de logs

### 4.0.0
* FEATURE: Novo sistema de logs.
* FEATURE: Adicionado suporte para multisite.
* MINOR: Testado até à versão 6.2.2 do Wordpress
* MINOR: Testado até à versão 7.7.0 do WooCommerce

### 3.0.88
* UPDATE: Melhorias na criação/atualização de produtos de forma automática
* MINOR: Testado até à versão 6.2 do Wordpress
* MINOR: Testado até à versão 7.5.1 do WooCommerce

### 3.0.87
* MINOR: Melhoria no tratamento de erros na autenticação.

### 3.0.86
* FIX: Correção de erro no agendamento de crons.

### 3.0.85
* FIX: Apresentação de erro verboso quando artigos da encomenda já não existem.
* FIX: Omitir mesagem de sucesso na criação de documentos se processo for cancelado.

### 3.0.84
* MINOR: Remover atualização automática do Tipo de Mercadoria AT.

### 3.0.82
* FIX: Correção de erro na edição de artigos em versões antigas do WooCommerce.

### 3.0.81
* FIX: Correção na sincronização de stocks em artigos com variantes

### 3.0.80
* FEATURE: Adicionado suporte para encomendas HPOS do WooCommerce
* MINOR: Testado até à versão 7.2.2 do WooCommerce

### 3.0.79
* FIX: Corrigido alerta PHP.
* MINOR: Testado até à versão 6.1.1 do Wordpress
* MINOR: Testado até à versão 7.2.0 do WooCommerce

### 3.0.78
* FEATURE: Adicionado filtro moloni_before_pending_orders_fetch.
* MINOR: Testado até à versão 6.0.3 do Wordpress
* MINOR: Testado até à versão 7.0.0 do WooCommerce

### 3.0.77
* FIX: Correção de erro na descarga de documentos
* UPDATE: Adicionada nova página para utilizadores sem empresas válidas
* MINOR: Testado até à versão 6.0.2 do Wordpress
* MINOR: Testado até à versão 6.9.4 do WooCommerce

### 3.0.76
* FEATURE: Nova opção para envio de e-mail em caso de erro no plugin

### 3.0.75
* FEATURE: Nova opção para criar documento de transporte
* UPDATE: Atualizado logotipo e banner
* MINOR: Testado até à versão 6.0.1 do Wordpress
* MINOR: Testado até à versão 6.8.0 do WooCommerce

### 3.0.74
* UPDATE: Tentativas depois de falha ao inserir/atualizar documentos

### 3.0.73
* UPDATE: Atualizadas todas as URLs do plugin

### 3.0.72
* UPDATE: Atualizadas versões testadas

### 3.0.71
* UPDATE: Atualizada a posição do menu para combatibilidade com WooCommerce 6.4.0 

### 3.0.70
* MINOR: Melhoria na pesquisa e criação de categorias


### 3.0.69
* FIX: Correção de alerta

### 3.0.68
* FIX: Prevenção de perdas de autenticação
* FEATURE: Nova opção para definir a morada de carga
* MINOR: Testado até à versão 5.9.1 do Wordpress
* MINOR: Testado até à versão 6.2.1 do WooCommerce

### 3.0.67
* FIX: Aplicação da taxa por defeito da empresa caso o artigo não tenha impostos.

### 3.0.66
* FIX: Removido uso da taxa por defeito da empresa.
* FIX: Restaurada cache de taxas na inserção.

### 3.0.65
* FEATURE: Novo hook que corre após atualização do plugin
* FEATURE: Nova opção para CAE
* MINOR: Testado até à versão 5.8.2 do Wordpress
* MINOR: Testado até à versão 5.9.0 do WooCommerce

### 3.0.64
* FIX: Correção da verificação da zona fiscal

### 3.0.63
* FIX: Correção da verificação da zona fiscal

### 3.0.62
* CHANGE: Alteração na definição da zona fiscal
* FIX: Melhorias nas rotinas de sincronização de stocks

### 3.0.61
* CHANGE: Alteração das tabelas da base de dados para usarem o prefixo definido no WooCommerce
* FIX: Correção de impostos de taxas com valor reduzido

### 3.0.60
* FIX: Correção de impostos de taxas com valor reduzido

### 3.0.59
* FEATURE: Acrescentada, caso seja ativado nas definições do plugin, uma coluna na listagem de encomendas WooCommerce para descarregamento rápido de documentos.

### 3.0.58
* MINOR: Testado até à versão 5.8 do Wordpress
* MINOR: Testado até à versão 5.6.0 do WooCommerce
* FIX: Correção em encomendas com produtos devolvidos

### 3.0.57
* CHANGE: Alteração nas taxas de produtos compostos
* FIX: Corrigido de erro com métodos de entrega inválidos

### 3.0.56
* FEATURE: Adicionado filtro moloni_after_close_document após fecho de documentos
* FIX: Corrigido método de cálculo do valor de pagamento

### 3.0.55
* MINOR: Prevenção de alertas de constantes

### 3.0.54
* MINOR: Manter visibilidade do produto na atualização.

### 3.0.53
* FIX: Prevenção de criação de documentos repetidos (através de hooks)
* MINOR: Pesquisa de produtos retorna produtos inativos.

### 3.0.52
* FEATURE: Possibilidade de definir uma razão de isenção para vendas fora da Europa
* MINOR: Comparações rigorosa

### 3.0.51
* FIX: Alterada a forma como é definido o stock de um artigo durante a sincronização

### 3.0.49
* CHANGE: Alterada visibilidade de algumas propriedades para poderem ser alteradas nos filtros de criação de documentos

### 3.0.48
* FIX: Correção de erro no PHP 8.

### 3.0.47
* FEATURE: Adicionado filtro moloni_before_start_document no inicio do processo de criação de documento
* FEATURE: Adicionado filtro moloni_before_insert_document antes da criação do documento
* FEATURE: Adicionado filtro moloni_after_insert_document após da criação do documento

### 3.0.46
* MINOR: Testado até à versão 5.7 do Wordpress
* MINOR: Testado até à versão 5.1.0 do WooCommerce
* FIX: Correção de comportamento do plugin quando são feitos pedidos à API Rest do WooCommerce.

### 3.0.45
* MINOR: Testado até à versão 5.6.2 do Wordpress
* FIX: Correção de comportamento do plugin quando são feitos pedidos à API Rest do WooCommerce.

### 3.0.44
* MINOR: Testado até à versão 5.5.1 do Wordpress

### 3.0.43
* CHANGE: Colocação automática da taxa de IVA por defeito caso não tenha razão de isenção selecionada

### 3.0.42
* FEATURE: Adicionada opção para definir o estado do stock de um artigo quando o artigo é sincronizado com stock igual a zero
* FEATURE: Adicionada opção para atualização de stocks com base num armazém apenas
* FEATURE: Adicionada opção para escolher se o nome deverá ser usado para a referência do artigo ou não
* FEATURE: Adicionada a meta tag _ywbc_barcode_display_value para que possa ser usada como EAN
* FEATURE: Adicionado filtro moloni_admin_menu_permission para as permissões de administrador

### 3.0.41
* FIX: Erros de notificação na página de opções após primeiro login

### 3.0.40
* CHANGE: Na criação de um artigo, se não tiver referência, passou a ser usado o ID do artigo como base da referência
* FIX: Na atualização de artigos, passamos a limpar as taxas antes de atualizar, de forma a evitar taxas duplicadas

### 3.0.37
* FEATURE: Adicionada possibilidade de emissão de faturas pró-forma

### 3.0.34
* FEATURE: Adicionados Hooks moloni_after_order_shipping_setName e moloni_after_order_shipping_setSummary para que seja alterado o nom e resumo dos portes
* CHANGE: Solidificar o método de renovação das tokens com retry e log
* FIX: Tratar da codificação do nome das categorias em caracteres como &

### 3.0.33
* FEATURE: Método de expedição adicionado automaticamente

### 3.0.32
* FEATURE: Utilização de artigos compostos
* FIX: Verificação extra para prevenir preços negativos

### 3.0.31 =
* FIX: Remover criação de erro ao criar um documento quando o Hook corre no Front End

### 3.0.30 =
* CHANGE: Passou a sér possível emitir documentos diretamente da encomenda quando a mesma está no estado "wc-pending" e "wc-on-hold"
* FIX: Quando um artigo "filho" é atualizado no WooCommerce, passou também a correr a ação de atualização de artigos do Moloni

### 3.0.29 =
* FEATURE: Permitir a escolha entre criar documento quando a encomenda passa a "Completa" ou "Em Processamento"
* FEATURE: Permitir escolher o tipo de documento diretamente na página da encomenda
* CHANGE: A opção "Tem Stock" passa a ser controlada pela opção do WooCommerce "Gerir stock"
* CHANGE: Caso um artigo "Atributo" não tenha preço, deverá ser usado o preço do artigo "Pai"
* FIX: Remover as tags do nome do artigo

### 3.0.28
* CHANGE: Permitir sincronização de artigos com variações. Os artigos "Filhos" são criados individualmente no Moloni e com os dados corretos

### 3.0.27
* FEATURE: Adição de hook para a alteração do resumo do artigo
* FEATURE: A funcionalidade de inserir/atualizar artigos foi dividida em duas, uma própria para inserir, outra para atualizar
* FEATURE: Adicionada nova opção para usar os dados dos artigos que estão no Moloni (nome e resumo), caso já existam
* CHANGE: O campo EAN passou a não ser atualizado caso esteja vazio
* CHANGE: Validação correta das taxas/isenções

### 3.0.26
* FIX: Correção do carregamento de ficheiros .js e .css

### 3.0.25
* FIX: Correção da ordem das taxas

### 3.0.24
* FIX: Verificação da taxa nos artigos - Verificar se a taxa é do tipo IVA

### 3.0.22
* FEATURE: Criação de vários níveis de categorias e sub-categorias

### 3.0.2
* FEATURE: Inserção de métodos de pagamento
* FIX: Formulário de login na página do artigo

### 3.0.19
* FEATURE: Suporte a Orçamentos

### 3.0.18
* FEATURE: Suporte a Orçamentos

### 3.0.18
* CHANGE: Melhoria no cálculo das taxas de Portes
* FIX: Preços atualizados deverão ter em conta se os artigos têm IVA incluído ou não
* FIX: Strip Slashes da password

### 3.0.17
* FIX: Melhorias na validação dos códigos postais

### 3.0.16
* FIX: Alterações no câmbio

### 3.0.15
* FEATURE: Utilização de moedas de câmbio

### 3.0.13
* FEATURE: Paginação na listagem de encomendas pendentes

### 3.0.12
* CHANGE: Emissão de documentos em bulk
* FIX: Razões de isenção em taxas de 0%

### 3.0.11
* CHANGE: Consulta de logs
* CHANGE: Limpeza de logs
* FIX: Sincronização de stocks