Integração WooCommerce em Portugal
Sincronize produtos, encomendas e envios entre Corp-Merch e WooCommerce para Portugal — para IVA 23% via Portal das Finanças (AT).
Arquitectura — WooCommerce como storefront
Ligue a sua loja WooCommerce a Corp-Merch com a app oficial, com âmbito de leitura de produtos e escrita de encomendas. Novas encomendas em WooCommerce são replicadas na nossa pipeline de fulfillment; envios e tracking voltam. O mapa SKU é mantido no dashboard com overrides por variante, para que packs e bundles em Portugal reconciliem limpamente. O IVA 23% é calculado no servidor com base nas classes fiscais WooCommerce e na mapeação AT, com split bruto/líquido visível antes de cada push.
Como integrar — Webhooks e Admin API WooCommerce
Instale a app Corp-Merch a partir da loja WooCommerce e autorize os scopes: read_products, read_orders, write_orders, write_fulfillments. Subscrevemos orders/create, orders/paid e orders/cancelled. Webhooks de saída de Corp-Merch (order.shipped, return.received, invoice.issued) voltam ao seu endpoint ou directamente para a timeline da encomenda como notas — incluindo o id de factura AT para reconciliação de AP em Portugal.
Operação e casos extremos — Reembolsos, devoluções, artigos custom
Artigos custom (merch made-to-order) saltam o inventário WooCommerce e vão directos para a fila de produção; o tracking referencia a encomenda WooCommerce original. Reembolsos e devoluções são especulares, para que o finance veja uma fonte de verdade única. Chaves de idempotência derivadas dos ids de encomenda WooCommerce evitam duplicados nos retries. Ajustes de IVA 23% em reembolsos parciais são recalculados e reemitidos via AT.
Perguntas frequentes
Qual plano WooCommerce precisamos?
Qualquer plano pago que suporte apps custom. Os planos enterprise têm ambientes sandbox + produção e SSO.
Podemos manter WooCommerce como fonte de verdade das encomendas?
Sim — Corp-Merch é o lado fulfillment. Encomendas, clientes e moradas ficam em WooCommerce; só devolvemos estado e tracking.
Como é gerido o IVA?
O IVA 23% é calculado sobre as classes fiscais WooCommerce; facturas emitidas via Portal das Finanças (AT) após fulfillment.
Suportam multi-moeda?
Sim — Corp-Merch segue a presentment currency de WooCommerce; o settlement é EUR para Portugal.
Onde aparece o IVA 23%?
Na linha da encomenda no admin WooCommerce e no dashboard Corp-Merch antes do push, discriminado para o finance validar.