Integração Magento em Portugal
Sincronize produtos, encomendas e envios entre Corp-Merch e Magento para Portugal — para IVA 23% via Portal das Finanças (AT).
Arquitectura — Magento como storefront
Ligue a sua loja Magento a Corp-Merch com a app oficial, com âmbito de leitura de produtos e escrita de encomendas. Novas encomendas em Magento 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 Magento e na mapeação AT, com split bruto/líquido visível antes de cada push.
Como integrar — Webhooks e Admin API Magento
Instale a app Corp-Merch a partir da loja Magento 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 Magento e vão directos para a fila de produção; o tracking referencia a encomenda Magento 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 Magento evitam duplicados nos retries. Ajustes de IVA 23% em reembolsos parciais são recalculados e reemitidos via AT.
Perguntas frequentes
Qual plano Magento precisamos?
Qualquer plano pago que suporte apps custom. Os planos enterprise têm ambientes sandbox + produção e SSO.
Podemos manter Magento como fonte de verdade das encomendas?
Sim — Corp-Merch é o lado fulfillment. Encomendas, clientes e moradas ficam em Magento; só devolvemos estado e tracking.
Como é gerido o IVA?
O IVA 23% é calculado sobre as classes fiscais Magento; facturas emitidas via Portal das Finanças (AT) após fulfillment.
Suportam multi-moeda?
Sim — Corp-Merch segue a presentment currency de Magento; o settlement é EUR para Portugal.
Onde aparece o IVA 23%?
Na linha da encomenda no admin Magento e no dashboard Corp-Merch antes do push, discriminado para o finance validar.