Histórico da Página

...

id_retaguarda

Deck of Cards

id	dk1

Produto_similar

Card

id	card1
label	Descrição dos campos e regras

Informação	Coluna	Obrigatório	Tipo	Tamanho	Descriçã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 N CM
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

Defasado

	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

Quantidade do Valor no Atacado

quantidade_valor_atacado

Não

Numérico

Informações

title	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.

		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

Informação

Coluna

Obrigatório

Tipo

Tamanho

Descrição

Identificação no retaguarda

Não

Texto

100

ID da tabela produto do item "raiz"

	Identificação do departamento no erp
Identificação da seção	id_retaguarda_secao

id_produto

Não

Inteiro

Texto

Identificação do produto raiz, que ao ser consultado irá apresentar quais seu similaresID da tabela produto do item similar ao "raiz"id_similarNãoInteiroIdentificação do item similar ao consultadoSituaçãosituacaoSimInteiro

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

0 - Inativo
1 - Ativo

Data de cadastrodata_cadastroSimDataExemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi cadastrado localmente.Data de atualizaçãodata_atualizacaoSimDataExemplo "2024-03-20 20:56:43.15725". Corresponde a data em que o dado foi atualizado localmente.

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 seletivo	id_imposto_seletivo	Não	Inteiro		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/CBS	id_imposto_ibs_cbs	Não	Inteiro		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.

Árvore de páginas

Versões comparadas

Versão antiga 25

Nova versão Atual

Chave

Requisição

Exemplo de body da requisição

Definições dos campos do body

Retorno

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno

Requisição

Exemplo de body da requisição

Definições dos campos do body

Retornos

Exemplo de body de retorno

Definições dos campos do retorno

Exemplo de body de retorno

Definições dos campos do retorno

Informação	Coluna	Obrigatório	Tipo	Tamanho	Descrição
ID do produtoIdentificação no retaguarda	id_produtoretaguarda	Não	Texto	Inteiro100
ID do item na tabela produto. Vinculo entre a produto e codigo_identificacao_produto	Código	codigo	Sim	Texto	200	da tabela produto do item "raiz"	id_produto	Não	Inteiro		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_sugestao	Código externo	codigo_externo	Não	Texto	200Inteiro		Identificação dos itens sugeridos para o item consultado
Descrição do código	descricao	Não	Texto	200	Descrição do tipo de código, por padrão "Código Referência"
Situação	situacao	Sim	Inteiro		Define se o o vinculo 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

Informação	Coluna	Obrigatório	Tipo	Tamanho	Descrição
ID do produto	id_produto	Não	Inteiro		ID do item na tabela produto. Vinculo entre a produto e codigo_identificacao_produto
Código	codigo	Sim	Texto	200	Identificação do produto raiz, que ao ser consultado irá apresentar quais itens são sugeridos ao compra-lo
Código externo	codigo_externo	Não	Texto	200	Identificação dos itens sugeridos para o item consultado
Descrição do código	descricao	Não	Texto	200	Descrição do tipo de código, por padrão "Código Referência"
Situação	situacao	Sim	Inteiro		Define se o o vinculo 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