Com o crescimento do comércio eletrônico B2C e B2B e a expansão para marketplaces (Mercado Livre, Amazon, Magalu), ter uma integração em tempo real e à prova de falhas entre a loja virtual e o ERP Protheus® deixou de ser diferencial e virou pré-requisito de sobrevivência comercial.

Sem uma integração estruturada, ocorrem problemas graves como a venda de produtos sem estoque (overselling), atrasos no faturamento e emissão de Nota Fiscal Eletrônica (NF-e), além de erros de conciliação financeira de gateways de pagamento (PagSeguro, Mercado Pago, Adyen, Stripe). Neste artigo, detalhamos a arquitetura de integração perfeita.

1. A Arquitetura de Comunicação via API REST (AppServer WebService)

No Protheus, a forma mais moderna e performática de integrar plataformas digitais é através de APIs RESTful desenvolvidas em TLPP ou AdvPL e publicadas no AppServer HTTP. Esqueça integrações legadas via arquivos TXT, CSV ou acesso direto via ODBC/banco de dados (que violam a integridade e regras de negócio do ERP).

Endpoints essenciais na API de integração:

GET /api/v1/products/stock: Consulta de saldo de estoque disponível (Estoque Físico menos Reservas).
POST /api/v1/orders: Inclusão automática de Pedidos de Venda (tabelas SC5/SC6).
GET /api/v1/orders/{id}/status: Rastreamento do status do pedido e código de rastreio de logística.
GET /api/v1/invoices/{id}/pdf: Download do DANFE em PDF e XML da nota fiscal emitida.

2. Gestão de Saldo de Estoque: Evitando o Overselling

Um dos maiores pesadelos do e-commerce é vender um item que já teve seu saldo zerado na loja física ou em outro canal. Para resolver isso no Protheus:

Estoque Reservado (MATA410): Assim que a venda é aprovada no e-commerce, o pedido é inserido no Protheus gerando empenho/reserva imediata no produto (campo C6_QTDEMP).
Webhook de Atualização Ativa: Em vez da plataforma de e-commerce consultar o Protheus a cada segundo, o Protheus dispara um Webhook para a loja virtual sempre que houver movimentação de estoque nas tabelas SB2/SD3.
Margem de Segurança (Estoque de Segurança): Configuração de uma regra de negócio na API para expor à loja virtual apenas 90% ou 95% do saldo real de itens de altíssimo giro.

3. Inclusão Automatizada de Clientes (SA1) e Pedidos (SC5/SC6)

Quando um cliente final faz uma compra na VTEX, Shopify ou Magento, a integração deve:

Verificar pelo CPF/CNPJ se o cliente já existe no cadastro de Clientes (SA1). Se não existir, efetua a inclusão automática (MATA030).
Gerar o Pedido de Venda no Protheus (MATA410) incluindo os itens (SC6), valores de frete, desconto e condicional de pagamento correta.
Gravar o ID do pedido do e-commerce em um campo customizado (ex.: C5_XIDLOJA) para fácil identificação e auditoria.

4. Faturamento Automático e Transmissão de NF-e

Após a gravação do pedido e liberação de crédito, a rotina automatizada de faturamento (MATA460A / MATA461) gera a Nota Fiscal de Saída (SF2/SD2), transmite o lote para o TSS/SEFAZ e envia a chave de acesso e a URL de rastreio de volta para a plataforma de e-commerce em segundos.

Perguntas Frequentes (FAQ)

1. É melhor usar um Hub de Integração (iPaaS) ou criar integração direta com o Protheus?

Para empresas que vendem em múltiplos marketplaces simultaneamente (Mercado Livre, Amazon, Magalu, Shopee), o uso de um Hub de Integração (ex.: Anymarket, Plugg.to, Lexos) intermediando o e-commerce e o Protheus é altamente recomendado, pois centraliza a gestão de anúncios e converte os pedidos em um único formato padronizado para o ERP.

2. Como funciona a conciliação das taxas de cartão de crédito e gateways de pagamento no Protheus?

As vendas de e-commerce entram no Protheus com o título a receber no contas a receber (SE1) alocado no portador do gateway (ex.: PagSeguro ou Adyen). A conciliação automática lê os arquivos de repasse (EDI/API) do gateway e efetua a baixa com o desconto exato da taxa de administração bancária.

3. A integração consome licenças de usuários do Protheus?

As integrações via API REST utilizam licenças de serviço IOT/Webservice (licenças de integração), que possuem custo significativamente reduzido em relação às licenças de usuário concorrente desktop.

4. O que acontece se a internet da empresa cair durante uma venda no e-commerce?

Se a infraestrutura do Protheus for local e a conexão cair, a plataforma de e-commerce ou o middleware de integração armazena as vendas em uma fila segura (Queue/RabbitMQ). Assim que a conexão for restabelecida, a fila é processada e sincronizada sem perda de nenhum pedido.

5. Como a Global ERP apoia na integração de e-commerce?

Desenvolvemos e implementamos APIs REST customizadas de alta performance em TLPP/AdvPL para conectar o Protheus a qualquer plataforma (VTEX, Shopify, Magento, WooCommerce, Tray) ou marketplace, garantindo velocidade, segurança e suporte contínuo.

Protheus®, TOTVS®, Microsiga® e Fluig® são marcas registradas da TOTVS S.A. A Global ERP é consultoria independente, sem afiliação formal com a fabricante. As orientações deste artigo refletem a interpretação técnica da equipe Global ERP e não substituem orientação contábil-jurídica formal.

Acesso Temporariamente