TOTVS Protheus + E-commerce

Protheus conectado al ecommerce — en tiempo real, con NF-e

El mercado medio brasileño funciona en Protheus. CCX Company integra Protheus con VTEX, Shopify, Salesforce Commerce y Magento, cubriendo catálogo, inventario, precio, pedidos B2C/B2B y emisión de facturas—todo con cumplimiento fiscal brasileño y observabilidad de extremo a extremo.

  • APIs REST nativas de Protheus (FWREST, ADVPL/TLPP)
  • VTEX, Shopify, Salesforce Commerce y Magento
  • Catálogo, inventario, precio, pedidos, NF-e en tiempo real
  • Middleware en AWS/GCP con colas y reintentos
  • Cumplimiento fiscal BR: NF-e, ICMS ST, Simples Nacional
  • Squads trabajando lado a lado con tu equipo de Protheus

Protheus 12+

Cloud u on-prem

4-6

Meses típicos de proyecto

99.9%

SLA de integración

NF-e

De extremo a extremo

Por qué integrar Protheus

Protheus en el núcleo, ecommerce en el borde

Protheus trae décadas de madurez en operaciones fiscales, financieras y logísticas en Brasil. Bien integrado, se convierte en el motor confiable de tu operación digital sin necesidad de reemplazo.

Protheus es el ERP más utilizado en el mercado medio brasileño
Ya carga reglas fiscales, contables y operacionales de tu negocio
Reemplazar con SAP u Oracle es costoso y raramente justificado
El ecommerce bien integrado convierte Protheus en un motor de ventas en línea
Reduce el retrabajo manual, discrepancias y retrasos en NF-e
Habilita marketplaces, D2C y B2B en el mismo ERP
Arquitectura

Tres formas de conectar Protheus al ecommerce

Bajo volumen

APIs REST directas

El ecommerce llama APIs de Protheus (FWREST) y viceversa vía webhooks. Integración directa, sin capa intermedia. Simple y rápido para hasta ~500 pedidos/día.

Volumen + resiliencia

Middleware dedicado

Capa en AWS/GCP con colas (SQS, Pub/Sub), reintentos idempotentes, DLQ y observabilidad. Aísla Protheus de picos de tráfico y absorbe fallos transitorios.

Alto volumen de datos

ETL + Batch

Para catálogos grandes o datos analíticos. ETL diario/horario a data lake o warehouse, sincronizando registros maestros e informes sin estresar el ERP.

Flujos cubiertos

Seis flujos esenciales en producción

Catálogo y SKUs

Productos, variaciones, medidas, pesos, jerarquía y atributos fluyen de Protheus al ecommerce, con control de versiones y reversión por lote.

Precio y tablas

Tablas de precios, listas, negociación B2B, promociones y descuentos calculados en Protheus y publicados por canal y segmento.

Inventario y disponibilidad

Inventario por sucursal, centro de distribución y reserva en tiempo real. Integración con WMS y split-order para pedidos de múltiples orígenes.

Pedidos B2C y B2B

El pedido del ecommerce entra en Protheus, orquesta crédito, reserva inventario, arregla envío, y devuelve estado hasta entrega final.

NF-e y finanzas

Emisión de NF-e vía SEFAZ, DANFE adjunto al pedido, entrada contable y sincronización con cuentas por cobrar en Protheus Finance.

Registros

Clientes (persona física/empresa) con CPF/CNPJ, direcciones, contactos, lista de precios vinculada y términos de pago. Sincronización bidireccional cuando sea necesario.

Plataformas soportadas

Integramos Protheus con las principales plataformas BR

VTEX
Shopify Plus
Salesforce Commerce
Magento 2
Cumplimiento fiscal BR

Integración con rigor fiscal brasileño

NF-e y DANFE

Emisión, cancelación, carta de corrección y consulta de estado vía SEFAZ integrados en el ciclo de pedido.

ICMS e ICMS-ST

Cálculo de ICMS, sustitución tributaria y DIFAL según estado de origen y destino, directo en Protheus.

Simples Nacional

Régimen fiscal del cliente considerado en el cálculo de impuestos y generación de documento fiscal.

MDF-e y CT-e

Para operaciones con logística propia, documentos fiscales complementarios también entran en el flujo.

Análisis profundo

Arquitectura de integración para mercado medio

Las operaciones de mercado medio brasileño tienen particularidades: ERP Protheus en el núcleo, operación fiscal compleja, equipos de TI reducidos y presupuestos sensibles a costos de licencia. CCX Company diseña integraciones que respetan esta realidad. Cuando el volumen es modesto, usamos APIs REST de Protheus directamente contra la plataforma de comercio, con webhooks para eventos. Cuando el volumen crece u operaciones ganan marketplaces y múltiples sucursales, introducimos middleware con colas y observabilidad, sin obligar al cliente a licenciar un hub costoso como MuleSoft o CPI. El enfoque es incremental, asequible y escalable.

Mapeo de campos y diccionario de datos

La mitad del éxito de la integración de Protheus está en el mapeo de campos. Cada tabla (SA1, SB1, SC5, SD1) tiene docenas de columnas, muchas personalizadas. Los campos fiscales (CFOP, NCM, CEST, origen) deben viajar correctamente al ecommerce y viceversa. Los atributos del producto (color, tamaño, voltaje) a menudo se encuentran en campos de forma libre que necesitan normalización. CCX comienza cada proyecto con un taller de mapeo de datos junto a tu equipo de Protheus o socio TOTVS, produciendo un diccionario vivo que guía la implementación y evita sorpresas en la puesta en marcha.

Orquestación pedido → NF-e → entrega

El flujo de pedido en operaciones brasileñas tiene más pasos que otros mercados: verificación de crédito, reserva de inventario, cálculo fiscal, emisión de NF-e, autorización SEFAZ, picking, envío, CT-e en algunos casos, y actualizaciones de clientes. CCX orquesta esto con IDs de correlación que te permiten rastrear cada paso en Protheus, ecommerce y middleware. Cada evento relevante (autorización, nota emitida, pedido facturado, paquete enviado, entrega completada) actualiza el pedido en ecommerce y dispara notificaciones de clientes. Los errores se convierten en tareas operacionales, no pedidos silenciosamente atrapados.

Mercado medio: SAP es caro, las hojas de cálculo no escalan

Muchas empresas de mercado medio quedan atrapadas en un limbo: Protheus funciona bien en el núcleo, pero el ecommerce crece y las integraciones manuales no acompañan. Migrar a SAP es costoso y largo, exportar CSV no escala, y los conectores estándar entregan solo 60% de lo necesario. CCX entrega una tercera vía: integraciones personalizadas en alcance reducido, con middleware ligero, costo predecible y propiedad clara. Muchas operaciones pasan de 2–3 días de retraso en pedido/NF a tiempo real aproximado en 4 meses, sin tocar el ERP ni licenciar herramientas pesadas nuevas.

Preguntas frecuentes

Preguntas frecuentes

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.

Vamos a hablar

Listo para integrar Protheus con tu ecommerce?

En dos sesiones mapeamos APIs, flujos, cumplimiento fiscal y entregamos alcance, cronograma y estimación realista de esfuerzo.

+55 (11) 2427-6839 • [email protected]

Integração TOTVS Protheus com E-commerce | CCX Company | CCX Company