=== OurivesWeb ===
Contributors: ponto25
Tags: faturação, ourivesaria, woocommerce, invoicing, stock
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.1
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

Liga a loja WooCommerce ao Ourives: faturação certificada das encomendas e catálogo da ourivesaria sincronizado, com tamanhos e peças únicas.

== Description ==

O Ourives é o software de gestão para ourivesarias da PONTO 25 - Informática Lda, certificado pela Autoridade Tributária com o n.º 1541.

Este plugin liga a loja WooCommerce ao Ourives. As encomendas são faturadas no Ourives e os artigos do Ourives aparecem na loja, sem passar nada à mão.

= Faturação das encomendas =

* Faturas, faturas simplificadas, faturas-recibo, guias e outros documentos do Ourives, emitidos automaticamente quando a encomenda muda de estado, ou à mão, uma a uma ou em massa.
* O documento tem sempre o mesmo total que a encomenda, ao cêntimo. Se o total não bater, o documento fica suspenso no Ourives para rever, em vez de sair errado.
* Cada linha leva o artigo, o tamanho e a peça vendida, para o stock do Ourives baixar no sítio certo.
* Notas de crédito nos reembolsos, associadas à linha da fatura, e recibos para faturas pagas.
* Campo de NIF no checkout (clássico e por blocos), com validação do NIF português. Sem NIF, o documento sai para consumidor final.
* PDF do documento na encomenda e, se quiser, na área "A minha conta" do cliente.
* Registo de tudo o que é enviado e email de alerta quando alguma coisa falha.

= Catálogo da ourivesaria =

O catálogo é gerido no Ourives e a loja acompanha-o.

* Vão para a loja os artigos marcados para a web no Ourives. Um artigo escondido ou inativo passa a rascunho na loja.
* O preço é o PVP do Ourives que escolher nas definições.
* Os tamanhos de um artigo passam a variações do mesmo produto, cada uma com o seu stock.
* Cada peça com número de série é um produto, com o seu preço e o seu peso. Quando a peça é vendida, na loja ou ao balcão, sai da loja.
* Imagens do artigo, categorias pela família e subfamília, matéria e toque como atributos.
* O stock na loja é o do Ourives menos o que já foi vendido online e ainda não foi faturado.
* Nada é apagado. O que deixa de estar à venda passa a rascunho e volta quando voltar a estar disponível no Ourives.
* Depois da primeira importação completa, a loja é atualizada de 5 em 5 minutos.

O nome, os preços, o stock e os atributos de um produto do Ourives voltam aos valores do Ourives na sincronização seguinte, mesmo que tenham sido alterados na loja. A descrição longa só é escrita na criação do produto, salvo se ativar a opção para a atualizar sempre.

= Requisitos =

* Conta no Ourives, com o código de entidade e a password da empresa.
* As séries dos documentos fiscais têm de estar comunicadas à AT no Ourives.

Todo o suporte técnico e comercial é prestado pela equipa de apoio a clientes do Ourives: apoiotecnico@ponto25.pt

== Installation ==

1. Instale o plugin em Plugins > Adicionar novo, ou envie a pasta `ourivesweb-api` para `/wp-content/plugins/`.
2. Ative o plugin. O WooCommerce tem de estar ativo.
3. No menu "Ourives", ligue com o código de entidade e a password do Ourives.
4. Em Definições, escolha o tipo de documento, a série e quando emitir.
5. Para trazer os artigos, ative a sincronização do catálogo em Definições > Artigos. A primeira importação começa logo a seguir.

== 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 onde ele guarda o NIF.

= Porque ficou um documento suspenso? =

Porque o total calculado não bateu com o da encomenda. O documento fica suspenso no Ourives para o rever e finalizar. As encomendas com peças únicas nunca ficam suspensas: ficam por faturar e recebe um alerta.

= Posso criar artigos na loja e enviá-los para o Ourives? =

Não. Os artigos são criados no Ourives e passam para a loja. Os produtos criados à mão na loja não são alterados pelo plugin, mas para os faturar a referência (SKU) tem de existir no Ourives.

= Uma peça foi vendida ao balcão. Sai da loja? =

Sim, na sincronização seguinte. Para a peça ficar vendida no Ourives também quando é vendida online, o tipo de documento escolhido tem de movimentar stock no Ourives. As definições avisam se não movimentar.

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

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

= Já usava a versão 1. O que acontece ao atualizar? =

A ligação, as definições e os documentos já emitidos são aproveitados. A sincronização do catálogo fica desligada até rever as definições de artigos. Se a ligação falhar, a faturação automática fica parada e recebe um email de alerta.

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

apoiotecnico@ponto25.pt

== Screenshots ==

1. Encomendas pendentes: emitir os documentos uma a uma ou em massa.
2. O documento do Ourives na encomenda, com o PDF.
3. Definições dos documentos: tipo, série e emissão automática.
4. Definições do catálogo: PVP, armazém, campos a importar.
5. Artigos do Ourives visíveis na web, para importar ou atualizar.
6. O artigo do Ourives no produto: stock e última sincronização.

== Upgrade Notice ==

= 2.0.0 =
Passa a usar a API REST do Ourives e traz o catálogo da ourivesaria para a loja. Depois de atualizar, confirme a ligação e reveja as definições de artigos.

== Changelog ==

= 2.0.1 =
* A sincronização do catálogo e a lista de artigos em Ferramentas passam a pedir ao Ourives só os artigos ativos e visíveis na web. Antes também percorriam os artigos inativos, o que tornava a primeira importação muito mais lenta.

= 2.0.0 =
* Nova versão, ligada à API REST do Ourives em vez do serviço SOAP.
* Documentos com o mesmo total da encomenda, linhas com tamanho e peça única, notas de crédito nos reembolsos e recibos para faturas pagas.
* Catálogo do Ourives na loja: tamanhos como variações e cada peça única como produto.
* Campo de NIF no checkout clássico e por blocos.
* Compatível com HPOS. Requer PHP 7.4 ou superior.
* Ao atualizar a partir da 1.x, as credenciais e as definições são aproveitadas.

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