Saneamiento del maestro de productos en TOTVS Protheus: guía práctica

Para sanear el maestro de productos en TOTVS Protheus, empiece por los campos que cambian el comportamiento del sistema: tipo de producto, grupo, las dos unidades de medida y su factor de conversión, el TES estándar de entrada y de salida, origen y alícuota de IPI. Para sacar de uso un duplicado, cuente con el bloqueo por el campo B1_MSBLQL o con una regla de negocio en la rutina FATA100, no con la eliminación. Y lleve un registro propio de cada cambio, porque el historial nativo de Protheus solo guarda la descripción y el margen de ganancia.

Protheus es el ERP brasileño desarrollado por TOTVS. Una escena común: llega la solicitud de un código nuevo para guantes de nitrilo. La analista consulta los productos y encuentra tres parecidos: uno en el grupo "0002 Borracha" (caucho), uno sin grupo y uno con tipo MC (material de consumo) que la planta usa como materia prima. Con la cola de solicitudes llena, el camino más corto es abrir el primero de la lista, usar la opción "Cópia" (copia) y liberar el código nuevo. El cuarto código nace con el mismo grupo, el mismo tipo y el mismo TES estándar del original, correctos o no.

Este artículo trata de lo que es propio de Protheus dentro del saneamiento del maestro de materiales y productos: el maestro de productos (rutina MATA010), los grupos de productos (MATA035) y el bloqueo de registros (MSBLQL). La revisión general campo por campo, válida para cualquier sistema, está en nuestro checklist de saneamiento del maestro de materiales.

¿Qué es el maestro de productos en Protheus?

Según la documentación de TOTVS, el maestro "Produtos" (rutina MATA010) contiene la información principal sobre los productos y servicios que la empresa compra, fabrica o suministra, y controla esos productos en todos los módulos del sistema (TDN, Produtos - MATA010). TDN es el portal de documentación técnica de TOTVS. Los campos están en la tabla SB1, con el prefijo B1_, como B1_DESC (descripción) y B1_MSBLQL (indicador de bloqueo).

La misma página recuerda que la definición de producto varía según el sector y el módulo: en el módulo de talleres es una pieza, en gestión ambiental es un residuo, en gestión de transporte es combustible. Por eso un error en la SB1 no se queda en compras. Aparece en inventario, producción, facturación y libros fiscales.

¿El tipo de producto es correcto, y qué cambia si no lo es?

La documentación de TOTVS dice que el campo "Tipo do Produto" (tipo de producto) sirve para agrupar productos y restringir procesos, informes y consultas. Los ejemplos citados son BN (beneficiamiento o procesamiento por terceros), CG (gastos generales), MO (mano de obra), MP (materia prima), PA (producto terminado), PI (producto intermedio) y MC (material de consumo). La empresa puede crear tipos propios en la tabla 02 del módulo "Configurador" (configuración) (TDN, MATA010).

Tres puntos de la misma página orientan el saneamiento:

• Los tipos son solo informativos. El único con tratamiento especial es BN, que identifica productos que la empresa procesa o envía a procesar; estos no se reservan al abrir las órdenes de producción.
• Comprar o producir no depende del tipo. El sistema lo identifica por la existencia del registro maestro y de sus estructuras (listas de materiales).
• Si la empresa usa el tipo en las reglas de asiento contable, los tipos deben ser coherentes con el plan de cuentas.

Nuestra lectura: un MC usado como MP no bloquea compras ni producción, pero distorsiona todo filtro e informe por tipo y, si el tipo entra en la contabilización, puede llevar el asiento a la cuenta equivocada. Por eso corregir el tipo es decisión de contraloría, no solo del equipo de datos maestros. También conviene revisar la propia tabla 02: los tipos creados a lo largo de los años, con nombres parecidos, suelen repartirse la misma familia de ítems.

¿Sus grupos de productos (MATA035) todavía tienen sentido?

Según la documentación de TOTVS, el grupo reúne productos con características comunes (forma, peso, tipo, uso, dimensión) para facilitar su selección en procesos, consultas e informes, y para identificar ítems que necesitan cuidados especiales de manipulación, almacenamiento o embalaje. Las rutinas parametrizadas por grupo aceptan un rango de grupos, y todos los productos clasificados en ellos entran en el proceso (TDN, Grupos de Produtos - MATA035).

El sistema trae siete grupos registrados, de 0001 a 0007: "Plástico" (plástico), "Borracha" (caucho), "Alumínio" (aluminio), "Eletrônicos" (electrónicos), "Pneumáticos" (neumáticos), "Produtos Químicos" (productos químicos) y "Produto de Venda" (producto de venta). TOTVS dice que son solo sugerencias, que se pueden modificar o eliminar, y que se pueden incluir grupos nuevos en cualquier momento.

La señal de alerta es la base que nunca tocó esas sugerencias. "Produto de Venda" mezcla ítems sin relación entre sí, "Eletrônicos" se vuelve un cajón para todo lo que se enchufa y una parte de los productos queda sin grupo. Como los informes y las rutinas trabajan por rango de grupos, un grupo mal definido hace que el ítem desaparezca del análisis o entre donde no debe. Recomendamos diseñar los grupos a partir de la clasificación que la empresa quiere usar y solo después mover los productos.

Unidad de medida y factor de conversión: ¿qué revisar?

Protheus trabaja con dos unidades. La documentación de TOTVS describe la unidad estándar, usada en todos los movimientos desde la compra hasta la venta, y la segunda unidad, que se obtiene con el factor de conversión y el tipo de conversión, que indica si el sistema multiplica o divide la primera unidad por el factor. El ejemplo de TOTVS: 3 kg, factor 1000, multiplicación, da 3000 gramos. El sistema controla el saldo en las dos unidades, pero el costo unitario refleja la unidad estándar. Cuando no hay un factor fijo, como en ítems que varían con la humedad o el calor, se pueden informar las dos cantidades directamente (TDN, MATA010).

Señales de alerta: tipo de conversión invertido (dividir en lugar de multiplicar), factor fijo en un ítem de peso variable, segunda unidad sin factor en un ítem de conversión fija, y códigos duplicados del mismo ítem con unidad estándar distinta. Este campo requiere revisión ítem por ítem, con quienes compran y reciben el material.

¿Qué campos de la SB1 dependen de decisiones de las áreas fiscal y de compras?

Origen, alícuota de IPI y alícuota de ICMS

En la pestaña "Impostos" (impuestos), la documentación de TOTVS dice que la alícuota de IPI (impuesto federal brasileño sobre productos industrializados) sigue la TIPI, la tabla oficial de alícuotas del IPI. El código de origen (0 nacional, 1 extranjero por importación directa, 2 extranjero adquirido en el mercado interno) se usa en las facturas y en los libros fiscales. La alícuota de ICMS (impuesto estatal brasileño sobre la circulación de mercancías) solo debe informarse para ítems con tributación específica; si no, vale la alícuota interna del parámetro MV_ICMPAD. Las rutinas de entrada y salida solo calculan ICMS, IPI e ISS (impuesto municipal sobre servicios) si el TES utilizado lo indica (TDN, MATA010). TES significa "Tipo de Entrada e Saída", el tipo de operación de entrada y salida de Protheus que define los efectos fiscales, de inventario y financieros.

Señales de alerta: alícuota de ICMS informada en un ítem sin tributación específica, origen distinto entre duplicados del mismo ítem, IPI que no coincide con la clasificación. La revisión de la NCM en sí (el código de clasificación de mercancías del Mercosur usado en los documentos fiscales de Brasil) tiene su propia guía: cómo revisar la NCM en el maestro de materiales.

TE y TS estándar

Los campos "TE Padrão" y "TS Padrão" asignan un TES estándar a las entradas y salidas del producto, usado para calcular impuestos, actualizar el inventario y generar el movimiento financiero. Cambiar el TES estándar en lote cambia impuestos, inventario y finanzas de los movimientos futuros. Decide el área fiscal, junto con contraloría.

Proveedor y sucursal ("Loja Padrão") estándar

Según la documentación, los campos "Fornecedor Padrão" y "Loja Padrão" deben completarse cuando compras usa contratos de asociación y autorizaciones de entrega, con el mismo proveedor del contrato. Si no están completos, el análisis de reposición genera solicitudes de compra en lugar de autorizaciones de entrega. Un proveedor estándar antiguo, o copiado de un código duplicado, cambia la forma en que se compra el ítem.

¿Qué hacer con los productos genéricos "Diversos"?

La propia TOTVS sugiere, como consejo en el maestro de productos, crear productos con códigos como "Genéricos", "Despesas" o "Diversos" (genéricos, gastos, varios) para ítems no almacenables. El recurso es legítimo. El problema aparece cuando no tiene regla de uso: compras recurrentes de ítems que deberían tener código propio pasan por el genérico, y la empresa pierde el historial de precio, proveedor y consumo.

En el saneamiento, recomendamos listar lo que se compró con esos códigos, separar lo que es gasto real de lo que es material recurrente y dejar por escrito cuándo se puede usar el genérico. Los ítems recurrentes reciben código propio, con descripción estandarizada (nuestra guía sobre cómo describir materiales en el maestro ayuda en esa parte).

¿Cómo sacar de circulación un producto duplicado en Protheus?

Antes de tocar el sistema, la empresa tiene que haber decidido qué código se queda. Los criterios para esa elección están en nuestra guía sobre materiales duplicados y cómo identificarlos. Con el par decidido, el proceso en Protheus tiene cuatro pasos, cada uno respaldado por la documentación.

1. No cuente con la eliminación

TOTVS informa que no es posible eliminar un producto si forma parte de la "Sugestão de Orçamento" (sugerencia de presupuesto) (TDN, MATA010). Nuestra lectura: aun cuando la eliminación se acepta, para un duplicado el bloqueo suele ser el camino más seguro, porque mantiene el código y el historial vinculado a él, como muestra el paso siguiente.

2. Bloquee con el campo B1_MSBLQL

Según la documentación de TOTVS, el bloqueo de registros en Protheus se hace con el campo MSBLQL; si la tabla no lo tiene, se crea en el módulo "Configurador". En el módulo de facturación, el bloqueo impide seleccionar el registro en transacciones nuevas, como un nuevo pedido de venta. El estado y el historial ya generados siguen siendo válidos y se pueden manipular normalmente, y el bloqueo vale solo desde el momento en que se aplicó (TDN, FAT0099 MSBLQL).

3. Revise la producción antes de bloquear

La misma página advierte que B1_MSBLQL impide seleccionar el producto en nuevos pedidos de venta, pero también impide procesar la orden de producción, si la empresa las usa. Si el duplicado todavía tiene una orden de producción por procesar, bloquearlo ahora traba esa orden.

4. Si solo hay que detener las ventas, use una regla de negocio

Como alternativa, TOTVS indica incluir el producto en una regla de negocio en la rutina "Regras de Negócio" (FATA100), pestaña "Comercialização" (comercialización), como regla de excepción. Los pedidos de venta con ese producto pasan a quedar bloqueados por regla de negocio (TDN, FAT0099 MSBLQL). En la práctica, recomendamos la regla de negocio mientras terminan las órdenes de producción del código antiguo, y B1_MSBLQL cuando ya nada dependa de él.

¿Protheus guarda el historial de lo que se cambió en el saneamiento?

Solo en parte. La documentación de TOTVS dice que, con el parámetro MV_HISTTAB igual a .T., cada cambio confirmado en el maestro de productos se registra en la tabla AIF ("Alterações Cadastrais", cambios de registros maestros). Pero el control solo registra cambios en la descripción del producto y en el margen de ganancia: los campos B1_DESC, B1_PICMENT y B1_PICMRET (estos dos son el margen de ganancia usado en el cálculo del ICMS por sustitución tributaria, el ICMS-ST, en los campos "Solid. Entr." y "Solid. Saída" de la pestaña "Impostos", no el margen comercial). La tabla AIF la usa el equipo fiscal, con la función MSCONHIST para consultar el historial (TDN, MATA010).

Tipo, grupo, unidades, factor de conversión, TES estándar, origen, proveedor estándar y bloqueo quedan fuera de ese historial. En nuestra lectura, en un saneamiento son justamente los campos que más cambian. Por eso cada lote necesita su propio registro, con código, campo, valor anterior, valor nuevo, fecha y quién aprobó.

¿Por qué la opción de copia propaga el error?

TOTVS presenta la opción "Cópia" (copia), en el menú de mantenimiento de productos, como una forma de agilizar el registro. Copia el producto de origen con todo lo que tiene. Si el ítem de origen está en el grupo equivocado, con el tipo equivocado o con un TES estándar desactualizado, el código nuevo lo hereda todo, como en la escena del inicio. Mientras la base no esté saneada, recomendamos copiar solo de productos modelo ya revisados.

¿Qué revisar en cada recurso de Protheus, y quién decide?

La columna "quién decide" es una recomendación nuestra, no una regla de TOTVS. Ajústela a la estructura de su empresa.

Recurso o campo de Protheus	Qué revisar	Señal de alerta	Lote o ítem por ítem	Quién decide
"Tipo do Produto" (tabla 02)	Si el tipo refleja el uso real; si los tipos propios de la tabla 02 se superponen	MC usado como MP; tipos con nombres parecidos; BN en un ítem que nunca va a procesamiento	Lote por grupo, después de aprobar la regla	Contraloría (si el tipo entra en la contabilización) con datos maestros
Grupos de productos (MATA035)	Si los grupos 0001 a 0007 se adaptaron; si todo producto tiene grupo	Productos sin grupo; grupo genérico con ítems sin relación	Diseño de grupos ítem por ítem; reasignación en lote	Datos maestros con abastecimiento
Unidad estándar, segunda unidad, factor y tipo de conversión	Coherencia entre las dos unidades y el sentido de la conversión	Multiplicar en lugar de dividir; factor fijo en ítem de peso variable	Ítem por ítem	Abastecimiento y almacén
Origen, alícuota de IPI, alícuota de ICMS	Origen 0, 1 o 2; IPI según la TIPI; ICMS solo con tributación específica	Origen distinto entre duplicados; ICMS informado sin motivo	Ítem por ítem, con validación fiscal	Área fiscal
TE y TS estándar	Si el TES estándar todavía corresponde a la operación del ítem	TES antiguo; TES distinto entre códigos del mismo ítem	Lote solo después de probar en ambiente de homologación	Área fiscal con contraloría
Proveedor y sucursal ("Loja Padrão") estándar	Si coinciden con el contrato de asociación, cuando lo hay	Solicitud de compra generada donde se esperaba una autorización de entrega	Ítem por ítem	Compras
Productos genéricos ("Diversos", "Despesas")	Qué se compró con ellos y con qué frecuencia	Material recurrente comprado siempre por el genérico	Análisis ítem por ítem; regla de uso para todos	Compras con contraloría
B1_MSBLQL y regla de negocio (FATA100)	Si el duplicado todavía tiene orden de producción o pedido por procesar	Duplicado sin bloqueo; bloqueo que trabó una orden de producción	Decisión del par ítem por ítem; bloqueo en lote	Datos maestros con planificación de producción y ventas
MV_HISTTAB y tabla AIF	Si el parámetro está activo y qué registra	Equipo que cree que el sistema guarda todo el historial	Configuración única	TI con el área fiscal

¿Cómo se ve esto en un caso concreto? (ejemplo hipotético)

Ejemplo hipotético, creado solo para ilustrar. No es un caso de cliente.

Una industria tiene tres códigos para el mismo guante de nitrilo. El código A está en un grupo de equipos de protección personal creado por la empresa, con tipo MC. El código B está en el grupo sugerido "0002 Borracha", también con tipo MC. El código C se creó copiando una materia prima y quedó con tipo MP y con el TES estándar de la materia prima. El equipo decide que A se queda.

1. El área fiscal revisa origen, alícuota de IPI y el TE estándar de A antes de cualquier cambio, ya que A pasa a recibir toda la demanda.
2. El código B no tiene orden de producción ni pedido abierto. Datos maestros marca B1_MSBLQL y registra el valor anterior y el nuevo en el registro del saneamiento.
3. El código C aparece en una orden de producción todavía abierta. Bloquearlo con B1_MSBLQL impediría procesar esa orden. El equipo usa la regla de negocio en FATA100 para detener nuevas ventas de C y programa el B1_MSBLQL para después del cierre de la orden.
4. Contraloría confirma que el tipo MP de C entraba en una regla de asiento contable. El tipo de C se corrige solo después de ese análisis, para que los asientos futuros no cambien sin aviso.
5. Datos maestros acuerda que los guantes nuevos se crean copiando A, ya revisado, y nunca B ni C.

Por dónde empezar

1. Exporte la SB1 con tipo, grupo, unidades, factor y tipo de conversión, origen, alícuotas, TE y TS estándar, proveedor estándar y B1_MSBLQL. Verifique que el campo MSBLQL exista en la tabla; si no existe, TI lo crea en el módulo "Configurador".
2. Revise la tabla 02 de tipos y los grupos de MATA035 antes de tocar los productos. Son ellos los que van a definir los lotes.
3. Lleve al área fiscal y a contraloría la lista de cambios en TES estándar y en tipos usados en la contabilización. Nada de eso cambia sin la decisión de esas áreas.
4. Decida los pares de duplicados y, para cada uno, verifique órdenes de producción y pedidos abiertos. Elija entre B1_MSBLQL y una regla de negocio en FATA100.
5. Arme el registro de cambios con código, campo, valor anterior, valor nuevo, fecha y aprobador, porque el historial nativo (MV_HISTTAB y AIF) no cubre esos campos.
6. Pruebe cada lote en un ambiente de homologación: emita una factura, abra una orden de producción, genere una solicitud de compra. La carga por lote la hace el equipo técnico, con la herramienta que ya usa, probada antes en homologación.
7. Aplique en producción lote por lote, empezando por los grupos de mayor impacto. Si la base es grande, la priorización por curva ABC ayuda a ordenar los lotes.

Preguntas frecuentes

¿Se puede eliminar un producto duplicado en Protheus?

No siempre. La documentación de TOTVS informa que no se puede eliminar un producto que forma parte de la "Sugestão de Orçamento" (sugerencia de presupuesto). Para duplicados, el camino documentado para sacar el código de uso es el bloqueo con el campo B1_MSBLQL, que impide el uso en transacciones nuevas y mantiene el historial ya generado.

¿Bloquear el producto con B1_MSBLQL detiene la producción?

Sí. TOTVS advierte que B1_MSBLQL impide seleccionar el producto en nuevos pedidos de venta y también procesar la orden de producción, si la empresa las usa. Si solo hay que detener las ventas, la alternativa documentada es una regla de negocio en la rutina FATA100, pestaña "Comercialização", como excepción.

¿Protheus guarda el historial de cambios del maestro de productos?

En parte. Con el parámetro MV_HISTTAB igual a .T., los cambios van a la tabla AIF, pero solo cuando cambian la descripción (B1_DESC) o el margen de ganancia (B1_PICMENT y B1_PICMRET). Los cambios en tipo, grupo, unidades, TES estándar y bloqueo necesitan un registro propio.

¿Qué afecta un tipo de producto incorrecto?

Según la documentación de TOTVS, los tipos son informativos, sirven para filtrar y no deciden si el ítem se compra o se produce. El único con tratamiento especial es BN. El efecto aparece en informes y procesos filtrados por tipo y, si la empresa usa el tipo en las reglas de asiento contable, en la contabilización.

¿Puedo usar los grupos estándar 0001 a 0007?

Puede, pero TOTVS presenta esos grupos (plástico, caucho, aluminio, electrónicos, neumáticos, productos químicos y producto de venta) solo como sugerencias que se pueden modificar o eliminar. Conviene mantener los que representan su catálogo y crear los grupos que faltan.

¿Hay que detener la operación para sanear?

No necesariamente. El bloqueo por MSBLQL vale solo para transacciones nuevas y no invalida lo que ya se generó, lo que permite sanear por lotes. Atención: B1_MSBLQL también impide procesar las órdenes de producción, así que revise las órdenes abiertas antes de bloquear o, si la idea es detener solo las ventas, use la regla de negocio en FATA100. El cuidado está en los cambios que afectan movimientos futuros, como el TES estándar y los tipos usados en la contabilización: esos deben pasar por pruebas en homologación y por la aprobación del área fiscal y de contraloría.

Cómo 4MDG puede ayudar

Lo que describe este artículo es la parte de Protheus. Antes viene el trabajo sobre el catálogo: taxonomía por familia, PDM con descripción corta y larga, deduplicación con puntuación y survivorship, clasificación NCM y UNSPSC, unidad de medida y factor de conversión. Es nuestro saneamiento del maestro de materiales, que termina con carga y gobierno, con reglas en la entrada y flujo de aprobación. La plataforma de 4MDG se integra con ERP como SAP, TOTVS y Oracle mediante conectores, como se describe en capacidades y arquitectura. Para saber cómo está su catálogo, solicite el diagnóstico gratuito o escríbanos desde la página de contacto.

Aviso: parámetros, campos y rutinas pueden variar según la versión y la configuración de Protheus en su empresa. Confirme con su equipo técnico y con el área fiscal antes de aplicar. Las reglas fiscales mencionadas aquí valen solo en Brasil.

Fuentes

• TOTVS, TDN, "Produtos - MATA010". https://tdn.totvs.com/display/public/PROT/Produtos+-+MATA010. Consultado el 3 de noviembre de 2026.
• TOTVS, TDN, "Grupos de Produtos - MATA035". https://tdn.totvs.com/display/public/PROT/Grupos+de+Produtos+-+MATA035. Consultado el 3 de noviembre de 2026.
• TOTVS, TDN, "FAT0099 MSBLQL Bloqueio de Registro / Cadastro". https://tdn.totvs.com/display/PROT/FAT0099_MSBLQL_Bloqueio_de_Registro_Cadastro. Consultado el 3 de noviembre de 2026.