API REST de TOTVS
Camino estándar en entornos actualizados. brisk4 consume los endpoints REST expuestos por Protheus, RM o Datasul, autenticados por token.
Integración · ERP
WhatsApp oficial + TOTVS.
La integración entre brisk4 y TOTVS lleva el dato que ya existe en el ERP a la conversación con el cliente. Vale para Protheus, RM y Datasul, vía API REST del propio TOTVS, webhook o capa intermedia cuando el entorno es personalizado.
Qué sincroniza
Objetos de TOTVS en la conversación.
| Objeto de TOTVS | Dirección | Disparador |
|---|---|---|
| Pedido de venta | TOTVS → brisk4 | El cliente pregunta el estado; brisk4 consulta por número de pedido o CNPJ y responde etapa, previsión y transportista. |
| Título financiero y factura | TOTVS → brisk4 | Solicitud de segunda vía en el chat, o envío automático de recordatorio cuando el título se acerca al vencimiento. |
| Documento fiscal | TOTVS → brisk4 | La facturación del pedido dispara el envío del documento fiscal y su clave de acceso por WhatsApp. |
| Ficha de cliente | brisk4 ↔ TOTVS | La atención identifica al cliente por CNPJ y actualiza contacto y dirección de vuelta en el ERP. |
| Orden de servicio | brisk4 → TOTVS | Una solicitud de asistencia abierta en la conversación se convierte en orden de servicio en el ERP, con historial y adjuntos. |
Flujos listos
Qué entra en vivo primero.
- Segunda vía de factura sin filaEl cliente pide la segunda vía en WhatsApp, brisk4 valida el CNPJ, consulta el título abierto en TOTVS y devuelve la factura con código de barras y línea digitable. Sin pasar por finanzas.
- Estado de pedido en autoservicioLa consulta por número de pedido o CNPJ devuelve etapa de producción, facturación, transportista y código de seguimiento, leídos directo de Protheus.
- Apertura de orden de servicio desde el chatLa IA hace el triaje, identifica el equipo y el contrato, abre la orden de servicio en el ERP y devuelve el número del ticket en la misma conversación.
Cómo conectamos
Método y prerrequisitos.
Webhook de evento
Facturación, liquidación de título y cambio de estado disparan la notificación. Evita polling y mantiene el mensaje en el momento correcto.
Capa intermedia
Para entornos muy personalizados o versiones antiguas, diseñamos un middleware o lectura directa de la base en la implantación.
- Productos cubiertos
- TOTVS Protheus, TOTVS RM y TOTVS Datasul
- Acceso necesario
- Usuario de integración con permiso de lectura en los módulos involucrados
- Entorno
- TOTVS en la nube u on-premise con el servidor accesible por la red
- Licenciamiento
- Módulo o usuario de API según tu contrato TOTVS
- Alcance de escritura
- Definido en la implantación, con aprobación de tu equipo de TI
- Homologación
- Entorno de prueba del ERP antes de cualquier llamada en producción
Preguntas frecuentes
TOTVS y brisk4: dudas.
¿brisk4 se integra con TOTVS Protheus?
Sí. La integración con TOTVS Protheus se hace por la API REST del propio ERP, por webhook de evento o por una capa intermedia cuando el entorno tiene personalización pesada. Los objetos más usados son pedido de venta, título financiero, documento fiscal, ficha de cliente y orden de servicio.
¿La integración vale también para RM y Datasul?
Sí. El mismo método se aplica a TOTVS RM y TOTVS Datasul. Lo que cambia entre líneas son los endpoints y el nombre de los objetos, mapeados en la implantación junto a tu equipo.
¿Necesito instalar algo en mi servidor TOTVS?
En la mayoría de los casos, no. Basta un usuario de integración con permiso de lectura y el servidor accesible por la red. Entornos sin API disponible pueden exigir un componente intermedio, definido en el diagnóstico.
¿El cliente puede sacar la segunda vía de factura solo?
Sí, es uno de los flujos más pedidos. El cliente lo pide en WhatsApp, brisk4 valida la identificación, consulta el título abierto en TOTVS y devuelve la factura con línea digitable, sin pasar por finanzas.
Míralo funcionando en tu TOTVS.
En el diagnóstico gratuito un especialista releva tu línea TOTVS, qué expone y qué flujo da retorno más rápido.