EmerSoftwareSoftware Factory
Líder em Manufatura & Varejo BR

Integração de Agentes de IA com TOTVS Protheus e RM

Potencialize o maior ERP do Brasil com agentes de IA capazes de interagir com ADVPL, REST APIs e tabelas SZ.

A EmerSoftware conecta agentes inteligentes ao TOTVS Protheus com respeito à arquitetura AppServer e licenças de integração. Automatize emissão de NFe, entrada de notas e gestão de estoque sem sobrecarregar a equipe técnica interna.

100%

Compatibilidade com ExecAuto padrão

85%

Redução no tempo de lançamento de notas fiscais

SPED

Total conformidade com obrigações fiscais brasileiras

Arquitetura Enterprise

Como o EmerAgents orquestra fluxos no TOTVS Protheus & RM

O EmerAgents se comunica com o TOTVS Protheus via API REST oficial do AppServer ou microsserviços intermediários que disparam rotinas automáticas (ExecAuto). Isso assegura que todos os gatilhos, validações de dicionário (SX3) e regras fiscais sejam integralmente cumpridos.

Fluxo Arquitetural Semântico
[ XML Danfe / Fornecedores / WMS ]
                 │
                 ▼
┌──────────────────────────────────────────────────┐
│            EmerAgents Fiscal AI Engine           │
│  - Regras Tributárias Brasileiras (ICMS/PIS/COF) │
│  - Mapeamento Inteligente de TES & CFOP          │
│  - Human Oversight para Divergências             │
└────────────────────────┬─────────────────────────┘
                         │
                         ▼
┌──────────────────────────────────────────────────┐
│          TOTVS Protheus REST API Gateway         │
│          (AppServer / RESTful API Service)       │
└────────────────────────┬─────────────────────────┘
                         │
                         ▼
┌──────────────────────────────────────────────────┐
│      TOTVS ExecAuto (MATA103, MATA410, etc.)     │
│      Validação de Dicionário SX e Banco SX3      │
└──────────────────────────────────────────────────┘
01

Captura do Documento / Evento

Recepção de XML de NFe, espelho de pedido ou demanda de suprimentos.

02

Classificação Fiscal Inteligente

O agente determina TES, CFOP e tributações com base no histórico tributário da empresa.

03

Chamada ao ExecAuto Protheus

Envio dos dados estruturados via API REST disparando a validação nativa de regras.

04

Feedback e Atualização de Status

Retorno imediato do número de documento gerado ou alerta de inconsistência cadastral.

totvs-execauto-tool.ts
Tool de Integração com API REST do TOTVS Protheus
import { createAgentTool } from "@emersoft/emeragents-core";
import { totvsRestClient } from "./totvs-client";
import { z } from "zod";

export const registerInvoiceProtheusTool = createAgentTool({
  name: "totvs_register_supplier_invoice",
  description: "Registra nota fiscal de entrada no TOTVS Protheus via MATA103.",
  schema: z.object({
    docNumber: z.string(),
    serie: z.string(),
    supplierCode: z.string(),
    store: z.string().default("01"),
    items: z.array(z.object({
      productCode: z.string(),
      quantity: z.number(),
      unitPrice: z.number(),
      tes: z.string(),
    })),
  }),
  execute: async (data) => {
    // Envia requisição ao endpoint Protheus com validação ExecAuto
    const response = await totvsRestClient.post("/api/framework/v1/invoices", data);
    return {
      status: "SUCCESS",
      protheusDocId: response.documentInternalId,
      message: "Nota fiscal integrada e contabilizada com sucesso no Protheus.",
    };
  },
});

Vantagens estratégicas da integração com a EmerSoftware

Respeito às Validações Nativas do Protheus

Nada de gravar direto no SQL e corromper índices: uso estrito das rotinas oficiais de integridade.

Inteligência Fiscal Brasileira Embutida

Capacidade de cruzar NCM, alíquotas estaduais e regimes especiais antes de submeter ao ERP.

Alívio Imediato para Equipes de TI e Suporte

Menos chamados internos para lançamentos manuais ou correções de lotes com erro de amarração.

People Also Ask — Perguntas Frequentes

Dúvidas técnicas sobre integração de IA com TOTVS Protheus & RM

Como agentes de IA podem interagir com o TOTVS Protheus sem ferir as licenças?↓

A integração é feita através dos serviços REST oficiais do AppServer ou via integração assíncrona por mensageria (Kafka/RabbitMQ), utilizando usuários de integração devidamente licenciados, sem violação dos termos de uso da TOTVS.

O agente pode errar a TES (Tipo de Entrada e Saída) na emissão de notas?↓

O EmerAgents utiliza regras determinísticas acopladas ao raciocínio semântico: caso o grau de certeza na classificação tributária não seja de 100% ou surja um novo produto sem histórico, o fluxo é automaticamente desviado para um gatekeeper humano com a sugestão pré-preenchida.

Pronto para orquestrar agentes no TOTVS Protheus & RM?

Solicite o Diagnóstico 30/60/90 com nossos arquitetos de software e receba o blueprint completo de integração segura com conformidade e governança.

WhatsApp (15) 99143-7215
Integração TOTVS Protheus com Agentes de IA | EmerSoftware | EmerSoftware