O cadastro de produtos desempenha um papel crucial na execução das operações de venda, sendo essencial para o funcionamento eficiente do TOTVS PDV Omni. Além de ser fundamental para as operações de venda, o cadastro também é utilizado na consulta de produtos, oferecendo aos usuários a capacidade de verificar detalhes do produto, posição do estoque e até mesmo sugestões e itens similares.

O produto poderá ter as seguintes informações:


InformaçãoColunaObrigatórioTipoTamanhoDescrição
Descrição

descricao

Sim

Texto

200

Cada produto requer uma descrição, que será utilizada nas operações de consultas, no carrinho de venda e documentos fiscais. 

Imposto

id_imposto

Não

Inteiro


Para que a operação de venda seja realizada todo produto deverá estar associado a um imposto, onde irá determinar a alíquota ICMS que o PDV Omni deverá utilizar na emissão de XML.

Consulte mais detalhes em Imposto

Código NCM

id_ncm

Não

Inteiro


Para que a operação de venda seja realizada todo produto deverá estar associado a um NCM, onde irá determinar a alíquota nacional, importada, estadual e municipal e também o código CEST que o PDV Omni deverá utilizar na emissão de XML.

Consulte mais detalhes em NCM

Unidade de medida

unidade_medida

Sim

Texto

20

Para que a operação de venda seja realizada todo produto deverá possuir a identificação da unidade de medida do produto. Como os listados abaixo entre outros:

  • UN (Unidade)
  • PC (Pacote)
  • KG (Kilo)

No campo, normalmente é utilizada a abreviação da medida, por exemplo "UN", "PC".

Desconto máximo

desconto_maximo

Não

Numérico


Configuração do desconto máximo que aquele item poderá receber.

Esse desconto pode ser ultrapassado caso seja realizada a identificação de um supervisor autorizando o desconto acima do configurado.

Arredonda ou trunca

tipo_arredonda_trunca

Sim

Texto

1

Informação obsoleta, sendo:

0 - Arredonda

1- Trunca

Código

codigo_produto

Sim

Texto

20

O produto deve ter pelo menos um código alfanumérico, embora seja possível associá-lo a múltiplos códigos, se necessário. 

Código alternativo

codigo_alternativo

Sim

Texto

40


Origem do produto

origem_produto

Sim

Texto

20


Pis/Cofins

id_pis_cofins

Não

Inteiro


Para que a operação de venda seja realizada todo produto deverá estar associado a um PIS e COFINS, onde irá determinar o CST e alíquota PIS e CST e alíquota COFINS que o PDV Omni deverá utilizar na emissão de XML.

Consulte mais detalhes em PIS/COFINS

Situação

situacao

Sim

Inteiro


Define se o produto em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastro

data_cadastro

Sim

Data


Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.

Data de atualização

data_atualizacao

Sim

Data


Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.

Identificação no retaguarda

id_retaguarda

Não

Texto

100


Imagem

imagem

Não

Imagem

200

***Caminho da imagem do produto para apresentação em tela

Identificação do seu tipo 

tipo_produto

Não

Inteiro


Identificação do tipo de produto informado, para que o PDV saiba qual comportamento deve ter conforme o tipo de produto. Por exemplo, se o item é produto do tipo serviço, a tela do PDV para uma venda serviço possui uma diferença quando comparada a tela de item de revenda.

  • 0 - Não definido
  • 1 - Consumo
  • 2 - Revenda
  • 3 - KIT
  • 4 - Matéria prima
  • 5 - Produto acabado
  • 6 - Serviço
Identificação de o produto é fracionado

fracionado

Não

Inteiro


Para que o PDV libera a pesagem do item e também aumente a quantidade de casa decimais na quantidade do produto, o mesmo deve estar cadastrado como fracionado.

  • 0 - False
  • 1 - True
CNPJ do fornecedor

cnpj_fornecedor

Não

Texto

20

Para emissão da XML da venda, caso a coluna escala_relevante esteja definida com o valor "True", a SEFAZ exisge que seja informado também na XML o CNPJ do fabricante do produto. Para o preenchimento dessa TAG n XML, é utilizado o dado do CNPJ do fornecedor.

Produzido em escala relevante

escala_relevante

Não

Boleano


Para emissão da XML da venda, é necessário que no cadastro do item seja informado se trata-se de um item fabricado em escala relevante ou não.

  • False - Produto sujeito a substituição tributária.
  • True - Produto não sujeito a substituição tributária (conforme Convênio ICMS 51/2017)
Valor base do fundo de combate a probreza (FCP)

valor_base_fcp

Não

Numérico


Defasado

Código de benefício fiscal (CBNEF)

codigo_beneficio_fiscal

Não

Texto

20

Para emissão da XML da venda, quando o item possui um benefício fiscal, seja ele com relação a carga tributária ou isenção de imposto, é necessário informar o código desse benefício. Os estados de DF, GO, PR, RS, RJ e SC obrigam o preenchimento dessa TAG, ou seja, para esses estados é obrigatório o cadastro do código. Para a geração dessa TAG na XML é utilizado o valor integrado no campo codigo_beneficio_fiscal. 

Percentual do fundo de combate a pobreza (FCP)

percentual_fcp

Não

Numérico


Para emissão da XML da venda, caso o produto comercializado estiver determinado na legislação do estado para recolhimento do FCP a TAG com o valor a ser recolhido deve ser preenchida. O valor é calculado com base ao percentual, também definido pelo estado, de recolhimento. Para o calculo do valor e preenchimento da TAG vFCP é necessário informar o percentual definido pelo estado no campo percentual_fcp. 

CST do ICMS

cst_icms

Não

Texto

4

Defasado

Percentual de redução de ICMS

percentual_reducao_icms

Não

Numérico


Para emissão da XML da venda, quando o item possui esse campo e o campo aliquota_icms preenchidos, esses campos são utilizados para o preenchimento das TAGs com relação ao ICMS efetivo. Esse campo realizar o preenchimento da TAG pRedBCEfet.

Alíquota ICMS

aliquota_icms

Não

Numérico


Para emissão da XML da venda, quando o item possui esse campo e o campo percentual_reducao_icms preenchidos, esses campos são utilizados para o preenchimento das TAGs com relação ao ICMS efetivo. Esse campo é utilizado para o cálculo do pICMSEfet e vICMSEfet

Valor de ICMS retido

vlicmsret

Não

Numérico


Defasado

Motivo da desoneração de ICMS

motivo_desoneracao_icms

Não

Inteiro


Para emissão da XML da venda, o preenchimento desse campo com valor diferente de 0 "habilita" o cálculo de desoneração na nota. Esse campo é utilizado para o preenchimento da TAG motDesICMS. A TAG vICMSDeson é preenchida após o cálculo. Para CSTs 30, 40, 41 e 50 são utilizados os campos aliquota_icms e percentual_fcp para cálculo, já para os CSTs 20, 70 e 90 é utilizado o percentual_fcp e a alíquota da tabela Imposto.

Desconta desoneração na NF

desconta_desoneracao_nf

Não

Boleano


Campo utilizado para indicar se o produto estará sujeito ao desconto da desoneração do ICMS sobre seu valor, conforme a NT 2023.004 v1.10.

CEST

cest

Não

Texto

7

Para emissão da XML da venda, produtos com substituição tributária devem conter a informação do CEST. Essa informação possui dois locais para o cadastro, diretamente no produto e no NCM. Caso o produto não tenha essa informação, será usado o valor presente na tabela no NCM, mas caso exista o valor cest na tabela produto, era será a presente na XML

Valor de pauta ICMS

valor_pauta_icms

Não

Numérico


Defasado

MD5 PAF

md5_paf

Não

Texto

64

Campo utilizado para armazenar o MD5 calculado de acordo com a informação do produto quando utilizado o modelo fiscal NFCe com PAF ativo

Encomenda

encomenda

Não

Boleano


Controle se o item pode ou não ser encomendado pela loja

Quantidade em movimentação

quantidade_movimentacao

Não

Numérico


Quantidade de movimentação é a configuração de valor mínimo de compra.

Por exemplo, pode ser configurado para que determinado item seja vendido somente de 5 em 5. Ou seja, se o cliente tentar informar somente um item, o PDV irá informar que a quantidade mínima de movimentação é 5 ou múltiplo de 5

Peso bruto do produto

peso_bruto

Não

Numérico


Peso bruto do produto

Peso líquido do produto

peso_liquido

Não

Numérico


Peso líquido do produto

Controle de lote

controla_lote

Não

Boleano


Controle de lote é a configuração para controlar lote por produto nas vendas de pisos e cerâmicas.

Identificação do Produto Principal

Id_produto_principal

Não

Inteiro


Produto principal é a configuração para indicar um produto principal de um produto.

Exemplo: Na venda do produto (id_produto) que tenha um produto principal cadastrado, será utilizado o mesmo preço promocional do produto principal.

Quantidade do Valor no Atacado

quantidade_valor_atacado

Não

Numérico


Quantidade do Valor no Atacado é a configuração da quantidade mínima para utilizar o preço de atacado.

Por exemplo, pode ser configurado para que determinado item seja vendido no valor de atacado a partir de 5.

Identificação do fornecedor

id_retaguarda_fornecedor

Não

Texto

100

Identificação do fornecedor no erp

Identificação do departamento

id_retaguarda_departamento

Não

Texto

100

Identificação do departamento no erp

Identificação da seção

id_retaguarda_secao

Não

Texto

100

Identificação da seção no erp

Identificação da categoria

id_retaguarda_categoria

Não

Texto

100

Identificação da categoria no erp

Identificação da subcategoria

id_retaguarda_sub_categoria

Não

Texto

100

Identificação da subcategoria no erp

Identificação da marca

id_retaguarda_marca

Não

Texto

100

Identificação da marca no erp

id imposto seletivoid_imposto_seletivoNãoInteiro
Para que a operação de venda seja realizada com utilização do imposto seletivo o produto deverá estar associado a a tabela imposto_seletivo, onde irá determinar o CST e alíquota  e  que o PDV Omni deverá utilizar na emissão de XML.
id imposto IBS/CBSid_imposto_ibs_cbsNãoInteiro
Para que a operação de venda seja realizada com utilização do imposto IBS/CBS o produto deverá estar associado a a tabela imposto_seletivo, onde irá determinar o CST e alíquota  e  que o PDV Omni deverá utilizar na emissão de XML.


Produto_similar

No PDV, quando é acessada a tela de detalhes do produto é possível encontrar a informação de produtos similares a ele mesmo. Para isso é necessário fazer o vinculo do produto com seu similar através da tabela produto_similar.

InformaçãoColunaObrigatórioTipoTamanhoDescrição
Identificação no retaguardaid_retaguardaNãoTexto100
ID da tabela produto do item "raiz"id_produtoNãoInteiro
Identificação do produto raiz, que ao ser consultado irá apresentar quais seu similares
ID da tabela produto do item similar ao "raiz"id_similarNãoInteiro
Identificação do item similar ao consultado
SituaçãosituacaoSimInteiro

Define se o o vinculo em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.


Produto_Sugestao

No PDV, quando é acessada a tela de detalhes do produto é possível encontrar a informação de produtos sugeridos para serem vendidos junto a ele. Para isso é necessário fazer o vinculo do produto com seus sugeridos através da tabela produto_sugestao.

InformaçãoColunaObrigatórioTipoTamanhoDescrição
Identificação no retaguardaid_retaguardaNãoTexto100
ID da tabela produto do item "raiz"id_produtoNãoInteiro
Identificação do produto raiz, que ao ser consultado irá apresentar quais itens são sugeridos ao compra-lo
ID da tabela produto do item sugestão ao "raiz"id_sugestaoNãoInteiro
Identificação dos itens sugeridos para o item consultado
SituaçãosituacaoSimInteiro

Define se o o vinculo em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.


Codigo_identificacao_produto

Quando o produto possui mais de um código de identificação pode adicionar essa identificação na tabela de codigo_identificacao_produto. Atualmente o cliente que mais usa essa tabela é a Technos.

Esses códigos também podem ser informados no PDV para adicionar o item ao carrinho.

InformaçãoColunaObrigatórioTipoTamanhoDescrição
ID do produtoid_produtoNãoInteiro
ID do item na tabela produto. Vinculo entre a produto e codigo_identificacao_produto
CódigocodigoSimTexto200Identificação do produto raiz, que ao ser consultado irá apresentar quais itens são sugeridos ao compra-lo
Código externocodigo_externoNãoTexto200Identificação dos itens sugeridos para o item consultado
Descrição do códigodescricaoNãoTexto200Descrição do tipo de código, por padrão "Código Referência"
SituaçãosituacaoSimInteiro

Define se o o vinculo em questão está ativo ou inativo.

  • 0 - Inativo
  • 1 - Ativo
Data de cadastrodata_cadastroSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.
Data de atualizaçãodata_atualizacaoSimData
Exemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.
Identificação no retaguardaid_retaguardaNãoTexto100



Para maiores informações de como integrar o Produto, clique aqui.