Office System - Contribuições do(a) usuário(a) [pt-br]

Integração Sites

2026-04-29T18:33:17Z

Igor: /* Integração WooCommerce: */

==='''Integração Office Web:'''===

*Via FTP
*Arquivo XML

'''Exporta:'''

*Produtos > Imagens

'''Importa:'''

*Pedidos > parcelas (somente no pedido)
*Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração Dooca:'''===

*Via SFTP
*Arquivo JSON

'''Exporta:'''

*Atualiza o Estoque dos Produtos (necessário vincular o código do e-commerce no nosso código e-commerce manualmente)

'''Importa:'''

*Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração Dooca2:'''===

*Via API
*Arquivo JSON

'''Exporta (opcionais):'''

*Produtos (campos opcionais):
*#Nome
*#Preço (opção para tabela de preços)
*#Descrição
*#Descrição Curta
*#Quantidade Mínima
*#Peso
*#Profundidade
*#Largura
*#Altura
*#Inativo
*#Grades (somente Inserção):
*##Cor
*##Tamanho
*##Código de Barras

*Estoque
*Cores (somente Inserção)
*Tamanhos (somente Inserção)
*Notas Fiscais (venda)

'''Importa (opcionais):'''

*Pedidos (insere o Pedido e depois somente altera os Status e Pagamentos):
*#Status
*#Status Financeiro
*#Cliente
*#Nome Cliente
*#Data
*#Hora
*#Valor Total
*#Valor Frete
*#Data Entrega
*#Observação: contém nome de Pagamento, nro de Parcelas e o valor de cada
*#Produtos:
*##Quantidade
*##Valor Unitário
*##Valor de Desconto
*##Valor Total
*##Grades
*#Parcelas:
*##Data + 30 dias subsequentemente
*##Valor (valor total do Pedido / nro de parcelas)

**Clientes:
**#Nome
**#CPF
**#CNPJ
**#Data de Nascimento
**#Inscrição Estadual
**#Telefone
**#Data ficha
**#Email
**#Endereço:
**##Endereço
**##Número
**##Bairro
**##Complemento
**##CEP
**##Estado
**##Cidade

*Cores (somente Inserção)
*Tamanhos (somente Inserção)

___________________________________________________________________________________________________________________________________________

==='''Integração EBranvo:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos (ao atualizar envia somente o Estoque e Preço)
*Marcas (somente inserção)
*Grupos e Subgrupos (somente inserção).

'''Importa:'''

*Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

==='''Integração EcomDC:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos (ao atualizar envia somente Preço de Venda/Custo e Estoque)
*#Nome (Cadastro ou Descrição do e-commerce)
*#Código Interno
*#Descrição (Referencia técnica ou Nome)
*#Grupo
*#Subgrupo
*#Marca
*#Profundidade (É enviado como comprimento)
*#Largura
*#Altura
*#Peso (Bruto)
*#Cubagem
*#Garantia
*#Modelo
*#Código de Barras
*#Estoque (uma única loja)
*#Preço de venda
*#Preço de custo (Preço de custo ou Preço de custo 2)

'''Importa:'''

*Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração EMacro:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Tamanhos = variações
*Grupos e Subgrupos
*Produtos > Grades = variações do Produto
*Imagens dos Produtos

'''Importa:'''

*Pedidos (os itens possuem grades (variações))
*Clientes > Endereços

___________________________________________________________________________________________________________________________________________

==='''Integração Gluk:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos

'''Importa:'''

*Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

==='''Integração Magento:'''===

*Via API
*Arquivo JSON

'''Exporta (inseri e atualiza):'''

*Produtos:
*#Nome (dados ecommerce)
*#Preço
*#Código interno
*#Inativo
*#Peso bruto
*#Saldo estoque (opcional)
*#Referência técnica
*#Nome
*#Opção de marketplace
*#Código de barras
*#Voltagem
*#Profundidade
*#Altura
*#Largura
*#Atraso expedição
*#Grupo e subgrupo (importa todas categorias do ecommerce para então verificar se o nome é igual e utilizar o código)
*#Imagens

'''Importa:'''

*Pedidos:
*#Cliente
*#Nome cliente
*#Data
*#Hora
*#Status
*#Status financeiro
*#Frete
*#Tipo frete
*#Valor total
*#Observação: informações de pagamento
*#Itens:
*##Quantidade
*##Valor unitário
*##Valor frete
*##Percentual de desconto
*##Valor de desconto
*##Valor total

**Clientes:
**#Nome
**#CPF
**#CNPJ
**#Data de Nascimento
**#Inscrição Estadual
**#Telefone
**#Data ficha
**#Email
**#Endereço principal e múltiplos endereços:
**##Endereço
**##Número
**##Bairro
**##Complemento
**##CEP
**##Estado
**##Cidade

___________________________________________________________________________________________________________________________________________

==='''Integração Mercado Livre:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Anúncios (tela específica criada no MasterKey) > Produtos (> imagens)

'''Importa:'''

*Pedidos > Clientes / Contas a Receber
*Categorias Mercado Livre (tabela específica criada no MasterKey)

___________________________________________________________________________________________________________________________________________

==='''Integração Tray:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Categorias eCommerce
*Produtos opção de seleção em separado do que Incluiu ou Atualiza
*#Código de Barras
*#Nome
*#Código Interno
*#Altura
*#Largura
*#Comprimento
*#Data lançamento
*#Disponivel
*#Estoque (uma ou mais lojas)
*#Preço Promocional
*#Inicio/fim promoção
*#Marca
*#modelo
*#Observação
*#Opções de Pagamento
*#Peso Bruto
*#Preço de Custo
*#Preço de Venda (Cadastro ou Tabela)

*Variações (Produtos similares no master key)
*#Código Interno
*#Produto Pai
*#Tipo
*#Variação
*#Altura
*#Lagura
*#Comprimento
*#Preço de Venda
*#Preço Promocional
*#Inicio/Fim promoção
*#Peso Bruto

*Dados do Faturamento
*#Nro da Nota
*#Data Emissão Nf
*#Chave Nfe

'''Importa:'''

*Cliente
*Pedidos

___________________________________________________________________________________________________________________________________________

==='''Integração Magazord:'''===

*Via API
*Arquivo JSON

Obs: Não tem como fazer para não enviar o tamanho "Único", da problema no envio de imagens

'''Exporta:'''

*Categorias Ecommerce

*Marcas

*Derivações (Grades - Tamanho e Cor)

*Imagens

*Produtos (Incluiu e Atualiza)
*#Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
*#Cód.Barra
*#Peso
*#Altura (Dados Ecommerce)
*#Largura (Dados Ecommerce)
*#Profundidade (Dados Ecommerce)
*#Modelo (Dados Ecommerce)
*#Garantia (Envia fixo o id 1)
*#NCM
*#CEST
*#Unidade
*#Categoria Ecommerce (Dados Ecommerce)
*#Acompanha (É o campo Observação do cadastro do produto do Master Key)
*#Imagens

*Derivações (Grades no master key)
*#Nome/Identificação
*#Cod.Barra

*Preços (opção de selecionar a tabela)

*Estoque (opção de selecionar a loja)
*#produto e grade

'''Importa:'''

*Cliente
*Pedidos

 

Possíveis erros

(NFe) Nota não encontrada:

Este erro acontece pois o integrador não consegue encontrar a nota dentro do banco do '''MASTER-NFE''' para enviar. Acontece geralmente quando o cliente tem sincroniza, pois fazem notas em outros "servidores" e acaba não conseguindo sincronizar. Se o cliente não quer a nota no site, basta rodar este comando para ignorar a sincronização desta nota:<syntaxhighlight lang="sql">
DELETE FROM campos c
WHERE c.cp_tabela = 'PedidoVenda'
AND c.cp_idinterno = :codigo_do_pedido
</syntaxhighlight>Para pegar o código do pedido, basta ir no integrador, dar dois cliques no erro e pegar o código. ___________________________________________________________________________________________________________________________________________

==='''Integração Site Mercado:'''===

*Via API

'''Observações:'''

*É necessário no mínimo 200 produtos cadastrados para ter uma carga completa de dados
*Produtos devem ter no mínimo Status e Nome Ecommerce.

'''Primeiros passos:'''

*Cliente entrar em contato com o SiteMercado informando ter o sistema da Officesystem que já foi feito a homologação via API e deseja utiliza-lo;
*Solicitar ClienID e Client Secret;
*Enviado a primeira carga de dados pelo nosso sistema;
*Entrar em contato novamente com SiteMercado e solicitar o Link de testes;
*Utilizar o Link fazendo a verificação se esta tudo funcionando corretamente;
*Solicitar liberação do modo produção;

'''Exporta:'''

*Produtos opção de seleção em separado do que Incluiu ou Atualiza
*#Código de Barras
*#Nome
*#Código Interno
*#Altura
*#Largura
*#Comprimento
*#Data lançamento
*#Disponível
*#Estoque (uma ou mais lojas)
*#Preço Promocional
*#Inicio/fim promoção
*#Marca
*#modelo
*#Observação
*#Opções de Pagamento
*#Peso Bruto
*#Preço de Custo
*#Preço de Venda (Cadastro ou Tabela)

'''Importa:'''

*Cliente
*Pedidos

___________________________________________________________________________________________________________________________________________
==='''Integração VTEX'''===

*Via API

___________________________________________________________________________________________________________________________________________
==='''Integração Loja Integrada'''===
'''Observações:'''

*O integrador apenas envia imagens dos produtos. Ele não remove e nem altera a ordenação das imagens. É necessário realizar manualmente pelo site.
*Não é possível alterar se o produto é lançamento ou não. Isso é realizado automaticamente pela LojaIntegrada.

'''Enviar similares (na Loja Integrada fica como grade/variação):'''

*Depois que um produto for enviado sem similar, não é possível atualizar e enviar com similar pro site. É necessario excluir o mesmo da Loja Integrada e reenviar com o similar já cadastrado.
*O produto "pai" que vai ter os similares no MKey, não vai mais ser possível vender na Loja Integrada, apenas os similares

*Depois de cadastrado um produto similar, não é possível alterar e nem excluir a variação. Pelo site da Loja Integrada é possível alterar e excluir.
*Os produtos similares não aceitam imagens, então foi atualizado para enviar para o produto pai as imagens do produto filho.
*Na LI as variações ficam dentro do cadastro de grades, em uma grade chamada "Variações".
*Ao cadastrar um similiar no Mkey, '''NÃO''' adicionar o produto "pai" como similar do "filho" ou de outro produto.

Exemplo de cadastro de similares no MKey:

*Saco Golden Carne (Pai)
**Saco Golden Carne 15 kg (Similar)
**Saco Golden Carne 20kg (Similar)

'''Erros e Soluções:'''

<nowiki>Erro: {"error": {"produto": {"grades": ["Grades só podem ser enviadas caso o tipo do produto seja atributo"]}}, "error_message": "Um ou mais campos não são válidos."}</nowiki>

Acontece quando é adicionado um produto similar em um produto que já foi enviado para a Loja Integrada

Solução: Para resolver tem que excluir os PRODUTOS e as GRADES (Similares) da LI, executar o relatório configurado com os códigos dos produtos no MK4 e reenviar para a LI com os similares já informados.

Caso queira executar pelo Ibexpert, pode executar os seguintes comandos, informando os códigos dos produtos:

*'''DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN ('''''código dos produtos aqui''''')'''
*'''DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN (SELECT p.pr_nome FROM produtos p WHERE p.pr_codigo IN ('''''código dos produtos aqui'''''))'''

*'''UPDATE prodecom p SET p.ec_hratlz = current_time WHERE p.ec_produto in ('''''código dos produtos aqui''''')'''
*'''UPDATE produtos pr SET pr.pr_hratlz = current_time WHERE pr.pr_codigo in ('''''código dos produtos aqui''''')'''

'''Exporta:'''

*Produtos
*#Código Interno
*#Nome
*#Descrição Completa
*#Ativo
*#Destaque
*#NCM
*#Peso
*#Altura
*#Largura
*#Profundidade
*#Marca
*#GTIN
*#Categoria
*#Imagens
*#Similares (Ler observações)

*Preços
*#Preço de venda
*#Preço de custo
*#Preço promocional

*Marcas
*#Nome
*#Apelido
*#Descrição
*#Ativo
*Categorias
*#Nome
*#Descrição
*#Categoria Pai
*Estoque
*#Quantidade em estoques

'''Importa:'''

*Cliente
*Pedidos

*

___________________________________________________________________________________________________________________________________________
==='''Integração MK Shops'''===
___________________________________________________________________________________________________________________________________________

==='''Integração Shopify'''===

*Via API

'''Observações:'''

*O status do pedido só é atualizado se for cancelado no MKey e se o mesmo não estiver com status de pago na Shopify
*Ao gerar NF dos pedidos, os mesmos tem que ter seu status atualizado na shopify
*Shopify não aceita envio de NF
*Cada grade aceita apenas uma imagem de "capa", mas as outras também são cadastradas no produto

'''Exporta:'''

*Produtos
*#Nome
*#Descrição Completa
*#Ativo
*#Peso
*#Altura
*#Categoria
*#Imagens
*#Grades

*Preços
*#Preço de venda
*Estoque
*#Quantidade em estoque

'''Importa:'''

*Cliente
*Pedidos

'''Configurações:'''

URL: [https://topbonsai-6806.myshopify.com/admin/api https://{usuario}.myshopify.com/admin/api]
[[Arquivo:URL Shopify.png|esquerda|miniaturadaimagem|313x313px|Substituir {usuario} pelo usuario do cliente na Shopify. Pode ser obtido pelo link de acesso da plataforma admin (é o que vem depois de "store/")]]

Obs: geralmente não é o mesmo do url de dominio da loja.

'''Token:'''

Passo a passo para gerar o token da Shopify:
[[Arquivo:Integração Shopify Token 1.png|esquerda|miniaturadaimagem|635x635px|Acessar "Configurações da Shopify" -> "Apps e canais de venda" -> "Desenvolver apps"]]

 
[[Arquivo:Integração Shopify Token 2.png|esquerda|miniaturadaimagem|631x631px|Informar o nome da Integração. Pode ser qualquer coisa]]

[[Arquivo:Integração Shopify Token 3.png|esquerda|miniaturadaimagem|Na aba "Configuração" é necessário configurar a integração. Em "Escopos de acesso à API Admin" pode marcar tudo e em "Assinaturas do webhook" selecionar "2024-04"]]

[[Arquivo:Integração Shopify Token 4.png|esquerda|miniaturadaimagem|Instalar o app para gerar o token]]

 
[[Arquivo:Integração Shopify Token 5.png|esquerda|miniaturadaimagem|640x640px|Pronto, só copiar o token e inserir no integrador. Só é possível visualizar uma vez o token, se ele se perder é necessário realizar o passo a passo novamente]]

___________________________________________________________________________________________________________________________________________
==='''Integração Mercos'''===

(Manual em Desenvolvimento) Normalmente usado em substituição ao MK Mobile. Porem pode ser usado também para integração com Sites. Precisa de Categorias eCommerce e envia os que estiverem disponiveis nos Dados eCommerce.

*Via API

'''Exporta:'''

*Produtos
*#Nome
*#Descrição Completa
*#Ativo
*#Peso
*#Altura
*#Categoria eCommerce
*#Imagens

*Preços
*#Preço de venda
*#Tabelas de Preço
*Estoque
*#Quantidade em estoque

'''Importa:'''

*Pedidos

'''Erros:'''

*"Produto {id} não encontrado. Verifique!" - Aconteceu algum erro de vinculação MK -> Mercos ou o cliente criou o produto manual no site
**Rodar essa SQL vinculando um produto do MK com o la da Mercos<syntaxhighlight lang="sql">
-- ERRO DE VINCULO DE PRODUTO MERCOS -> MK
INSERT INTO CAMPOS (CP_ID, CP_INTEGRACAO, CP_TABELA, CP_IDINTERNO, CP_CAMPO, CP_VALOR)
VALUES (GEN_ID(GEN_CAMPOS,1), 'IntegraMercos', 'Produtos', :IDINTERNO, 'Codigo', :IDEXTERNO);
</syntaxhighlight>
*Erro: Não existe usuario com o email "Teste@mercos.com" cadastrado. Verifique!
**Você precisa criar um vendedor com o e-mail que mostra na rejeição. (se tiver essa rejeição, não sincroniza: Clientes, Pedidos, etc...)

___________________________________________________________________________________________________________________________________________
==='''Integração NuvemShop:'''===

*Via API
*Arquivo JSON

'''Instalação:'''

''--- Inicio do Processo feito por Fernando, Maico ou Jonas ---''

<nowiki>***</nowiki>Está nos Documentos do Office Atendimentos o passo a passo.

'''**** Muito importante, após gerar as credenciais, entrar em <nowiki>https://partners.nuvemshop.com.br/</nowiki> no computador do cliente e sair da conta da Office.'''

''--- Fim do prcesso feito por Fernando, Maico ou Jonas ---''

No integrador:

*URL: <nowiki>https://api.nuvemshop.com.br/v1/{</nowiki>''user_id''}
*API Key: {''access_token''}

'''Exporta:'''

*Categorias Ecommerce

*Marcas

*Derivações (Grades - Tamanho e Cor / Produto precisa possuir grades e estar marcado para enviar no Integrado / "Descrição no Site" (vale para todos os produtos) só é necessario se o cliente cadastrou na cor ou no tamanho algo diferente, por exemplo os sabor, aroma... Caso contrario o integrador envia TAMANHO como Tamanho e COR como Cor / Também é possivel enviar somente COR ou Somente TAMANHO)

*Imagens (Envia imagens do produto e grade junto, só da para editar qual é a imagem de cada grade pelo site)

*Produtos (Incluiu e Atualiza)
*#Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
*#Cód.Barra
*#Peso
*#Altura (Dados Ecommerce)
*#Largura (Dados Ecommerce)
*#Profundidade (Dados Ecommerce)
*#Unidade
*#Categoria Ecommerce (Dados Ecommerce)
*#Acompanha (É o campo Observação do cadastro do produto do Master Key)
*#Imagens

*Derivações (Grades no master key)
*#Nome/Identificação
*#Cod.Barra

*Preços (opção de selecionar a tabela)

*Estoque (opção de selecionar a loja)
*#produto e grade

'''Importa:'''

*Cliente
*Pedidos

___________________________________________________________________________________________________________________________________________

==='''Integração WooCommerce:'''===

*Via API
*Arquivo JSON

'''Erros:'''

'''The SKU you are trying to insert is already under processing'''

Ele normalmente ocorre por dois motivos:

1. Produto na lixeira do WooCommerce

Dentro do WooCommerce, na área de Produtos, existe a seção de Lixeira.

Se o produto estiver lá, mesmo apagado, o WooCommerce entende que o SKU ainda existe e bloqueia a criação.

👉 Solução: Esvaziar a lixeira. Isso costuma resolver imediatamente.

2. Bug interno do WooCommerce

Em alguns casos, existe um bug no WooCommerce em que o SKU fica “preso” no banco de dados.

A correção envolve rodar comandos diretamente no banco para remover o registro.

👉 Solução: Essa parte precisa ser feita por quem desenvolveu o site ou pelo responsável pelo servidor.

Se não for possível corrigir, outra alternativa é configurar para que esse produto não seja enviado.

'''-> (ERRO) que você está tentando inserir já está presente na tabela de consulta woocommerce'''

👉 Solução: É algum bug no WooCommerce, um jeito que testei e funcionou é entrar na aba do WooCommerce e ir em Status -> Ferramentas e clicar em gerar tabela para consulta rápida de produtos (as vezes tem que esperar um pouco), dai clicar para sincronizar novamente.
[[Arquivo:Imagem 9992.png|esquerda|miniaturadaimagem]]

Arquivo:Imagem 9992.png

2026-04-29T18:32:50Z

Igor:

Erro

Integração Sites

2025-10-17T17:58:02Z

Igor:

==='''Integração Office Web:'''===

*Via FTP
*Arquivo XML

'''Exporta:'''

*Produtos > Imagens

'''Importa:'''

*Pedidos > parcelas (somente no pedido)
*Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração Dooca:'''===

*Via SFTP
*Arquivo JSON

'''Exporta:'''

*Atualiza o Estoque dos Produtos (necessário vincular o código do e-commerce no nosso código e-commerce manualmente)

'''Importa:'''

*Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração Dooca2:'''===

*Via API
*Arquivo JSON

'''Exporta (opcionais):'''

*Produtos (campos opcionais):
*#Nome
*#Preço (opção para tabela de preços)
*#Descrição
*#Descrição Curta
*#Quantidade Mínima
*#Peso
*#Profundidade
*#Largura
*#Altura
*#Inativo
*#Grades (somente Inserção):
*##Cor
*##Tamanho
*##Código de Barras

*Estoque
*Cores (somente Inserção)
*Tamanhos (somente Inserção)
*Notas Fiscais (venda)

'''Importa (opcionais):'''

*Pedidos (insere o Pedido e depois somente altera os Status e Pagamentos):
*#Status
*#Status Financeiro
*#Cliente
*#Nome Cliente
*#Data
*#Hora
*#Valor Total
*#Valor Frete
*#Data Entrega
*#Observação: contém nome de Pagamento, nro de Parcelas e o valor de cada
*#Produtos:
*##Quantidade
*##Valor Unitário
*##Valor de Desconto
*##Valor Total
*##Grades
*#Parcelas:
*##Data + 30 dias subsequentemente
*##Valor (valor total do Pedido / nro de parcelas)

**Clientes:
**#Nome
**#CPF
**#CNPJ
**#Data de Nascimento
**#Inscrição Estadual
**#Telefone
**#Data ficha
**#Email
**#Endereço:
**##Endereço
**##Número
**##Bairro
**##Complemento
**##CEP
**##Estado
**##Cidade

*Cores (somente Inserção)
*Tamanhos (somente Inserção)

___________________________________________________________________________________________________________________________________________

==='''Integração EBranvo:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos (ao atualizar envia somente o Estoque e Preço)
*Marcas (somente inserção)
*Grupos e Subgrupos (somente inserção).

'''Importa:'''

*Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

==='''Integração EcomDC:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos (ao atualizar envia somente Preço de Venda/Custo e Estoque)
*#Nome (Cadastro ou Descrição do e-commerce)
*#Código Interno
*#Descrição (Referencia técnica ou Nome)
*#Grupo
*#Subgrupo
*#Marca
*#Profundidade (É enviado como comprimento)
*#Largura
*#Altura
*#Peso (Bruto)
*#Cubagem
*#Garantia
*#Modelo
*#Código de Barras
*#Estoque (uma única loja)
*#Preço de venda
*#Preço de custo (Preço de custo ou Preço de custo 2)

'''Importa:'''

*Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

==='''Integração EMacro:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Tamanhos = variações
*Grupos e Subgrupos
*Produtos > Grades = variações do Produto
*Imagens dos Produtos

'''Importa:'''

*Pedidos (os itens possuem grades (variações))
*Clientes > Endereços

___________________________________________________________________________________________________________________________________________

==='''Integração Gluk:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Produtos

'''Importa:'''

*Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

==='''Integração Magento:'''===

*Via API
*Arquivo JSON

'''Exporta (inseri e atualiza):'''

*Produtos:
*#Nome (dados ecommerce)
*#Preço
*#Código interno
*#Inativo
*#Peso bruto
*#Saldo estoque (opcional)
*#Referência técnica
*#Nome
*#Opção de marketplace
*#Código de barras
*#Voltagem
*#Profundidade
*#Altura
*#Largura
*#Atraso expedição
*#Grupo e subgrupo (importa todas categorias do ecommerce para então verificar se o nome é igual e utilizar o código)
*#Imagens

'''Importa:'''

*Pedidos:
*#Cliente
*#Nome cliente
*#Data
*#Hora
*#Status
*#Status financeiro
*#Frete
*#Tipo frete
*#Valor total
*#Observação: informações de pagamento
*#Itens:
*##Quantidade
*##Valor unitário
*##Valor frete
*##Percentual de desconto
*##Valor de desconto
*##Valor total

**Clientes:
**#Nome
**#CPF
**#CNPJ
**#Data de Nascimento
**#Inscrição Estadual
**#Telefone
**#Data ficha
**#Email
**#Endereço principal e múltiplos endereços:
**##Endereço
**##Número
**##Bairro
**##Complemento
**##CEP
**##Estado
**##Cidade

___________________________________________________________________________________________________________________________________________

==='''Integração Mercado Livre:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Anúncios (tela específica criada no MasterKey) > Produtos (> imagens)

'''Importa:'''

*Pedidos > Clientes / Contas a Receber
*Categorias Mercado Livre (tabela específica criada no MasterKey)

___________________________________________________________________________________________________________________________________________

==='''Integração Tray:'''===

*Via API
*Arquivo JSON

'''Exporta:'''

*Categorias eCommerce
*Produtos opção de seleção em separado do que Incluiu ou Atualiza
*#Código de Barras
*#Nome
*#Código Interno
*#Altura
*#Largura
*#Comprimento
*#Data lançamento
*#Disponivel
*#Estoque (uma ou mais lojas)
*#Preço Promocional
*#Inicio/fim promoção
*#Marca
*#modelo
*#Observação
*#Opções de Pagamento
*#Peso Bruto
*#Preço de Custo
*#Preço de Venda (Cadastro ou Tabela)

*Variações (Produtos similares no master key)
*#Código Interno
*#Produto Pai
*#Tipo
*#Variação
*#Altura
*#Lagura
*#Comprimento
*#Preço de Venda
*#Preço Promocional
*#Inicio/Fim promoção
*#Peso Bruto

*Dados do Faturamento
*#Nro da Nota
*#Data Emissão Nf
*#Chave Nfe

'''Importa:'''

*Cliente
*Pedidos

___________________________________________________________________________________________________________________________________________

==='''Integração Magazord:'''===

*Via API
*Arquivo JSON

Obs: Não tem como fazer para não enviar o tamanho "Único", da problema no envio de imagens

'''Exporta:'''

*Categorias Ecommerce

*Marcas

*Derivações (Grades - Tamanho e Cor)

*Imagens

*Produtos (Incluiu e Atualiza)
*#Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
*#Cód.Barra
*#Peso
*#Altura (Dados Ecommerce)
*#Largura (Dados Ecommerce)
*#Profundidade (Dados Ecommerce)
*#Modelo (Dados Ecommerce)
*#Garantia (Envia fixo o id 1)
*#NCM
*#CEST
*#Unidade
*#Categoria Ecommerce (Dados Ecommerce)
*#Acompanha (É o campo Observação do cadastro do produto do Master Key)
*#Imagens

*Derivações (Grades no master key)
*#Nome/Identificação
*#Cod.Barra

*Preços (opção de selecionar a tabela)

*Estoque (opção de selecionar a loja)
*#produto e grade

'''Importa:'''

*Cliente
*Pedidos

 

Possíveis erros

(NFe) Nota não encontrada:

Este erro acontece pois o integrador não consegue encontrar a nota dentro do banco do '''MASTER-NFE''' para enviar. Acontece geralmente quando o cliente tem sincroniza, pois fazem notas em outros "servidores" e acaba não conseguindo sincronizar. Se o cliente não quer a nota no site, basta rodar este comando para ignorar a sincronização desta nota:<syntaxhighlight lang="sql">
DELETE FROM campos c
WHERE c.cp_tabela = 'PedidoVenda'
AND c.cp_idinterno = :codigo_do_pedido
</syntaxhighlight>Para pegar o código do pedido, basta ir no integrador, dar dois cliques no erro e pegar o código. ___________________________________________________________________________________________________________________________________________

==='''Integração Site Mercado:'''===

*Via API

'''Observações:'''

*É necessário no mínimo 200 produtos cadastrados para ter uma carga completa de dados
*Produtos devem ter no mínimo Status e Nome Ecommerce.

'''Primeiros passos:'''

*Cliente entrar em contato com o SiteMercado informando ter o sistema da Officesystem que já foi feito a homologação via API e deseja utiliza-lo;
*Solicitar ClienID e Client Secret;
*Enviado a primeira carga de dados pelo nosso sistema;
*Entrar em contato novamente com SiteMercado e solicitar o Link de testes;
*Utilizar o Link fazendo a verificação se esta tudo funcionando corretamente;
*Solicitar liberação do modo produção;

'''Exporta:'''

*Produtos opção de seleção em separado do que Incluiu ou Atualiza
*#Código de Barras
*#Nome
*#Código Interno
*#Altura
*#Largura
*#Comprimento
*#Data lançamento
*#Disponível
*#Estoque (uma ou mais lojas)
*#Preço Promocional
*#Inicio/fim promoção
*#Marca
*#modelo
*#Observação
*#Opções de Pagamento
*#Peso Bruto
*#Preço de Custo
*#Preço de Venda (Cadastro ou Tabela)

'''Importa:'''

*Cliente
*Pedidos

___________________________________________________________________________________________________________________________________________
==='''Integração VTEX'''===

*Via API

___________________________________________________________________________________________________________________________________________
==='''Integração Loja Integrada'''===
'''Observações:'''

*O integrador apenas envia imagens dos produtos. Ele não remove e nem altera a ordenação das imagens. É necessário realizar manualmente pelo site.
*Não é possível alterar se o produto é lançamento ou não. Isso é realizado automaticamente pela LojaIntegrada.

'''Enviar similares (na Loja Integrada fica como grade/variação):'''

*Depois que um produto for enviado sem similar, não é possível atualizar e enviar com similar pro site. É necessario excluir o mesmo da Loja Integrada e reenviar com o similar já cadastrado.
*O produto "pai" que vai ter os similares no MKey, não vai mais ser possível vender na Loja Integrada, apenas os similares

*Depois de cadastrado um produto similar, não é possível alterar e nem excluir a variação. Pelo site da Loja Integrada é possível alterar e excluir.
*Os produtos similares não aceitam imagens, então foi atualizado para enviar para o produto pai as imagens do produto filho.
*Na LI as variações ficam dentro do cadastro de grades, em uma grade chamada "Variações".
*Ao cadastrar um similiar no Mkey, '''NÃO''' adicionar o produto "pai" como similar do "filho" ou de outro produto.

Exemplo de cadastro de similares no MKey:

*Saco Golden Carne (Pai)
**Saco Golden Carne 15 kg (Similar)
**Saco Golden Carne 20kg (Similar)

'''Erros e Soluções:'''

<nowiki>Erro: {"error": {"produto": {"grades": ["Grades só podem ser enviadas caso o tipo do produto seja atributo"]}}, "error_message": "Um ou mais campos não são válidos."}</nowiki>

Acontece quando é adicionado um produto similar em um produto que já foi enviado para a Loja Integrada

Solução: Para resolver tem que excluir os PRODUTOS e as GRADES (Similares) da LI, executar o relatório configurado com os códigos dos produtos no MK4 e reenviar para a LI com os similares já informados.

Caso queira executar pelo Ibexpert, pode executar os seguintes comandos, informando os códigos dos produtos:

*'''DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN ('''''código dos produtos aqui''''')'''
*'''DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN (SELECT p.pr_nome FROM produtos p WHERE p.pr_codigo IN ('''''código dos produtos aqui'''''))'''

*'''UPDATE prodecom p SET p.ec_hratlz = current_time WHERE p.ec_produto in ('''''código dos produtos aqui''''')'''
*'''UPDATE produtos pr SET pr.pr_hratlz = current_time WHERE pr.pr_codigo in ('''''código dos produtos aqui''''')'''

'''Exporta:'''

*Produtos
*#Código Interno
*#Nome
*#Descrição Completa
*#Ativo
*#Destaque
*#NCM
*#Peso
*#Altura
*#Largura
*#Profundidade
*#Marca
*#GTIN
*#Categoria
*#Imagens
*#Similares (Ler observações)

*Preços
*#Preço de venda
*#Preço de custo
*#Preço promocional

*Marcas
*#Nome
*#Apelido
*#Descrição
*#Ativo
*Categorias
*#Nome
*#Descrição
*#Categoria Pai
*Estoque
*#Quantidade em estoques

'''Importa:'''

*Cliente
*Pedidos

*

___________________________________________________________________________________________________________________________________________
==='''Integração MK Shops'''===
___________________________________________________________________________________________________________________________________________

==='''Integração Shopify'''===

*Via API

'''Observações:'''

*O status do pedido só é atualizado se for cancelado no MKey e se o mesmo não estiver com status de pago na Shopify
*Ao gerar NF dos pedidos, os mesmos tem que ter seu status atualizado na shopify
*Shopify não aceita envio de NF
*Cada grade aceita apenas uma imagem de "capa", mas as outras também são cadastradas no produto

'''Exporta:'''

*Produtos
*#Nome
*#Descrição Completa
*#Ativo
*#Peso
*#Altura
*#Categoria
*#Imagens
*#Grades

*Preços
*#Preço de venda
*Estoque
*#Quantidade em estoque

'''Importa:'''

*Cliente
*Pedidos

'''Configurações:'''

URL: [https://topbonsai-6806.myshopify.com/admin/api https://{usuario}.myshopify.com/admin/api]
[[Arquivo:URL Shopify.png|esquerda|miniaturadaimagem|313x313px|Substituir {usuario} pelo usuario do cliente na Shopify. Pode ser obtido pelo link de acesso da plataforma admin (é o que vem depois de "store/")]]

Obs: geralmente não é o mesmo do url de dominio da loja.

'''Token:'''

Passo a passo para gerar o token da Shopify:
[[Arquivo:Integração Shopify Token 1.png|esquerda|miniaturadaimagem|635x635px|Acessar "Configurações da Shopify" -> "Apps e canais de venda" -> "Desenvolver apps"]]

 
[[Arquivo:Integração Shopify Token 2.png|esquerda|miniaturadaimagem|631x631px|Informar o nome da Integração. Pode ser qualquer coisa]]

[[Arquivo:Integração Shopify Token 3.png|esquerda|miniaturadaimagem|Na aba "Configuração" é necessário configurar a integração. Em "Escopos de acesso à API Admin" pode marcar tudo e em "Assinaturas do webhook" selecionar "2024-04"]]

[[Arquivo:Integração Shopify Token 4.png|esquerda|miniaturadaimagem|Instalar o app para gerar o token]]

 
[[Arquivo:Integração Shopify Token 5.png|esquerda|miniaturadaimagem|640x640px|Pronto, só copiar o token e inserir no integrador. Só é possível visualizar uma vez o token, se ele se perder é necessário realizar o passo a passo novamente]]

___________________________________________________________________________________________________________________________________________
==='''Integração Mercos'''===

(Manual em Desenvolvimento) Normalmente usado em substituição ao MK Mobile. Porem pode ser usado também para integração com Sites. Precisa de Categorias eCommerce e envia os que estiverem disponiveis nos Dados eCommerce.

*Via API

'''Exporta:'''

*Produtos
*#Nome
*#Descrição Completa
*#Ativo
*#Peso
*#Altura
*#Categoria eCommerce
*#Imagens

*Preços
*#Preço de venda
*#Tabelas de Preço
*Estoque
*#Quantidade em estoque

'''Importa:'''

*Pedidos

'''Erros:'''

*"Produto {id} não encontrado. Verifique!" - Aconteceu algum erro de vinculação MK -> Mercos ou o cliente criou o produto manual no site
**Rodar essa SQL vinculando um produto do MK com o la da Mercos<syntaxhighlight lang="sql">
-- ERRO DE VINCULO DE PRODUTO MERCOS -> MK
INSERT INTO CAMPOS (CP_ID, CP_INTEGRACAO, CP_TABELA, CP_IDINTERNO, CP_CAMPO, CP_VALOR)
VALUES (GEN_ID(GEN_CAMPOS,1), 'IntegraMercos', 'Produtos', :IDINTERNO, 'Codigo', :IDEXTERNO);
</syntaxhighlight>
*Erro: Não existe usuario com o email "Teste@mercos.com" cadastrado. Verifique!
**Você precisa criar um vendedor com o e-mail que mostra na rejeição. (se tiver essa rejeição, não sincroniza: Clientes, Pedidos, etc...)

___________________________________________________________________________________________________________________________________________
==='''Integração NuvemShop:'''===

*Via API
*Arquivo JSON

'''Instalação:'''

''--- Inicio do Processo feito por Fernando, Maico ou Jonas ---''

No computador do cliente, onde ele já está logado na area de admin da NuvemShop, acessar e efetuar login com as credenciais da Office em '''https://partners.nuvemshop.com.br/'''

Adicionar o aplicativo na loja do cliente através do link "<nowiki>https://{endereco-area-de-admin-loja-cliente}/admin/apps/14811/authorize</nowiki>", exemplo "<nowiki>https://cajuchocolates.lojavirtualnuvem.com.br/admin/apps/14811/authorize</nowiki>".

Ao acessar o link acima, vai carregar uma página onde se deve aceitar as permissões de integração e irá gerar um código para requisição do ''user_id'' e ''access_token''. (''Vem um "Client Code" usando curl pronto, que pode ser executado no terminal Linux'')

Após efetuar essa requisição, será retornado o ''user_id'' e ''access_token''.

'''**** Muito importante, após gerar as credenciais, entrar em <nowiki>https://partners.nuvemshop.com.br/</nowiki> no computador do cliente e sair da conta da Office.'''

''--- Fim do prcesso feito por Fernando, Maico ou Jonas ---''

No integrador:

*URL: <nowiki>https://api.nuvemshop.com.br/v1/{</nowiki>''user_id''}
*API Key: {''access_token''}

'''Exporta:'''

*Categorias Ecommerce

*Marcas

*Derivações (Grades - Tamanho e Cor / Produto precisa possuir grades e estar marcado para enviar no Integrado / "Descrição no Site" (vale para todos os produtos) só é necessario se o cliente cadastrou na cor ou no tamanho algo diferente, por exemplo os sabor, aroma... Caso contrario o integrador envia TAMANHO como Tamanho e COR como Cor / Também é possivel enviar somente COR ou Somente TAMANHO)

*Imagens (Envia imagens do produto e grade junto, só da para editar qual é a imagem de cada grade pelo site)

*Produtos (Incluiu e Atualiza)
*#Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
*#Cód.Barra
*#Peso
*#Altura (Dados Ecommerce)
*#Largura (Dados Ecommerce)
*#Profundidade (Dados Ecommerce)
*#Unidade
*#Categoria Ecommerce (Dados Ecommerce)
*#Acompanha (É o campo Observação do cadastro do produto do Master Key)
*#Imagens

*Derivações (Grades no master key)
*#Nome/Identificação
*#Cod.Barra

*Preços (opção de selecionar a tabela)

*Estoque (opção de selecionar a loja)
*#produto e grade

'''Importa:'''

*Cliente
*Pedidos

Gera Vale

2025-08-29T14:42:55Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a criar Vales e entender melhor como ele funciona.

===Utilização:===

*Usado como Vale Presente.
*Usado em caso de devolução de mercadoria. Cliente recebe um vale para futuras compras no estabelicimento.

===Como gerar um vale:===

====Local:====
Master Key:

*Financeiro > Gera Vale.

PDV (Ponto de vendas):

*Emissão > Vale:

====Como Criar um novo vale:====
Para gerar o seu primeiro vale, você precisa fazer os seguintes passos.

*Selecione um cliente ou cadastre ele antes (para aprender a cadastrar clique aqui).
*No campo valor, adicione o valor do vale que vai ser gerado.
*Quantidade de vales normalmente seria 1 mas se for mais, só aumentar o numero.
*Categorias
*Subcategorias
*Observação não é obrigatorio mas você pode adicionar.

para finalizar, só clicar em Pagar e Gerar Vale.
====Como criar um vale por uma devolução de venda:====
Quando é feito uma devolução utilizando a janela "Gerador de NF de devolução" Você vai ter a opção de gerar um vale dessa devolução.

Antes de você clicar em Gerar NF de Devolução. Você seleciona a opção vale e preencha as informações de Categoria e subcategoria. como na imagem a baixo.

 
[[Arquivo:Gerar vale devolução.png|centro|miniaturadaimagem]]

 
===Perguntas frequentes:===

====- Aonde fica esses vales que foram criados?====
Você pode pesquisar eles dentro do contas a Pagar em "opções > Filtros > Somente Vales"

====- Como reemprimir um vale?====
Você pode ir em Financeiro > Contas a Pagar. Opções > Filtros > Somente Vales. Após você pode encontrar esse vale por algum filtro exemplo: nome do Cliente, Controle,etc..

entre no vale que deseja reemprimir, clica em opções > reemprimir vale.

Gera Vale

2025-08-29T14:42:37Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a criar Vales e entender melhor como ele funciona.

===Utilização:===

*Usado como Vale Presente.
*Usado em caso de devolução de mercadoria. Cliente recebe um vale para futuras compras no estabelicimento.

===Como gerar um vale:===

====Local:====
Master Key:

*Financeiro > Gera Vale.

PDV (Ponto de vendas):

*Emissão > Vale:

====Como Criar um novo vale:====
Para gerar o seu primeiro vale, você precisa fazer os seguintes passos.

*Selecione um cliente ou cadastre ele antes (para aprender a cadastrar clique aqui).
*No campo valor, adicione o valor do vale que vai ser gerado.
*Quantidade de vales normalmente seria 1 mas se for mais, só aumentar o numero.
*Categorias
*Subcategorias
*Observação não é obrigatorio mas você pode adicionar.

para finalizar, só clicar em Pagar e Gerar Vale.
[[Arquivo:Gerar vale devolução.png|centro|miniaturadaimagem]]

====Como criar um vale por uma devolução de venda:====
Quando é feito uma devolução utilizando a janela "Gerador de NF de devolução" Você vai ter a opção de gerar um vale dessa devolução.

Antes de você clicar em Gerar NF de Devolução. Você seleciona a opção vale e preencha as informações de Categoria e subcategoria. como na imagem a baixo.
 
===Perguntas frequentes:===

====- Aonde fica esses vales que foram criados?====
Você pode pesquisar eles dentro do contas a Pagar em "opções > Filtros > Somente Vales"

====- Como reemprimir um vale?====
Você pode ir em Financeiro > Contas a Pagar. Opções > Filtros > Somente Vales. Após você pode encontrar esse vale por algum filtro exemplo: nome do Cliente, Controle,etc..

entre no vale que deseja reemprimir, clica em opções > reemprimir vale.

Arquivo:Gerar vale devolução.png

2025-08-29T14:42:05Z

Igor:

Gerar_vale_devolução

Gera Vale

2025-08-29T14:41:14Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a criar Vales e entender melhor como ele funciona.

===Utilização:===

*Usado como Vale Presente.
*Usado em caso de devolução de mercadoria. Cliente recebe um vale para futuras compras no estabelicimento.

===Como gerar um vale:===

====Local:====
Master Key:

*Financeiro > Gera Vale.

PDV (Ponto de vendas):

*Emissão > Vale:

====Como Criar um novo vale:====
Para gerar o seu primeiro vale, você precisa fazer os seguintes passos.

*Selecione um cliente ou cadastre ele antes (para aprender a cadastrar clique aqui).
*No campo valor, adicione o valor do vale que vai ser gerado.
*Quantidade de vales normalmente seria 1 mas se for mais, só aumentar o numero.
*Categorias
*Subcategorias
*Observação não é obrigatorio mas você pode adicionar.

para finalizar, só clicar em Pagar e Gerar Vale.

==== Como criar um vale por uma devolução de venda: ====
Quando é feito uma devolução utilizando a janela "Gerador de NF de devolução" Você vai ter a opção de gerar um vale dessa devolução.

Antes de você clicar em Gerar NF de Devolução. Você seleciona a opção vale e preencha as informações de Categoria e subcategoria. como na imagem a baixo.
 
===Perguntas frequentes:===

====- Aonde fica esses vales que foram criados?====
Você pode pesquisar eles dentro do contas a Pagar em "opções > Filtros > Somente Vales"

====- Como reemprimir um vale?====
Você pode ir em Financeiro > Contas a Pagar. Opções > Filtros > Somente Vales. Após você pode encontrar esse vale por algum filtro exemplo: nome do Cliente, Controle,etc..

entre no vale que deseja reemprimir, clica em opções > reemprimir vale.

Gera Vale

2025-08-29T14:37:34Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a criar Vales e entender melhor como ele funciona.

===Utilização:===

*Usado como Vale Presente.
*Usado em caso de devolução de mercadoria. Cliente recebe um vale para futuras compras no estabelicimento.

===Como gerar um vale:===

====Local:====
Master Key:

*Financeiro > Gera Vale.

PDV (Ponto de vendas):

*Emissão > Vale:

====Como Criar um novo vale:====
Para gerar o seu primeiro vale, você precisa fazer os seguintes passos.

*Selecione um cliente ou cadastre ele antes (para aprender a cadastrar clique aqui).
*No campo valor, adicione o valor do vale que vai ser gerado.
*Quantidade de vales normalmente seria 1 mas se for mais, só aumentar o numero.
*Categorias
*Subcategorias
*Observação não é obrigatorio mas você pode adicionar.

para finalizar, só clicar em Pagar e Gerar Vale.

 

=== Perguntas frequentes: ===

==== - Aonde fica esses vales que foram criados? ====
Você pode pesquisar eles dentro do contas a Pagar em "opções > Filtros > Somente Vales"

==== - Como reemprimir um vale? ====
Você pode ir em Financeiro > Contas a Pagar. Opções > Filtros > Somente Vales. Após você pode encontrar esse vale por algum filtro exemplo: nome do Cliente, Controle,etc..

entre no vale que deseja reemprimir, clica em opções > reemprimir vale.

Gera Vale

2025-08-29T14:32:14Z

Igor:

Gera Vale

2025-08-29T14:26:55Z

Igor:

Gera Vale

2025-08-29T14:26:00Z

Igor: Criou página com '=== Introdução: === Nesse guia, você vai aprender a criar Vales e entender melhor como ele funciona. === Utilização: === * Usado como Vale Presente. * Usado em caso de...'

Importação extrato bancário (Arquivo OFX/OFC)

2025-08-29T14:14:27Z

Igor: Criou página com '=== Introdução: === Importação de movimentos bancarios atravez de arquivos OFX e OFC que os bancos normalmente disponibilizam nas plataforma deles. ==== Local: ==== Você...'

=== Introdução: ===
Importação de movimentos bancarios atravez de arquivos OFX e OFC que os bancos normalmente disponibilizam nas plataforma deles.

==== Local: ====
Você pode ir em Financeiro > Movimento Bancário > Opções > Impotação extrato bancário (Arquivo OFX/OFC).

==== Como Importar o arquivo: ====

* Com a aba "Impotação extrato bancário (Arquivo OFX/OFC)" aberta você pode fazer o seguinte:

# Selecione o codigo da sua conta corrente ou procure no lupinha ao lado direito.
# Selecione o arquivo clicando na no icon (pasta amarela) e selecione o arquivo que você baixou na plataforma do banco.
# Clique em Importar.

* Depois, você pode adicionar a conta corrente e selecionar o arquivo que baixou no banco e clicar em Importar. O sistema vai importar o arquivo do extrado e vai solicitar a você para adicionar as categorias e SubCategorias para a importação. após isso, você pode ir em Ação. Nela você vai definir o que vai fazer com esse registro.
** Ignorar (Não vai importar).
** Incluir (vai incluir um novo movimento bancario para você)
** Associar (Vai abrir uma janela para você associar um movimento bancario que você já tem no sistema.)

Obs: Você pode tambem clicar com o botão direito em cima de um dos registros e ocultar ele.

Após fazer isso em todos os registros, você pode clicar em Processar.

Movimento Bancário

2025-08-29T14:04:38Z

Igor:

Opções

*[[Importação extrato bancário (Arquivo OFX/OFC)]]

Movimento Bancário

2025-08-29T14:04:24Z

Igor: Criou página com '*Importação extrato bancário (Arquivo OFX/OFC)'

*[[Importação extrato bancário (Arquivo OFX/OFC)]]

ABERTURA E FECHAMENTO DE CAIXA

2025-03-07T14:06:05Z

Igor: /* MANUAL ABERTURA E FECHAMENTO CAIXA */

==MANUAL ABERTURA E FECHAMENTO CAIXA==
[[Arquivo:Imagem1.png|miniaturadaimagem|242x242px|'''MKPDV''']]'''''Introdução:'''''

O controle de caixa é um dos processos mais importantes para a organização financeira de um negócio. A abertura e o fechamento de caixa garantem que todas as transações sejam registradas corretamente, evitando divergências e facilitando a gestão dos recursos.

==='''PRIMEIRA ETAPA'''===
MKPDV: Se você está utilizando no PDV, seguir essas passos.

* Abrir o PDV
* Clicar em Menu
* Abertura e Fechamento de Caixa (F1)

[[Arquivo:Abert fecha caixa MK4.png|miniaturadaimagem|'''MK4''']]
Master Key 4: Se você está utilizando no MK4, seguir essas passos.

* Abrir o MK4
* Clicar em Financeiro
* Movimento de Caixa
* Opções
* Abertura e Fechamento de Caixa

[[Arquivo:Imagem2.png|miniaturadaimagem|313x313px|'''SEGUNDA ETAPA''']]

==='''SEGUNDA ETAPA (Abertura do Caixa)'''===

* Seleciona a data do caixa que deseja Abrir
* Clicar na Setinha Verde
* Colocar o valor que você tem no caixa
* Clicar em Abrir Caixa 

[[Arquivo:Imagem3.png|miniaturadaimagem|378x378px|'''TERCEIRA ETAPA''']]

 
==='''TERCEIRA ETAPA (SANGRIA E SUPRIMENTO)'''===

* '''SANGRIA ->''' Saída de caixa, no histórico preencher o motivo, colocar o valor e executar. Quando for tirado dinheiro do caixa para quitação de alguma conta ou por motivo de diminuir valor do caixa.

* '''SUPRIMENTO ->''' Entrada de caixa, preencher o histórico, colocar valor e executar. Geralmente utilizado quando acrescenta algum valor no caixa, exemplo: Ficou sem notas de R$ 5,00 e coloca R$ 50,00 reais em notas de R$ 5,00 sem pegar o mesmo valor do caixa nesse caso foi feito um suprimento.

 
==='''QUARTA ETAPA (FECHAMENTO DE CAIXA)'''===
[[Arquivo:Imagem4.png|miniaturadaimagem|430x430px|'''QUARTA ETAPA''' ]]

* Preencher o que você possui no Fisico.
* Clicar em Efetuar Inicio de Fechamento
* Conferir valor sistema com valor físico
* Clicar em Efetuar Fechamento de caixa

 

=== Quinta Etapa (Troco) ===

* Após você fechar o caixa o sistema ira mostrar para você a seguinte mensagem: "Confirmar fim de fechamento de caixa no valor de R$ ****,** ".
** Se os valores estão corretos, você pode clicar em Sim.
** Se o valor esta incorreto, você clica em não e verificar os valores novamente.
* Depois de clicar em Sim (na mensagem a cima) o sistema vai mostrar a seguinte mensagem: "Deseja Deixar um valor de troco no caixa?"
** Se clicar em Sim, o sistema vai solicitar um valor para deixar no caixa para a proxima abertura de caixa.
** Se clicar em Não, na proxima abertura, você terá que informar um valor para iniciar o caixa.

Arquivo:Abert fecha caixa MK4.png

2025-03-07T13:54:27Z

Igor:

Abertura e fechamento de caixa MK4

Utilitários

2022-12-28T12:34:28Z

Igor:

*[[Alteração de senha do Usuario Atual|Alteração de Senha]]
*[[Atualizações de Tabelas|Atualizações de tabelas]]
*[[Verificação de logs|Auditória de Dados]]
*[[Estoque|Contagem de Estoque]]

Instalação Atualização

2022-12-08T19:51:15Z

Igor:

===Padrão de Instalação===
Por padrão o sistema será instalado no C:\Sistema\.

*Criar uma pasta Setup dentro da pasta Sistema e salvar todos os instaladores na mesma (inclusive e principalmente o instalador do gerenciador de certificado digital quando o cliente possui A3 ou o instalador do certificado e a senha quando for A1);
*Na instalação do servidor, caso for alterada a unidade de instalação para o D:\, por exemplo, a instalação do Firebird será feita automaticamente no C:\ então, logo após a instalação, deve-se DESISTALAR o Firebird do C:\, e apagar essa pasta sistema e fazer a instalação manual do Firebird no D:\Sistema (o instalador está na pasta Uteis);
*Caso o cliente utilize NFCe configurar a tag [NFE] no connect.ini com os dados do NFE e alterar a linha StartNFE para True, dessa forma ao abrir o PDV o sistema abrirá o NFe automaticamente.

===Padrão de Atualização===

*Baixar todos os ZIPs dos executáveis que o cliente utiliza (nisso se inclui etiqueta, sincroniza, MKI entre outros);
*Fazer o backup dos bancos de dados dos sistemas que o cliente utiliza (preferencialmente fazer um ZIP/RAR dos mesmos);
*Apagar bancos/backups antigos (nisso se incluem .ZIP, .RAR, FBK, DBMKEY - Copia.FDB entre outros) deixando apenas o backup atual que você fez e o anterior (verifique pela data);
*Na pasta do sistema pode ser apagado também arquivos desnecessários (Logs de atualização antigos, PDF de pedidos/boletos/Relatorios, XML de notas antigas, etc (cuidado aqui com o que for apagado));
*Apague todo o conteúdo da pasta atual, copie para ela os ZIPs da atualização e extraia os mesmos, deixando assim somente o necessário.

=== Atualização feita via Updater: ===

* Utilize esse tutorial para entender melhor como funciona. [[Updater|Como utilizar o Updater]]

Clientes

2022-12-08T19:47:03Z

Igor:

===Introdução:===
Tela de Cadastro de Cliente e suas funcionalidades.

===Cadastramento:===
Como efetuar o cadastro de clientes no sistema:

*Abra o sistema MK4 (Master Key 4) vá até Cadastros > Clientes/Fornecedores > Cadastramento :
*Para cadastrar, clique em NOVO.
*na aba Dados, Informe os dados do cliente que deseja cadastrar.
*Campos obrigatórios para efetuar um cadastro sem problemas:

Tipo Cliente:

*Informe um Nome
*CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
*Informações de Localização (Preencha todos os campos)
*Informe Praça: (Pode ser Cadastrado aqui: [[Praça]])
*Informe Vendedor (Pode ser Cadastrado aqui: [[Vendedores|Vendedor]])
*Informe Atividade: (Pode ser Cadastrado aqui: [[Atividade]])

Tipo Fornecedor:

*Informe um Nome
*CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
*Informações de Localização (Preencha todos os campos)

===Recursos:===

====Limite de Credito====
Limite de crédito, é um valor definido no cadastro do cliente, para compras a prazo. Este valor pode ser definido manualmente ou calculado automaticamente pelo sistema baseado num percentual de comprometimento da renda, logo para que funcione a forma automaticamente quando ativada nos parâmetros, deve-se informar todas as rendas do cliente em seu cadastro. Importante lembrar que este limite também tem um "vencimento" e pode ser informado no cadastro para que após um certo período estipulado o cliente tenha que fazer uma nova avaliação de crédito.

Ativar a opção de limite no mês impacta diretamente no valor de credito a ser concedido ao cliente, quando marcado o valor será significativamente menor.

A utilização de um ou outro modo vai depender da política da empresa, porém levando em consideração que o ideal é que o cliente não comprometa mais de 30% de sua renda liquida, a melhor opção seria utilizar o limite dentro do mês.

'''EXEMPLO:'''

'''1 -''' Cliente com renda de R$ 1.100,00. Vai comprar uma Geladeira de R$ 800,00. No limite de credito normal a empresa terá que liberar R$ 800,00 de limite para ele. Com este limite liberado ele poderá fazer na condição de 1x ou 2x que irá resultar em valores muitos altos para a sua renda.

Já se ativarmos o limite de crédito no mês, estipularíamos para o cliente o limite de R$ 330,00 (1.100 * 0,3) o que obrigará o cliente a fazer em no mínimo 3x., desta forma o valor da parcela (R$ 267,00) ficará dentro do poder pagamento do cliente.

'''2 -''' Se o cliente quiser fazer uma aquisição de maior valor, como exemplo uma construção em que o valor do orçamento está estipulado em R$ 10.000 e o cliente consiga comprovar condição de pagamento, optaria pela utilização do limite de credito pois neste casos as vezes a negociação acontece no final da obra.

E na hipótese de um supermercado em que o cliente efetua compras mensais, utilizaria o limite mensal.

Vantagem: É importante o limite de crédito para que as empresas não corram o risco de ter muitos clientes inadimplentes e assim estipular um valor para que quando atingir esse valor limite, tanto a empresa como o cliente sejam avisados.

Não confunda ! Limite de Credito com inadimplência. Mesmo com o limite de crédito no mês o cliente só poderá fazer novas compras se estiver em dia, ou seja, se tiver pago o valor do mês anterior. (Claro que para isso deve estar ativo nos parâmetros o bloqueio por inadimplência.

====Relacionamento com Clientes====
Esta aba foi criada pensando e baseando-se em uma das definições de CRM (Customer Relationship Management) ou em português Gestão de Relacionamento com o Cliente, que entre outras estratégias diversas, busca gerenciar a relação com os clientes.

Nesta parte do sistema podemos detalhar todo e qualquer contato feito com o cliente, registrando ofertas de produtos e também agendar próximos contatos.

'''Exemplos de Utilização'''

'''A -''' É um forma de agendar uma venda de produto ou serviço. Havendo a opção de lançar o período específico para avisar o cliente de que o produto ou serviço que deseja, já está disponível no estabelecimento, ou também já lançar o produto/serviço que o cliente vai adquirir. Com isso tudo preenchido tem a opção de gerar pedido ou ordem de serviço.

'''B -''' Serve para programar serviço e vendas de produtos programada, podendo escolher o tempo de intervalo entre as operações. Podendo gerar Pedido ou OS a partir desses lançamentos e depois gerar NFe.

'''C -''' Renovação de carteira de motorista é a cada 5 anos, as auto escolas podem entrar em contato oferecendo o serviço pois saberão a data do vencimento através do preenchimento correto dessa aba

'''Funcionalidades'''

'''A -''' Caso tenha sido preenchido alguns produtos no momento do contato, pode-se gerar Pedidos ou OS diretamente desta ferramenta. Desta forma evita-se o retrabalho da digitação na venda, bem como, garantimos o valor correto pre negociado.

'''B -''' o Relatório dos contatos realizados ou dos próximos contatos devem ser emitidos em Relatórios - Cadastros - Clientes .. Relacionamento com Cliente.

Praça

2022-12-08T19:46:26Z

Igor: Criou página com '== Cadastro de Praça: == === Introdução: === Nesse Guia, você ira aprender como cadastrar Praça: === Cadastramento: === Para efetuar o Cadastramento, você precisa: *...'

== Cadastro de Praça: ==

=== Introdução: ===
Nesse Guia, você ira aprender como cadastrar Praça:

=== Cadastramento: ===
Para efetuar o Cadastramento, você precisa:

* Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Praça
* Após abrir a janela, você clica em NOVO.
* Adicione um nome a Praça
* Após todos os passos a cima, só clicar em Gravar.

Atividade

2022-12-08T19:33:32Z

Igor:

== Cadastro de Tipos de Atividades: ==

=== Introdução: ===
Nesse Guia, você ira aprender como cadastrar Tipos de Atividades:

=== Cadastramento: ===
Para efetuar o Cadastramento, você precisa:

* Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Tipos de Atividades
* Após abrir a janela, você clica em NOVO.
* Adicione um nome a Atividades
* Após todos os paços a cima, só clicar em Gravar.

Clientes

2022-12-08T19:31:08Z

Igor:

===Introdução:===
Tela de Cadastro de Cliente e suas funcionalidades.

===Cadastramento:===
Como efetuar o cadastro de clientes no sistema:

*Abra o sistema MK4 (Master Key 4) vá até Cadastros > Clientes/Fornecedores > Cadastramento :
*Para cadastrar, clique em NOVO.
*na aba Dados, Informe os dados do cliente que deseja cadastrar.
*Campos obrigatórios para efetuar um cadastro sem problemas:

Tipo Cliente:

*Informe um Nome
*CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
*Informações de Localização (Preencha todos os campos)
*Informe Praça: (Pode ser Cadastrado aqui: Praça)
*Informe Vendedor (Pode ser Cadastrado aqui: [[Vendedores|Vendedor]])
*Informe Atividade: (Pode ser Cadastrado aqui: Atividade)

Tipo Fornecedor:

*Informe um Nome
*CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
*Informações de Localização (Preencha todos os campos)

===Recursos:===

====Limite de Credito====
Limite de crédito, é um valor definido no cadastro do cliente, para compras a prazo. Este valor pode ser definido manualmente ou calculado automaticamente pelo sistema baseado num percentual de comprometimento da renda, logo para que funcione a forma automaticamente quando ativada nos parâmetros, deve-se informar todas as rendas do cliente em seu cadastro. Importante lembrar que este limite também tem um "vencimento" e pode ser informado no cadastro para que após um certo período estipulado o cliente tenha que fazer uma nova avaliação de crédito.

Ativar a opção de limite no mês impacta diretamente no valor de credito a ser concedido ao cliente, quando marcado o valor será significativamente menor.

A utilização de um ou outro modo vai depender da política da empresa, porém levando em consideração que o ideal é que o cliente não comprometa mais de 30% de sua renda liquida, a melhor opção seria utilizar o limite dentro do mês.

'''EXEMPLO:'''

'''1 -''' Cliente com renda de R$ 1.100,00. Vai comprar uma Geladeira de R$ 800,00. No limite de credito normal a empresa terá que liberar R$ 800,00 de limite para ele. Com este limite liberado ele poderá fazer na condição de 1x ou 2x que irá resultar em valores muitos altos para a sua renda.

Já se ativarmos o limite de crédito no mês, estipularíamos para o cliente o limite de R$ 330,00 (1.100 * 0,3) o que obrigará o cliente a fazer em no mínimo 3x., desta forma o valor da parcela (R$ 267,00) ficará dentro do poder pagamento do cliente.

'''2 -''' Se o cliente quiser fazer uma aquisição de maior valor, como exemplo uma construção em que o valor do orçamento está estipulado em R$ 10.000 e o cliente consiga comprovar condição de pagamento, optaria pela utilização do limite de credito pois neste casos as vezes a negociação acontece no final da obra.

E na hipótese de um supermercado em que o cliente efetua compras mensais, utilizaria o limite mensal.

Vantagem: É importante o limite de crédito para que as empresas não corram o risco de ter muitos clientes inadimplentes e assim estipular um valor para que quando atingir esse valor limite, tanto a empresa como o cliente sejam avisados.

Não confunda ! Limite de Credito com inadimplência. Mesmo com o limite de crédito no mês o cliente só poderá fazer novas compras se estiver em dia, ou seja, se tiver pago o valor do mês anterior. (Claro que para isso deve estar ativo nos parâmetros o bloqueio por inadimplência.

====Relacionamento com Clientes====
Esta aba foi criada pensando e baseando-se em uma das definições de CRM (Customer Relationship Management) ou em português Gestão de Relacionamento com o Cliente, que entre outras estratégias diversas, busca gerenciar a relação com os clientes.

Nesta parte do sistema podemos detalhar todo e qualquer contato feito com o cliente, registrando ofertas de produtos e também agendar próximos contatos.

'''Exemplos de Utilização'''

'''A -''' É um forma de agendar uma venda de produto ou serviço. Havendo a opção de lançar o período específico para avisar o cliente de que o produto ou serviço que deseja, já está disponível no estabelecimento, ou também já lançar o produto/serviço que o cliente vai adquirir. Com isso tudo preenchido tem a opção de gerar pedido ou ordem de serviço.

'''B -''' Serve para programar serviço e vendas de produtos programada, podendo escolher o tempo de intervalo entre as operações. Podendo gerar Pedido ou OS a partir desses lançamentos e depois gerar NFe.

'''C -''' Renovação de carteira de motorista é a cada 5 anos, as auto escolas podem entrar em contato oferecendo o serviço pois saberão a data do vencimento através do preenchimento correto dessa aba

'''Funcionalidades'''

'''A -''' Caso tenha sido preenchido alguns produtos no momento do contato, pode-se gerar Pedidos ou OS diretamente desta ferramenta. Desta forma evita-se o retrabalho da digitação na venda, bem como, garantimos o valor correto pre negociado.

'''B -''' o Relatório dos contatos realizados ou dos próximos contatos devem ser emitidos em Relatórios - Cadastros - Clientes .. Relacionamento com Cliente.

Atividade

2022-12-08T19:30:25Z

Igor: Criou página com 'a'

Complementares

2022-12-08T19:30:09Z

Igor:

*[[Grupo]]
*[[Subgrupo de Produtos]]
*[[Marca]]
*[[Tributações]]
*[[Sped Pis/Cofins]]
*[[Unidade]]
*[[Praça]]
*[[Atividade|Tipo de Atividades]]

Complementares

2022-12-08T19:29:35Z

Igor:

* [[Grupo]]
* [[Subgrupo de Produtos]]
* [[Marca]]
* [[Tributações]]
* [[Sped Pis/Cofins]]
* [[Unidade]]
* [[Praça]]
* [[Atividade]]

Clientes

2022-12-08T19:28:45Z

Igor:

=== Introdução: ===
Tela de Cadastro de Cliente e suas funcionalidades.

=== Cadastramento: ===
Como efetuar o cadastro de clientes no sistema:

* Abra o sistema MK4 (Master Key 4) vá até Cadastros > Clientes/Fornecedores > Cadastramento :
* Para cadastrar, clique em NOVO.
* na aba Dados, Informe os dados do cliente que deseja cadastrar.
* Campos obrigatórios para efetuar um cadastro sem problemas:

Tipo Cliente:

* Informe um Nome
* CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
* Informações de Localização (Preencha todos os campos)
* Informe Praça: (Pode ser Cadastrado aqui: Praça)
* Informe Vendedor (Pode ser Cadastrado aqui: [[Vendedores|Vendedor]])
* Informe Atividade: (Pode ser Cadastrado aqui: Atividade)

Tipo Fornecedor:

* Informe um Nome
* CNPJ ou CPF (Se for CNPJ verifique a IE - Inscrição Estadual)
* Informações de Localização (Preencha todos os campos)

=== Recursos: ===

==== Limite de Credito ====
Limite de crédito, é um valor definido no cadastro do cliente, para compras a prazo. Este valor pode ser definido manualmente ou calculado automaticamente pelo sistema baseado num percentual de comprometimento da renda, logo para que funcione a forma automaticamente quando ativada nos parâmetros, deve-se informar todas as rendas do cliente em seu cadastro. Importante lembrar que este limite também tem um "vencimento" e pode ser informado no cadastro para que após um certo período estipulado o cliente tenha que fazer uma nova avaliação de crédito.

Ativar a opção de limite no mês impacta diretamente no valor de credito a ser concedido ao cliente, quando marcado o valor será significativamente menor.

A utilização de um ou outro modo vai depender da política da empresa, porém levando em consideração que o ideal é que o cliente não comprometa mais de 30% de sua renda liquida, a melhor opção seria utilizar o limite dentro do mês.

'''EXEMPLO:'''

'''1 -''' Cliente com renda de R$ 1.100,00. Vai comprar uma Geladeira de R$ 800,00. No limite de credito normal a empresa terá que liberar R$ 800,00 de limite para ele. Com este limite liberado ele poderá fazer na condição de 1x ou 2x que irá resultar em valores muitos altos para a sua renda.

Já se ativarmos o limite de crédito no mês, estipularíamos para o cliente o limite de R$ 330,00 (1.100 * 0,3) o que obrigará o cliente a fazer em no mínimo 3x., desta forma o valor da parcela (R$ 267,00) ficará dentro do poder pagamento do cliente.

'''2 -''' Se o cliente quiser fazer uma aquisição de maior valor, como exemplo uma construção em que o valor do orçamento está estipulado em R$ 10.000 e o cliente consiga comprovar condição de pagamento, optaria pela utilização do limite de credito pois neste casos as vezes a negociação acontece no final da obra.

E na hipótese de um supermercado em que o cliente efetua compras mensais, utilizaria o limite mensal.

Vantagem: É importante o limite de crédito para que as empresas não corram o risco de ter muitos clientes inadimplentes e assim estipular um valor para que quando atingir esse valor limite, tanto a empresa como o cliente sejam avisados.

Não confunda ! Limite de Credito com inadimplência. Mesmo com o limite de crédito no mês o cliente só poderá fazer novas compras se estiver em dia, ou seja, se tiver pago o valor do mês anterior. (Claro que para isso deve estar ativo nos parâmetros o bloqueio por inadimplência.

===Relacionamento com Clientes===
Esta aba foi criada pensando e baseando-se em uma das definições de CRM (Customer Relationship Management) ou em português Gestão de Relacionamento com o Cliente, que entre outras estratégias diversas, busca gerenciar a relação com os clientes.

Nesta parte do sistema podemos detalhar todo e qualquer contato feito com o cliente, registrando ofertas de produtos e também agendar próximos contatos.

'''Exemplos de Utilização'''

'''A -''' É um forma de agendar uma venda de produto ou serviço. Havendo a opção de lançar o período específico para avisar o cliente de que o produto ou serviço que deseja, já está disponível no estabelecimento, ou também já lançar o produto/serviço que o cliente vai adquirir. Com isso tudo preenchido tem a opção de gerar pedido ou ordem de serviço.

'''B -''' Serve para programar serviço e vendas de produtos programada, podendo escolher o tempo de intervalo entre as operações. Podendo gerar Pedido ou OS a partir desses lançamentos e depois gerar NFe.

'''C -''' Renovação de carteira de motorista é a cada 5 anos, as auto escolas podem entrar em contato oferecendo o serviço pois saberão a data do vencimento através do preenchimento correto dessa aba

'''Funcionalidades'''

'''A -''' Caso tenha sido preenchido alguns produtos no momento do contato, pode-se gerar Pedidos ou OS diretamente desta ferramenta. Desta forma evita-se o retrabalho da digitação na venda, bem como, garantimos o valor correto pre negociado.

'''B -''' o Relatório dos contatos realizados ou dos próximos contatos devem ser emitidos em Relatórios - Cadastros - Clientes .. Relacionamento com Cliente.

Produtos/Serviços

2022-12-08T19:13:28Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas.

===Cadastramento:===

====Cadastro básico de produto:====

*Você precisa abrir o MK4 (Master Key 4) ir em Cadastros > Produtos. (Se você utiliza Serviço vai mostrar o nome "Produtos/Serviços")
*Após aberto, você deve clicar em NOVO.
*Clicando em NOVO, você vai precisar preencher todos os campos obrigatório (que possui um asterisco no inicio do nome.) exemplo: *Nome, *Grupo,....
*Campos Obrigatórios:
**Nome: Nome do Produto
**Grupo: Código do Grupo cadastrado em: [[Grupo]]
**Subgrupo: Código do Subgrupo Cadastrado em: [[Subgrupo de Produtos|Subgrupo]]
**Marca: Código da Marca Cadastrado em: [[Marca]]
**NCM: Código da NCM. (Código Consiste em 8 Dígitos.) Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**CEST: Código da CEST. Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**Tributação: Código da tributação cadastrada em:
**Trib.Pis/Cofins: Código da tributação Pis/Cofins cadastrado em:
**Unidade: Unidade, exemplo: UN,KG,PC,... [[Unidade]]
**Preço de Venda: Valor que será vendido esse produto.
*Após todos os campos informados, só clicar em Gravar, com isso o seu produto será cadastrado.

Unidade

2022-12-08T19:12:34Z

Igor: Criou página com '== Cadastro de Unidade: == === Introdução: === Nesse Guia, você ira aprender como cadastrar Unidade: === Cadastramento: === Para efetuar o Cadastramento, você precisa:...'

== Cadastro de Unidade: ==

=== Introdução: ===
Nesse Guia, você ira aprender como cadastrar Unidade:

=== Cadastramento: ===
Para efetuar o Cadastramento, você precisa:

* Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Unidade
* Após abrir a janela, você clica em NOVO.
* Adicione uma Unidade, Exemplo: UN
* Adicione uma descrição. Exemplo: UNIDADE
* Após todos os paços a cima, só clicar em Gravar.

Produtos/Serviços

2022-12-08T19:04:20Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas.

===Cadastramento:===

====Cadastro básico de produto:====

*Você precisa abrir o MK4 (Master Key 4) ir em Cadastros > Produtos. (Se você utiliza Serviço vai mostrar o nome "Produtos/Serviços")
*Após aberto, você deve clicar em NOVO.
*Clicando em NOVO, você vai precisar preencher todos os campos obrigatório (que possui um asterisco no inicio do nome.) exemplo: *Nome, *Grupo,....
*Campos Obrigatórios:
**Nome: Nome do Produto
**Grupo: Código do Grupo cadastrado em: [[Grupo]]
**Subgrupo: Código do Subgrupo Cadastrado em: [[Subgrupo de Produtos|Subgrupo]]
**Marca: Código da Marca Cadastrado em: [[Marca]]
**NCM: Código da NCM. (Código Consiste em 8 Dígitos.) Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**CEST: Código da CEST. Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**Tributação: Código da tributação cadastrada em:
**Trib.Pis/Cofins: Código da tributação Pis/Cofins cadastrado em:
**Unidade: Unidade, exemplo: UN,KG,PC,...
**Preço de Venda: Valor que será vendido esse produto.
*Após todos os campos informados, só clicar em Gravar, com isso o seu produto será cadastrado.

Marca

2022-12-08T19:03:36Z

Igor:

== Cadastro de Marca: ==

=== Introdução: ===
Nesse Guia, você ira aprender como cadastrar Marca:

=== Cadastramento: ===
Para efetuar o Cadastramento, você precisa:

* Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Marca
* Após abrir a janela, você clica em NOVO.
* Adicione um nome a Marca
* Após todos os paços a cima, só clicar em Gravar.

Marca

2022-12-08T19:01:47Z

Igor: Criou página com 'a'

Produtos/Serviços

2022-12-08T18:54:18Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas.

===Cadastramento:===

====Cadastro básico de produto:====

*Você precisa abrir o MK4 (Master Key 4) ir em Cadastros > Produtos. (Se você utiliza Serviço vai mostrar o nome "Produtos/Serviços")
*Após aberto, você deve clicar em NOVO.
*Clicando em NOVO, você vai precisar preencher todos os campos obrigatório (que possui um asterisco no inicio do nome.) exemplo: *Nome, *Grupo,....
*Campos Obrigatórios:
**Nome: Nome do Produto
**Grupo: Código do Grupo cadastrado em: [[Grupo]]
**Subgrupo: Código do Subgrupo Cadastrado em: [[Subgrupo de Produtos|Subgrupo]]
**Marca: Código da Marca Cadastrado em:
**NCM: Código da NCM. (Código Consiste em 8 Dígitos.) Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**CEST: Código da CEST. Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**Tributação: Código da tributação cadastrada em:
**Trib.Pis/Cofins: Código da tributação Pis/Cofins cadastrado em:
**Unidade: Unidade, exemplo: UN,KG,PC,...
**Preço de Venda: Valor que será vendido esse produto.
*Após todos os campos informados, só clicar em Gravar, com isso o seu produto será cadastrado.

Produtos/Serviços

2022-12-08T18:53:44Z

Igor:

===Introdução:===
Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas.

===Cadastramento:===

====Cadastro básico de produto:====

*Você precisa abrir o MK4 (Master Key 4) ir em Cadastros > Produtos. (Se você utiliza Serviço vai mostrar o nome "Produtos/Serviços")
*Após aberto, você deve clicar em NOVO.
*Clicando em NOVO, você vai precisar preencher todos os campos obrigatório (que possui um asterisco no inicio do nome.) exemplo: *Nome, *Grupo,....
*Campos Obrigatórios:
**Nome: Nome do Produto
**Grupo: Código do Grupo cadastrado em: [[Grupo]]
**Subgrupo: Código do Subgrupo Cadastrado em:
**Marca: Código da Marca Cadastrado em:
**NCM: Código da NCM. (Código Consiste em 8 Dígitos.) Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**CEST: Código da CEST. Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
**Tributação: Código da tributação cadastrada em:
**Trib.Pis/Cofins: Código da tributação Pis/Cofins cadastrado em:
**Unidade: Unidade, exemplo: UN,KG,PC,...
**Preço de Venda: Valor que será vendido esse produto.
*Após todos os campos informados, só clicar em Gravar, com isso o seu produto será cadastrado.

Subgrupo de Produtos

2022-12-08T18:53:08Z

Igor:

==Cadastro de Grupo de Produtos:==

===Introdução:===
Nesse Guia, você ira aprender como cadastrar Subgrupo de Produtos:

===Cadastramento:===
Para efetuar o Cadastramento, você precisa:

*Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Subgrupo de Produtos
*Após abrir a janela, você clica em NOVO.
*Adicione um nome ao seu Subgrupo
*Após todos os paços a cima, só clicar em Gravar.

Subgrupo de Produtos

2022-12-08T18:51:55Z

Igor:

== Cadastro de Grupo de Produtos: ==

=== Introdução: ===
Nesse Guia, você ira aprender como cadastrar Grupo de Produtos:

=== Cadastramento: ===
Para efetuar o Cadastramento, você precisa:

* Abrir o MK4 (Master Key 4) ir em Cadastros > Complementares > Grupos
* Após abrir a janela, você clica em NOVO.
* Adicione um nome ao seu grupo e informe a referencia
** Cadastro de Produtos
** Pedidos
** Ordem de Serviços
** Condicional
* Você pode adicionar uma imagem a esse grupo clicando na Galeria.
* Após todos os paços a cima, só clicar em Gravar.

Subgrupo de Produtos

2022-12-08T18:51:46Z

Igor: Criou página com 'a'

Grupo

2022-12-08T18:48:03Z

Igor: Criou página com '== Cadastro de Grupo de Produtos: == === Introdução: === Nesse Guia, você ira aprender como cadastrar Grupo de Produtos: === Cadastramento: === Para efetuar o Cadastramen...'

Complementares

2022-12-08T18:41:09Z

Igor:

* [[Grupo]]
* [[Subgrupo de Produtos]]
* [[Marca]]
* [[Tributações]]
* [[Sped Pis/Cofins]]
* [[Unidade]]

Complementares

2022-12-08T18:38:45Z

Igor: Criou página com 'a'

Produtos/Serviços

2022-12-08T18:37:25Z

Igor: Criou página com '=== Introdução: === Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas. === Cadastramento: === ==== Cadastro básico...'

=== Introdução: ===
Nesse guia, você vai aprender a como cadastrar um produto/serviço e configurar o mesmo de varias formas.

=== Cadastramento: ===

==== Cadastro básico de produto: ====

* Você precisa abrir o MK4 (Master Key 4) ir em Cadastros > Produtos. (Se você utiliza Serviço vai mostrar o nome "Produtos/Serviços")
* Após aberto, você deve clicar em NOVO.
* Clicando em NOVO, você vai precisar preencher todos os campos obrigatório (que possui um asterisco no inicio do nome.) exemplo: *Nome, *Grupo,....
* Campos Obrigatórios:
** Nome: Nome do Produto
** Grupo: Código do Grupo cadastrado em:
** Subgrupo: Código do Subgrupo Cadastrado em:
** Marca: Código da Marca Cadastrado em:
** NCM: Código da NCM. (Código Consiste em 8 Dígitos.) Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
** CEST: Código da CEST. Você pode encontrar o código nas notas de compra ou solicitando a contabilidade qual informar.
** Tributação: Código da tributação cadastrada em:
** Trib.Pis/Cofins: Código da tributação Pis/Cofins cadastrado em:
** Unidade: Unidade, exemplo: UN,KG,PC,...
** Preço de Venda: Valor que será vendido esse produto.
* Após todos os campos informados, só clicar em Gravar, com isso o seu produto será cadastrado.

Tabela de Preço

2022-12-08T18:03:39Z

Igor:

===Introdução:===
Nesse guia, você vai aprender como efetuar o cadastro de uma tabela de preço no sistema Master Key 4 e como utilizar ele em suas vendas.

===Configurações:===
Para habilitar as tabelas de preço nas suas vendas, você precisa primeira mente:

*Abrir o sistema MK4 (Master Key 4) ir em Utilitário > Parâmetros do Sistema.
*Clique em Configurações do Sistema.
*Clique em Movimentações dos Produtos.
*Na opção Preços dos Produtos, Você deve optar pela opção Ambos ou Tabelas de Preços. (Normal é Ambos pois utiliza a tabela de preço e o preço de venda do cadastro de produtos.)
*após selecionar a opção, só Clicar e Gravar

===Cadastrar Tabela de Preço:===
Para Efetuar o cadastro das tabelas de preços, você pode:

*Abrir o sistema MK4 (Master Key 4) ir em Cadastros > Tabelas de Preços.
*Após, você pode clicar em Novo.
*Você deve preencher o campo Nome. Exemplo: Tabela Atacado (para preços em atacado) ou Tabela Varejo (com os preços a venda varejo)
*após, você deve informar a Origem, Operação e Percentual aplicável sobre a origem do preço do seus produtos.
*Clica em Gravar.

Exemplo: Origem (Preço de custo), Operação (Acréscimo) e Percentual (Exemplo: 10%)

nesse caso acima ficaria assim:
[[Arquivo:Cadastro Tabela De Preço.jpg|nenhum|miniaturadaimagem]]

===Cadastros de Produtos na Tabela de Preço:===
Para adicionar os produtos a tabela de preço, possui duas maneiras, Manual e Automático(Pegando a referencia de Grupo, Subgrupo e Marca).

====Manual:====

* Você deve abrir o MK4 (Master Key 4) ir em Cadastros > Tabelas de Preços.
* Abra a tabela de preço cadastrada que você deseja adicionar os produtos.
* Após aberta, você clica na aba Preço. (você visualizara essa tela, igual a imagem a baixo.)

 
[[Arquivo:Preço TabelaDePreço.jpg|nenhum|miniaturadaimagem]]
 

* Após aberto essa tela, você precisa clicar em Novo.
* Depois, no campo Produto, você deve informar o código ou pesquisar o cadastro do produto.
* Após isso, você deve clicar no ENTER do teclado.
* Com isso, o sistema vai pegar as informações de Origem, Operação e Percentual aplicável que você cadastrou na tabela de preço. (mas você pode alterar manual.)
* Após, você pode verificar se o preço está correto como você precisa e só clicar em Gravar.

 
====Automático:====
Para adicionar os produtos de forma automática:

* Você deve abrir o MK4 (Master Key 4) ir em Cadastros > Tabelas de Preços.
* Abra a tabela de preço cadastrada que você deseja adicionar os produtos.
* Abra a aba "Importação de Produtos" como a imagem a baixo.

[[Arquivo:TabelaDePreço ImpDeProdutos.jpg|nenhum|miniaturadaimagem]]

* Após abrir a janela de importação.
* Você deve clicar em NOVO, Ajustar as informações de (Origem, Operação, e Percentual aplicável.)
* Com os valores da formação do preço informada, você deve ir até a opção Seleção.
* Na opção Seleção, você deve fazer o seu filtro exemplo:
** Opções:
** Todos: Serve para adicionar todos os produtos do Grupo, Subgrupo, Marca e Produtos.
** Intervalo: adicionar um intervalo entre Grupo, Subgrupo, Marca e Produtos, Exemplo: Grupos de 1 até 10.
** Individual: Apenas de um dos Grupo, Subgrupo, Marca e Produtos. Exemplo: Grupo 3
* Após saber qual filtro você vai fazer, você clica no ENTER e após, você deve clicar em Importar.
* Depois dos passos a cima serem efetuados, os produtos iram entrar na sua tabela de preço automaticamente.

Arquivo:TabelaDePreço ImpDeProdutos.jpg

2022-12-08T17:51:25Z

Igor:

Arquivo:Preço TabelaDePreço.jpg

2022-12-08T17:36:07Z

Igor:

Preço_TabelaDePreço

Tabela de Preço

2022-12-08T17:30:56Z

Igor:

Tabela de Preço

2022-12-07T21:11:48Z

Igor:

Tabela de Preço

2022-12-07T20:47:44Z

Igor:

Arquivo:Cadastro Tabela De Preço.jpg

2022-12-07T20:46:57Z

Igor:

Tabela de Preço

2022-12-07T20:28:27Z

Igor: Criou página com '=== Introdução: === Nesse guia, você vai aprender como efetuar o cadastro de uma tabela de preço no sistema Master Key 4 e como utilizar ele em suas vendas. === Configura...'

Transportadores

2022-12-07T20:19:36Z

Igor: Criou página com '=== Introdução: === Nesse guia, você vai aprender a como efetuar o cadastro de transportadoras para utilizar nas notas. === Cadastramento: === ==== Cadastro de Transporta...'

=== Introdução: ===
Nesse guia, você vai aprender a como efetuar o cadastro de transportadoras para utilizar nas notas.

=== Cadastramento: ===

==== Cadastro de Transportadoras: ====
Para efetuar o cadastramento da transportadora, você precisa:

# Abrir o sistema MK4 (Master Key 4), ir em Cadastro > Transportadoras.
# Após, você pode clicar em NOVO.
# Preencha o máximo de informações possível, quanto mais completo melhor o cadastros.
# Após o preenchimento, só clicar em Gravar.

==== Cadastro de Placas nas Transportadoras: ====
Para efetuar o cadastramento das placas dentro da transportadoras, você pode entrar em:

# Abrir o sistema MK4 (Master Key 4), ir em Cadastro > Transportadoras.
# Dar dois cliques no cadastro da transportadora que deseja adicionar as placas.
# após, você clicar na opção Placas e clica em NOVO
# após, informe a placa e clica em Gravar.

Após todos os passos a cima concluídos, você terá o cadastro de transportadores completo e funcional.

Vendedores

2022-12-07T20:01:43Z

Igor:

===Introdução:===
Nessa opção, você vai aprender como cadastras os seus vendedores, configurar e consultar eles quando preciso.
===Cadastro:===
Para efetuar um cadastro de Vendedores, você deve fazer os seguintes passos:

#Você pode abrir o MK4 (Master Key 4) ir em Cadastros > Vendedores.
#Após, você pode clicar no botão NOVO (Fica no canto superior esquerdo da tela)
#Depois, você é direcionado para o formulário de cadastramento de vendedores.
#Dentro do cadastro, você pode preencher os campos com as informações do vendedor. ''OBS: apenas o campo NOME é obrigatório.''
#Após preencher o campo NOME e as outra informações (Opcionais), só clicar no botão Gravar (parte superior da tela) que iram salvar o seu cadastro de vendedor.

===Configurações:===

====Configuração de Comissão:====
Para efetuar a configuração da comissão do vendedor:

#Você pode abrir o MK4 (Master Key 4) ir em Cadastro > Vendedores.
#Após, você pode abrir o cadastro do vendedor que você deseja alterar os percentuais de comissões.
#Depois, na aba Vendedor, você pode ir até o campo "Comissão de venda" e adicionar os percentuais.

OBS: Comissão é calculada baseada no total da nota com o percentual da comissão que está no campos comissão.

Ex: Total da nota é R$100,00 e a comissão é 3%. a comissão desse vendedor é R$3,00.

Exemplo Produtos/Serviços:

*A Vista - Comissão para todas as vendas efetuadas com o tipo de pagamento A VISTA (Dinheiro, PIX ....)serão comissionados com esse percentual.
*A Prazo - Comissão para todas as vendas efetuadas com o tipo de pagamento A Prazo (Carne Venda a Prazo ....) serão comissionados com esse percentual.

===== Relatórios para comissões: =====
Você pode utilizar os seguintes relatórios: Comissões ou Comissões (Gráfico)

Caminho para encontrar esses relatórios:

* Relatório > Movimentações > Vendas > Vendas por Vendedor.

 

==== Configurações Desconto do Vendedor: ====
Dentro do cadastro do vendedor, você pode configurar um percentual de desconto que esse vendedor pode dar ao cliente.

* Você pode ir no MK4 (Master Key 4) ir em Cadastros > Vendedores. Encontre o Vendedor que deseja alterar e abra o cadastro.
* Após, você pode ir na aba Vendedor e ir na parte inferior da tela e verá o campo Descontos à Vista e Descontos à Prazo.

Após, você pode preencher os campos de Valor máximo e mínimo de Desconto.