Guia de configuração e operação do ERP, PDV, Portal de Vendas, estoque, WMS, financeiro, franquias, integrações e recursos de inteligência.
Manual compatívelERP 0.1.6 · PDV 0.1.16Ambiente de homologação
Importante:
As telas e ações visíveis dependem do seu perfil, empresa e unidade selecionados. Os conectores fiscal, bancário, de pagamentos e marketplaces possuem níveis de maturidade diferentes; a operação real requer credenciais e homologação com cada fornecedor.
Entenda o login único, a seleção do contexto organizacional e os cuidados básicos para iniciar a operação.
Onde acessar
Página de login e menu Empresa e unidade
Entrar no sistema
Acesse erp.cynquo.com e informe seu e-mail e sua senha.
Após a autenticação, escolha a empresa e a unidade em que irá trabalhar.
A sessão web permanece válida por até 2 horas. Durante esse período o usuário continua conectado; após o limite absoluto, um novo login é obrigatório.
Confira o contexto atual no topo da tela antes de cadastrar ou movimentar informações.
Para trocar de empresa ou unidade sem outro login, clique no contexto atual e faça uma nova seleção.
Em computadores, use Ocultar menu ou Mostrar menu no topo para ganhar espaço de trabalho; a escolha fica salva neste navegador.
Encerrar a sessão
No menu lateral, localize seu nome e selecione Sair com segurança.
Em computadores compartilhados, feche também a janela do navegador.
Se a sessão expirar, entre novamente; operações não confirmadas devem ser conferidas antes de repetir.
Instalar o painel no celular como aplicativo
Abra o CYNQUO pelo navegador do celular e entre normalmente.
Use Instalar aplicativo no cabeçalho. No iPhone, escolha Compartilhar → Adicionar à Tela de Início; no Android, confirme Instalar aplicativo.
Autorize câmera somente quando usar o leitor de código de barras do estoque, produtos, WMS ou Portal de Vendas.
O painel instalado como PWA usa o mesmo login, perfil e contexto da versão web; ele não substitui o PDV desktop para integrações locais de impressora e TEF.
Boas práticas e observações
O tenant é obtido da sessão autenticada e não de um identificador livre informado pela tela.
Nunca compartilhe senha. Cada ação crítica é associada ao usuário autenticado.
Gerencie usuários, RBAC com escopo organizacional, sessões ativas e auditoria de alterações.
Onde acessar
Administração → Usuários, Perfis, Permissões, Sessões ativas e Auditoria
Acesso necessário
user.read, user.create, user.update, user.delete, role.manage ou audit.read, conforme a operação
Cadastrar e autorizar um usuário
Abra Usuários, selecione Criar usuário e informe nome, e-mail individual e senha inicial.
O sistema cria automaticamente um cliente vinculado ao usuário; informe CPF e WhatsApp para completar o cadastro.
Para permitir conta assinada, selecione as empresas autorizadas e defina um limite. O limite nunca é compartilhado entre tenants.
Associe um perfil compatível com a função exercida; perfis de empresa exigem a empresa vinculada.
Para gestores ou operadores locais, selecione o perfil de unidade e a unidade correspondente.
Use Unidades adicionais somente quando o usuário precisar atuar além do escopo principal do perfil.
Marque a troca obrigatória da senha e revise o acesso efetivo antes de liberar o primeiro login.
Editar ou excluir um usuário
Em Usuários, selecione Editar para alterar nome, e-mail, senha, status, perfis, empresas ou unidades.
Informe uma justificativa para que a mudança fique registrada na auditoria.
Use Bloqueado ou Inativo para interromper o login sem remover o cadastro.
Ao selecionar Excluir, o sistema inativa logicamente o usuário e revoga sessões, tokens, perfis e acessos.
O administrador não pode excluir o próprio usuário nem remover o último administrador do tenant.
Controlar acessos
Use Perfis para agrupar permissões e evite conceder permissões isoladas sem necessidade.
Revogue uma sessão ativa quando houver perda de dispositivo ou suspeita de acesso.
Consulte Auditoria para identificar autor, IP, dispositivo, entidade e valores anteriores/posteriores.
Executar correções administrativas
Abra Administração → Correções administrativas usando um perfil com a permissão cash.correct.
Edite o fundo somente antes da primeira venda, suprimento ou sangria do caixa.
Anule apenas caixas sem operações; caixas com movimentos devem permanecer no histórico.
Para vendas, use Cancelar / estornar: o sistema preserva a venda original e cria os reflexos inversos no estoque e no financeiro.
Produtos podem ser alterados ou arquivados na tela de detalhes; tabelas de preço possuem Editar e Excluir na própria listagem.
Movimentações de estoque são corrigidas por lançamento inverso; baixas financeiras são corrigidas por estorno.
Solicitações, pedidos de compra e pedidos omnichannel podem ser cancelados somente enquanto o estágio operacional permitir.
Informe sempre uma justificativa objetiva e consulte Auditoria para conferir autor, valores anteriores e valores posteriores.
Boas práticas e observações
Acesso negado significa ausência de permissão ou de escopo para a empresa/unidade atual.
O perfil Superadministrador da plataforma deve ser restrito à administração técnica.
Lançamentos operacionais, contábeis, fiscais e de auditoria nunca são apagados fisicamente; a correção ocorre por cancelamento, estorno ou inativação lógica.
Execute recebimento, endereçamento, put-away, picking, packing, inventário rotativo e expedição.
Onde acessar
Operação → WMS e expedição ou Coletor WMS
Acesso necessário
wms.read ou wms.task.execute
Receber e armazenar mercadorias
Abra o recebimento vinculado ao pedido de compra e selecione a doca.
Confira itens, lotes, validades, séries e custos por bipagem. Nesta etapa, o endereço técnico de entrada é automático e não precisa ser bipado.
Na conferência cega, a quantidade esperada fica oculta do operador.
Quando houver falta, excesso, avaria ou item incorreto, registre a divergência; se configurado, o sistema abrirá recontagem para outro operador.
Se chegar um produto não previsto, use Registrar produto inesperado. O item será vinculado ao recebimento e ficará em quarentena até a decisão do gestor.
Finalize a conferência e resolva as divergências antes de liberar as tarefas de armazenagem.
Depois da conferência, abra a tarefa de armazenagem, siga o endereço sugerido e confirme produto, quantidade e destino. A sugestão respeita capacidade e as regras de mistura de produto e lote.
Tratar divergências do recebimento
Abra a divergência para aceitar, rejeitar, devolver ou solicitar correção conforme a ocorrência física e fiscal.
Use Comunicar fornecedor para registrar solicitação de correção, cobrança de nota complementar, aviso de divergência ou coleta de devolução.
O sistema mantém a comunicação e a decisão no histórico do recebimento para auditoria.
Itens rejeitados ou ainda pendentes permanecem bloqueados em quarentena e não integram o saldo disponível.
Agendar e supervisionar o recebimento
Quando Compras marcar a mercadoria como recebida e encaminhar ao WMS, a tarefa aparecerá na fila supervisionada sem duplicar o documento.
Abra Supervisão, escolha o recebimento, a doca e o intervalo previsto; informe transportadora, placa e orientações de descarga.
Abra o Coletor WMS no equipamento operacional, selecione o depósito e dê um nome ao aparelho. Ele aparecerá como ativo na supervisão enquanto estiver conectado.
Na fila supervisionada, escolha o coletor ativo que receberá a tarefa. A tarefa direcionada somente poderá ser iniciada naquela sessão.
Acompanhe responsável, coletor, progresso, prazo, prioridade, última atualização e exceções; pause, libere, cancele ou redistribua quando necessário.
Atualize a chegada para Check-in e Em doca. O recebimento será atualizado junto com o agendamento.
Trate as divergências abertas na mesma central, registrando decisão, providência e justificativa para auditoria.
Separar e expedir
Libere pedidos ou ondas de separação conforme prioridade.
Execute o picking pelo coletor seguindo FIFO, FEFO ou a estratégia configurada.
No packing, confira novamente os itens e gere volumes e etiquetas.
Associe a remessa, doca e transportadora e confirme a expedição.
Usar a nova central operacional
Selecione o depósito no topo e consulte prioridades na área Visão geral.
Navegue pelas áreas Recebimentos, Separação, Packing e expedição, Inventário e Endereços.
Use Endereços para cadastrar, pesquisar, bloquear ou liberar posições físicas.
Use Configurações para definir FEFO, FIFO, menor deslocamento, bipagens obrigatórias, conferência cega, recontagem independente, distribuição automática e avisos de tarefas.
Cadastre a capacidade e as permissões de mistura em cada endereço para impedir sugestões incompatíveis de armazenagem.
Contar e reabastecer
Em Inventário, selecione os endereços e libere a contagem rotativa para o coletor.
O operador deve bipar o endereço antes do produto quando essa validação estiver habilitada.
No Coletor WMS, use Tarefas e recebimento para executar o fluxo liberado sem misturá-lo com consultas ou ajustes.
Use Consulta por bipagem para ler um endereço e visualizar todo o seu conteúdo, ou ler um produto e consultar cada posição, lote, saldo físico, reservado e disponível.
Em Contagem e ajuste, selecione primeiro o depósito, bipe o endereço e depois bipe cada unidade física; cada leitura soma uma unidade e a quantidade pode ser corrigida manualmente.
Para informar que um item esperado não existe fisicamente, use Contar zero na lista de conteúdo do endereço.
Revise as divergências, informe a justificativa e confirme. Somente os itens incluídos na contagem são ajustados; os demais saldos permanecem intactos.
A confirmação gera inventário e movimentações no livro-razão com usuário, endereço, data e chave de idempotência.
Gere sugestões de reabastecimento para recompor posições de picking abaixo da meta.
Acompanhe as tarefas e exceções na fila operacional sem alterar diretamente o saldo.
Boas práticas e observações
O Coletor WMS aceita leitor que emula teclado e faz leitura automática pela câmera em navegadores compatíveis.
Sem conexão, o coletor mantém a consulta visível e bloqueia confirmações para evitar operações sem registro.
Produtos serializados continuam exigindo inventário individual por número de série no painel WMS.
FEFO deve ser preferido para produtos controlados por validade.
Tarefas distribuídas automaticamente aparecem no coletor do operador; quando o navegador permite, uma notificação informa a nova atividade.
Instale o aplicativo desktop, registre o dispositivo e selecione empresa, unidade e terminal.
Onde acessar
Central de downloads e aplicativo CYNQUO PDV
Acesso necessário
Usuário ativo com acesso à unidade e ao terminal
Instalar e ativar
Baixe o instalador adequado na Central de downloads e conclua a instalação.
Abra o aplicativo e mantenha a API central configurada como https://erp.cynquo.com/api.
Entre com seu usuário e escolha empresa, unidade e terminal autorizado.
Confirme o registro do dispositivo e aguarde a primeira sincronização do catálogo.
O perfil permanece autenticado no PDV por até 12 horas, inclusive para as operações offline previamente autorizadas.
Verifique os indicadores de conexão e sincronização antes de abrir o caixa.
Configurar equipamentos
Pressione F2 ou use o botão Dispositivos para abrir a Central de dispositivos. Atualize as filas e escolha a impressora exatamente como ela aparece no Windows, ou selecione a impressora padrão.
Confira na própria central o driver, a porta e a situação da fila. Se ela estiver offline, corrija primeiro em Impressoras e scanners do Windows.
Defina papel de 58 ou 80 mm, quantidade de cópias e se a impressão será automática para comprovante gerencial e documento fiscal.
Use Imprimir página de teste antes de operar e, no histórico da venda, use a reimpressão manual quando necessário.
Na seção TEF da mesma central, escolha o modo simulado para testes ou informe a URL do integrador local homologado e use Testar comunicação TEF.
No TEF real, valide pinpad, adquirentes, timeout e estorno com o fornecedor antes do uso em produção.
O leitor USB/HID funciona como teclado; impressora, gaveta, balança e display permanecem desacoplados de fabricantes específicos.
Use os dispositivos simulados para homologar o fluxo sem hardware real.
Faça um teste individual de cada equipamento e registre o resultado.
Para encerrar a operação, use o botão Sair sempre visível no cabeçalho do PDV.
Reutilizar um computador de homologação em outro cliente
Antes da troca, sincronize as operações pendentes e feche qualquer caixa aberto no terminal atual.
Abra o menu do operador e use Trocar empresa, unidade ou terminal quando a fila local estiver zerada.
Se o terminal anterior foi inativado e ainda existem pendências de teste, use Recuperação e reset.
Informe o motivo, digite a frase de confirmação exibida e autorize o arquivamento local das pendências.
O CYNQUO mantém o mesmo identificador físico do computador, limpa os dados locais do cliente anterior e registra a ação na auditoria.
Entre novamente e selecione o novo cliente, a empresa, a unidade e o terminal. A API libera automaticamente vínculos anteriores sem caixa aberto.
Boas práticas e observações
As integrações de hardware usam abstrações; confirme o adaptador homologado antes de uso produtivo.
Não altere o identificador do dispositivo copiando manualmente arquivos locais entre caixas.
Nunca troque de cliente mantendo catálogo ou vendas locais do cliente anterior; use sempre o fluxo de troca ou recuperação.
Oriente a rotina do operador desde a abertura até o fechamento, incluindo venda, desconto e pagamento.
Onde acessar
Aplicativo CYNQUO PDV
Acesso necessário
Operador de caixa e autorizações adicionais para desconto/cancelamento
Operar o caixa
Inicie a sessão do operador e faça a abertura com o fundo de troco contado.
Registre suprimentos e sangrias no momento em que ocorrerem, sempre com motivo.
No fechamento, informe os valores contados por forma de pagamento sem depender do esperado.
Revise diferenças e encaminhe para conferência quando a política exigir.
Realizar uma venda
Leia o código de barras ou busque o produto e confira descrição, quantidade e preço.
Identifique cliente e vendedor quando aplicável. Para cadastrar um cliente no caixa, use + Novo ao lado do seletor e informe nome completo, CPF, WhatsApp e e-mail.
Para conceder desconto, solicite o PIN administrativo de oito dígitos de um gestor com acesso à unidade e permissão de desconto. A autorização é de uso único e expira rapidamente.
Selecione dinheiro, Pix manual, cartão manual, Cartão via TEF, crédito da loja, conta assinada, vale ou pagamento misto.
Conta assinada exige cliente vinculado a usuário ativo, autorização prévia para a empresa e limite disponível; essa modalidade não funciona offline.
No TEF, aguarde a confirmação do integrador; o código da transação e a autorização são vinculados automaticamente ao pagamento.
Confirme que os pagamentos cobrem o total, confira o troco e finalize uma única vez.
Quando não houver documento fiscal, o PDV imprime o comprovante gerencial conforme a configuração. Quando houver NFC-e autorizada, imprime o DANFC-e.
Entregue o comprovante; correções posteriores devem ocorrer por cancelamento, devolução ou estorno.
Cadastrar o PIN de aprovação de desconto
No painel web, acesse Administração → Usuários e abra o cadastro do gestor responsável.
Informe um PIN numérico exclusivo de oito dígitos e garanta que o usuário possua a permissão sale.discount no escopo da unidade.
O PIN não é exibido nem armazenado em texto aberto; para substituí-lo, cadastre um novo PIN no mesmo formulário.
Tentativas inválidas são limitadas e toda aprovação fica vinculada à venda e registrada em auditoria.
Boas práticas e observações
Venda finalizada é imutável e possui UUID global e chave de idempotência.
Pix e cartão manuais exigem conferência operacional; provedores reais ainda dependem de homologação.
Na primeira ativação, mantenha o PDV online até o download automático de produtos, códigos de barras, preços, clientes essenciais, usuários autorizados e estoque de referência terminar.
Confirme em F2 → Configuração local a quantidade de produtos locais e a data da última sincronização.
Confirme que o catálogo local foi sincronizado anteriormente e que o status indica modo offline.
Realize somente operações liberadas: catálogo local, caixa, venda e pagamentos permitidos offline.
Pagamentos TEF reais exigem conexão com o integrador local e não devem ser tratados como autorizados somente por estarem no catálogo offline.
Não feche o aplicativo durante uma gravação; o evento é salvo na outbox local.
Quando a internet retornar, mantenha o PDV aberto até a fila pendente ser confirmada.
Tratar uma falha
Abra a tela de falhas e leia a mensagem, o número de tentativas e o evento relacionado.
Corrija o contexto ou dado indicado; não recrie uma venda já concluída.
Use Reprocessar apenas com autorização. Eventos inválidos persistentes vão para a fila local de falhas.
Em conflito, preserve o UUID original para que o servidor reconheça reenvios duplicados.
Boas práticas e observações
Sem internet ficam bloqueados cadastros críticos, crédito excepcional, descontos fora do limite e estoque de outras unidades.
A referência de estoque local não substitui o saldo central confirmado.
Acompanhe contas, tesouraria, bancos, conciliação OFX, fluxo de caixa, crédito e indicadores financeiros sem apagar históricos.
Onde acessar
Gestão financeira → Financeiro
Acesso necessário
finance.read e permissões de lançamento, baixa ou estorno
Lançar e liquidar contas
Escolha primeiro a categoria principal — Receitas, Custos, Despesas operacionais, Despesas financeiras, Investimentos / Ativo ou Movimentações financeiras — e depois selecione a conta analítica exibida no campo Plano de contas.
Quando parcelado, confira valores e datas de cada parcela.
Se houver boleto, nota, fatura ou comprovante, selecione o tipo e anexe o arquivo ao criar o título. Também é possível anexar, baixar ou excluir documentos depois pela lista de contas.
São aceitos PDF, XML, JPG, PNG e WebP com até 10 MB. Os arquivos seguem o mesmo acesso por empresa e unidade do lançamento.
Na baixa total ou parcial, informe conta financeira, data, juros, multa e desconto.
Para corrigir uma liquidação, gere um estorno vinculado ao lançamento original.
Configurar o financeiro
Abra Financeiro → Estrutura financeira → Plano de contas financeiro. O modelo padrão já vem cadastrado para o tenant e é compartilhado pelas empresas autorizadas.
Em Estrutura e integrações, use “Instalar ou atualizar modelo” para preparar o plano financeiro gerencial recomendado sem apagar personalizações existentes.
O plano financeiro possui dois níveis: as seis categorias principais e, diretamente abaixo delas, os planos de contas que recebem lançamentos.
Nos lançamentos e na conciliação, o campo Categoria apresenta o grupo principal; o campo Plano de contas é filtrado automaticamente e mostra somente os planos vinculados à categoria escolhida.
Para personalizar, abra a categoria desejada e use “+ Plano de conta”. Os seis grupos e os planos fornecidos com o sistema permanecem como estrutura padrão.
Em cada classificação, confira a natureza gerencial, o grupo, a participação na DRE e o impacto no fluxo de caixa. Investimentos e transferências normalmente ficam fora da DRE.
As contas padrão podem ser renomeadas. Para ajustes próprios, crie subcontas personalizadas, que podem ser editadas, inativadas ou excluídas sem apagar o histórico.
O plano contábil patrimonial continua separado e opcional no lançamento; a categoria financeira e o centro de custo alimentam os relatórios gerenciais.
Cadastre contas bancárias com banco, agência, conta, tipo e saldo inicial; cadastre contas caixa separadamente quando representarem numerário físico.
Use conta transitória para valores temporários, adquirente para cartões a receber, carteira digital para saldos em plataformas e marketplace para repasses de canais.
Edite ou inative cadastros somente quando permitido. Lançamentos históricos permanecem ligados aos registros originais.
Usar tesouraria e conciliação bancária
Em Tesouraria, registre suprimento, sangria, transferência e demais movimentações na conta financeira correta, sempre com documento e motivo.
Em Conciliação bancária, selecione a conta e importe o arquivo OFX baixado diretamente do banco.
Confira período, saldo, duplicidades e lançamentos importados antes de iniciar os comparativos.
Vincule cada linha do extrato ao lançamento correspondente, crie a pendência quando necessário e conclua somente as correspondências conferidas.
Use a exportação em PDF para arquivar ou compartilhar o demonstrativo da conciliação.
Analisar o BI financeiro e o valor do estoque
Na Visão geral, confira contas a pagar, contas a receber, vencidos, fluxo e próximos vencimentos.
Abra BI financeiro para analisar receitas, custos, despesas operacionais, despesas financeiras, resultado, margem, inadimplência, centros de custo e comparação entre períodos.
Os cartões Estoque pelo custo e Estoque pelo preço de venda usam os saldos atuais e os cadastros de custo/preço do escopo selecionado.
Produtos sem custo ou sem preço são informados separadamente; corrija o cadastro antes de usar os totais como base gerencial.
Gerar relatórios nativos
Abra Início e análise → Central de relatórios e informe período, empresa e unidade.
Exporte vendas, estoque e contas a pagar/receber em CSV para análise detalhada.
Gere o PDF de fechamentos para conferir abertura, sangrias, suprimentos, valor esperado, valor contado e diferença por operador.
Gere o PDF de pedidos de compra ou abra a conciliação bancária para emitir o demonstrativo do OFX.
Venda integrada ao financeiro
Após a venda, confira recebimentos, parcelas e movimentações gerados automaticamente.
Revise crédito utilizado, troco, comissão do vendedor e eventos de conciliação.
Cancelamentos e devoluções geram lançamentos inversos sem apagar os registros da venda.
Boas práticas e observações
Separe visão por caixa e por competência ao analisar o fluxo financeiro.
Limites de crédito e exceções devem respeitar alçada e ficar auditados.
A importação OFX auxilia a conciliação, mas não movimenta dinheiro no banco e não substitui a conferência do responsável financeiro.
Configure os documentos de cada CNPJ, emita, receba e acompanhe o processamento fiscal.
Onde acessar
Operação → Central Fiscal; Gestão financeira → Configuração fiscal
Acesso necessário
fiscal.read; fiscal.manage para emitir; integration.manage para configurar
Habilitar os documentos usados pelo CNPJ
Abra Operação → Central Fiscal, selecione a empresa e depois o CNPJ correto.
Em Tipos e regras, habilite somente os documentos realmente usados pelo estabelecimento.
Defina se o documento será de saída, entrada ou ambos e escolha emissão automática, manual, externa ou somente recebimento.
Configure ambiente, provedor, série, natureza da operação, contingência e emissão automática quando aplicáveis.
Uma configuração sem credencial ou sem suporte do provedor ficará como pendente e não será transmitida.
Emitir e acompanhar notas
Use Emitir documento somente para tipos marcados como prontos no CNPJ selecionado.
Informe a origem: venda, pedido, transferência, devolução, remessa, serviço, transporte ou emissão avulsa.
Acompanhe autorização, processamento, rejeição, contingência ou cancelamento em Notas emitidas.
Consulte novamente ou reprocesse apenas falhas transitórias; rejeições de cadastro devem ser corrigidas na origem.
Baixe XML e documento auxiliar somente depois que o provedor os disponibilizar.
Receber notas e transferências
Abra Notas recebidas e use Receber nova nota para importar XML, consultar uma chave ou lançar manualmente.
Confirme se o destinatário do XML é o mesmo CNPJ e selecione unidade e depósito de entrada.
Vincule cada item ao produto existente ou crie o produto antes de concluir o recebimento.
A conclusão gera movimentação rastreável de estoque e, quando informado, contas a pagar e anexos.
Notas de transferência recebidas seguem o mesmo fluxo de conferência, sem exigir pedido de compra.
Configurar uma integração
Selecione o tenant, CNPJ, tipo de integração e ambiente de homologação.
Cadastre as credenciais pelo campo seguro e configure timeout, retentativas e circuit breaker.
Execute o teste de conexão e verifique o log sanitizado, sem copiar segredos para observações.
Ative somente após validar emissão, consulta, cancelamento ou estorno no ambiente do fornecedor.
Acompanhar processamento
Consulte status, protocolo, XML e tentativas da operação.
Em falha transitória, aguarde a retentativa; em falha de regra, corrija o cadastro responsável.
Use contingência fiscal apenas conforme a configuração e o procedimento tributário aplicável.
Boas práticas e observações
NF-e, NFC-e e NFS-e possuem adaptador Focus NFe. Outros documentos podem ser configurados para controle externo ou homologados por um novo adaptador antes da produção.
NFA-e depende do portal e das regras da SEFAZ de cada estado; não é transmitida genericamente como uma NF-e comum.
CT-e, CT-e OS, MDF-e, BP-e, GTV-e, NF3-e, NFCom, NFGás e DC-e exigem credenciamento, leiaute e provedor compatíveis com a atividade da empresa.
Nunca registre senha, token, chave Pix ou dado completo de cartão em logs ou observações.
Acompanhe pedidos externos, mapeamento de SKU, reserva, fulfillment, expedição e retorno de status.
Onde acessar
Comercial e operação → Pedidos omnichannel
Acesso necessário
order.read e permissões operacionais do canal
Configurar e receber pedidos
Cadastre a conexão do canal e associe-a à empresa, unidade e política de estoque/preço.
Mapeie cada SKU externo para o produto/variação interno correspondente.
Valide o webhook e acompanhe idempotência, rate limiting e logs de integração.
Após a entrada, confira pagamento, reserva e unidade responsável pelo atendimento.
Atender o pedido
Libere o fulfillment para picking e packing.
Gere volume e etiqueta, confirme expedição e informe rastreamento.
Acompanhe o retorno de status ao canal e trate divergências na conciliação.
Boas práticas e observações
Mercado Livre e TikTok Shop possuem conectores reais em homologação. Shopee e Amazon permanecem bloqueados até a homologação oficial, sem simular sucesso.
Pedido externo reenviado deve atualizar o mesmo registro, nunca criar duplicidade.
Administre o ciclo completo do colaborador, documentos, solicitações, jornada, desenvolvimento e preparação financeira.
Onde acessar
Pessoas e RH → Gestão de pessoas, Central profissional de RH, Portal do colaborador e Relógio de ponto
Acesso necessário
people.*, benefit.*, timeclock.*, payroll.*, recruitment.*, performance.*, training.* e finance.manage para enviar pagamentos
Cadastrar e manter colaboradores
Na aba Colaboradores, informe vínculo, documentos, contato, endereço, remuneração e dados de pagamento.
Vincule o usuário do sistema para habilitar o relógio de ponto e os descontos autorizados por conta assinada.
Edite o cadastro sempre que necessário; no desligamento, informe o motivo para preservar o histórico auditável.
Controlar benefícios e jornadas
Cadastre cada benefício com fornecedor, custo da empresa, desconto do colaborador e regra de pré-folha.
Vincule o benefício ao colaborador e encerre o vínculo quando ele deixar de ser aplicável.
Publique jornadas com início, fim e intervalo; horários sobrepostos para a mesma pessoa são bloqueados.
Manter contratos, dependentes e documentos
Abra Central profissional de RH → Dossiês e selecione a empresa de trabalho.
Registre contratos com regime, vigência, cargo, jornada, salário de referência, sindicato e regra coletiva.
Inclua dependentes e informe separadamente a utilização para imposto de renda e benefícios.
Envie PDF, XML ou imagem para o dossiê; o arquivo fica protegido, com hash contra duplicidade, validade e trilha de auditoria.
Use o histórico contratual em vez de sobrescrever vínculos anteriores.
Administrar solicitações e banco de horas
O colaborador cria pedidos de férias, afastamento, ajuste de ponto, benefício ou documento pelo Portal do colaborador.
O RH abre Central profissional de RH → Solicitações para aprovar ou rejeitar com justificativa obrigatória.
Em Banco de horas, compare jornada prevista, horas efetivamente pareadas e ajustes manuais.
Créditos ou débitos manuais exigem data, quantidade e motivo e ficam vinculados ao autor na auditoria.
Registrar e administrar o ponto
O colaborador acessa Pessoas e RH → Relógio de ponto pelo computador ou celular.
A sequência permitida é entrada, início do intervalo, fim do intervalo e saída.
Na aba Gestão do ponto, um gestor pode incluir uma correção administrativa com data, hora e motivo; a operação fica auditada.
Conduzir recrutamento e desenvolvimento
Em Recrutamento, abra vagas com quantidade, departamento e faixa salarial e vincule candidatos ao funil.
Em Desempenho, crie o ciclo, defina o período e conclua com nota e feedback.
Em Treinamentos, cadastre cursos, carga horária, obrigatoriedade e validade e atribua aos colaboradores.
O colaborador acompanha avaliações e capacitações na área Desenvolvimento do portal pessoal.
Usar o portal do colaborador
Vincule o usuário a um colaborador ativo; sem esse vínculo o portal bloqueia dados pessoais.
O colaborador pode bater ponto, consultar banco de horas, acompanhar solicitações, baixar documentos e enviar novos arquivos.
Benefícios, dependentes, treinamentos, avaliações e demonstrativos operacionais são apresentados somente ao titular autenticado.
Preparar pagamentos
Cadastre rubricas de provento, desconto ou informação e aplique eventos avulsos ou recorrentes aos colaboradores.
Calcule a pré-folha da competência e confira bruto, benefícios, outros descontos, conta assinada e líquido por pessoa.
Aprove a pré-folha e use Enviar ao contas a pagar para criar um título por colaborador de forma idempotente.
Faça a baixa e conciliação no Financeiro e encerre a competência após a conferência.
Boas práticas e observações
A pré-folha é um controle operacional e sempre deve ser validada pelo responsável contábil ou sistema trabalhista oficial.
A central prepara lotes de cadastros, ponto ou pré-folha para conferência; ela não transmite ao eSocial e não calcula automaticamente FGTS, INSS, IRRF, férias ou rescisão.
Batidas e operações financeiras são isoladas por tenant, empresa, unidade e permissões do usuário.
Documentos pessoais são confidenciais e devem ser acessados apenas por perfis autorizados.
Crie orçamentos e pedidos no balcão, encaminhe ao caixa ou fature a prazo sem expor o painel administrativo ao vendedor.
Onde acessar
Operação → Portal de vendas ou acesso exclusivo em erp.cynquo.com/vendas
Acesso necessário
sales_portal.access e permissões comerciais do perfil do vendedor
Habilitar o modo da unidade
No painel administrativo, abra Portal de vendas → Configuração e selecione a unidade.
Escolha somente PDV, somente Portal de Vendas, ambos ou apenas pedidos para faturamento posterior.
Defina se o recebimento será feito em caixa separado, pelo vendedor, de forma híbrida ou por faturamento a prazo.
Configure depósito, reserva de estoque, aprovações de desconto, política de crédito e permissões antes de liberar os usuários.
Na seção Modos de venda, revise venda à vista, retirada, entrega, venda a prazo e rateio; cada modo controla pagamento, entrega, parcelamento e aprovação.
Atender pelo acesso exclusivo do vendedor
Acesse erp.cynquo.com/vendas e entre com o usuário do vendedor.
Selecione somente uma empresa e unidade autorizadas; o vendedor não recebe menus de cadastro, financeiro ou administração.
Escolha ou cadastre o cliente PF/PJ, informe entrega e depósito e inicie um orçamento ou pedido.
Adicione produtos por SKU, nome ou código de barras. No celular, use o botão de câmera quando disponível.
Use os filtros de marca, ano, modelo e somente com estoque para localizar os produtos.
Confira preço, promoções, saldo, limite total, limite disponível, bloqueio, boletos, títulos vencidos, desconto e explicação das regras antes de enviar.
Aprovar, receber e concluir
Pedidos começam como Rascunho e podem seguir para Aguardando aprovação quando houver desconto, crédito ou exceção.
Cliente bloqueado ou com título vencido pode comprar em dinheiro ou Pix; qualquer outra forma solicita liberação do financeiro.
No caixa separado, o vendedor envia como Pronto para o caixa; o caixa assume o pedido sem recalcular a negociação aprovada.
Na venda a prazo por boleto, selecione um plano como 7/14/21 ou 30/60/90; o financeiro cria exatamente esses vencimentos e compromete o limite do cliente.
No rateio, cadastre previamente o percentual no cliente. O pedido preserva 100% do valor entre as partes documentais e exige aprovação financeira.
Use a fila, o histórico e os estados em português para acompanhar até Pago, Faturado, Concluído ou Cancelado.
Cancelamentos liberam reservas quando o pedido ainda não foi pago; após pagamento ou faturamento, use estorno formal.
Boas práticas e observações
O Portal de Vendas é opcional por unidade e não altera o funcionamento do PDV já configurado.
Preço, estoque, crédito e permissões são calculados pela API central, não pela interface do vendedor.
Resolva os casos mais comuns sem comprometer dados, sessões ou a rastreabilidade da operação.
Checklist rápido
Falha ao entrar: confirme internet, endereço da API, e-mail, senha e se o usuário está ativo.
Menu ausente: confirme o contexto selecionado e peça ao administrador para revisar perfil e escopo.
PDV sem sincronizar: confira conexão, relógio do computador, fila pendente e última mensagem de erro.
Produto não encontrado: valide se está ativo, com SKU/código correto e sincronizado para a unidade.
Saldo divergente: consulte o livro-razão e documentos de origem; nunca corrija diretamente no banco.
Pagamento ou documento fiscal pendente: consulte o status da integração antes de tentar novamente.
Registrar um atendimento
Anote data/hora, usuário, empresa, unidade, terminal, tela e ação executada.
Inclua a mensagem completa e o identificador da entidade, sem enviar senhas ou credenciais.
Informe se a operação ocorreu online ou offline e se foi reenviada.
Preserve os logs locais do PDV e os registros de auditoria até a conclusão da análise.
Entender o estado operacional
O núcleo é validado por formatação, lint, tipos, testes automatizados, build, migrações e health check de PostgreSQL, Redis e RabbitMQ.
Fiscal, TEF, adquirentes, marketplaces e equipamentos só podem ser considerados produtivos depois da homologação com credenciais e dispositivos reais do cliente.
Antes de uma liberação, confirme backup recente, migrações aplicadas, serviços saudáveis e ausência de eventos offline sem tratamento.
Não interprete uma tela acessível como prova de homologação externa; consulte o status e o relatório do provedor correspondente.
Boas práticas e observações
Antes de repetir uma venda, pagamento, emissão ou movimentação, confirme se a primeira tentativa foi processada.
O ambiente atual é de homologação; fiscal, pagamentos e marketplaces exigem credenciais, contratação e homologação para produção.
ERP + PDV integrado