Catalogo & SKU
Prodotti, varianti, misure, pesi, gerarchia e attributi partono da Protheus e arrivano all'e-commerce, con versionamento e rollback per lotto.
TOTVS Protheus + E-commerce
Protheus collegato all'e-commerce — in tempo reale, con fatturazione elettronica
Il mid-market brasiliano gira su TOTVS Protheus. Se la tua operazione in Brasile o America Latina utilizza Protheus, la CCX Company lo integra con VTEX, Shopify, Salesforce Commerce e Magento — catalogo, giacenze, prezzi, ordini B2C/B2B e fatturazione elettronica — con conformità fiscale locale e osservabilità end-to-end.
- API REST native di Protheus (FWREST, ADVPL/TLPP)
- VTEX, Shopify, Salesforce Commerce e Magento
- Catalogo, giacenze, prezzi, ordini e fatturazione elettronica in tempo reale
- Middleware su AWS/GCP con code e retry
- Conformità fiscale locale: fatturazione elettronica e regimi d'imposta
- Squad che lavorano fianco a fianco con il team Protheus del cliente
Protheus 12+
Cloud o on-prem
4-6
Mesi progetto tipico
99.9%
SLA integrazione
NF-e
End-to-end
Perché integrare Protheus
Protheus nel core, e-commerce sul fronte
Protheus porta decenni di maturità nell'operatività fiscale, finanziaria e logistica in Brasile. Ben integrato, diventa il motore affidabile dell'operazione digitale senza bisogno di essere sostituito.
Protheus è l'ERP più diffuso nel mid-market brasiliano
Contiene già le regole fiscali, contabili e operative del business
Sostituirlo con SAP o Oracle è costoso e raramente giustificato
Un e-commerce ben integrato trasforma Protheus in un motore di vendita online
Riduce il lavoro manuale, le divergenze e i ritardi nella fatturazione
Abilita marketplace, D2C e B2B sullo stesso ERP
Architettura
Tre modi per collegare Protheus all'e-commerce
Basso volume
API REST dirette
L'e-commerce chiama le API di Protheus (FWREST) e viceversa tramite webhook. Integrazione diretta, senza layer intermedio. Semplice e rapida per operazioni fino a ~500 ordini/giorno.
Volume + resilienza
Middleware dedicato
Layer su AWS/GCP con code (SQS, Pub/Sub), retry idempotenti, DLQ e osservabilità. Isola Protheus dai picchi di traffico e assorbe i guasti transitori.
Grande volume di dati
ETL + Batch
Per cataloghi voluminosi o dati analitici. ETL giornaliero/orario verso data lake o warehouse, sincronizzando master e report senza stressare l'ERP.
Flussi coperti
Sei flussi essenziali in produzione
Prezzi & Listini
Listini, liste, negoziazione B2B, promozioni e sconti calcolati in Protheus e pubblicati per canale e segmento.
Giacenze & Disponibilità
Giacenze per filiale, centro di distribuzione e riserva in tempo reale. Integrazioni con WMS e split-order per ordini multi-origine.
Ordini B2C e B2B
L'ordine dell'e-commerce entra in Protheus, orchestra credito, giacenza riservata, spedizione e restituisce lo stato fino alla consegna finale.
Fatturazione & Finance
Emissione della fattura elettronica tramite l'autorità fiscale (SEFAZ), documento allegato all'ordine, registrazione contabile e sincronizzazione con i crediti verso clienti nel finance di Protheus.
Anagrafiche
Clienti privati/aziende con identificativo fiscale, indirizzi, contatti, listino collegato e condizioni di pagamento. Sincronizzazione bidirezionale quando necessario.
Piattaforme supportate
Integriamo Protheus con le principali piattaforme di commerce
VTEX
Shopify Plus
Salesforce Commerce
Magento 2
Conformità fiscale locale
Integrazione con il rigore fiscale brasiliano
Fatturazione elettronica
Emissione, annullamento, nota di correzione e verifica dello stato tramite l'autorità fiscale (SEFAZ), integrati nel ciclo dell'ordine.
Imposte statali e sostituzione d'imposta
Calcolo delle imposte statali, della sostituzione d'imposta e del differenziale d'aliquota in base allo stato di origine e destinazione, direttamente in Protheus.
Regime fiscale
Il regime fiscale del cliente viene considerato nel calcolo delle imposte e nella generazione del documento fiscale.
Documenti di trasporto
Nelle operazioni con logistica propria, anche i documenti fiscali di trasporto entrano nel flusso.
Analisi approfondita
Architettura di integrazione per il mid-market
Le operazioni mid-market brasiliane hanno le loro particolarità: ERP Protheus nel core, operatività fiscale complessa, team IT snelli e budget sensibili al costo delle licenze. La CCX Company progetta integrazioni che rispettano questa realtà. Quando il volume è modesto, usiamo le API REST di Protheus direttamente contro la piattaforma di commerce, con webhook per gli eventi. Quando il volume cresce, o l'operazione acquisisce marketplace e più filiali, introduciamo un middleware con code e osservabilità, senza obbligare il cliente a licenziare un hub costoso come MuleSoft o CPI. Il percorso è incrementale, sostenibile e scalabile.
Mappatura dei campi e dizionario dati
Metà del successo di un'integrazione Protheus sta nella mappatura dei campi. Ogni tabella (SA1, SB1, SC5, SD1) ha decine di colonne, molte personalizzate. I campi fiscali (codici di classificazione, origine, aliquote) devono viaggiare corretti verso l'e-commerce e viceversa. Gli attributi di prodotto (colore, taglia, voltaggio) spesso risiedono in campi liberi da normalizzare. La CCX avvia ogni progetto con un workshop di data mapping insieme al team Protheus del cliente o al partner TOTVS, producendo un dizionario vivo che guida l'implementazione ed evita sorprese in fase di collaudo.
Orchestrazione ordine → fattura → consegna
Il flusso dell'ordine in un'operazione brasiliana ha più passaggi che in altri mercati: credito, riserva della giacenza, calcolo fiscale, emissione della fattura elettronica, autorizzazione dell'autorità fiscale, prelievo, spedizione, documento di trasporto in alcuni casi e aggiornamento del consumatore. La CCX orchestra tutto con correlation id che permettono di tracciare ogni passaggio in Protheus, nell'e-commerce e nel middleware. Ogni evento rilevante (autorizzazione, fattura emessa, ordine fatturato, pacco spedito, consegna completata) aggiorna l'ordine nell'e-commerce e attiva le notifiche al cliente. I guasti diventano task nel flusso operativo, non ordini bloccati in silenzio.
Mid-market: SAP è costoso, il foglio di calcolo non scala
Molte aziende mid-market restano in un limbo: Protheus va bene nel core, ma l'e-commerce cresce e le integrazioni manuali non stanno al passo. Migrare a SAP è costoso e lungo, esportare CSV non scala, e i connettori generici di mercato coprono solo il 60% del necessario. La CCX offre una terza via: integrazioni su misura, ma in ambito contenuto, con middleware leggero, costi prevedibili e ownership chiara. Molte operazioni passano da 2-3 giorni di ritardo su ordine/fattura al near real-time in 4 mesi, senza toccare l'ERP e senza licenziare nulla di nuovo e pesante.
FAQ
Domande frequenti
O Protheus tem APIs REST prontas para integração?
Sim. Desde a versão 12, Protheus expõe APIs REST nativas via FWREST e ADVPL. Os módulos SIGAFAT, SIGAFIS, SIGACOM e outros possuem endpoints padrão para catálogo, pedido, estoque, preço e financeiro — além de permitir endpoints customizados em ADVPL/TLPP.
É possível integrar Protheus com VTEX?
Sim, é um dos cenários mais comuns no mercado médio brasileiro. A CCX integra Protheus com VTEX cobrindo catálogo, estoque, preço, pedido B2C e B2B, emissão de NF-e e atualização de status. Usamos APIs REST do Protheus combinadas com APIs e webhooks da VTEX.
Preciso de middleware para integrar Protheus?
Depende do volume e da complexidade. Em operações menores, integração direta API-to-API funciona. Em volumes maiores ou com múltiplas plataformas (ex: Protheus + VTEX + marketplaces), recomendamos middleware com filas e observabilidade — em AWS, GCP ou on-premise.
Como é feito o fluxo de NF-e?
O pedido entra no ecommerce, é enviado ao Protheus, que reserva estoque, calcula impostos e emite a NF-e via SEFAZ. O XML e DANFE retornam para o ecommerce, são anexados ao pedido do cliente e enviados por email/WhatsApp. Status fiscais (autorizada, cancelada, rejeitada) ficam sincronizados.
Quanto tempo leva um projeto de integração Protheus + ecommerce?
Para o escopo core (catálogo, estoque, preço, pedido, NF-e), projetos ficam tipicamente entre 2 e 4 meses. Escopos ampliados com B2B, múltiplas filiais, marketplaces conectados e regras fiscais complexas podem chegar a 6 meses.
A CCX customiza o Protheus?
Não somos especialistas em ADVPL/TLPP puro, mas trabalhamos junto com o time Protheus do cliente ou parceiro TOTVS. Nosso foco é a camada de integração: APIs, middleware, mapeamento de campos, orquestração de pedido e resiliência. Isso permite dividir escopo claro entre as partes.
Protheus Cloud ou on-premise faz diferença para integração?
Pouca. Protheus Cloud expõe as mesmas APIs REST via TOTVS Fluig/TLPP Web. Em on-premise, é necessário cuidar de acesso de rede (VPN, tunelamento ou exposição segura). Os patterns de integração (pedido, estoque, preço) são idênticos.
Quais plataformas de ecommerce vocês conectam com Protheus?
VTEX (IO e Classic), Shopify Plus, Salesforce Commerce Cloud, Magento 2, Wake e plataformas custom com APIs. Para marketplaces, conectamos via hub central (ex: Olist, Anymarket) ou diretamente com Mercado Livre, Amazon e Magalu.
Parliamone
Pronto a integrare Protheus con il tuo e-commerce?
In due sessioni mappiamo API, flussi e aspetti fiscali e consegniamo ambito, cronoprogramma e una stima realistica dell'effort.
+55 11 96140-1372 • [email protected]