📘 DOCUMENTAÇÃO TÉCNICA – COMPATIBILIZADOR MERCOS
Fonte: UPDMP01.prw
Rotina: UPDMP01 / MP_PROCESSA
Tipo: Compatibilizador de Dicionário de Dados – TOTVS Protheus
Integração: TOTVS Protheus ↔ MERCOS
1. Visão Geral da Rotina
A rotina UPDMP01 é responsável por preparar, validar e compatibilizar toda a estrutura de dados necessária para a integração entre o TOTVS Protheus e a plataforma MERCOS. Trata-se de um compatibilizador completo de dicionário, com impacto direto em tabelas, campos, índices, parâmetros e estrutura física do banco de dados.
A execução ocorre para todas as empresas cadastradas na tabela SM0, garantindo compatibilidade multiempresa.
- Criação e atualização de tabelas customizadas (SX2)
- Criação e padronização de campos de integração (SX3)
- Criação e validação de índices (SIX)
- Criação de parâmetros (SX6)
- Criação de triggers de integração (SX7)
- Criação de pastas de menu (SXA)
- Inclusão de consultas padrão (SXB)
- Criação/ajuste das tabelas físicas no banco (X31UpdTable)
2. Tabelas Criadas / Atualizadas pelo Compatibilizador (SX2)
O compatibilizador cria ou atualiza 17 tabelas no dicionário SX2, sendo 16 tabelas customizadas (MP*) e 1 tabela de apoio (SZT).
MP0 – Configurações Gerais da Integração
Arquivo: MP0{Empresa}0
Chave: MP0_FILIAL + MP0_CODIGO
Tabela-mestra da integração MERCOS, centralizando parâmetros globais, URLs, tokens e regras de comportamento.
MP1 – Entidades de Saída (Protheus → MERCOS)
Arquivo: MP1{Empresa}0
Chave: MP1_FILIAL + MP1_CTAMP + MP1_TPREG + MP1_IDPROT
Controla as entidades exportadas do Protheus para a MERCOS.
MP2 – Log de Integração de Saída
Arquivo: MP2{Empresa}0
Registra logs detalhados do processo de exportação.
MP3 – Entidades de Entrada (MERCOS → Protheus)
Arquivo: MP3{Empresa}0
Chave: MP3_FILIAL + MP3_CTAMP + MP3_TPREG + MP3_IDMP + MP3_IDPROT
Registra dados recebidos da MERCOS para processamento no Protheus.
MP4 – Log de Integração de Entrada
Arquivo: MP4{Empresa}0
Registra logs detalhados do processo de importação.
MPA – Cliente × Tabela de Preço
Arquivo: MPA{Empresa}0
Chave: MPA_FILIAL + MPA_CLIENT + MPA_LOJA
Define quais tabelas de preço cada cliente utiliza na integração MERCOS.
MPB – Cliente × Condição de Pagamento
Arquivo: MPB{Empresa}0
Chave: MPB_FILIAL + MPB_CLIENT + MPB_LOJA
Determina as condições de pagamento permitidas para clientes integrados.
MPC – Formas de Pagamento
Arquivo: MPC{Empresa}0
Chave: MPC_FILIAL + MPC_FORMA
Define formas de pagamento disponíveis na MERCOS e seu vínculo com Protheus.
MPD – Produtos Especiais
Arquivo: MPD{Empresa}0
Chave: MPD_FILIAL + MPD_COD
Tabela para produtos tratados de maneira especial na integração.
MPE – Tipos de Pedido
Arquivo: MPE{Empresa}0
Chave: MPE_FILIAL + MPE_TIPO
Mapeia tipos de pedidos do Protheus ↔ MERCOS.
MPF – Status de Pedido
Arquivo: MPF{Empresa}0
Chave: MPF_FILIAL + MPF_STATUS
Mapeia os diversos status de pedidos entre Protheus e MERCOS.
MPG – Cliente × Vendedor
Arquivo: MPG{Empresa}0
Chave: MPG_FILIAL + MPG_CLIENT + MPG_LOJA
Amarra qual vendedor MERCOS atende cada cliente do Protheus.
MPH – Campos Extras MERCOS
Arquivo: MPH{Empresa}0
Chave: MPH_FILIAL + MPH_COD
Mantém campos customizados (extras) usados pela MERCOS.
MPI – Tags MERCOS
Arquivo: MPI{Empresa}0
Chave: MPI_FILIAL + MPI_TAG
Tabela de definição de tags disponíveis na MERCOS.
MPJ – Cliente × Tags
Arquivo: MPJ{Empresa}0
Chave: MPJ_FILIAL + MPJ_CLIENT + MPJ_LOJA
Relaciona quais tags cada cliente possui.
SZT – Configurações Complementares
Arquivo: SZT{Empresa}0
Tabela de apoio com parâmetros específicos do módulo SIGAFAT.
3. Campos Criados, Padronizados e Migrados (SX3)
A rotina UPDMP01 utiliza como núcleo de padronização o bloco aTabCpo, responsável por definir todas as tabelas e campos que participam do controle de transmissão da integração MERCOS.
Esse bloco é processado dinamicamente pela rotina, executando:
- Validação da existência do campo no SX3
- Criação automática do campo quando inexistente
- Ajuste da estrutura física via X31UpdTable
- Inicialização dos valores de controle
- Migração de dados de campos legados, quando informado
Tipo
C(1) · Prefixo _XMP_ · Finalidade: Controle de transmissão/sincronização3.1 Estrutura Técnica do Bloco aTabCpo
Cada posição do array possui o formato:
{"TABELA", "CAMPO_NOVO", "CAMPO_LEGADO"}Quando o terceiro parâmetro é informado, a rotina realiza migração automática do conteúdo do campo legado para o novo campo.
3.2 Tabelas Nativas do Protheus Impactadas
| Tabela | Campo | Observação |
|---|---|---|
| SA1 | A1_XMPTRAN | Clientes transmitidos |
| SA4 | A4_XMPTRAN | Vendedores transmitidos |
| SB1 | B1_XMPTRAN | Produtos transmitidos |
| SB5 | B5_XMPTRAN | Família de produtos |
| SBM | BM_XMPTRAN | Marca de produtos |
| SB2 | B2_XMPTRAN | Saldo/estoque |
| DA0 | DA0_XMPTRA | Migra de DA0_XMPINT |
| DA1 | DA1_XMPTRA | Financeiro |
| SE4 | E4_XMPTRAN | Migra de E4_XMPINTE |
| SE1 | E1_XMPTRAN | Títulos financeiros |
| SC5 | C5_XMPTRAN | Pedidos de venda |
| AOV | AOV_XMPTRA | Controle auxiliar |
| ACY | ACY_XMPTRA | Controle auxiliar |
| ACU | ACU_XMPTRA | Controle auxiliar |
| ACV | ACV_XMPTRA | Controle auxiliar |
| AC8 | AC8_XMPTRA | Condição de pagamento |
| SU5 | U5_XMPTRAN | Relações comerciais |
| SUM | UM_XMPTRAN | Unidade de medida |
| AGB | AGB_XMPTRA | Agenda / Workflow |
3.3 Tabelas Customizadas Impactadas (MP*)
| Tabela | Campo |
|---|---|
| MPA | MPA_XMPTRA |
| MPB | MPB_XMPTRA |
| MPC | MPC_XMPTRA |
| MPD | MPD_XMPTRA |
| MPE | MPE_XMPTRA |
| MPF | MPF_XMPTRA |
| MPG | MPG_XMPTRA |
| MPH | MPH_XMPTRA |
| MPI | MPI_XMPTRA |
| MPJ | MPJ_XMPTRA |
3.4 Tabela de Configuração
| Tabela | Campo | Finalidade |
|---|---|---|
| SZT | ZT_XMPTRAN | Controle de transmissão de parâmetros |
4. Outros Objetos Criados
- SX6: Parâmetros de integração
- SX7: Triggers de controle de transmissão
- SIX: Índices de performance
- SXA: Pasta de menu MERCOS
- SXB: Consultas padrão administrativas
5. Fluxo Técnico de Execução
- Usuário executa o compatibilizador UPDMP01
- Rotina percorre todas as empresas cadastradas na SM0
- Atualiza SX2, SX3, SX6, SX7, SXA, SXB e SIX
- Atualiza/cria estruturas físicas via X31UpdTable
- Gera log de execução
6. Conclusão Técnica
O fonte UPDMP01 implementa toda a base estrutural necessária para a integração MERCOS no Protheus, garantindo rastreabilidade, controle de sincronização e aderência ao padrão TOTVS de compatibilização.
Recomendação: Nenhuma das estruturas criadas deve ser removida em processos de upgrade ou manutenção do ambiente.