- Inicio
- Integraciones
- Protheus y e-commerce
Protheus conectado al e-commerce, con NF-e.
TOTVS Protheus integrado con VTEX, Shopify Plus, Salesforce Commerce y Magento: catálogo, inventario, precios, pedidos B2C y B2B y factura electrónica, con cumplimiento fiscal brasileño y observabilidad de extremo a extremo.
Protheus tiene décadas de madurez fiscal, financiera y logística en Brasil. Bien integrado, se convierte en el motor confiable de tu operación digital, sin necesidad de reemplazarlo.
Plataformas que conectamos a Protheus
Los mismos flujos de catálogo, inventario, precios, pedidos y NF-e, adaptados a las APIs de cada extremo, para marketplaces, D2C y B2B sobre el mismo ERP.
Por qué CCX en este frente
Integraciones a medida, con alcance acotado, middleware ligero, costo predecible y responsabilidades claras.
Foco en la capa de integración
APIs, middleware, mapeo de campos y orquestación. El ADVPL queda a cargo del equipo Protheus del cliente o del socio TOTVS, con un alcance claro entre las partes.
Diccionario de datos vivo
Todo proyecto empieza con un taller de mapeo de las tablas SA1, SB1, SC5 y SD1 y de los campos fiscales, como CFOP, NCM y CEST, para evitar sorpresas en las pruebas de aceptación.
Camino incremental
APIs directas cuando el volumen es modesto; middleware con colas cuando entran marketplaces y sucursales, sin obligarte a licenciar un hub corporativo de integración.
Codo a codo con tu equipo
Squads que trabajan junto al equipo Protheus del cliente, sin tocar el ERP y sin exigir un cambio de sistema.
Tres capas, con Protheus protegido de los picos
Las APIs de Protheus de un lado, las de la plataforma del otro y, en el medio, un middleware con colas, reintentos idempotentes y DLQ que absorbe picos y fallos transitorios.
- TOTVS ProtheusCloud u on-premise
- APIs RESTFWREST, ADVPL y TLPP
- NF-e en la SEFAZXML y DANFE autorizados
- MiddlewareAWS o GCP, colas y DLQ
- Colas en la nubeAWS SQS o Google Pub/Sub
- APIs y webhooksDel lado del commerce
- VTEXVTEX IO y Classic
- Shopify PlusPedidos y fulfillment
- SalesforceCommerce Cloud B2B y B2C
- Cliente finalEstado, NF-e y DANFE
Arquitectura de referencia para volumen y resiliencia. En operaciones de bajo volumen, las APIs REST de Protheus se comunican directamente con la plataforma, sin middleware.
APIs directas, middleware o ETL: cuándo usar cada uno
Los tres caminos llevan los datos de Protheus al e-commerce. Cambian el volumen, la cantidad de canales y la necesidad de tiempo real.
| Camino | Tiene sentido cuando | Atención |
|---|---|---|
| APIs REST directas (FWREST y webhooks) | La operación tiene bajo volumen, hasta unos 500 pedidos por día, y una plataforma de commerce. | Sin capa intermedia, Protheus recibe directamente los picos de tráfico. |
| Middleware dedicado (AWS o GCP) | El volumen crece, entran marketplaces y varias sucursales, o hay más de una plataforma. | Exige colas, reintentos idempotentes, DLQ y observabilidad diseñados desde el primer release. |
| ETL y batch | Catálogos voluminosos o datos analíticos que van a un data lake o warehouse, sin sobrecargar el ERP. | Corre en ventanas diarias u horarias; los pedidos y el inventario en tiempo real quedan en las APIs o en el middleware. |
Seis flujos que ponemos en producción
Dónde suele fallar la integración entre Protheus y e-commerce, y cómo diseñamos cada flujo.
Catálogo y SKUs
Productos, variaciones, medidas, pesos, jerarquía y atributos salen de Protheus y llegan al e-commerce, con control de versiones y reversión por lote.
Precios 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 y centro de distribución, con reserva en tiempo real, integración con el WMS y división de pedidos con varios orígenes.
Pedidos B2C y B2B
El pedido del e-commerce entra en Protheus, orquesta crédito, reserva de inventario y flete, y devuelve el estado hasta la entrega final.
NF-e y finanzas
Emisión de NF-e vía SEFAZ, DANFE adjunto al pedido, registro contable y sincronización con las cuentas por cobrar de Protheus.
Registros de clientes
Clientes personas físicas y jurídicas con CPF o CNPJ, direcciones, contactos, lista de precios vinculada y condición de pago, con sincronización bidireccional cuando hace falta.
Del pedido a la entrega, con rigor fiscal brasileño
En Brasil, el pedido tiene más etapas que en otros mercados. Las orquestamos todas con un correlation ID: un fallo se convierte en una tarea del flujo operativo, no en un pedido bloqueado en silencio.
- Crédito, reserva de inventario y cálculo fiscal realizados en Protheus.
- NF-e emitida, cancelada, corregida y consultada en la SEFAZ dentro del ciclo del pedido.
- ICMS, ICMS-ST y DIFAL según el estado de origen y de destino, considerando el Simples Nacional.
- MDF-e y CT-e en el flujo cuando la operación tiene logística propia.
- Factura emitida, pedido facturado, envío despachado y entrega completada actualizan el pedido en la tienda.
- Correlation ID para rastrear cada paso en Protheus, en el middleware y en el e-commerce.
Preguntas frecuentes
¿Protheus tiene APIs REST listas para integrar?
Sí. Desde la versión 12, Protheus expone APIs REST nativas mediante FWREST y ADVPL. Los módulos SIGAFAT, SIGAFIS, SIGACOM y otros tienen endpoints estándar para catálogo, pedidos, inventario, precios y finanzas, y además permiten endpoints personalizados en ADVPL o TLPP.
¿Se puede integrar Protheus con VTEX?
Sí, es uno de los escenarios más comunes en el mercado medio brasileño. CCX integra Protheus con VTEX y cubre catálogo, inventario, precios, pedidos B2C y B2B, emisión de NF-e y actualización de estados, combinando las APIs REST de Protheus con las APIs y webhooks de VTEX.
¿Necesito middleware para integrar Protheus?
Depende del volumen y de la complejidad. En operaciones más pequeñas, la integración directa entre APIs funciona. Con volúmenes mayores o varias plataformas, como Protheus, VTEX y marketplaces, recomendamos un middleware con colas y observabilidad, en AWS, GCP u on-premise.
¿Cómo funciona el flujo de NF-e?
El pedido entra en el e-commerce y se envía a Protheus, que reserva inventario, calcula los impuestos y emite la NF-e vía SEFAZ. El XML y el DANFE vuelven al e-commerce, se adjuntan al pedido y se envían al cliente por e-mail o WhatsApp. Los estados fiscales (autorizada, cancelada, rechazada) se mantienen sincronizados.
¿Cuánto dura un proyecto de integración entre Protheus y e-commerce?
Para el alcance core, con catálogo, inventario, precios, pedidos y NF-e, los proyectos suelen durar entre 2 y 4 meses. Los alcances ampliados, con B2B, varias sucursales, marketplaces conectados y reglas fiscales complejas, pueden llegar a 6 meses.
¿CCX personaliza Protheus?
No somos especialistas en ADVPL o TLPP puro, pero trabajamos junto al equipo Protheus del cliente o al socio TOTVS. Nuestro foco es la capa de integración: APIs, middleware, mapeo de campos, orquestación de pedidos y resiliencia. Así, el alcance de cada parte queda claro.
¿Protheus Cloud u on-premise cambia algo en la integración?
Poco. Protheus Cloud expone las mismas APIs REST vía TOTVS Fluig y TLPP Web. En on-premise, hay que ocuparse del acceso de red, con VPN, túneles o exposición segura. Los patrones de integración de pedidos, inventario y precios son idénticos.
¿Qué plataformas de e-commerce conectan con Protheus?
VTEX (IO y Classic), Shopify Plus, Salesforce Commerce Cloud, Magento 2, Wake y plataformas propias con APIs. Para marketplaces, conectamos a través de un hub central, como Olist o Anymarket, o directamente con Mercado Livre, Amazon y Magalu.
Integra Protheus con tu e-commerce.
Treinta minutos con un ingeniero de CCX, sin costo, para mapear APIs, flujos, reglas fiscales y próximos pasos entre Protheus y tu plataforma.