=== Marvinerp ===
Contributors: ponto25
Tags: faturação, invoicing, woocommerce, encomendas, at
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.3
WC requires at least: 7.0
WC tested up to: 11.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Faturação certificada das encomendas WooCommerce no Marvin ERP, com clientes, artigos e stock.

== Description ==

O Marvin ERP é um produto da PONTO 25 - Informática Lda, certificado pela Autoridade Tributária com o número 1539.

Com este plugin a loja WooCommerce fica ligada ao Marvin ERP:

* Emissão automática ou manual de faturas, faturas simplificadas, faturas-recibo, pró-formas, orçamentos e guias a partir das encomendas, também em massa.
* Documentos suspensos para rever antes de finalizar, e proteção contra documentos duplicados.
* Totais iguais aos da encomenda ao cêntimo, com cupões, portes, taxas e preços com ou sem IVA; se não baterem, o documento fica suspenso em vez de sair errado.
* IVA de outros países da UE (OSS) e motivos de isenção para vendas fora da UE.
* Notas de crédito automáticas nos reembolsos e recibos para faturas pagas.
* Clientes e artigos criados no Marvin quando aparecem numa encomenda.
* Artigos criados e atualizados no Marvin quando são gravados na loja, com a imagem e a família escolhida por categoria.
* Stock do Marvin na loja de 5 em 5 minutos, total ou de um armazém.
* Ferramentas para importar artigos do Marvin para a loja e para acertar o stock do Marvin com o da loja.
* Campo de NIF no checkout (clássico e por blocos) com validação do NIF português.
* PDF dos documentos no painel da encomenda e, opcionalmente, na área "A minha conta" do cliente.
* Registos e alertas por email quando algo falha.

Todo o suporte técnico e comercial é prestado pela equipa de Apoio a Clientes do Marvin ERP.

== Installation ==

1. Instale o plugin pelo instalador de plugins do WordPress ou envie a pasta `marvinerp-api` para `/wp-content/plugins/`.
2. Ative o plugin. O WooCommerce tem de estar ativo.
3. Em "Marvin ERP", ligue com o código de entidade e a password do Marvin e escolha o tipo de documento e a série.

== Frequently Asked Questions ==

= Preciso de outro plugin para o NIF? =

Não. O plugin acrescenta o campo NIF ao checkout. Se já usa outro plugin para isso, indique nas definições o campo da encomenda onde ele guarda o NIF.

= A série tem de estar comunicada à AT? =

Sim, para documentos fiscais as séries têm de estar comunicadas à AT no Marvin. As séries por comunicar aparecem assinaladas nas definições.

= De onde vem o stock? =

Do Marvin. A loja nunca envia stock para o Marvin ao gravar um artigo; só a ferramenta "Acertar stock no Marvin" o faz, quando pedido.

= Como associo categorias a famílias? =

Em Definições > Artigos e stock, na tabela "Categorias e famílias". Cada artigo fica com a família da sua categoria mais específica que estiver na tabela; os restantes ficam com a família por defeito.

= Tenho várias lojas ligadas à mesma entidade Marvin =

Defina um "Prefixo da referência da encomenda" diferente em cada loja, para o plugin nunca confundir encomendas de lojas diferentes.

= Tenho dúvidas ou sugestões, quem posso contactar? =

apoiotecnico@ponto25.pt

== Screenshots ==

1. Encomendas pendentes: gerar documentos uma a uma ou em massa.
2. O documento do Marvin no painel da encomenda, com o PDF e a opção de gerar novamente.
3. Definições: tipo de documento, série, estado e isenções de IVA.
4. Ferramentas: artigos e stock do Marvin, criar artigos na loja e acertar stock.

== Upgrade Notice ==

= 2.0.3 =
As séries criadas no Marvin depois de ligar a loja aparecem logo nas definições.

= 2.0.2 =
Os artigos criados ou atualizados a partir da loja passam a levar a imagem para o Marvin.

= 2.0.1 =
Corrige o total dos documentos em lojas com preços sem IVA. Recomendado para todos.

== Changelog ==

= 2.0.3 =
* Definições: uma lista vazia do Marvin (por exemplo, ainda sem séries) deixa de ficar guardada 12 horas; as séries criadas a seguir aparecem ao fim de um minuto.
* "Atualizar dados do Marvin" passa a funcionar também em sites com cache de objetos (Redis, Memcached).
* Ligação: o browser deixa de preencher a entidade e a password com o login do WordPress.

= 2.0.2 =
* A imagem principal do artigo é enviada para o Marvin quando o artigo é criado ou atualizado a partir da loja, se ainda não tiver imagem no Marvin.

= 2.0.1 =
* Lojas com preços sem IVA: o total do documento passa a ser sempre igual ao da encomenda, mesmo quando o WooCommerce arredonda o IVA linha a linha. Uma diferença de 1 cêntimo já não sai como documento final.
* Ferramentas: preços dos artigos do Marvin mostrados em euros.


= 2.0.0 =
* Nova versão, ligada à API REST do Marvin ERP.
* Ao atualizar a partir da 1.x, as credenciais e as definições são aproveitadas automaticamente. Se a ligação falhar, a faturação automática fica parada e é enviado um email de alerta.
* Requer PHP 7.4 ou superior.

= 1.1.0 =
* Versão ligada ao serviço SOAP.
