Tutoriais/Compras/VinculoProdutos - Histórico de revisão

Matheus: Documentacao da rotina

2026-08-27T12:41:44Z

Documentacao da rotina

← Edição anterior		Edição das 12h41min de 27 de agosto de 2026
Linha 1:		Linha 1:
	{{Cabecalho		{{Cabecalho
	\| [[Tutoriais]]		\| [[Tutoriais]]
	\| ~~Vínculo de Produtos no XML~~		\| Relacionamento do Produto [COT016]
	}}		}}

Raul em 04h00min de 7 de dezembro de 2025

2025-12-07T04:00:01Z

← Edição anterior		Edição das 04h00min de 7 de dezembro de 2025
Linha 1:		Linha 1:
	{{Cabecalho		{{Cabecalho
	\| [[Tutoriais~~]] > [[Módulo_Compras\|Compras~~]]		\| [[Tutoriais]]
	\| Vínculo de Produtos no XML		\| Vínculo de Produtos no XML
	}}		}}

Raul em 01h30min de 5 de dezembro de 2025

2025-12-05T01:30:48Z

← Edição anterior		Edição das 01h30min de 5 de dezembro de 2025
Linha 10:		Linha 10:
	* '''Direita (Sistema):''' Como o produto será gravado no seu estoque.		* '''Direita (Sistema):''' Como o produto será gravado no seu estoque.

	#: {{Print\|~~image_2e8e67~~.png\|Tela de relacionamento: Comparativo entre dados do XML e cadastro do sistema}}		#: {{Print\|3relacionamentoproduto.png\|Tela de relacionamento: Comparativo entre dados do XML e cadastro do sistema}}

	== Ferramentas de Agilidade ==		== Ferramentas de Agilidade ==

Raul em 01h29min de 5 de dezembro de 2025

2025-12-05T01:29:44Z

← Edição anterior		Edição das 01h29min de 5 de dezembro de 2025
Linha 6:		Linha 6:
	Esta tela [COT016] é acionada quando o sistema não reconhece um produto ou identifica mudanças no cadastro. Aqui é feito o "De/Para" entre o Fornecedor e a Empresa.		Esta tela [COT016] é acionada quando o sistema não reconhece um produto ou identifica mudanças no cadastro. Aqui é feito o "De/Para" entre o Fornecedor e a Empresa.

	== 1. Estrutura da Tela ==		== Estrutura da Tela ==
	* '''Esquerda (Fornecedor):''' Dados imutáveis vindos do XML (Unidade de compra, descrição original).		* '''Esquerda (Fornecedor):''' Dados imutáveis vindos do XML (Unidade de compra, descrição original).
	* '''Direita (Sistema):''' Como o produto será gravado no seu estoque.		* '''Direita (Sistema):''' Como o produto será gravado no seu estoque.

	#: {{Print\|image_2e8e67.png\|Tela de relacionamento ~~detalhada~~}}		#: {{Print\|image_2e8e67.png\|Tela de relacionamento: Comparativo entre dados do XML e cadastro do sistema}}

	== 2. Ferramentas de Agilidade ==		== Ferramentas de Agilidade ==
	O sistema possui atalhos ~~escondidos~~ para acelerar o cadastro:		O sistema possui atalhos programados para acelerar o cadastro:

	{{TabelaCampos\|		{{TabelaCampos\|
Linha 30:		Linha 30:
	}}		}}

	== 3. Regras de Validação ==		== Regras de Validação ==
	Ao confirmar o vínculo (Botão OK), o sistema valida:		Ao confirmar o vínculo (Botão OK), o sistema valida:

Linha 37:		Linha 37:
	* '''Garantido Integral:''' Se a empresa usa este regime, os campos de Margem e Alíquota serão habilitados conforme a CST selecionada.		* '''Garantido Integral:''' Se a empresa usa este regime, os campos de Margem e Alíquota serão habilitados conforme a CST selecionada.

	== 4. Divergências de Cadastro ==		== Divergências de Cadastro ==
	No rodapé, decida o que fazer com dados que mudaram:		No rodapé, decida o que fazer com dados que mudaram:
	* '''Código de Barras/NCM:''' Selecione "Alterar para este" para atualizar seu cadastro com o dado novo do XML, ou "Manter este" para ignorar a mudança.		* '''Código de Barras/NCM:''' Selecione "Alterar para este" para atualizar seu cadastro com o dado novo do XML, ou "Manter este" para ignorar a mudança.

	{{ContatoSuporte}}		{{ContatoSuporte}}

Raul em 01h22min de 5 de dezembro de 2025

2025-12-05T01:22:04Z

← Edição anterior		Edição das 01h22min de 5 de dezembro de 2025
Linha 4:		Linha 4:
	}}		}}

	Esta é ~~a etapa mais crítica da entrada de notas~~. ~~O sistema compara os itens do arquivo XML (~~Fornecedor~~) com o cadastro de produtos do Celta (Interno)~~.		Esta tela [COT016] é acionada quando o sistema não reconhece um produto ou identifica mudanças no cadastro. Aqui é feito o "De/Para" entre o Fornecedor e a Empresa.

	== 1. ~~Entendendo as Cores (Status)~~ ==		== 1. Estrutura da Tela ==
	~~Ao abrir a nota~~, ~~você verá uma lista de produtos com cores distintas [COT015]~~:		* '''Esquerda (Fornecedor):''' Dados imutáveis vindos do XML (Unidade de compra, descrição original).
			* '''Direita (Sistema):''' Como o produto será gravado no seu estoque.

	* <span style="color:~~red">'''Vermelho (Pendente):'''</span> O sistema não reconheceu este produto. Ou ele não está cadastrado, ou o código do fornecedor mudou~~. ~~É obrigatório realizar a ação~~ de ~~vínculo.~~		#: {{Print\|image_2e8e67.png\|Tela de relacionamento detalhada}}
	* <span style="color:blue">'''Azul/Verde (Vinculado):'''</span> O produto já foi identificado e está associado ao cadastro local. Nenhuma ação é necessária, a menos que queira conferir a conversão.

	~~#: {{Print\|image_2ee0f6.png\|Tela de importação exibindo itens pendentes (vermelho)}}~~		== 2. Ferramentas de Agilidade ==
			O sistema possui atalhos escondidos para acelerar o cadastro:
	== 2. ~~Tela~~ de ~~Relacionamento~~ ==
	~~Pressione '''Enter''' sobre um item <span style="color:red">vermelho</span>~~ para ~~abrir a janela de detalhes [COT016]. Esta tela é dividida em dois blocos: esquerda (Fornecedor) e direita (Sua Empresa).~~

	~~=== Dados do XML (Esquerda) ===~~
	~~Exibe exatamente~~ o ~~que veio na nota fiscal (Imutável).~~
	* '''Produto/CFOP/CST:''' Dados originais da nota.
	* '''Unidade de compra:~~''' A unidade que o fornecedor usou (Ex: CX, FD, KG).~~

	~~=== Dados no Sistema (Direita) ===~~
	~~Aqui você define como este produto entrará no seu estoque.~~

	{{TabelaCampos\|		{{TabelaCampos\|
	{{Linha		{{Linha
	\| 1= ~~Botão: Copiar do Anterior~~		\| 1= Cadastro Rápido (Mouse)
	~~\| 2= Ferramenta de agilidade. Ao clicar, o sistema copia a Descrição, NCM e Códigos do XML para os campos do sistema.~~		\| 2= Clique com o '''Botão Direito''' no campo "Produto" (ou tecle '''+''') para abrir a janela de cadastro de produto simplificada sem sair desta tela.
	}}
	~~{{Linha~~
	~~\| 1= Produto~~ (~~Código~~)
	\| 2= ~~Campo para selecionar o produto no seu estoque.~~
	* '''Busca:''' Digite o código ou pressione '''F3''' para pesquisar.
	* '''Cadastro Rápido (Atalho):''' Clique com o '''Botão Direito''' ~~do mouse neste~~ campo ou ~~pressione a tecla~~ '''+ ~~(Mais)~~''' para abrir ~~o cadastro simplificado de produtos imediatamente.~~
	}}
	~~{{Linha~~
	~~\| 1= CFOP (Fiscal)~~
	~~\| 2= Classificação tributária de entrada.~~
	* '''Validação:''' O sistema valida se a CFOP informada é compatível com a ~~operação (Estadual/Interestadual) e se o subtipo (Uso e Consumo/Comercialização) está correto.~~
	}}
	~~{{Linha~~
	~~\| 1= CST (Fiscal)~~
	~~\| 2= Código~~ de ~~Situação Tributária para a entrada. O sistema sugere baseado no~~ cadastro~~, mas deve ser conferido~~.
	}}		}}
	{{Linha		{{Linha
	\| 1= ~~Equivalente a (Fator)~~		\| 1= Botão "Copiar do Anterior"
	\| 2= ~~'''Campo Crítico~~ de ~~Estoque~~.~~''' Define a conversão entre a unidade de compra e a de venda.~~		\| 2= Copia o vínculo feito no item de cima. Útil para notas com vários itens sequenciais do mesmo produto (ex: grades de cor/tamanho).
	* '''Exemplo:''' Comprou 1 CX com ~~12 UN. Preencha '''12'''.~~
	* '''Calculadora:~~''' Ao lado do campo, há um botão~~ de ~~calculadora que auxilia na divisão automática caso você tenha apenas o preço unitário~~.
	}}		}}
	}}

	~~=== 2.1. Tratamento de Divergências (Rodapé da Janela) ===~~
	~~O sistema detecta automaticamente se houve mudança nos dados cadastrais em relação à última compra.~~

	~~{{TabelaCampos\|~~
	{{Linha		{{Linha
	\| 1= ~~Código~~ de ~~Barras~~		\| 1= Calculadora de Fator
	\| 2= ~~Se o GTIN~~ do ~~XML for diferente do sistema~~, ~~escolha:~~		\| 2= Ao lado do campo "Equivalente a", o botão de calculadora auxilia a encontrar o fator de conversão dividindo o custo total pela quantidade.
	* '''Alterar para este:''' Atualiza o cadastro do produto com o ~~novo código~~ de ~~barras.~~
	* '''Manter este:''' Ignora o XML e mantém o ~~código antigo.~~
	}}
	~~{{Linha~~
	~~\| 1= NCM e Referência~~
	~~\| 2= Mesma lógica do código~~ de ~~barras. Permite atualizar a Classificação Fiscal e~~ o ~~código de referência do fornecedor automaticamente~~.
	}}		}}
	}}		}}

	~~#: {{Print\|image_2e8e67.png\|Tela de relacionamento detalhada: Fator de conversão e dados do produto}}~~		== 3. Regras de Validação ==
			Ao confirmar o vínculo (Botão OK), o sistema valida:
	{{Nota\|info\|GARANTIDO INTEGRAL (MT)\|Se a empresa estiver configurada para cálculo de '''Garantido Integral''', campos adicionais de ''Margem'' e ''Alíquota'' aparecerão habilitados nesta tela para preenchimento.}}

	== 3. ~~Painel~~ de ~~Pendências (Rodapé)~~ ==
	~~Na tela principal de listagem,~~ o ~~rodapé exibe alertas importantes antes da importação final.~~

	* '''Itens com pendência(s):~~''' Deve estar '''Zero''' para prosseguir.~~
	* '''Links de Validação:''' Clique nos links em azul ("Próximo") para navegar diretamente para os itens que possuem divergência de Código de Barras, NCM ou Referência.

	~~Após resolver todas as linhas vermelhas, clique em~~ '''~~Importar~~''' (~~canto inferior direito~~) ~~para gerar~~ a ~~Nota~~ de ~~Entrada~~.		* '''Geografia Fiscal (CFOP):''' Verifica se a CFOP informada é permitida para a UF do fornecedor (Ex: Bloqueia CFOP interna para fornecedor de outro estado).
			* '''Fator de Conversão:''' Multiplica a Qtde do XML pelo Fator. Se o produto não permitir fração no cadastro, o sistema arredonda o resultado automaticamente.
			* '''Garantido Integral:''' Se a empresa usa este regime, os campos de Margem e Alíquota serão habilitados conforme a CST selecionada.

	#: ~~{{Print\|image_2e8b1e~~.~~png\|Tela pronta para importação (Todos os itens vinculados)}}~~		== 4. Divergências de Cadastro ==
			No rodapé, decida o que fazer com dados que mudaram:
			* '''Código de Barras/NCM:''' Selecione "Alterar para este" para atualizar seu cadastro com o dado novo do XML, ou "Manter este" para ignorar a mudança.

	{{ContatoSuporte}}		{{ContatoSuporte}}

Raul em 01h01min de 5 de dezembro de 2025

2025-12-05T01:01:04Z

← Edição anterior		Edição das 01h01min de 5 de dezembro de 2025
Linha 18:		Linha 18:

	=== Dados do XML (Esquerda) ===		=== Dados do XML (Esquerda) ===
	Exibe exatamente o que veio na nota fiscal.		Exibe exatamente o que veio na nota fiscal (Imutável).
	* '''Produto/CFOP/CST:''' Dados originais ~~imutáveis~~.		* '''Produto/CFOP/CST:''' Dados originais da nota.
	* '''Unidade de compra:''' A unidade que o fornecedor usou (Ex: CX, FD, KG).		* '''Unidade de compra:''' A unidade que o fornecedor usou (Ex: CX, FD, KG).

Linha 28:		Linha 28:
	{{Linha		{{Linha
	\| 1= Botão: Copiar do Anterior		\| 1= Botão: Copiar do Anterior
	\| 2= Ferramenta de agilidade. Ao clicar, o sistema copia a Descrição, NCM e Códigos do XML para os campos do sistema~~. Ideal para cadastrar produtos novos rapidamente~~.		\| 2= Ferramenta de agilidade. Ao clicar, o sistema copia a Descrição, NCM e Códigos do XML para os campos do sistema.
	}}		}}
	{{Linha		{{Linha
	\| 1= Produto (Código)		\| 1= Produto (Código)
	\| 2= Campo para selecionar o produto no seu estoque.		\| 2= Campo para selecionar o produto no seu estoque.
	* '''~~Se já existe~~:''' Digite o código ou pressione F3 para ~~buscar~~.		* '''Busca:''' Digite o código ou pressione '''F3''' para pesquisar.
	* '''~~Se é novo~~:''' ~~Use~~ o ~~botão "Copiar~~ do ~~Anterior", coloque o cursor~~ neste campo e pressione a tecla '''+ (Mais)''' ~~do teclado numérico~~ para ~~gerar um novo código livre~~.		* '''Cadastro Rápido (Atalho):''' Clique com o '''Botão Direito''' do mouse neste campo ou pressione a tecla '''+ (Mais)''' para abrir o cadastro simplificado de produtos imediatamente.
	}}		}}
	{{Linha		{{Linha
	\| 1= CFOP ~~/ CST~~ (Fiscal)		\| 1= CFOP (Fiscal)
	\| 2= Classificação tributária de entrada. O sistema ~~sugere~~ a ~~padrão~~ (~~Ex:~~ 1~~.102/~~2.~~102)~~, mas deve ser ~~verificada conforme a operação~~.		\| 2= Classificação tributária de entrada.
			* '''Validação:''' O sistema valida se a CFOP informada é compatível com a operação (Estadual/Interestadual) e se o subtipo (Uso e Consumo/Comercialização) está correto.
			}}
			{{Linha
			\| 1= CST (Fiscal)
			\| 2= Código de Situação Tributária para a entrada. O sistema sugere baseado no cadastro, mas deve ser conferido.
	}}		}}
	{{Linha		{{Linha
	\| 1= Equivalente a (Fator)		\| 1= Equivalente a (Fator)
	\| 2= '''Campo Crítico de Estoque.''' Define a conversão entre a unidade de compra e a de venda.		\| 2= '''Campo Crítico de Estoque.''' Define a conversão entre a unidade de compra e a de venda.
	* '''Exemplo ~~na imagem~~:''' ~~O fornecedor vendeu~~ 1 CX ~~(Caixa)~~. Se na ~~sua loja~~ você ~~vende por UN~~ (~~Unidade~~) ~~e na caixa vêm 12~~, ~~preencha~~ '''12''' ~~neste campo~~.		* '''Exemplo:''' Comprou 1 CX com 12 UN. Preencha '''12'''.
	* '''~~Cálculo~~:''' ~~Qtde Comprada (4) x Fator (1) = Qtde Convertida (4)~~.		* '''Calculadora:''' Ao lado do campo, há um botão de calculadora que auxilia na divisão automática caso você tenha apenas o preço unitário.
			}}
			}}

			=== 2.1. Tratamento de Divergências (Rodapé da Janela) ===
			O sistema detecta automaticamente se houve mudança nos dados cadastrais em relação à última compra.

			{{TabelaCampos\|
			{{Linha
			\| 1= Código de Barras
			\| 2= Se o GTIN do XML for diferente do sistema, escolha:
			* '''Alterar para este:''' Atualiza o cadastro do produto com o novo código de barras.
			* '''Manter este:''' Ignora o XML e mantém o código antigo.
	}}		}}
	{{Linha		{{Linha
	\| 1= ~~Código de Barras /~~ Referência		\| 1= NCM e Referência
	\| 2= ~~No rodapé da janela, você pode escolher entre '''Alterar para este''' (atualiza seu cadastro com o dado~~ do ~~XML) ou '''Manter este''' (preserva~~ o ~~dado atual~~ do ~~seu cadastro)~~.		\| 2= Mesma lógica do código de barras. Permite atualizar a Classificação Fiscal e o código de referência do fornecedor automaticamente.
	}}		}}
	}}		}}

	#: {{Print\|image_2e8e67.png\|Tela de relacionamento detalhada: Fator de conversão e dados do produto}}		#: {{Print\|image_2e8e67.png\|Tela de relacionamento detalhada: Fator de conversão e dados do produto}}

			{{Nota\|info\|GARANTIDO INTEGRAL (MT)\|Se a empresa estiver configurada para cálculo de '''Garantido Integral''', campos adicionais de ''Margem'' e ''Alíquota'' aparecerão habilitados nesta tela para preenchimento.}}

	== 3. Painel de Pendências (Rodapé) ==		== 3. Painel de Pendências (Rodapé) ==
	Na tela principal de listagem, o rodapé exibe alertas importantes antes da importação final.		Na tela principal de listagem, o rodapé exibe alertas importantes antes da importação final.

	* '''Itens com pendência(s):''' Deve estar '''Zero''' para prosseguir~~. Clique em "Próximo" se houver pendências~~.		* '''Itens com pendência(s):''' Deve estar '''Zero''' para prosseguir.
	* '''~~Código barras divergente~~:''' ~~Alerta quando o GTIN do produto mudou.~~		* '''Links de Validação:''' Clique nos links em azul ("Próximo") para navegar diretamente para os itens que possuem divergência de Código de Barras, NCM ou Referência.
	* '''NCM ~~divergente:''' Alerta quando a classificação fiscal do fornecedor é diferente da sua.~~
	* '''Ref. fornecedor divergente:''' Indica mudança no código interno do fornecedor.

	Após resolver todas as linhas vermelhas, clique em '''Importar''' (canto inferior direito) para gerar a Nota de Entrada.		Após resolver todas as linhas vermelhas, clique em '''Importar''' (canto inferior direito) para gerar a Nota de Entrada.

Raul: Criou página com '{{Cabecalho | Tutoriais > Compras | Vínculo de Produtos no XML }} Esta é a etapa mais crítica da entrada de notas. O sistema compara os itens do arquivo XML (Fornecedor) com o cadastro de produtos do Celta (Interno). == 1. Entendendo as Cores (Status) == Ao abrir a nota, você verá uma lista de produtos com cores distintas [COT015]: * '''Vermelho (Pendente):''' O sistema não reconheceu este produto. Ou ele...'

2025-12-05T00:57:45Z

Criou página com '{{Cabecalho | Tutoriais > Compras | Vínculo de Produtos no XML }} Esta é a etapa mais crítica da entrada de notas. O sistema compara os itens do arquivo XML (Fornecedor) com o cadastro de produtos do Celta (Interno). == 1. Entendendo as Cores (Status) == Ao abrir a nota, você verá uma lista de produtos com cores distintas [COT015]: * '''Vermelho (Pendente):''' O sistema não reconheceu este produto. Ou ele...'

Página nova

{{Cabecalho
| [[Tutoriais]] > [[Módulo_Compras|Compras]]
| Vínculo de Produtos no XML
}}

Esta é a etapa mais crítica da entrada de notas. O sistema compara os itens do arquivo XML (Fornecedor) com o cadastro de produtos do Celta (Interno).

== 1. Entendendo as Cores (Status) ==
Ao abrir a nota, você verá uma lista de produtos com cores distintas [COT015]:

* '''Vermelho (Pendente):''' O sistema não reconheceu este produto. Ou ele não está cadastrado, ou o código do fornecedor mudou. É obrigatório realizar a ação de vínculo.
* '''Azul/Verde (Vinculado):''' O produto já foi identificado e está associado ao cadastro local. Nenhuma ação é necessária, a menos que queira conferir a conversão.

#: {{Print|image_2ee0f6.png|Tela de importação exibindo itens pendentes (vermelho)}}

== 2. Tela de Relacionamento ==
Pressione '''Enter''' sobre um item vermelho para abrir a janela de detalhes [COT016]. Esta tela é dividida em dois blocos: esquerda (Fornecedor) e direita (Sua Empresa).

=== Dados do XML (Esquerda) ===
Exibe exatamente o que veio na nota fiscal.
* '''Produto/CFOP/CST:''' Dados originais imutáveis.
* '''Unidade de compra:''' A unidade que o fornecedor usou (Ex: CX, FD, KG).

=== Dados no Sistema (Direita) ===
Aqui você define como este produto entrará no seu estoque.

{{TabelaCampos|
{{Linha
| 1= Botão: Copiar do Anterior
| 2= Ferramenta de agilidade. Ao clicar, o sistema copia a Descrição, NCM e Códigos do XML para os campos do sistema. Ideal para cadastrar produtos novos rapidamente.
}}
{{Linha
| 1= Produto (Código)
| 2= Campo para selecionar o produto no seu estoque.
* '''Se já existe:''' Digite o código ou pressione F3 para buscar.
* '''Se é novo:''' Use o botão "Copiar do Anterior", coloque o cursor neste campo e pressione a tecla '''+ (Mais)''' do teclado numérico para gerar um novo código livre.
}}
{{Linha
| 1= CFOP / CST (Fiscal)
| 2= Classificação tributária de entrada. O sistema sugere a padrão (Ex: 1.102/2.102), mas deve ser verificada conforme a operação.
}}
{{Linha
| 1= Equivalente a (Fator)
| 2= '''Campo Crítico de Estoque.''' Define a conversão entre a unidade de compra e a de venda.
* '''Exemplo na imagem:''' O fornecedor vendeu 1 CX (Caixa). Se na sua loja você vende por UN (Unidade) e na caixa vêm 12, preencha '''12''' neste campo.
* '''Cálculo:''' Qtde Comprada (4) x Fator (1) = Qtde Convertida (4).
}}
{{Linha
| 1= Código de Barras / Referência
| 2= No rodapé da janela, você pode escolher entre '''Alterar para este''' (atualiza seu cadastro com o dado do XML) ou '''Manter este''' (preserva o dado atual do seu cadastro).
}}
}}

#: {{Print|image_2e8e67.png|Tela de relacionamento detalhada: Fator de conversão e dados do produto}}

== 3. Painel de Pendências (Rodapé) ==
Na tela principal de listagem, o rodapé exibe alertas importantes antes da importação final.

* '''Itens com pendência(s):''' Deve estar '''Zero''' para prosseguir. Clique em "Próximo" se houver pendências.
* '''Código barras divergente:''' Alerta quando o GTIN do produto mudou.
* '''NCM divergente:''' Alerta quando a classificação fiscal do fornecedor é diferente da sua.
* '''Ref. fornecedor divergente:''' Indica mudança no código interno do fornecedor.

Após resolver todas as linhas vermelhas, clique em '''Importar''' (canto inferior direito) para gerar a Nota de Entrada.

#: {{Print|image_2e8b1e.png|Tela pronta para importação (Todos os itens vinculados)}}

{{ContatoSuporte}}