Quincefin ↔ OpenCart & Horoshop
Quincefin ↔ Shops Sync é um middleware de integração entre o QUINCEFIN (contabilidade / gestão de inventário) e as lojas online:
- OpenCart 2.3
- Horoshop
O QUINCEFIN é o sistema principal para a gestão de stock e preços. O middleware fica entre os sistemas: recebe eventos, obtém os dados completos de produtos e encomendas e envia as alterações para as lojas online (e também recupera as encomendas das lojas para o QUINCEFIN).
O sistema existe porque:
- Os webhooks do QUINCEFIN enviam apenas um id e um timestamp — é necessário confirmar a receção, obter novamente os dados reais e distribuí-los pelas lojas.
As chaves de API estão restringidas por endereço IP; as lojas têm limites de pedidos.
- O OpenCart 2.3 não possui uma API integrada para gerir stock ou preços.
- Um único serviço com um IP fixo, uma fila e um sistema de correspondência de produtos/encomendas mantém todos os dados consistentes.
O que o sistema faz
QUINCEFIN → lojas
O stock e os preços de venda a retalho são sincronizados com o OpenCart (e, opcionalmente, com o catálogo Horoshop). Os webhooks dos produtos são agrupados, de modo que várias alterações realizadas rapidamente resultem numa única atualização. Uma reconciliação noturna deteta quaisquer dados que possam ter sido ignorados pelos webhooks.
### Lojas → QUINCEFIN
As encomendas novas e atualizadas são obtidas a cada 5 minutos para o QUINCEFIN como documentos de venda (`OC-…` para OpenCart, `HS-…` para Horoshop), com os dados do cliente no comentário, os descontos aplicados às linhas e um nome fixo para o parceiro de retalho.
As páginas de estado do operador (`/status`, registos de encomendas, live probes) mostram o estado dos canais, as execuções recentes e as encomendas associadas sem utilizar o painel de administração da loja.
Plugin OpenCart: Dimoks Sync
O Dimoks Sync é uma pequena extensão para OpenCart 2.3 (tipo: Feed) instalada na loja OpenCart.
É um módulo completo e visível no painel de administração (Extensions → Feeds → Dimoks Sync), e não apenas um conjunto de ficheiros independentes. Disponibiliza uma API JSON protegida por token que é utilizada pelo middleware.
Definições do administrador
- Ativar / desativar a integração
- Sync token (deve corresponder a `OPENCART_TOKEN` no serviço middleware)
- Campo de chave do produto: `model` ou `sku` (referência / artigo utilizado para associar o produto ao QUINCEFIN)
- Indicação do endpoint para o URL de ping
O que a API do módulo disponibiliza
- Ping — verificação do estado e da versão
- Products — leitura e atualização da quantidade, preço e estado através da referência do artigo
- Orders — obtenção da lista de encomendas alteradas desde um determinado timestamp (para importação no QUINCEFIN)
- Optional order status push back to OpenCart — envio opcional do estado da encomenda de volta para o OpenCart
Sem este módulo, o OpenCart 2.3 não pode ser controlado pelo QUINCEFIN para atualizar o stock e os preços.
Numa única frase
O middleware mantém o stock e os preços do QUINCEFIN sincronizados com o OpenCart (através do plugin Dimoks Sync) e o Horoshop, e também importa as encomendas das lojas online para o QUINCEFIN como documentos `OC-…` / `HS-…`.