Integração Teorema X Pluggto

---
title: Integração Teorema X Pluggto
slug: integracao-teorema-x-pluggto
sistema: 
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
autor: Gabriel Faria
setor: Qualidade
modulo: Integração Pluggto
versao_doc: 01
revisao: Andreia Burko Bley
aprovado_em: 10/2023
release: Manuais 2023
versao_pipeline: 2.6.0
publico: ""
keywords:
  - Pluggto
  - integração
  - marketplace
  - pedidos
  - sincronização
  - configurações
  - operação fiscal
chamado: ""
ultima_revisao: "2026-06-12"
---

## Visão Geral

A integração entre os Sistemas Teorema e a plataforma Plugg.to permite gerenciar pedidos recebidos de marketplaces conectados, sincronizar itens disponíveis para venda e configurar regras fiscais, tabelas de preço e condições de pagamento por canal de venda. A configuração é realizada no Teorema Integrador em conjunto com a equipe de suporte de segundo nível.

## Acessar o Teorema Integrador

Acesse `integrador.teorema.inf.br`, informe suas credenciais de e-mail e senha e clique em **Entrar**.

![Tela de login do Teorema Integrador com campos E-mail e Senha, botão Entrar e opção Entrar com Google](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-01.png)

## Verificar Pedidos Sincronizados

Na seção **Pedidos**, visualize todos os pedidos processados pelo integrador e seus respectivos status. O status **SYNCED** indica que o pedido foi sincronizado com sucesso e está disponível no sistema para tratamento normal.

![Seção Pedidos do Teorema Integrador exibindo lista de pedidos com colunas ID, Cliente, Data, Valor e Status; pedidos com status SYNCED originados do MercadoLivre e Shopee](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-02.png)

## Consultar Itens Disponíveis para Venda

A seção **Itens** exibe os produtos marcados como webservice no Módulo Gestão Administrativa que estão disponíveis para venda nas plataformas integradas ao Plugg.to. A coluna **Sincronização** indica o status de cada item (Ok).

![Seção Itens do Teorema Integrador com lista de produtos, colunas REF, Descrição, Sincronização, Message, ID Int e ID Int sku, todos com status Ok](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-03.png)

## Configurar Dados de Homologação

Os dados necessários para a homologação da integração (URL da API, Client ID, Client Secret, Username e Password) devem ser obtidos junto ao cliente e à plataforma Plugg.to e repassados à equipe de suporte de segundo nível, responsável pela configuração e pelos testes de integração.

> ⚠️ **Atenção:** Os campos Client Secret e Password são credenciais sensíveis. Não compartilhe esses valores por canais não seguros. Solicite à equipe responsável a rotação dessas credenciais após a homologação.

![Tela Configurações do Teorema Integrador com campos Nome loja, Alias, Tabela de preço (TABELA DE PRECOS), Operação Fiscal (VENDA MARKETPLACE - D.E.), Condição de pagamento (MARKETPLACE), SKU e, no painel lateral, campos de integração Plugg.to com a URL visível e os valores de Client ID, Client Secret, Username e Password ocultados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-04.png)

## Definir Configurações Padrão da Integração

As configurações padrão determinam como os pedidos e itens serão processados para todos os canais da integração. Configure os campos exibidos na aba da loja no Teorema Integrador, incluindo tabela de preços, operação fiscal, condição de pagamento e tipo de SKU.

![Tela Configurações do Teorema Integrador com destaque nos campos Nome loja (Lesouk Plugg.To), Alias (lesouk), Tabela de preço (TABELA DE PRECOS), Operação Fiscal (VENDA MARKETPLACE - D.E.), Condição de pagamento (MARKETPLACE) e SKU (Item Reduzido); painel lateral com campos de integração Plugg.to (valores de credencial ocultados) e tabela de Configurações de Dimensões](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-05.png)

## Definir Configurações Específicas por Cliente

Além das configurações padrão, é possível definir parâmetros específicos por cliente, como Vendedor, Empresa, Empresa Estoque, Classificação, Dimensões e Campo Nome. A tabela de Configurações de Dimensões mapeia os atributos do sistema (Comprimento, Largura, Altura, model) para os campos correspondentes no Bridgeweb com seus multiplicadores.

![Tela Configurações do Teorema Integrador com destaque nos campos Vendedor (PASHMINA - CLIENTE SITE), Empresa (0005 - LE SOUK COMERCIO DE ACESSORIOS E DECORAC...), Empresa Estoque, Local de estoque, Classificação (VENDA ATACADO INTERNA), Dimensões (Sem Embalagem), Campo Nome (Full Description) e Quantidade mínima de estoque; tabela de Configurações de Dimensões com atributos Comprimento/measureLength, Largura/measureWidth, Altura/measureThickness e model/observationsOther](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-06.png)

## Ajustar Opções de Sincronização

Configure as opções adicionais de sincronização disponíveis na aba da loja. Os campos a serem ignorados (name e special_price) impedem que esses atributos sejam sobrescritos durante a sincronização.

| Opção | Valor |
|---|---|
| Ativar Sincronização de Faturamento | Desmarcado |
| Enviar Marca dos Itens | Desmarcado |
| Enviar Fotos dos Itens | Marcado |
| Não Sincronizar Pedidos | Desmarcado |
| Ativar Sincronização de Itens | Marcado |
| Sincronizar Apenas Itens Integrados | Marcado |
| Ignorar Pedidos ML | Desmarcado (parcialmente visível) |

**Campos a ser ignorados:** name, special_price.

![Tela Configurações do Teorema Integrador com lista de opções de sincronização (checkboxes) e tabela Campos a ser ignorados com entradas name e special_price](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/integracao-teorema-x-pluggto/integracao-teorema-x-pluggto-07.png)

## Configurar Situações Fiscais Específicas por Marketplace

Quando há necessidade de operação fiscal, vendedor ou condição de pagamento distintos por marketplace ou canal de venda, cadastre as situações fiscais específicas na seção correspondente das Configurações.

| Marketplace | Canal de Venda | Estado | Operação Fiscal | Vendedor | Condição de Pagamento | Ignorar Valor do Frete |
|---|---|---|---|---|---|---|
| Olist | | PARANÁ | VENDA MARKETPLACE OLIST - VAREJO - D.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE - OLIST | Desmarcado |
| Olist | | | VENDA MARKETPLACE OLIST - VAREJO - F.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE - OLIST | Desmarcado |
| Camicado | | PARANÁ | VENDA MARKETPLACE CAMICADO - VAREJO - D.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE- CAMICADO | Desmarcado |
| Camicado | | | VENDA MARKETPLACE CAMICADO - VAREJO - F.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE- CAMICADO | Desmarcado |
| MercadoLivre | BESHA SELLER4 | | VENDA MARKETPLACE MERCADO LIVRE - VAREJO - F.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE - MERCADO LIVRE | Desmarcado |
| MadeiraMadeira | | PARANÁ | VENDA MARKETPLACE MADEIRA MADEIRA - VAREJO - D.E. | MARKETPLACE - JOÃO VICTOR ALBUQUERQUE MEDEIROS | MARKETPLACE - MADEIRA MADEIRA | Desmarcado |
| MadeiraMadeira | | | VENDA MARKETPLACE MADEIRA... | MARKETPLACE - JOÃO VICTOR... | MARKETPLACE -... | Desmarcado |

## Informações do documento

> Autor: Gabriel Faria
> Setor: Qualidade
> Módulo: Integração Pluggto
> Chamado:
> Versão do Sistema: 23.07a
> Versão do documento: 01
> Revisão: Andreia Burko Bley
> Aprovado em: 10/2023

---

> 📎 **Arquivos originais:** [Integração Teorema x Pluggto.docx](https://drive.google.com/uc?export=download&id=1vXbcqDcGLIddYchfxWhm9GtUdz7stg0F) · [Integração Teorema x Pluggto.pdf](https://drive.google.com/uc?export=download&id=1MbfJnjKiftiPJ3QLcUTRi620ibq2mS4T)