https://wiki.officesystem.com.br/api.php?action=feedcontributions&feedformat=atom&user=VitorOffice System - Contribuições do(a) usuário(a) [pt-br]2026-09-26T23:14:16ZContribuições do(a) usuário(a)MediaWiki 1.34.2https://wiki.officesystem.com.br/index.php?title=Central_de_Notifica%C3%A7%C3%B5es&diff=2401Central de Notificações2026-09-24T12:59:11Z<p>Vitor: </p>
<hr />
<div>==Central de Notificações==<br />
<br />
==Visão funcional==<br />
A Central de Notificações envia mensagens aos clientes por '''WhatsApp''' e '''e-mail'''. O envio pode acontecer de duas formas:<br />
<br />
*'''Manual''' – o operador escolhe a categoria e o período, seleciona os destinatários na lista e dispara na hora, pela aba '''Notificações''';<br />
*'''Automático''' – o próprio Master Key dispara uma vez por dia, no horário configurado, para as categorias marcadas na aba '''Configurações > Automático'''.<br />
<br />
Tudo na Central é '''separado por loja''': configurações de WhatsApp e e-mail, templates, envio automático e histórico. A loja em uso é escolhida no campo '''Loja''', no topo da tela. Esse campo só aparece quando a empresa tem mais de uma loja, e só fica liberado para usuários que podem trocar de loja.<br />
<br />
O cliente definido como '''consumidor padrão''' da loja (cliente usado nas vendas de balcão) nunca aparece em nenhuma categoria.<br />
<br />
===Categorias===<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!O que aparece na busca manual (dentro do período)!!Anexo enviado!!Envio automático<br />
|-<br />
|'''Aniversário'''||Clientes ativos que fazem aniversário (dia e mês) no período. O ano de nascimento é ignorado e o período pode virar o ano (ex.: 20/12 a 10/01)||Nenhum||Sim – aniversariantes do dia<br />
|-<br />
|'''Cobrança a Vencer'''||Títulos do contas a receber em aberto (sem pagamento e com valor maior que zero) com vencimento no período||Boleto, quando o título tem boleto||Sim – títulos que vencem no dia<br />
|-<br />
|'''Cobrança Vencida'''||Títulos em aberto com vencimento no período (use um período já passado)||Boleto, quando o título tem boleto||Sim – títulos que venceram desde a última execução até ontem<br />
|-<br />
|'''Cobrança Paga'''||Títulos com data de pagamento no período||Nenhum||Sim – títulos pagos desde a última execução até hoje<br />
|-<br />
|'''Ordens de Serviço'''||OS com data de abertura no período, exceto orçamentos, filtradas pelos status marcados em '''Status da OS''' (nenhum marcado = todos os status)||Nenhum||'''Não'''<br />
|-<br />
|'''Nota Fiscal'''||Vendas com nota '''autorizada''' (NF-e, NFC-e ou NFS-e) com emissão no período||PDF da nota (DANFE/DANFS-e), boleto da venda (se houver) e XML da nota||Sim – notas emitidas desde a última execução até ontem<br />
|-<br />
|'''Tipos personalizados'''||O que o SQL do tipo retornar (ver seção "Tipos Personalizados")||Nenhum||Sim, se marcado<br />
|}<br />
<br />
'''Controle de envio duplicado:''' tudo o que já foi enviado '''com sucesso''' deixa de aparecer na busca da categoria, a não ser que a opção '''Permitir reenvio''' esteja marcada. O controle é feito:<br />
<br />
*nas Cobranças, por título (ou pelo boleto inteiro, no caso de boleto acumulado);<br />
*na Nota Fiscal, por venda;<br />
*nas Ordens de Serviço, por OS;<br />
*no Aniversário, por cliente dentro do ano;<br />
*nos Tipos personalizados, pela coluna REFERENCIA do SQL.<br />
<br />
Envios com erro não contam: o registro continua aparecendo para ser enviado de novo.<br />
<br />
==Topo da tela==<br />
*'''Loja''' – loja cujas configurações, templates e histórico estão sendo usados (ver "Visão funcional");<br />
*'''WhatsApp: <situação>''' – aparece só quando a loja usa a '''API Não Oficial (uazapi)'''. Mostra se o WhatsApp da loja está '''Conectado''', '''Desconectado''', '''Conectando...''' etc., com a bolinha verde/vermelha ao lado. É atualizado sozinho a cada 15 segundos enquanto a tela está aberta.<br />
<br />
==Aba Notificações (envio manual)==<br />
<br />
===Filtros===<br />
*'''Categoria''' – categoria que será listada;<br />
*'''Permitir reenvio''' – quando marcado, a busca também traz registros que já receberam a notificação com sucesso;<br />
*'''Período''' – combo de atalhos + datas inicial e final + botão '''Buscar''';<br />
*'''Status da OS''' – aparece só na categoria Ordens de Serviço. Marque os status desejados; sem nenhum marcado, todos os status entram.<br />
<br />
'''Atalhos de período''' – escolher um atalho preenche as datas e já faz a busca. Se as datas forem alteradas manualmente, o combo passa sozinho para '''Personalizado'''. Ao abrir a tela o atalho padrão é '''Próximos 30 dias'''.<br />
<br />
{| class="wikitable"<br />
|-<br />
!Atalho!!Datas preenchidas<br />
|-<br />
|Hoje / Ontem / Amanhã||O próprio dia<br />
|-<br />
|Últimos 7 dias / Próximos 7 dias||7 dias contando hoje<br />
|-<br />
|Últimos 30 dias / Próximos 30 dias||30 dias contando hoje<br />
|-<br />
|Esta semana / Semana passada / Próxima semana||De segunda a domingo<br />
|-<br />
|Este mês / Mês passado / Próximo mês||Do dia 1 ao último dia do mês<br />
|-<br />
|Personalizado||Datas digitadas pelo operador<br />
|}<br />
<br />
Os atalhos servem para os dois sentidos porque cada categoria olha para um lado: Cobrança a Vencer e Aniversário normalmente usam datas futuras; Cobrança Vencida, Cobrança Paga, Nota Fiscal e OS usam datas passadas.<br />
<br />
===Lista de destinatários===<br />
*Mostra '''Nome''', '''Telefone''', '''E-mail''' e as colunas próprias de cada categoria (ex.: na Nota Fiscal: Nº Nota, Emissão, Valor e Chave; nas Cobranças: vencimento/pagamento, valor e documento; nas OS: número, abertura, status e valor);<br />
*Na '''NFS-e''', a coluna '''Chave''' mostra a chave de acesso da nota de serviço;<br />
*A caixa no cabeçalho da primeira coluna marca ou desmarca todos;<br />
*O contador no canto superior direito mostra quantos estão selecionados ('''x / y selecionado(s)''');<br />
*Depois do envio, cada linha fica '''verde''' (enviado com sucesso) ou '''vermelha''' (erro).<br />
<br />
===Canais e envio===<br />
*'''WhatsApp''' e '''E-mail''' – canais usados no envio. Pode marcar um ou os dois;<br />
*'''Clipe''' (ao lado dos canais) – salva os canais marcados como padrão do usuário. Ao abrir a tela, os canais já vêm marcados conforme o que foi salvo;<br />
*'''Enviar Selecionados''' – dispara o envio dos registros marcados.<br />
<br />
===Como o envio manual funciona===<br />
#O sistema pede confirmação com a quantidade de destinatários.<br />
#'''Somente uazapi, com 20 ou mais selecionados:''' consulta se o WhatsApp sinalizou restrição para iniciar novas conversas nessa conta. Se houver, avisa e pergunta se deseja enviar mesmo assim (insistir costuma agravar o bloqueio).<br />
#'''Somente uazapi:''' valida de uma vez quais números têm WhatsApp. Os que não têm não recebem a mensagem e ficam no histórico como erro "Número sem WhatsApp".<br />
#'''Somente uazapi, nas categorias sem anexo''' (Aniversário, Cobrança Paga, Ordens de Serviço e Tipos personalizados): as mensagens são entregues de uma vez para a fila da uazapi, que faz os disparos respeitando o intervalo configurado. A mensagem final ("Envio para a fila concluído – Aceitos/Rejeitados") indica só que a fila aceitou as mensagens; a entrega real acontece depois.<br />
#Nos demais casos o envio é '''um por um''':<br />
#*WhatsApp: após cada mensagem o sistema espera um tempo sorteado entre o intervalo configurado e o dobro dele (ex.: intervalo 5 → espera de 5 a 10 segundos), para não parecer disparo automático. Na uazapi, o contato também vê "digitando..." por 1 a 3 segundos antes de cada mensagem;<br />
#*E-mail: espera exatamente o intervalo configurado para e-mail.<br />
#Um cartão de progresso mostra o cliente da vez e o contador ("2 de 10"). O botão '''Cancelar''' interrompe o envio depois da mensagem em andamento.<br />
#Cada envio é gravado no '''Histórico''' com origem '''Manual'''. No final aparece o resumo com sucessos e erros.<br />
<br />
'''Destinatário usado em cada canal:'''<br />
*'''WhatsApp''': celular do cadastro do cliente; se estiver vazio, usa o telefone; se também estiver vazio, usa o fax. Números brasileiros com 10 ou 11 dígitos sem o 55 recebem o 55 automaticamente;<br />
*'''E-mail''': campo e-mail do cadastro do cliente;<br />
*Cliente sem telefone (ou sem e-mail) simplesmente não recebe por aquele canal. Isso não gera registro de erro no histórico.<br />
<br />
==Anexos, links e XML==<br />
<br />
===O que vai em cada canal===<br />
{| class="wikitable"<br />
|-<br />
!Situação!!E-mail!!WhatsApp uazapi!!WhatsApp API Oficial (Meta)<br />
|-<br />
|Cobrança a Vencer / Vencida com boleto||PDF do boleto anexado||PDF do boleto enviado como documento||Link do boleto no texto<br />
|-<br />
|Cobrança a Vencer / Vencida sem boleto||Só o texto||Só o texto||Só o texto<br />
|-<br />
|Nota Fiscal||PDF da nota + PDF do boleto (se a venda tiver) + '''XML sempre'''||PDF da nota + boleto (se houver) como documentos + XML '''se a opção estiver ligada'''||Links da nota, do boleto (se houver) e do XML ('''se a opção estiver ligada''')<br />
|-<br />
|Demais categorias||Só o texto||Só o texto||Só o texto<br />
|}<br />
<br />
*Na uazapi, a mensagem do template vai como legenda do primeiro documento; os demais documentos vão logo em seguida.<br />
*Na API Oficial, os arquivos são enviados para um armazenamento temporário na nuvem e o link entra no lugar da variável correspondente do template ({LINK_BOLETO}, {LINK_NOTA}/{LINK_NFE}, {LINK_XML}). Se o template não tiver a variável, o sistema acrescenta uma linha no fim da mensagem: "Nota Fiscal: <link>", "Boleto para pagamento: <link>" ou "XML da Nota: <link>".<br />
*A opção do XML no WhatsApp fica em '''Configurações > WhatsApp > "Enviar o XML junto no envio de Nota Fiscal"''' (por loja, desmarcada por padrão). No e-mail o XML vai sempre.<br />
<br />
===De onde vêm o PDF e o XML da nota===<br />
*'''Nota emitida pela API''' (o XML fica gravado no Master Key): o PDF e o XML são gerados pelo próprio Master Key.<br />
*'''Nota emitida pelo Master NF-e''' (NF-e, NFC-e e NFS-e): o Master Key pede o PDF e o XML ao Master NF-e. Para isso:<br />
**o '''Master NF-e precisa estar aberto''' e acessível. O endereço usado é o de '''Parâmetros do Sistema > quadro "Servidor DataSnap Master NF-e (Reimpressão e integração NFC-e)" > IP e Porta''' da loja. Em branco, usa a própria máquina e a porta 211;<br />
**se o Master NF-e estiver fechado, o Master Key tenta abri-lo sozinho, desde que o caminho do executável esteja configurado no Connect.ini do Master Key (seção [NFE], chave PathExe);<br />
**o '''Master NF-e precisa estar atualizado''' na mesma versão do Master Key. Versões antigas não sabem gerar o PDF da NFS-e nem o XML para a Central.<br />
<br />
===Quando o PDF ou o XML falham===<br />
*'''Cobranças – boleto não gerado:''' se o título tem boleto e o PDF não pode ser gerado, a mensagem daquele cliente '''não é enviada''' e o histórico registra o motivo.<br />
*'''Nota Fiscal – PDF da nota não gerado:''' a mensagem daquele cliente '''não é enviada''' e o histórico registra o motivo (ex.: "MasterNFe está fechado", "method not found" quando o Master NF-e está desatualizado). Exceção: no e-mail e no WhatsApp pela API Oficial, se o boleto da venda foi gerado, a mensagem segue só com o boleto. Se apenas o boleto da venda falhar, a mensagem segue sem ele.<br />
*'''XML não gerado:''' a mensagem '''é enviada mesmo assim''', só sem o XML. O motivo fica no arquivo de log (ver "Solução de problemas").<br />
*'''Título sem boleto:''' não é erro; a mensagem vai só com o texto.<br />
<br />
==Configurações==<br />
Aba com quatro sub-abas. As alterações são gravadas pelo botão de gravar da aba; ao trocar de aba com alterações pendentes, o sistema pergunta se deseja salvar.<br />
<br />
===WhatsApp===<br />
<br />
'''Tipo de API'''<br />
<br />
*'''API Oficial (Meta)''' – integração direta com a API oficial do WhatsApp. Não há risco de bloqueio do número. Envia só texto; os arquivos vão como link. Não há validação prévia de número nem consulta de restrição de conta;<br />
*'''API Não Oficial (uazapi)''' – conecta o WhatsApp da loja por QR Code. Envia os arquivos como documento, valida os números antes do envio e mostra a situação da conexão no topo da tela. '''Tem risco de bloqueio do número''' em caso de uso inadequado (envio em massa, spam); por isso a tela exibe o aviso em vermelho.<br />
<br />
'''Campos da API Oficial (Meta)'''<br />
*'''Phone ID''' – identificador do número na conta Meta;<br />
*'''Token''' – token de acesso da conta Meta;<br />
*'''Versão''' – versão da API (padrão v18.0).<br />
<br />
'''Campos da API Não Oficial (uazapi)'''<br />
*'''Servidor''' – endereço do servidor uazapi. Já vem preenchido com o servidor padrão;<br />
*'''Instância''' – nome gerado automaticamente pelo sistema, não editável. O formato é '''MK''' + CNPJ da empresa + '''F''' + código da loja (ex.: MK73766255000133F1).<br />
<br />
'''Botões da uazapi'''<br />
*'''Criar Instância''' – cria a instância no servidor uazapi e grava o token dela na configuração da loja. Exige o '''Admin Token''' da conta uazapi, que não tem campo na tela e precisa ser gravado direto no banco (tabela NOTIF_CONFIG, campo NC_WA_UAZ_ADMTOKEN, na linha da loja). Sem ele o sistema avisa e não cria. Se já existir no servidor uma instância com o mesmo nome, o sistema reaproveita essa instância em vez de criar outra;<br />
*'''Consultar Status''' – consulta na hora se o WhatsApp está conectado;<br />
*'''Conectar (QR Code)''' – mostra o QR Code para ler no celular (WhatsApp > Aparelhos conectados). O QR é renovado a cada 8 segundos até a conexão ser feita. Se já estiver conectado, o sistema avisa;<br />
*'''Desconectar''' – encerra a sessão do WhatsApp na instância (pede confirmação).<br />
<br />
'''Campos comuns'''<br />
*'''Intervalo entre envios (segundos)''' – vale para os dois tipos de API. Padrão: 2 segundos. No envio um por um, a espera real é sorteada entre esse valor e o dobro;<br />
*'''Enviar o XML junto no envio de Nota Fiscal''' – quando marcado, o WhatsApp também leva o XML nas notificações da categoria Nota Fiscal (ver "Anexos, links e XML").<br />
<br />
===E-mail===<br />
*'''Servidor SMTP''', '''Porta''' (padrão 587), '''Criptografia''' (TLS, SSL ou nenhuma; padrão TLS), '''Usuário''', '''Senha''';<br />
*'''Nome exibido''' – nome que aparece como remetente;<br />
*'''E-mail de resposta''' – endereço usado quando o cliente clica em "Responder";<br />
*'''Intervalo entre envios (segundos)''' – espera entre um e-mail e outro. Padrão: 3 segundos.<br />
<br />
Cada loja envia com a sua própria configuração de e-mail. Se o '''Servidor SMTP''' da loja estiver em branco, os e-mails dessa loja saem com a configuração de e-mail '''completa da loja 1''' (servidor, porta, usuário, senha, nome e e-mail de resposta).<br />
<br />
O botão '''Testar E-mail''' envia um e-mail de teste para o endereço informado em '''Usuário''', usando os valores que estão na tela no momento (mesmo antes de gravar). Numa loja com o servidor SMTP em branco o teste falha, embora o envio real funcione usando a configuração da loja 1.<br />
<br />
O texto do e-mail é enviado '''sem formatação''' (ver "Templates").<br />
<br />
===Templates===<br />
Cada categoria tem um template para '''WhatsApp''' e outro para '''E-mail''', separados por loja. O de e-mail tem também o campo '''Assunto''', que aceita as mesmas variáveis da mensagem.<br />
<br />
*A Central já vem com templates padrão para todas as categorias fixas;<br />
*'''Inserir variável''' – escolha a variável no combo e clique em '''Inserir na mensagem''' para colocá-la na posição do cursor;<br />
*'''Prévia da mensagem''' – mostra como a mensagem fica, preenchida com dados de exemplo;<br />
*O editor aceita formatação (negrito, cores etc.), mas '''a mensagem é enviada como texto simples''': a formatação não chega ao cliente. Emojis e quebras de linha são mantidos;<br />
*'''Template usado no envio:''' o da própria loja. Se a loja não tiver template preenchido para aquela categoria/canal (ex.: loja nova, que nunca teve o template editado), é usado o template da '''loja 1'''. Se nem a loja 1 tiver, a mensagem enviada é apenas "<nome do cliente>, olá!" e o assunto do e-mail é o nome da categoria.<br />
<br />
'''Variáveis disponíveis'''<br />
<br />
Todas as categorias aceitam: '''{NOME}''', '''{TELEFONE}''' e '''{EMAIL}'''. Variáveis extras por categoria:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Variáveis extras<br />
|-<br />
|Aniversário||{DATA_NASC}<br />
|-<br />
|Cobrança a Vencer / Vencida||{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}<br />
|-<br />
|Cobrança Paga||{VENCIMENTO} {VALOR} {DOCUMENTO}<br />
|-<br />
|Ordens de Serviço||{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}<br />
|-<br />
|Nota Fiscal||{NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO} {LINK_XML}<br />
|-<br />
|Tipos personalizados||{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC}<br />
|}<br />
<br />
*'''{CHAVE}''' – chave de acesso da nota; na NFS-e é a chave de acesso da nota de serviço;<br />
*'''{LINK_NOTA}''' e '''{LINK_NFE}''' são equivalentes (os dois viram o link do PDF da nota);<br />
*Na Cobrança Paga não existe {LINK_BOLETO}: se for colocada no template, o texto "{LINK_BOLETO}" aparece literal na mensagem.<br />
<br />
'''Sobre as variáveis de link ({LINK_BOLETO}, {LINK_NOTA}, {LINK_NFE}, {LINK_XML})''' – a tela mostra um aviso sobre isso nas categorias que têm links:<br />
*Elas só viram link no '''WhatsApp pela API Oficial (Meta)''';<br />
*No '''e-mail''' e no '''WhatsApp uazapi''' os arquivos vão anexados e a variável é apenas '''apagada''' do texto. Só a variável é apagada, não a frase em volta: um template escrito como "baixe o boleto pelo link: {LINK_BOLETO}" chega como "baixe o boleto pelo link:". Revise os templates pensando no canal que a loja usa;<br />
*Em títulos sem boleto, {LINK_BOLETO} também é apagada.<br />
<br />
===Automático===<br />
*'''Ativar envio automático diário''' – liga/desliga o automático da loja;<br />
*'''Hora do envio''' – horário (HH:MM) a partir do qual o envio do dia pode acontecer;<br />
*'''Canais''' – WhatsApp e/ou E-mail;<br />
*'''Categorias''' – categorias processadas no automático. '''Ordens de Serviço não aparece nesta lista''', porque não tem envio automático; OS só é enviada manualmente.<br />
<br />
Detalhes de funcionamento na seção "Envio automático".<br />
<br />
==Cobrança a Vencer, Vencida e Paga==<br />
Essas três categorias trabalham sobre o contas a receber como um todo. O título entra na lista tendo ou não boleto bancário; o que muda é o que é enviado.<br />
<br />
===Quando o título tem boleto===<br />
O boleto só é gerado e enviado quando:<br />
*o título tem banco informado;<br />
*esse banco tem layout de boleto configurado;<br />
*o banco tem conta corrente cadastrada para a loja do título.<br />
<br />
Títulos convertidos de outro sistema (série '''ANT''') nunca geram boleto.<br />
<br />
Se o sistema não conseguir verificar se o título tem boleto (erro de consulta), a mensagem daquele título '''não é enviada''', para não mandar cobrança sem o boleto por engano. O motivo fica no histórico.<br />
<br />
===Título sem boleto===<br />
A notificação é enviada mesmo assim, só com o texto do template (sem anexo e sem link), em qualquer canal.<br />
<br />
===Boleto acumulado (opção "Acumulativo" na impressão de boletos)===<br />
Quando o boleto foi gerado de forma acumulada – várias notas/parcelas agrupadas em um único boleto, pela tela '''Relatórios > Financeiro > Boletos e Duplicatas > Impressão''', marcando '''Acumulativo por Cliente''' ou '''Acumulativo por Cliente/Vencimento''' – a Central reconhece o agrupamento e:<br />
<br />
*mostra '''uma única linha''' na lista, representando o boleto inteiro;<br />
*exibe como '''Valor''' a soma das contas do grupo (em aberto, nas categorias a Vencer/Vencida; pagas, na Cobrança Paga);<br />
*exibe como '''Documento''' o número do boleto acumulado (ex.: AC00033);<br />
*envia um '''único PDF''', com o valor total e o mesmo nosso número da impressão de Boletos e Duplicatas;<br />
*controla o histórico pelo boleto inteiro, então a baixa de uma das contas do grupo não faz a notificação ser enviada de novo.<br />
<br />
==Envio automático==<br />
<br />
===Quando dispara===<br />
*Cada Master Key aberto verifica '''a cada minuto''' se já passou do horário configurado para a '''loja em que está logado''' e se o automático ainda não rodou hoje nessa loja.<br />
*Com vários computadores abertos, '''só um''' executa o envio do dia; os demais percebem que já foi feito. Resultado: '''uma execução por dia por loja'''.<br />
*É preciso que '''algum Master Key esteja aberto e logado na loja''' depois do horário configurado. Se ninguém abrir o sistema naquela loja no dia, o envio não acontece nesse dia.<br />
*O envio roda em segundo plano, sem travar o sistema e sem nenhuma tela.<br />
*'''Base de cliente aberta dentro da rede da Office''' (ex.: base copiada para análise pelo suporte): o automático '''não dispara''', para não mandar mensagens reais aos clientes daquela empresa.<br />
<br />
===Período processado por categoria===<br />
O sistema guarda o dia da última execução da loja. Na execução seguinte, processa '''desde esse dia''' – normalmente "ontem". Se o automático ficou alguns dias sem rodar (sistema fechado, feriado etc.), ele '''recupera os dias perdidos''' na próxima execução.<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!O que é processado<br />
|-<br />
|Aniversário||Aniversariantes de '''hoje'''<br />
|-<br />
|Cobrança a Vencer||Títulos em aberto que '''vencem hoje''' (o lembrete chega no dia do vencimento)<br />
|-<br />
|Cobrança Vencida||Títulos em aberto que venceram '''desde a última execução até ontem'''<br />
|-<br />
|Cobrança Paga||Títulos pagos '''desde a última execução até hoje'''<br />
|-<br />
|Nota Fiscal||Notas autorizadas emitidas '''desde a última execução até ontem'''<br />
|-<br />
|Tipos personalizados||O que o SQL retornar, com data inicial = dia da última execução e data final = hoje<br />
|-<br />
|Ordens de Serviço||Não tem envio automático<br />
|}<br />
<br />
===Regras do envio automático===<br />
*Categorias não marcadas são ignoradas. Sem nenhum canal marcado, nada é enviado.<br />
*A ordem de processamento é: Aniversário, Cobrança a Vencer, Cobrança Vencida, Cobrança Paga, Nota Fiscal e, por último, os Tipos personalizados.<br />
*'''Um cliente recebe no máximo uma categoria automática por dia.''' Se ele já recebeu com sucesso uma notificação automática de outra categoria no dia, as demais categorias dele são puladas. As mensagens puladas '''não são reenviadas depois pelo automático'''. Se necessário, envie pela aba Notificações.<br />
*Antes de cada envio o sistema '''reconfere''' o registro, porque a lista pode ter sido montada momentos antes: título que foi pago, nota que foi cancelada ou pagamento estornado não recebem a mensagem.<br />
*O que já foi enviado com sucesso nunca é enviado de novo pelo automático.<br />
*Os intervalos entre mensagens são os mesmos do envio manual.<br />
*Nos Tipos personalizados vale o '''Limite de envios''' do cadastro (quantidade máxima de mensagens por execução).<br />
*Tudo o que o automático envia fica no Histórico com origem '''Automático'''.<br />
<br />
==Histórico==<br />
<br />
===Filtros===<br />
*'''Período''' – mesmo combo de atalhos da aba Notificações. Ao abrir, o padrão é '''Últimos 30 dias''';<br />
*'''Tipo''' – Todos, WhatsApp ou E-mail;<br />
*'''Status''' – Todos, Sucesso, Erro ou Reenviado;<br />
*'''Origem''' – Todos, Manual, Automático ou Reenvio;<br />
*'''Categoria''' – mesmas categorias da aba Notificações, inclusive os tipos personalizados ativos;<br />
*'''Cliente''' – busca por parte do nome ou do destino (telefone/e-mail). '''Enter''' no campo já filtra;<br />
*'''Filtrar''' – aplica os filtros. Escolher um atalho de período também filtra na hora.<br />
<br />
Abaixo dos filtros aparece o total de '''falhas pendentes de reenvio''' da loja (todas as datas) e a data da mais antiga, em vermelho quando existe alguma.<br />
<br />
===Grade===<br />
{| class="wikitable"<br />
|-<br />
!Coluna!!Conteúdo<br />
|-<br />
|Data/Hora||Momento do envio (ou do último reenvio, quando o registro foi reenviado)<br />
|-<br />
|Tipo||WhatsApp ou E-mail<br />
|-<br />
|Categoria||Nome da categoria<br />
|-<br />
|Nome / Destino||Cliente e número/e-mail usado<br />
|-<br />
|Status||'''Sucesso''', '''Erro''' ou '''Reenviado''' (ver abaixo)<br />
|-<br />
|Origem||'''Manual''' (aba Notificações), '''Automático''' ou '''Reenvio'''<br />
|-<br />
|Anexos||Arquivos que foram junto: DANFE, DANFS-e, Boleto, XML. Só é preenchido nos envios com sucesso; no WhatsApp pela API Oficial fica vazio, porque lá os arquivos vão como link no texto<br />
|-<br />
|Detalhes||Motivo do erro ou retorno do envio<br />
|}<br />
<br />
*Linhas com '''Erro''' aparecem destacadas.<br />
*'''Duplo clique''' em qualquer linha abre a janela '''Detalhes do envio''', com todos os dados do registro, os detalhes completos e a '''mensagem completa''' que foi enviada. O texto pode ser selecionado e copiado.<br />
<br />
'''Significado do Status'''<br />
*'''Sucesso''' – o envio foi aceito pelo WhatsApp/servidor de e-mail;<br />
*'''Erro''' – o envio falhou; o motivo está em Detalhes;<br />
*'''Reenviado''' – usado em dois casos:<br />
**registros antigos que já foram reenviados;<br />
**falhas que o sistema decidiu '''não''' reenviar. Nesse caso, Detalhes mostra "Não reenviado: título já quitado" (vale também para nota cancelada) ou "Não reenviado: categoria não reconhecida".<br />
<br />
===Reenviar Falhas===<br />
Reenvia, de uma vez, os registros com status '''Erro''':<br />
*considera '''apenas o período e o filtro de Tipo'''. Os filtros de Status, Origem, Categoria e Cliente '''não''' limitam o Reenviar Falhas;<br />
*antes de reenviar, confere se o documento continua válido: título ainda em aberto, nota ainda autorizada, pagamento não estornado. Se não estiver, a falha é marcada como "Não reenviado" e não é enviada;<br />
*gera de novo os anexos (boleto, PDF e XML da nota), porque os arquivos do envio original não existem mais;<br />
*o reenvio '''atualiza o próprio registro''' do erro (data, status, detalhes e anexos) em vez de criar uma linha nova;<br />
*um documento que já tem '''5 ou mais falhas''' no período é considerado falha persistente e é '''ignorado''' pelo Reenviar Falhas (normalmente é problema de cadastro ou de configuração). Esses casos devem ser corrigidos e reenviados um a um pelo '''Reenviar Este''';<br />
*respeita os intervalos entre mensagens e mostra o cartão de progresso com '''Cancelar'''.<br />
<br />
Ao terminar, o resumo mostra só as linhas que aconteceram:<br />
*enviadas com sucesso;<br />
*com erro novamente (motivo na coluna Detalhes);<br />
*não reenviadas porque o título já foi quitado ou o documento cancelado;<br />
*ignoradas por já terem falhado 5 vezes.<br />
<br />
===Reenviar Este===<br />
Reenvia o registro selecionado na grade, '''qualquer que seja o status''':<br />
*'''Registro com Erro:''' o reenvio atualiza o próprio registro, como no Reenviar Falhas;<br />
*'''Registro com Sucesso''' (ou Reenviado): o sistema avisa que será criado um '''novo registro''' no histórico. O registro original fica intacto e o novo aparece com origem '''Reenvio''';<br />
*também confere se o documento ainda é válido e gera os anexos de novo;<br />
*se falhar, a mensagem orienta a ver o motivo na coluna Detalhes.<br />
<br />
==Tipos Personalizados==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > aba '''Tipos Personalizados''' (só aparece para quem tem a permissão 324 – ver "Permissões").<br />
<br />
Permite criar categorias próprias a partir de um SQL. Cada tipo ativo aparece automaticamente na aba Notificações, nos Templates, na lista do Automático e no filtro do Histórico. A lista de categorias é atualizada ao gravar ou excluir um tipo, sem precisar reabrir a tela.<br />
<br />
===Campos do cadastro===<br />
*'''Descrição''' – nome da categoria na tela;<br />
*'''Ativo''' – só tipos ativos aparecem nas listas;<br />
*'''Limite de envios''' – máximo de mensagens por execução do '''automático'''; 0 = sem limite. Não limita o envio manual;<br />
*'''SQL''' – consulta que retorna os destinatários;<br />
*'''Col 1 a Col 4''' – títulos das colunas DETALHE1 a DETALHE4 na lista de envio manual;<br />
*Botão '''Testar SQL''' – executa o SQL com parâmetros de teste e informa se há erro ou se não retornou registros.<br />
<br />
===Colunas que o SQL deve retornar===<br />
*'''CLIENTE_ID''' – código do cliente (usado no histórico e na regra de "uma categoria automática por dia");<br />
*'''NOME''' – nome do destinatário;<br />
*'''FONE''' – número de WhatsApp (sem essa coluna não há envio por WhatsApp);<br />
*'''EMAIL''' – e-mail (sem essa coluna não há envio por e-mail);<br />
*'''REFERENCIA''' – '''número inteiro e único''' por registro. É o que impede o mesmo registro de ser enviado duas vezes. Se vier vazio ou repetido, o controle não funciona: depois do primeiro envio com sucesso, os demais registros com a mesma referência deixam de aparecer.<br />
<br />
Colunas opcionais:<br />
*'''DETALHE1''' a '''DETALHE4''' – informações extras, usadas nas variáveis {DETALHE1}…{DETALHE4} e nas colunas da lista. O '''DETALHE3''' também é usado como '''documento''' do registro no histórico e na variável {REFERENCIA_DOC}.<br />
<br />
===Parâmetros que podem ser usados no SQL===<br />
*''':FILIAL''' – código da loja;<br />
*''':DATA_DE''' ou ''':DE''' – data inicial. No manual é a data inicial da tela; no automático é o dia da última execução;<br />
*''':DATA_ATE''' ou ''':ATE''' – data final. No manual é a data final da tela; no automático é hoje;<br />
*''':REENVIO''' – 'S' ou 'N'. No manual reflete a opção '''Permitir reenvio'''; no automático é sempre 'N'.<br />
<br />
===Validação das variáveis===<br />
Ao gravar o template de um tipo personalizado, o sistema confere se todas as variáveis usadas ({...}) são colunas que o SQL realmente retorna. Se alguma não existir, a gravação é bloqueada e a mensagem lista as colunas disponíveis.<br />
<br />
==Permissões==<br />
{| class="wikitable"<br />
|-<br />
!Permissão!!Efeito<br />
|-<br />
|Item de menu '''Central de Notificações'''||Acesso à tela<br />
|-<br />
|'''Central de Notificações – Tipos Personalizados''' (324)||Mostra a aba Tipos Personalizados. Sem ela, a aba fica oculta<br />
|}<br />
<br />
==Solução de problemas==<br />
<br />
===Onde ver o que aconteceu===<br />
*'''Histórico''' – status e motivo de cada envio; o duplo clique mostra a mensagem completa.<br />
*'''Arquivo de log''' – na pasta do Master Key, em '''Logs\Central Notificacoes\NotifAPI_DDMMAA.log''' (um arquivo por dia). Registra a geração do PDF e do XML das notas (inclusive por que falhou), as respostas da uazapi e o resumo de cada categoria do envio automático (quantos registros, quantos enviados, quantos pulados).<br />
<br />
===Mensagem não chega por WhatsApp===<br />
#Situação no topo da tela / '''Consultar Status''' (uazapi) deve estar '''Conectado'''.<br />
#O canal WhatsApp estava marcado no envio (e, no automático, em Configurações > Automático > Canais).<br />
#O cliente tem celular/telefone no cadastro.<br />
#Se o histórico mostra "Número sem WhatsApp", o número não tem WhatsApp ativo – corrigir o cadastro.<br />
#O template de WhatsApp da categoria está preenchido.<br />
#Envio em fila (uazapi, categorias sem anexo): "aceito" na fila não é garantia de entrega.<br />
#Se o WhatsApp sinalizou restrição da conta, parar os envios em massa por um tempo.<br />
<br />
===Mensagem não chega por e-mail===<br />
#Testar as configurações com '''Testar E-mail''' na loja em questão. Se o servidor SMTP da loja estiver em branco, o envio usa a configuração da loja 1: testar lá.<br />
#O cliente tem e-mail no cadastro.<br />
#O template de e-mail da categoria está preenchido.<br />
#Verificar a caixa de spam do cliente.<br />
<br />
===Nota Fiscal não é enviada (erro ao gerar o PDF)===<br />
*"MasterNFe está fechado" – abrir o Master NF-e (ou configurar o caminho dele no Connect.ini para o Master Key abrir sozinho) e conferir IP/Porta do DataSnap nos Parâmetros do Sistema da loja.<br />
*"method not found" / "not found in the server method list" – o Master NF-e aberto é de versão antiga. Atualizar o Master NF-e (e conferir se o executável aberto é o da pasta certa).<br />
*"Error writing data to the connection" – o Master NF-e perdeu a conexão com o banco (ex.: o Firebird foi reiniciado depois que ele foi aberto). Fechar e abrir o Master NF-e.<br />
<br />
===Nota enviada sem o XML===<br />
Ver o arquivo de log do dia (linhas "GerarXMLNFe"). Normalmente é o Master NF-e fechado, desatualizado ou sem acesso. No WhatsApp, conferir também se a opção "Enviar o XML junto no envio de Nota Fiscal" está marcada.<br />
<br />
===Mensagem com frase incompleta ("...pelo link:")===<br />
O template usa uma variável de link e a loja envia por e-mail ou uazapi, onde a variável é apagada. Ajustar o texto do template (ver "Templates").<br />
<br />
===Registro não aparece na lista para envio===<br />
*Já foi enviado com sucesso – marcar '''Permitir reenvio''' ou usar o '''Reenviar Este''' no Histórico.<br />
*É o consumidor padrão da loja.<br />
*Aniversário: cliente inativo, ou já recebeu com sucesso neste ano.<br />
*Cobranças: título já pago, com valor zero ou fora do período.<br />
*Nota Fiscal: nota não autorizada (cancelada, rejeitada etc.).<br />
*OS: é orçamento, ou o status não está marcado em "Status da OS".<br />
<br />
===Envio automático não disparou===<br />
#O automático está ativo na loja (Configurações > Automático).<br />
#O horário configurado já passou.<br />
#Algum Master Key foi aberto e logado '''nessa loja''' depois do horário.<br />
#Ao menos um canal e uma categoria estão marcados.<br />
#Ainda não rodou hoje: o campo NC_AUTO_ULTIMODIA da loja (tabela NOTIF_CONFIG) com a data de hoje indica que já executou.<br />
#Não é uma base de cliente aberta na rede da Office (nesse caso o automático é bloqueado de propósito).<br />
#Conferir no arquivo de log as linhas "Envio automático concluído" de cada categoria.<br />
<br />
===Registro aparece na busca manual mas não foi enviado pelo automático===<br />
*É '''Ordens de Serviço''' – não tem automático.<br />
*O período do automático é diferente do da tela (ver tabela em "Envio automático"). Exemplo: Cobrança a Vencer no automático só pega o que vence '''no dia'''.<br />
*O cliente já tinha recebido outra categoria automática no dia (regra de uma categoria por dia).<br />
*O título foi pago, a nota cancelada ou o pagamento estornado antes do envio.<br />
*Tipos personalizados: o Limite de envios foi atingido.<br />
<br />
===Falha que o Reenviar Falhas não reenvia===<br />
*O documento já falhou 5 ou mais vezes no período – corrigir a causa e usar '''Reenviar Este'''.<br />
*A falha está fora do período ou do Tipo filtrados.<br />
*O título foi quitado / a nota foi cancelada – aparece como "Não reenviado" em Detalhes.<br />
<br />
==Referência de banco de dados==<br />
Tabelas usadas pela Central:<br />
<br />
*'''NOTIF_CONFIG''' – configuração por loja (uma linha por loja, campo NC_FILIAL). Criada automaticamente ao abrir a Central na loja pela primeira vez;<br />
*'''NOTIF_TEMPLATE''' – templates por categoria, tipo (W = WhatsApp, E = E-mail) e loja;<br />
*'''NOTIF_HISTORICO''' – histórico de todos os envios;<br />
*'''NOTIF_TIPO_PERS''' – cadastro dos tipos personalizados.<br />
<br />
Campos úteis de NOTIF_CONFIG:<br />
*NC_WA_TIPO – tipo de API do WhatsApp (O = Oficial/Meta, U = uazapi);<br />
*NC_WA_UAZ_ADMTOKEN – Admin Token da conta uazapi (não tem campo na tela);<br />
*NC_WA_UAZ_TOKEN / NC_WA_UAZ_INSTANCIA – token e nome da instância uazapi;<br />
*NC_WA_ENVIA_XML – envia o XML da nota pelo WhatsApp (S/N);<br />
*NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS – configuração do envio automático;<br />
*NC_AUTO_ULTIMODIA – último dia em que o automático executou na loja.<br />
<br />
Campos úteis de NOTIF_HISTORICO:<br />
*NH_STATUS – S (Sucesso), E (Erro), R (Reenviado);<br />
*NH_ORIGEM – M (Manual), A (Automático), R (Reenvio);<br />
*NH_CATEGORIA – código da categoria (ANIVERSARIO, BOLETO_VENCER, BOLETO_VENCIDO, BOLETO_PAGO, OS_PRONTA para Ordens de Serviço, NFE para Nota Fiscal, PERS_<n> para os tipos personalizados);<br />
*NH_REFERENCIA / NH_REFERENCIA_DOC – documento notificado (título, venda, OS...);<br />
*NH_ERRO – detalhes/motivo;<br />
*NH_ANEXOS – anexos enviados;<br />
*NH_MENSAGEM / NH_ASSUNTO – mensagem e assunto enviados;<br />
*NH_STATUS_ENTREGA – situação de entrega no WhatsApp (uazapi), atualizada ao filtrar o histórico.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Central_de_Notifica%C3%A7%C3%B5es&diff=2400Central de Notificações2026-09-23T18:44:21Z<p>Vitor: </p>
<hr />
<div>==Central de Notificações==<br />
<br />
==Visão funcional==<br />
A Central de Notificações envia mensagens aos clientes por '''WhatsApp''' e '''e-mail'''. O envio pode acontecer de duas formas:<br />
<br />
*'''Manual''' – o operador escolhe a categoria e o período, seleciona os destinatários na lista e dispara na hora, pela aba '''Notificações''';<br />
*'''Automático''' – o próprio Master Key dispara uma vez por dia, no horário configurado, para as categorias marcadas na aba '''Configurações > Automático'''.<br />
<br />
Tudo na Central é '''separado por loja''': configurações de WhatsApp e e-mail, templates, envio automático e histórico. A loja em uso é escolhida no campo '''Loja''', no topo da tela. Esse campo só aparece quando a empresa tem mais de uma loja, e só fica liberado para usuários que podem trocar de loja.<br />
<br />
O cliente definido como '''consumidor padrão''' da loja (cliente usado nas vendas de balcão) nunca aparece em nenhuma categoria.<br />
<br />
===Categorias===<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!O que aparece na busca manual (dentro do período)!!Anexo enviado!!Envio automático<br />
|-<br />
|'''Aniversário'''||Clientes ativos que fazem aniversário (dia e mês) no período. O ano de nascimento é ignorado e o período pode virar o ano (ex.: 20/12 a 10/01)||Nenhum||Sim – aniversariantes do dia<br />
|-<br />
|'''Cobrança a Vencer'''||Títulos do contas a receber em aberto (sem pagamento e com valor maior que zero) com vencimento no período||Boleto, quando o título tem boleto||Sim – títulos que vencem no dia<br />
|-<br />
|'''Cobrança Vencida'''||Títulos em aberto com vencimento no período (use um período já passado)||Boleto, quando o título tem boleto||Sim – títulos que venceram desde a última execução até ontem<br />
|-<br />
|'''Cobrança Paga'''||Títulos com data de pagamento no período||Nenhum||Sim – títulos pagos desde a última execução até hoje<br />
|-<br />
|'''Ordens de Serviço'''||OS com data de abertura no período, exceto orçamentos, filtradas pelos status marcados em '''Status da OS''' (nenhum marcado = todos os status)||Nenhum||'''Não'''<br />
|-<br />
|'''Nota Fiscal'''||Vendas com nota '''autorizada''' (NF-e, NFC-e ou NFS-e) com emissão no período||PDF da nota (DANFE/DANFS-e), boleto da venda (se houver) e XML da nota||Sim – notas emitidas desde a última execução até ontem<br />
|-<br />
|'''Tipos personalizados'''||O que o SQL do tipo retornar (ver seção "Tipos Personalizados")||Nenhum||Sim, se marcado<br />
|}<br />
<br />
'''Controle de envio duplicado:''' tudo o que já foi enviado '''com sucesso''' deixa de aparecer na busca da categoria, a não ser que a opção '''Permitir reenvio''' esteja marcada. O controle é feito:<br />
<br />
*nas Cobranças, por título (ou pelo boleto inteiro, no caso de boleto acumulado);<br />
*na Nota Fiscal, por venda;<br />
*nas Ordens de Serviço, por OS;<br />
*no Aniversário, por cliente dentro do ano;<br />
*nos Tipos personalizados, pela coluna REFERENCIA do SQL.<br />
<br />
Envios com erro não contam: o registro continua aparecendo para ser enviado de novo.<br />
<br />
==Topo da tela==<br />
*'''Loja''' – loja cujas configurações, templates e histórico estão sendo usados (ver "Visão funcional");<br />
*'''WhatsApp: <situação>''' – aparece só quando a loja usa a '''API Não Oficial (uazapi)'''. Mostra se o WhatsApp da loja está '''Conectado''', '''Desconectado''', '''Conectando...''' etc., com a bolinha verde/vermelha ao lado. É atualizado sozinho a cada 15 segundos enquanto a tela está aberta.<br />
<br />
==Aba Notificações (envio manual)==<br />
<br />
===Filtros===<br />
*'''Categoria''' – categoria que será listada;<br />
*'''Permitir reenvio''' – quando marcado, a busca também traz registros que já receberam a notificação com sucesso;<br />
*'''Período''' – combo de atalhos + datas inicial e final + botão '''Buscar''';<br />
*'''Status da OS''' – aparece só na categoria Ordens de Serviço. Marque os status desejados; sem nenhum marcado, todos os status entram.<br />
<br />
'''Atalhos de período''' – escolher um atalho preenche as datas e já faz a busca. Se as datas forem alteradas manualmente, o combo passa sozinho para '''Personalizado'''. Ao abrir a tela o atalho padrão é '''Próximos 30 dias'''.<br />
<br />
{| class="wikitable"<br />
|-<br />
!Atalho!!Datas preenchidas<br />
|-<br />
|Hoje / Ontem / Amanhã||O próprio dia<br />
|-<br />
|Últimos 7 dias / Próximos 7 dias||7 dias contando hoje<br />
|-<br />
|Últimos 30 dias / Próximos 30 dias||30 dias contando hoje<br />
|-<br />
|Esta semana / Semana passada / Próxima semana||De segunda a domingo<br />
|-<br />
|Este mês / Mês passado / Próximo mês||Do dia 1 ao último dia do mês<br />
|-<br />
|Personalizado||Datas digitadas pelo operador<br />
|}<br />
<br />
Os atalhos servem para os dois sentidos porque cada categoria olha para um lado: Cobrança a Vencer e Aniversário normalmente usam datas futuras; Cobrança Vencida, Cobrança Paga, Nota Fiscal e OS usam datas passadas.<br />
<br />
===Lista de destinatários===<br />
*Mostra '''Nome''', '''Telefone''', '''E-mail''' e as colunas próprias de cada categoria (ex.: na Nota Fiscal: Nº Nota, Emissão, Valor e Chave; nas Cobranças: vencimento/pagamento, valor e documento; nas OS: número, abertura, status e valor);<br />
*Na '''NFS-e''', a coluna '''Chave''' mostra a chave de acesso da nota de serviço;<br />
*A caixa no cabeçalho da primeira coluna marca ou desmarca todos;<br />
*O contador no canto superior direito mostra quantos estão selecionados ('''x / y selecionado(s)''');<br />
*Depois do envio, cada linha fica '''verde''' (enviado com sucesso) ou '''vermelha''' (erro).<br />
<br />
===Canais e envio===<br />
*'''WhatsApp''' e '''E-mail''' – canais usados no envio. Pode marcar um ou os dois;<br />
*'''Clipe''' (ao lado dos canais) – salva os canais marcados como padrão do usuário. Ao abrir a tela, os canais já vêm marcados conforme o que foi salvo;<br />
*'''Enviar Selecionados''' – dispara o envio dos registros marcados.<br />
<br />
===Como o envio manual funciona===<br />
#O sistema pede confirmação com a quantidade de destinatários.<br />
#'''Somente uazapi, com 20 ou mais selecionados:''' consulta se o WhatsApp sinalizou restrição para iniciar novas conversas nessa conta. Se houver, avisa e pergunta se deseja enviar mesmo assim (insistir costuma agravar o bloqueio).<br />
#'''Somente uazapi:''' valida de uma vez quais números têm WhatsApp. Os que não têm não recebem a mensagem e ficam no histórico como erro "Número sem WhatsApp".<br />
#'''Somente uazapi, nas categorias sem anexo''' (Aniversário, Cobrança Paga, Ordens de Serviço e Tipos personalizados): as mensagens são entregues de uma vez para a fila da uazapi, que faz os disparos respeitando o intervalo configurado. A mensagem final ("Envio para a fila concluído – Aceitos/Rejeitados") indica só que a fila aceitou as mensagens; a entrega real acontece depois.<br />
#Nos demais casos o envio é '''um por um''':<br />
#*WhatsApp: após cada mensagem o sistema espera um tempo sorteado entre o intervalo configurado e o dobro dele (ex.: intervalo 5 → espera de 5 a 10 segundos), para não parecer disparo automático. Na uazapi, o contato também vê "digitando..." por 1 a 3 segundos antes de cada mensagem;<br />
#*E-mail: espera exatamente o intervalo configurado para e-mail.<br />
#Um cartão de progresso mostra o cliente da vez e o contador ("2 de 10"). O botão '''Cancelar''' interrompe o envio depois da mensagem em andamento.<br />
#Cada envio é gravado no '''Histórico''' com origem '''Manual'''. No final aparece o resumo com sucessos e erros.<br />
<br />
'''Destinatário usado em cada canal:'''<br />
*'''WhatsApp''': celular do cadastro do cliente; se estiver vazio, usa o telefone; se também estiver vazio, usa o fax. Números brasileiros com 10 ou 11 dígitos sem o 55 recebem o 55 automaticamente;<br />
*'''E-mail''': campo e-mail do cadastro do cliente;<br />
*Cliente sem telefone (ou sem e-mail) simplesmente não recebe por aquele canal. Isso não gera registro de erro no histórico.<br />
<br />
==Anexos, links e XML==<br />
<br />
===O que vai em cada canal===<br />
{| class="wikitable"<br />
|-<br />
!Situação!!E-mail!!WhatsApp uazapi!!WhatsApp API Oficial (Meta)<br />
|-<br />
|Cobrança a Vencer / Vencida com boleto||PDF do boleto anexado||PDF do boleto enviado como documento||Link do boleto no texto<br />
|-<br />
|Cobrança a Vencer / Vencida sem boleto||Só o texto||Só o texto||Só o texto<br />
|-<br />
|Nota Fiscal||PDF da nota + PDF do boleto (se a venda tiver) + '''XML sempre'''||PDF da nota + boleto (se houver) como documentos + XML '''se a opção estiver ligada'''||Links da nota, do boleto (se houver) e do XML ('''se a opção estiver ligada''')<br />
|-<br />
|Demais categorias||Só o texto||Só o texto||Só o texto<br />
|}<br />
<br />
*Na uazapi, a mensagem do template vai como legenda do primeiro documento; os demais documentos vão logo em seguida.<br />
*Na API Oficial, os arquivos são enviados para um armazenamento temporário na nuvem e o link entra no lugar da variável correspondente do template ({LINK_BOLETO}, {LINK_NOTA}/{LINK_NFE}, {LINK_XML}). Se o template não tiver a variável, o sistema acrescenta uma linha no fim da mensagem: "Nota Fiscal: <link>", "Boleto para pagamento: <link>" ou "XML da Nota: <link>".<br />
*A opção do XML no WhatsApp fica em '''Configurações > WhatsApp > "Enviar o XML junto no envio de Nota Fiscal"''' (por loja, desmarcada por padrão). No e-mail o XML vai sempre.<br />
<br />
===De onde vêm o PDF e o XML da nota===<br />
*'''Nota emitida pela API''' (o XML fica gravado no Master Key): o PDF e o XML são gerados pelo próprio Master Key.<br />
*'''Nota emitida pelo Master NF-e''' (NF-e, NFC-e e NFS-e): o Master Key pede o PDF e o XML ao Master NF-e. Para isso:<br />
**o '''Master NF-e precisa estar aberto''' e acessível. O endereço usado é o de '''Parâmetros do Sistema > quadro "Servidor DataSnap Master NF-e (Reimpressão e integração NFC-e)" > IP e Porta''' da loja. Em branco, usa a própria máquina e a porta 211;<br />
**se o Master NF-e estiver fechado, o Master Key tenta abri-lo sozinho, desde que o caminho do executável esteja configurado no Connect.ini do Master Key (seção [NFE], chave PathExe);<br />
**o '''Master NF-e precisa estar atualizado''' na mesma versão do Master Key. Versões antigas não sabem gerar o PDF da NFS-e nem o XML para a Central.<br />
<br />
===Quando o PDF ou o XML falham===<br />
*'''Cobranças – boleto não gerado:''' se o título tem boleto e o PDF não pode ser gerado, a mensagem daquele cliente '''não é enviada''' e o histórico registra o motivo.<br />
*'''Nota Fiscal – PDF da nota não gerado:''' a mensagem daquele cliente '''não é enviada''' e o histórico registra o motivo (ex.: "MasterNFe está fechado", "method not found" quando o Master NF-e está desatualizado). Exceção: no e-mail e no WhatsApp pela API Oficial, se o boleto da venda foi gerado, a mensagem segue só com o boleto. Se apenas o boleto da venda falhar, a mensagem segue sem ele.<br />
*'''XML não gerado:''' a mensagem '''é enviada mesmo assim''', só sem o XML. O motivo fica no arquivo de log (ver "Solução de problemas").<br />
*'''Título sem boleto:''' não é erro; a mensagem vai só com o texto.<br />
<br />
==Configurações==<br />
Aba com quatro sub-abas. As alterações são gravadas pelo botão de gravar da aba; ao trocar de aba com alterações pendentes, o sistema pergunta se deseja salvar.<br />
<br />
===WhatsApp===<br />
<br />
'''Tipo de API'''<br />
<br />
*'''API Oficial (Meta)''' – integração direta com a API oficial do WhatsApp. Não há risco de bloqueio do número. Envia só texto; os arquivos vão como link. Não há validação prévia de número nem consulta de restrição de conta;<br />
*'''API Não Oficial (uazapi)''' – conecta o WhatsApp da loja por QR Code. Envia os arquivos como documento, valida os números antes do envio e mostra a situação da conexão no topo da tela. '''Tem risco de bloqueio do número''' em caso de uso inadequado (envio em massa, spam); por isso a tela exibe o aviso em vermelho.<br />
<br />
'''Campos da API Oficial (Meta)'''<br />
*'''Phone ID''' – identificador do número na conta Meta;<br />
*'''Token''' – token de acesso da conta Meta;<br />
*'''Versão''' – versão da API (padrão v18.0).<br />
<br />
'''Campos da API Não Oficial (uazapi)'''<br />
*'''Servidor''' – endereço do servidor uazapi. Já vem preenchido com o servidor padrão;<br />
*'''Instância''' – nome gerado automaticamente pelo sistema, não editável. O formato é '''MK''' + CNPJ da empresa + '''F''' + código da loja (ex.: MK73766255000133F1).<br />
<br />
'''Botões da uazapi'''<br />
*'''Criar Instância''' – cria a instância no servidor uazapi e grava o token dela na configuração da loja. Exige o '''Admin Token''' da conta uazapi, que não tem campo na tela e precisa ser gravado direto no banco (tabela NOTIF_CONFIG, campo NC_WA_UAZ_ADMTOKEN, na linha da loja). Sem ele o sistema avisa e não cria. Se já existir no servidor uma instância com o mesmo nome, o sistema reaproveita essa instância em vez de criar outra;<br />
*'''Consultar Status''' – consulta na hora se o WhatsApp está conectado;<br />
*'''Conectar (QR Code)''' – mostra o QR Code para ler no celular (WhatsApp > Aparelhos conectados). O QR é renovado a cada 8 segundos até a conexão ser feita. Se já estiver conectado, o sistema avisa;<br />
*'''Desconectar''' – encerra a sessão do WhatsApp na instância (pede confirmação).<br />
<br />
'''Campos comuns'''<br />
*'''Intervalo entre envios (segundos)''' – vale para os dois tipos de API. Padrão: 2 segundos. No envio um por um, a espera real é sorteada entre esse valor e o dobro;<br />
*'''Enviar o XML junto no envio de Nota Fiscal''' – quando marcado, o WhatsApp também leva o XML nas notificações da categoria Nota Fiscal (ver "Anexos, links e XML").<br />
<br />
===E-mail===<br />
*'''Servidor SMTP''', '''Porta''' (padrão 587), '''Criptografia''' (TLS, SSL ou nenhuma; padrão TLS), '''Usuário''', '''Senha''';<br />
*'''Nome exibido''' – nome que aparece como remetente;<br />
*'''E-mail de resposta''' – endereço usado quando o cliente clica em "Responder";<br />
*'''Intervalo entre envios (segundos)''' – espera entre um e-mail e outro. Padrão: 3 segundos.<br />
<br />
O botão '''Testar E-mail''' envia um e-mail de teste para o endereço informado em '''Usuário''', usando os valores que estão na tela no momento (mesmo antes de gravar).<br />
<br />
O texto do e-mail é enviado '''sem formatação''' (ver "Templates").<br />
<br />
===Templates===<br />
Cada categoria tem um template para '''WhatsApp''' e outro para '''E-mail''', separados por loja. O de e-mail tem também o campo '''Assunto''', que aceita as mesmas variáveis da mensagem.<br />
<br />
*A Central já vem com templates padrão para todas as categorias fixas;<br />
*'''Inserir variável''' – escolha a variável no combo e clique em '''Inserir na mensagem''' para colocá-la na posição do cursor;<br />
*'''Prévia da mensagem''' – mostra como a mensagem fica, preenchida com dados de exemplo;<br />
*O editor aceita formatação (negrito, cores etc.), mas '''a mensagem é enviada como texto simples''': a formatação não chega ao cliente. Emojis e quebras de linha são mantidos;<br />
*Se não existir template para a categoria/canal, a mensagem enviada é apenas "<nome do cliente>, olá!" e o assunto do e-mail é o nome da categoria.<br />
<br />
'''Variáveis disponíveis'''<br />
<br />
Todas as categorias aceitam: '''{NOME}''', '''{TELEFONE}''' e '''{EMAIL}'''. Variáveis extras por categoria:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Variáveis extras<br />
|-<br />
|Aniversário||{DATA_NASC}<br />
|-<br />
|Cobrança a Vencer / Vencida||{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}<br />
|-<br />
|Cobrança Paga||{VENCIMENTO} {VALOR} {DOCUMENTO}<br />
|-<br />
|Ordens de Serviço||{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}<br />
|-<br />
|Nota Fiscal||{NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO} {LINK_XML}<br />
|-<br />
|Tipos personalizados||{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC}<br />
|}<br />
<br />
*'''{CHAVE}''' – chave de acesso da nota; na NFS-e é a chave de acesso da nota de serviço;<br />
*'''{LINK_NOTA}''' e '''{LINK_NFE}''' são equivalentes (os dois viram o link do PDF da nota);<br />
*Na Cobrança Paga não existe {LINK_BOLETO}: se for colocada no template, o texto "{LINK_BOLETO}" aparece literal na mensagem.<br />
<br />
'''Sobre as variáveis de link ({LINK_BOLETO}, {LINK_NOTA}, {LINK_NFE}, {LINK_XML})''' – a tela mostra um aviso sobre isso nas categorias que têm links:<br />
*Elas só viram link no '''WhatsApp pela API Oficial (Meta)''';<br />
*No '''e-mail''' e no '''WhatsApp uazapi''' os arquivos vão anexados e a variável é apenas '''apagada''' do texto. Só a variável é apagada, não a frase em volta: um template escrito como "baixe o boleto pelo link: {LINK_BOLETO}" chega como "baixe o boleto pelo link:". Revise os templates pensando no canal que a loja usa;<br />
*Em títulos sem boleto, {LINK_BOLETO} também é apagada.<br />
<br />
===Automático===<br />
*'''Ativar envio automático diário''' – liga/desliga o automático da loja;<br />
*'''Hora do envio''' – horário (HH:MM) a partir do qual o envio do dia pode acontecer;<br />
*'''Canais''' – WhatsApp e/ou E-mail;<br />
*'''Categorias''' – categorias processadas no automático. '''Ordens de Serviço não aparece nesta lista''', porque não tem envio automático; OS só é enviada manualmente.<br />
<br />
Detalhes de funcionamento na seção "Envio automático".<br />
<br />
==Cobrança a Vencer, Vencida e Paga==<br />
Essas três categorias trabalham sobre o contas a receber como um todo. O título entra na lista tendo ou não boleto bancário; o que muda é o que é enviado.<br />
<br />
===Quando o título tem boleto===<br />
O boleto só é gerado e enviado quando:<br />
*o título tem banco informado;<br />
*esse banco tem layout de boleto configurado;<br />
*o banco tem conta corrente cadastrada para a loja do título.<br />
<br />
Títulos convertidos de outro sistema (série '''ANT''') nunca geram boleto.<br />
<br />
Se o sistema não conseguir verificar se o título tem boleto (erro de consulta), a mensagem daquele título '''não é enviada''', para não mandar cobrança sem o boleto por engano. O motivo fica no histórico.<br />
<br />
===Título sem boleto===<br />
A notificação é enviada mesmo assim, só com o texto do template (sem anexo e sem link), em qualquer canal.<br />
<br />
===Boleto acumulado (opção "Acumulativo" na impressão de boletos)===<br />
Quando o boleto foi gerado de forma acumulada – várias notas/parcelas agrupadas em um único boleto, pela tela '''Relatórios > Financeiro > Boletos e Duplicatas > Impressão''', marcando '''Acumulativo por Cliente''' ou '''Acumulativo por Cliente/Vencimento''' – a Central reconhece o agrupamento e:<br />
<br />
*mostra '''uma única linha''' na lista, representando o boleto inteiro;<br />
*exibe como '''Valor''' a soma das contas do grupo (em aberto, nas categorias a Vencer/Vencida; pagas, na Cobrança Paga);<br />
*exibe como '''Documento''' o número do boleto acumulado (ex.: AC00033);<br />
*envia um '''único PDF''', com o valor total e o mesmo nosso número da impressão de Boletos e Duplicatas;<br />
*controla o histórico pelo boleto inteiro, então a baixa de uma das contas do grupo não faz a notificação ser enviada de novo.<br />
<br />
==Envio automático==<br />
<br />
===Quando dispara===<br />
*Cada Master Key aberto verifica '''a cada minuto''' se já passou do horário configurado para a '''loja em que está logado''' e se o automático ainda não rodou hoje nessa loja.<br />
*Com vários computadores abertos, '''só um''' executa o envio do dia; os demais percebem que já foi feito. Resultado: '''uma execução por dia por loja'''.<br />
*É preciso que '''algum Master Key esteja aberto e logado na loja''' depois do horário configurado. Se ninguém abrir o sistema naquela loja no dia, o envio não acontece nesse dia.<br />
*O envio roda em segundo plano, sem travar o sistema e sem nenhuma tela.<br />
*'''Base de cliente aberta dentro da rede da Office''' (ex.: base copiada para análise pelo suporte): o automático '''não dispara''', para não mandar mensagens reais aos clientes daquela empresa.<br />
<br />
===Período processado por categoria===<br />
O sistema guarda o dia da última execução da loja. Na execução seguinte, processa '''desde esse dia''' – normalmente "ontem". Se o automático ficou alguns dias sem rodar (sistema fechado, feriado etc.), ele '''recupera os dias perdidos''' na próxima execução.<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!O que é processado<br />
|-<br />
|Aniversário||Aniversariantes de '''hoje'''<br />
|-<br />
|Cobrança a Vencer||Títulos em aberto que '''vencem hoje''' (o lembrete chega no dia do vencimento)<br />
|-<br />
|Cobrança Vencida||Títulos em aberto que venceram '''desde a última execução até ontem'''<br />
|-<br />
|Cobrança Paga||Títulos pagos '''desde a última execução até hoje'''<br />
|-<br />
|Nota Fiscal||Notas autorizadas emitidas '''desde a última execução até ontem'''<br />
|-<br />
|Tipos personalizados||O que o SQL retornar, com data inicial = dia da última execução e data final = hoje<br />
|-<br />
|Ordens de Serviço||Não tem envio automático<br />
|}<br />
<br />
===Regras do envio automático===<br />
*Categorias não marcadas são ignoradas. Sem nenhum canal marcado, nada é enviado.<br />
*A ordem de processamento é: Aniversário, Cobrança a Vencer, Cobrança Vencida, Cobrança Paga, Nota Fiscal e, por último, os Tipos personalizados.<br />
*'''Um cliente recebe no máximo uma categoria automática por dia.''' Se ele já recebeu com sucesso uma notificação automática de outra categoria no dia, as demais categorias dele são puladas. As mensagens puladas '''não são reenviadas depois pelo automático'''. Se necessário, envie pela aba Notificações.<br />
*Antes de cada envio o sistema '''reconfere''' o registro, porque a lista pode ter sido montada momentos antes: título que foi pago, nota que foi cancelada ou pagamento estornado não recebem a mensagem.<br />
*O que já foi enviado com sucesso nunca é enviado de novo pelo automático.<br />
*Os intervalos entre mensagens são os mesmos do envio manual.<br />
*Nos Tipos personalizados vale o '''Limite de envios''' do cadastro (quantidade máxima de mensagens por execução).<br />
*Tudo o que o automático envia fica no Histórico com origem '''Automático'''.<br />
<br />
==Histórico==<br />
<br />
===Filtros===<br />
*'''Período''' – mesmo combo de atalhos da aba Notificações. Ao abrir, o padrão é '''Últimos 30 dias''';<br />
*'''Tipo''' – Todos, WhatsApp ou E-mail;<br />
*'''Status''' – Todos, Sucesso, Erro ou Reenviado;<br />
*'''Origem''' – Todos, Manual, Automático ou Reenvio;<br />
*'''Categoria''' – mesmas categorias da aba Notificações, inclusive os tipos personalizados ativos;<br />
*'''Cliente''' – busca por parte do nome ou do destino (telefone/e-mail). '''Enter''' no campo já filtra;<br />
*'''Filtrar''' – aplica os filtros. Escolher um atalho de período também filtra na hora.<br />
<br />
Abaixo dos filtros aparece o total de '''falhas pendentes de reenvio''' da loja (todas as datas) e a data da mais antiga, em vermelho quando existe alguma.<br />
<br />
===Grade===<br />
{| class="wikitable"<br />
|-<br />
!Coluna!!Conteúdo<br />
|-<br />
|Data/Hora||Momento do envio (ou do último reenvio, quando o registro foi reenviado)<br />
|-<br />
|Tipo||WhatsApp ou E-mail<br />
|-<br />
|Categoria||Nome da categoria<br />
|-<br />
|Nome / Destino||Cliente e número/e-mail usado<br />
|-<br />
|Status||'''Sucesso''', '''Erro''' ou '''Reenviado''' (ver abaixo)<br />
|-<br />
|Origem||'''Manual''' (aba Notificações), '''Automático''' ou '''Reenvio'''<br />
|-<br />
|Anexos||Arquivos que foram junto: DANFE, DANFS-e, Boleto, XML. Só é preenchido nos envios com sucesso; no WhatsApp pela API Oficial fica vazio, porque lá os arquivos vão como link no texto<br />
|-<br />
|Detalhes||Motivo do erro ou retorno do envio<br />
|}<br />
<br />
*Linhas com '''Erro''' aparecem destacadas.<br />
*'''Duplo clique''' em qualquer linha abre a janela '''Detalhes do envio''', com todos os dados do registro, os detalhes completos e a '''mensagem completa''' que foi enviada. O texto pode ser selecionado e copiado.<br />
<br />
'''Significado do Status'''<br />
*'''Sucesso''' – o envio foi aceito pelo WhatsApp/servidor de e-mail;<br />
*'''Erro''' – o envio falhou; o motivo está em Detalhes;<br />
*'''Reenviado''' – usado em dois casos:<br />
**registros antigos que já foram reenviados;<br />
**falhas que o sistema decidiu '''não''' reenviar. Nesse caso, Detalhes mostra "Não reenviado: título já quitado" (vale também para nota cancelada) ou "Não reenviado: categoria não reconhecida".<br />
<br />
===Reenviar Falhas===<br />
Reenvia, de uma vez, os registros com status '''Erro''':<br />
*considera '''apenas o período e o filtro de Tipo'''. Os filtros de Status, Origem, Categoria e Cliente '''não''' limitam o Reenviar Falhas;<br />
*antes de reenviar, confere se o documento continua válido: título ainda em aberto, nota ainda autorizada, pagamento não estornado. Se não estiver, a falha é marcada como "Não reenviado" e não é enviada;<br />
*gera de novo os anexos (boleto, PDF e XML da nota), porque os arquivos do envio original não existem mais;<br />
*o reenvio '''atualiza o próprio registro''' do erro (data, status, detalhes e anexos) em vez de criar uma linha nova;<br />
*um documento que já tem '''5 ou mais falhas''' no período é considerado falha persistente e é '''ignorado''' pelo Reenviar Falhas (normalmente é problema de cadastro ou de configuração). Esses casos devem ser corrigidos e reenviados um a um pelo '''Reenviar Este''';<br />
*respeita os intervalos entre mensagens e mostra o cartão de progresso com '''Cancelar'''.<br />
<br />
Ao terminar, o resumo mostra só as linhas que aconteceram:<br />
*enviadas com sucesso;<br />
*com erro novamente (motivo na coluna Detalhes);<br />
*não reenviadas porque o título já foi quitado ou o documento cancelado;<br />
*ignoradas por já terem falhado 5 vezes.<br />
<br />
===Reenviar Este===<br />
Reenvia o registro selecionado na grade, '''qualquer que seja o status''':<br />
*'''Registro com Erro:''' o reenvio atualiza o próprio registro, como no Reenviar Falhas;<br />
*'''Registro com Sucesso''' (ou Reenviado): o sistema avisa que será criado um '''novo registro''' no histórico. O registro original fica intacto e o novo aparece com origem '''Reenvio''';<br />
*também confere se o documento ainda é válido e gera os anexos de novo;<br />
*se falhar, a mensagem orienta a ver o motivo na coluna Detalhes.<br />
<br />
==Tipos Personalizados==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > aba '''Tipos Personalizados''' (só aparece para quem tem a permissão 324 – ver "Permissões").<br />
<br />
Permite criar categorias próprias a partir de um SQL. Cada tipo ativo aparece automaticamente na aba Notificações, nos Templates, na lista do Automático e no filtro do Histórico. A lista de categorias é atualizada ao gravar ou excluir um tipo, sem precisar reabrir a tela.<br />
<br />
===Campos do cadastro===<br />
*'''Descrição''' – nome da categoria na tela;<br />
*'''Ativo''' – só tipos ativos aparecem nas listas;<br />
*'''Limite de envios''' – máximo de mensagens por execução do '''automático'''; 0 = sem limite. Não limita o envio manual;<br />
*'''SQL''' – consulta que retorna os destinatários;<br />
*'''Col 1 a Col 4''' – títulos das colunas DETALHE1 a DETALHE4 na lista de envio manual;<br />
*Botão '''Testar SQL''' – executa o SQL com parâmetros de teste e informa se há erro ou se não retornou registros.<br />
<br />
===Colunas que o SQL deve retornar===<br />
*'''CLIENTE_ID''' – código do cliente (usado no histórico e na regra de "uma categoria automática por dia");<br />
*'''NOME''' – nome do destinatário;<br />
*'''FONE''' – número de WhatsApp (sem essa coluna não há envio por WhatsApp);<br />
*'''EMAIL''' – e-mail (sem essa coluna não há envio por e-mail);<br />
*'''REFERENCIA''' – '''número inteiro e único''' por registro. É o que impede o mesmo registro de ser enviado duas vezes. Se vier vazio ou repetido, o controle não funciona: depois do primeiro envio com sucesso, os demais registros com a mesma referência deixam de aparecer.<br />
<br />
Colunas opcionais:<br />
*'''DETALHE1''' a '''DETALHE4''' – informações extras, usadas nas variáveis {DETALHE1}…{DETALHE4} e nas colunas da lista. O '''DETALHE3''' também é usado como '''documento''' do registro no histórico e na variável {REFERENCIA_DOC}.<br />
<br />
===Parâmetros que podem ser usados no SQL===<br />
*''':FILIAL''' – código da loja;<br />
*''':DATA_DE''' ou ''':DE''' – data inicial. No manual é a data inicial da tela; no automático é o dia da última execução;<br />
*''':DATA_ATE''' ou ''':ATE''' – data final. No manual é a data final da tela; no automático é hoje;<br />
*''':REENVIO''' – 'S' ou 'N'. No manual reflete a opção '''Permitir reenvio'''; no automático é sempre 'N'.<br />
<br />
===Validação das variáveis===<br />
Ao gravar o template de um tipo personalizado, o sistema confere se todas as variáveis usadas ({...}) são colunas que o SQL realmente retorna. Se alguma não existir, a gravação é bloqueada e a mensagem lista as colunas disponíveis.<br />
<br />
==Permissões==<br />
{| class="wikitable"<br />
|-<br />
!Permissão!!Efeito<br />
|-<br />
|Item de menu '''Central de Notificações'''||Acesso à tela<br />
|-<br />
|'''Central de Notificações – Tipos Personalizados''' (324)||Mostra a aba Tipos Personalizados. Sem ela, a aba fica oculta<br />
|}<br />
<br />
==Solução de problemas==<br />
<br />
===Onde ver o que aconteceu===<br />
*'''Histórico''' – status e motivo de cada envio; o duplo clique mostra a mensagem completa.<br />
*'''Arquivo de log''' – na pasta do Master Key, em '''Logs\Central Notificacoes\NotifAPI_DDMMAA.log''' (um arquivo por dia). Registra a geração do PDF e do XML das notas (inclusive por que falhou), as respostas da uazapi e o resumo de cada categoria do envio automático (quantos registros, quantos enviados, quantos pulados).<br />
<br />
===Mensagem não chega por WhatsApp===<br />
#Situação no topo da tela / '''Consultar Status''' (uazapi) deve estar '''Conectado'''.<br />
#O canal WhatsApp estava marcado no envio (e, no automático, em Configurações > Automático > Canais).<br />
#O cliente tem celular/telefone no cadastro.<br />
#Se o histórico mostra "Número sem WhatsApp", o número não tem WhatsApp ativo – corrigir o cadastro.<br />
#O template de WhatsApp da categoria está preenchido.<br />
#Envio em fila (uazapi, categorias sem anexo): "aceito" na fila não é garantia de entrega.<br />
#Se o WhatsApp sinalizou restrição da conta, parar os envios em massa por um tempo.<br />
<br />
===Mensagem não chega por e-mail===<br />
#Testar as configurações com '''Testar E-mail'''.<br />
#O cliente tem e-mail no cadastro.<br />
#O template de e-mail da categoria está preenchido.<br />
#Verificar a caixa de spam do cliente.<br />
<br />
===Nota Fiscal não é enviada (erro ao gerar o PDF)===<br />
*"MasterNFe está fechado" – abrir o Master NF-e (ou configurar o caminho dele no Connect.ini para o Master Key abrir sozinho) e conferir IP/Porta do DataSnap nos Parâmetros do Sistema da loja.<br />
*"method not found" / "not found in the server method list" – o Master NF-e aberto é de versão antiga. Atualizar o Master NF-e (e conferir se o executável aberto é o da pasta certa).<br />
*"Error writing data to the connection" – o Master NF-e perdeu a conexão com o banco (ex.: o Firebird foi reiniciado depois que ele foi aberto). Fechar e abrir o Master NF-e.<br />
<br />
===Nota enviada sem o XML===<br />
Ver o arquivo de log do dia (linhas "GerarXMLNFe"). Normalmente é o Master NF-e fechado, desatualizado ou sem acesso. No WhatsApp, conferir também se a opção "Enviar o XML junto no envio de Nota Fiscal" está marcada.<br />
<br />
===Mensagem com frase incompleta ("...pelo link:")===<br />
O template usa uma variável de link e a loja envia por e-mail ou uazapi, onde a variável é apagada. Ajustar o texto do template (ver "Templates").<br />
<br />
===Registro não aparece na lista para envio===<br />
*Já foi enviado com sucesso – marcar '''Permitir reenvio''' ou usar o '''Reenviar Este''' no Histórico.<br />
*É o consumidor padrão da loja.<br />
*Aniversário: cliente inativo, ou já recebeu com sucesso neste ano.<br />
*Cobranças: título já pago, com valor zero ou fora do período.<br />
*Nota Fiscal: nota não autorizada (cancelada, rejeitada etc.).<br />
*OS: é orçamento, ou o status não está marcado em "Status da OS".<br />
<br />
===Envio automático não disparou===<br />
#O automático está ativo na loja (Configurações > Automático).<br />
#O horário configurado já passou.<br />
#Algum Master Key foi aberto e logado '''nessa loja''' depois do horário.<br />
#Ao menos um canal e uma categoria estão marcados.<br />
#Ainda não rodou hoje: o campo NC_AUTO_ULTIMODIA da loja (tabela NOTIF_CONFIG) com a data de hoje indica que já executou.<br />
#Não é uma base de cliente aberta na rede da Office (nesse caso o automático é bloqueado de propósito).<br />
#Conferir no arquivo de log as linhas "Envio automático concluído" de cada categoria.<br />
<br />
===Registro aparece na busca manual mas não foi enviado pelo automático===<br />
*É '''Ordens de Serviço''' – não tem automático.<br />
*O período do automático é diferente do da tela (ver tabela em "Envio automático"). Exemplo: Cobrança a Vencer no automático só pega o que vence '''no dia'''.<br />
*O cliente já tinha recebido outra categoria automática no dia (regra de uma categoria por dia).<br />
*O título foi pago, a nota cancelada ou o pagamento estornado antes do envio.<br />
*Tipos personalizados: o Limite de envios foi atingido.<br />
<br />
===Falha que o Reenviar Falhas não reenvia===<br />
*O documento já falhou 5 ou mais vezes no período – corrigir a causa e usar '''Reenviar Este'''.<br />
*A falha está fora do período ou do Tipo filtrados.<br />
*O título foi quitado / a nota foi cancelada – aparece como "Não reenviado" em Detalhes.<br />
<br />
==Referência de banco de dados==<br />
Tabelas usadas pela Central:<br />
<br />
*'''NOTIF_CONFIG''' – configuração por loja (uma linha por loja, campo NC_FILIAL). Criada automaticamente ao abrir a Central na loja pela primeira vez;<br />
*'''NOTIF_TEMPLATE''' – templates por categoria, tipo (W = WhatsApp, E = E-mail) e loja;<br />
*'''NOTIF_HISTORICO''' – histórico de todos os envios;<br />
*'''NOTIF_TIPO_PERS''' – cadastro dos tipos personalizados.<br />
<br />
Campos úteis de NOTIF_CONFIG:<br />
*NC_WA_TIPO – tipo de API do WhatsApp (O = Oficial/Meta, U = uazapi);<br />
*NC_WA_UAZ_ADMTOKEN – Admin Token da conta uazapi (não tem campo na tela);<br />
*NC_WA_UAZ_TOKEN / NC_WA_UAZ_INSTANCIA – token e nome da instância uazapi;<br />
*NC_WA_ENVIA_XML – envia o XML da nota pelo WhatsApp (S/N);<br />
*NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS – configuração do envio automático;<br />
*NC_AUTO_ULTIMODIA – último dia em que o automático executou na loja.<br />
<br />
Campos úteis de NOTIF_HISTORICO:<br />
*NH_STATUS – S (Sucesso), E (Erro), R (Reenviado);<br />
*NH_ORIGEM – M (Manual), A (Automático), R (Reenvio);<br />
*NH_CATEGORIA – código da categoria (ANIVERSARIO, BOLETO_VENCER, BOLETO_VENCIDO, BOLETO_PAGO, OS_PRONTA para Ordens de Serviço, NFE para Nota Fiscal, PERS_<n> para os tipos personalizados);<br />
*NH_REFERENCIA / NH_REFERENCIA_DOC – documento notificado (título, venda, OS...);<br />
*NH_ERRO – detalhes/motivo;<br />
*NH_ANEXOS – anexos enviados;<br />
*NH_MENSAGEM / NH_ASSUNTO – mensagem e assunto enviados;<br />
*NH_STATUS_ENTREGA – situação de entrega no WhatsApp (uazapi), atualizada ao filtrar o histórico.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2398Conciliação de cartões2026-09-21T12:42:18Z<p>Vitor: /* Tipos de arquivos aceitos para importação */</p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo,''' arquivo CSV.<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41), os arquivos tem as seguintes extensões: .BJR76, BJR06.<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.<br />
*'''Stone''', arquivo no formato CSV, gerado no portal da stone na parte de recebimentos (não é de vendas, é de recebimentos). Para conseguir o arquivo: Recebimentos --> Relatorio --> Lista de Recebimentos --> Continuar --> CSV --> Seleciona o periodo --> Enviar Relatório.<br />
*'''Rede''', suporta três tipos de arquivo posicional/CSV fornecidos pela administradora: - EEVC: arquivo posicional com informações de vendas a crédito (parcelado e rotativo) - EEVD: arquivo CSV com informações de vendas a débito - EEFI: arquivo posicional com informações financeiras (ajustes e débitos bancários)</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Central_de_Notifica%C3%A7%C3%B5es&diff=2389Central de Notificações2026-08-11T17:25:31Z<p>Vitor: /* Cobrança a Vencer, Vencida e Paga */</p>
<hr />
<div>==Central de Notificações==<br />
<br />
==Visão funcional==<br />
A Central de Notificações é o módulo responsável pelo envio de mensagens automáticas e manuais aos clientes via WhatsApp e e-mail. O envio pode ocorrer de duas formas: manualmente pelo operador, selecionando destinatários e disparando na hora, ou automaticamente pelo sistema em horário configurado.<br />
<br />
As categorias de notificação disponíveis são:<br />
<br />
*'''Aniversário''' – clientes que fazem aniversário no período;<br />
*'''Cobrança a Vencer''' – títulos do contas a receber com vencimento próximo, com ou sem boleto bancário gerado;<br />
*'''Cobrança Vencida''' – títulos em atraso, com ou sem boleto;<br />
*'''Cobrança Paga''' – títulos quitados;<br />
*'''OS Pronta''' – ordens de serviço com status de pronta;<br />
*'''NF-e''' – notas fiscais eletrônicas emitidas;<br />
*'''Tipos Personalizados''' – categorias criadas pelo próprio usuário com SQL customizado (ver seção específica).<br />
<br />
<small>'''Categorias de OS que existem mas não aparecem na tela:''' o sistema também tem as categorias '''OS Aberta''', '''OS em Andamento''' e '''OS Faturada''' (códigos <code>OS_ABERTA</code>, <code>OS_ANDAMENTO</code>, <code>OS_FATURADA</code>). Só "OS Pronta" fica visível nos combos de categoria, nos templates e no envio automático da tela; as outras três não aparecem em nenhum desses lugares, mas têm rótulo próprio no filtro de '''Histórico''' — ou seja, elas existem para uso via API/integração de outro módulo, e podem aparecer no Histórico sem que o operador tenha configurado nada na Central de Notificações para elas.</small><br />
<br />
==Abas da tela==<br />
<br />
===Notificações===<br />
Aba principal de consulta e envio manual. O operador filtra por categoria, filial e período, seleciona os destinatários na lista e aciona o envio por WhatsApp, e-mail ou ambos. O sistema exibe progresso em tempo real e permite cancelar o envio em andamento.<br />
<br />
===Configurações===<br />
Aba com quatro sub-abas de configuração:<br />
<br />
*'''WhatsApp''' – tipo de API, credenciais e intervalo entre envios;<br />
*'''E-mail''' – servidor SMTP, porta, criptografia e credenciais;<br />
*'''Templates''' – mensagens por categoria e canal;<br />
*'''Automático''' – ativação, horário e categorias do envio automático.<br />
<br />
===Histórico===<br />
Exibe registros de todos os envios realizados com filtros por período, tipo (WhatsApp/e-mail) e categoria. O filtro de '''status''' tem apenas as opções '''Todos''', '''Sucesso''' e '''Erro'''; "Reenviado" não é uma opção de filtro — é só um rótulo que aparece na grade para envios que foram reenviados. Permite reenvio de falhas diretamente da tela.<br />
<br />
===Tipos Personalizados===<br />
Gerenciamento das categorias customizadas criadas pelo usuário (ver seção específica). A aba só aparece para usuários com permissão de acesso ao módulo correspondente.<br />
<br />
==Configuração do WhatsApp==<br />
<br />
===Tipo de API===<br />
Existem duas opções de integração com WhatsApp:<br />
<br />
*'''API Oficial (Meta)''' – integração direta com a API oficial da Meta. Exige Phone ID, Token de acesso e versão da API (ex.: v18.0). Não apresenta risco de bloqueio do número;<br />
*'''API Não Oficial (uazapi)''' – emulação web do WhatsApp via uazapi. Exige a criação de uma instância e vinculação do celular por QR Code. Apresenta risco de bloqueio do número em caso de uso inadequado (envio em massa, spam).<br />
<br />
===Campos da API Oficial===<br />
'''Onde ficam'''<br />
<br />
Central de Notificações > Configurações > WhatsApp > grupo '''API Oficial Meta'''<br />
<br />
'''Campos'''<br />
<br />
*'''Phone ID''' (NC_WA_PHONEID)<br />
*'''Token''' (NC_WA_TOKEN)<br />
*'''Versão''' (NC_WA_VERSAO)<br />
<br />
===Campos da API Não Oficial (uazapi)===<br />
'''Onde ficam'''<br />
<br />
Central de Notificações > Configurações > WhatsApp > grupo '''API Não Oficial - uazapi'''<br />
<br />
'''Campos'''<br />
<br />
*'''Servidor''' (NC_WA_UAZ_URL) – endereço do servidor uazapi; em branco, usa o servidor padrão do sistema;<br />
*'''Instância''' (NC_WA_UAZ_INSTANCIA) – gerado automaticamente pelo sistema na primeira abertura; não editável pelo usuário;<br />
*'''Token''' (NC_WA_UAZ_TOKEN) – gerado automaticamente pelo botão '''Criar Instância'''; não aparece como campo editável na tela;<br />
*'''Intervalo entre envios (seg.)''' (NC_WA_INTERVALO) – tempo de espera entre cada mensagem enviada. Campo compartilhado pelos dois tipos de API.<br />
<br />
'''Ações disponíveis'''<br />
<br />
*'''Criar Instância''' – registra a instância no servidor uazapi. Exige que o Admin Token da conta uazapi já esteja gravado em '''NOTIF_CONFIG.NC_WA_UAZ_ADMTOKEN''' (não há campo na tela para isso; precisa ser gravado direto no banco);<br />
*'''Consultar Status''' – verifica se o WhatsApp está conectado;<br />
*'''Conectar (QR Code)''' – exibe o QR Code para leitura pelo celular;<br />
*'''Desconectar''' – encerra a sessão do WhatsApp na instância.<br />
<br />
O indicador de status (luz vermelha/verde) é atualizado automaticamente a cada 15 segundos enquanto a tela estiver aberta.<br />
<br />
==Configuração de E-mail==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > E-mail<br />
<br />
'''Campos'''<br />
<br />
*'''Servidor SMTP''' (NC_EMAIL_SMTP)<br />
*'''Porta''' (NC_EMAIL_PORTA)<br />
*'''Criptografia''' (NC_EMAIL_SSL) – opções: TLS, SSL, None<br />
*'''Usuário''' (NC_EMAIL_USUARIO)<br />
*'''Senha''' (NC_EMAIL_SENHA)<br />
*'''Nome exibido''' (NC_EMAIL_NOME)<br />
*'''E-mail de resposta (Reply-To)''' (NC_EMAIL_REPLY)<br />
*'''Intervalo entre envios (seg.)''' (NC_EMAIL_INTERVALO)<br />
<br />
O botão '''Testar E-mail''' envia uma mensagem de teste para o próprio endereço configurado em Usuário.<br />
<br />
==Templates de mensagem==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > Templates<br />
<br />
Cada categoria possui um template separado para WhatsApp e um para E-mail. O template de e-mail inclui campo de assunto. Os templates são salvos por filial.<br />
<br />
===Variáveis disponíveis===<br />
Todas as categorias suportam as variáveis base:<br />
<br />
*'''{NOME}''' – nome do cliente;<br />
*'''{TELEFONE}''' – telefone do destinatário;<br />
*'''{EMAIL}''' – e-mail do destinatário.<br />
<br />
Variáveis adicionais por categoria:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Variáveis extras<br />
|-<br />
|Aniversário||{DATA_NASC}<br />
|-<br />
|Cobrança a Vencer / Vencida||{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}<br />
|-<br />
|Cobrança Paga||{VENCIMENTO} {VALOR} {DOCUMENTO} <small>(sem {LINK_BOLETO} — ver nota abaixo)</small><br />
|-<br />
|OS Pronta||{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}<br />
|-<br />
|NF-e||{NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO}<br />
|-<br />
|Tipos Personalizados||{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC} + campos retornados pelo SQL<br />
|}<br />
<br />
'''Sobre {LINK_BOLETO} e {LINK_NOTA}/{LINK_NFE}:''' esses placeholders só são efetivamente substituídos por um link no canal '''WhatsApp via API Oficial (Meta)'''. Nos demais casos o comportamento é:<br />
<br />
*'''WhatsApp uazapi''': o boleto/nota vai anexado como documento (não como link); o placeholder é removido do texto;<br />
*'''E-mail''': o boleto/nota sempre vai anexado em PDF; o placeholder é removido do texto;<br />
*'''Título sem boleto gerado''' (ver seção "Cobrança a Vencer, Vencida e Paga"): não há link nem anexo; o placeholder também é removido.<br />
<br />
Como o placeholder é apenas removido (não a frase inteira em volta dele), um template escrito como "...você pode baixar o boleto pelo link: {LINK_BOLETO}" fica com a frase incompleta ("...pelo link:") sempre que o link não é usado. Vale revisar os templates de Cobrança pensando nesse caso.<br />
<br />
'''{LINK_BOLETO} não existe para Cobrança Paga:''' diferente de "a Vencer"/"Vencida", a categoria Cobrança Paga não gera link nem anexo — nunca gerou. Se {LINK_BOLETO} for colocado no template dela, o texto <code>{LINK_BOLETO}</code> aparece literal na mensagem, sem ser substituído por nada.<br />
<br />
==Cobrança a Vencer, Vencida e Paga==<br />
Essas três categorias trabalham em cima do contas a receber (CTARECEB) como um todo. Um título entra na lista independentemente de ter ou não boleto bancário gerado; o que muda é o que é enviado.<br />
<br />
===Título sem boleto bancário gerado===<br />
Quando o título não tem banco vinculado, ou o banco não tem layout de boleto (NOTACAPA) e conta corrente (CONTACORR) configurados para a filial, a notificação é enviada mesmo assim:<br />
<br />
*'''E-mail''': enviado sem anexo, só com o texto do template;<br />
*'''WhatsApp''' (uazapi ou Meta): enviado só com o texto, sem link e sem documento anexado.<br />
<br />
===Boleto acumulado (opção "Acumulativo" na impressão de boletos)===<br />
Quando o boleto foi gerado de forma acumulada — várias notas/parcelas agrupadas em um único boleto, pela tela '''Relatórios > Financeiro > Boletos e Duplicatas > Impressão''', marcando '''Acumulativo por Cliente''' ou '''Acumulativo por Cliente/Vencimento''' — a Central de Notificações reconhece o agrupamento automaticamente e:<br />
<br />
*Mostra '''uma única linha''' na listagem, representando o boleto inteiro (não uma linha por conta a receber);<br />
*O '''Valor''' exibido é a soma de todas as contas do grupo (em aberto, para Cobrança a Vencer/Vencida; pagas, para Cobrança Paga);<br />
*O '''Documento''' exibido é o número do boleto acumulado (ex.: <code>AC00033</code>);<br />
*O envio — e-mail ou WhatsApp — leva um '''único PDF''', com o valor total e o mesmo nosso número do boleto que seria impresso pela tela de Boletos e Duplicatas;<br />
*O histórico e o controle de reenvio consideram o boleto acumulado como um todo, então a baixa de uma das contas do grupo não faz a notificação ser enviada de novo por engano.<br />
<br />
==Envio Automático==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > Automático<br />
<br />
O sistema verifica a cada minuto se chegou o horário de envio e, se sim, dispara o processamento em segundo plano sem intervenção do usuário.<br />
<br />
===Campos de configuração===<br />
<br />
*'''Ativo''' (NC_AUTO_ATIVO) – habilita ou desabilita o envio automático da filial;<br />
*'''Hora de envio''' (NC_AUTO_HORA / NC_AUTO_MINUTO) – horário em que o envio deve ocorrer (formato HH:MM);<br />
*'''Canais''' (NC_AUTO_CANAIS) – WhatsApp e/ou E-mail;<br />
*'''Categorias''' (NC_AUTO_CATEGORIAS) – quais categorias devem ser processadas automaticamente.<br />
<br />
'''Atenção: "OS Pronta" aparece marcável nesta lista, mas nunca é enviada pelo automático.''' O checklist de categorias mostra toda categoria visível na tela (inclusive OS Pronta), mas o processamento automático só existe, de fato, para: Aniversário, Cobrança a Vencer, Cobrança Vencida, Cobrança Paga, NF-e e Tipos Personalizados. Marcar "OS Pronta" na aba Automático não tem efeito nenhum — essa categoria só é enviada manualmente, pela aba Notificações.<br />
<br />
===Regra de execução===<br />
<br />
*O sistema só executa uma vez por dia por filial (controla pela data em NC_AUTO_ULTIMODIA);<br />
*Categorias não marcadas são ignoradas;<br />
*Se nenhum canal estiver habilitado, o envio é abortado;<br />
*Boleto acumulado é processado como um único envio, mesmo no automático (ver seção "Cobrança a Vencer, Vencida e Paga").<br />
<br />
'''O período processado NÃO é "dia anterior" para todas as categorias.''' O sistema sempre calcula a data de corte como "ontem" (<code>Date - 1</code>), mas cada categoria usa esse valor de um jeito diferente:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Período efetivamente processado<br />
|-<br />
|Aniversário||Ignora a data de corte: sempre processa aniversariantes de '''hoje'''<br />
|-<br />
|Cobrança a Vencer||De ontem até '''hoje''' (inclui vencimentos do dia)<br />
|-<br />
|Cobrança Vencida||Só '''ontem'''<br />
|-<br />
|Cobrança Paga||De ontem até '''hoje''' (inclui pagamentos do dia)<br />
|-<br />
|NF-e||Só '''ontem'''<br />
|}<br />
<br />
Na prática: um aniversário, uma cobrança a vencer ou um pagamento de '''hoje''' já entra no próximo ciclo automático (mesmo dia seguinte de manhã); só Cobrança Vencida e NF-e realmente esperam até o dia seguinte ao registro.<br />
<br />
==Tipos Personalizados==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > aba '''Tipos Personalizados'''<br />
<br />
Permite criar categorias de notificação próprias, com SQL personalizado definido pelo usuário. Cada tipo personalizado aparece automaticamente nas abas de Notificações (envio manual), Templates e nas categorias do Envio Automático.<br />
<br />
===Campos do cadastro===<br />
<br />
*'''Descrição''' (NP_DESCRICAO) – nome da categoria exibido na interface;<br />
*'''Ativo''' (NP_ATIVO) – somente tipos ativos aparecem nas listas;<br />
*'''Limite de envios''' (NP_LIMIT) – quantidade máxima de registros processados por execução; 0 = sem limite. '''Vale só para o envio automático''' — não restringe disparos manuais pela aba Notificações;<br />
*'''SQL''' (NP_SQL) – consulta SQL que retorna os destinatários;<br />
*'''Col 1 a Col 4''' (NP_COL1_CAPTION a NP_COL4_CAPTION) – rótulos das colunas extras exibidas na listagem de envio manual.<br />
<br />
===Colunas obrigatórias no SQL===<br />
<br />
O SQL deve retornar obrigatoriamente as seguintes colunas:<br />
<br />
*'''CLIENTE_ID''' – código do cliente;<br />
*'''NOME''' – nome do destinatário;<br />
*'''FONE''' – número de WhatsApp;<br />
*'''EMAIL''' – endereço de e-mail;<br />
*'''REFERENCIA''' – identificador único do registro (usado para controle de reenvio).<br />
<br />
Colunas opcionais que alimentam os placeholders do template:<br />
<br />
*'''DETALHE1''' a '''DETALHE4''' – informações extras usadas via {DETALHE1}…{DETALHE4};<br />
*'''REFERENCIA_DOC''' – número de documento para exibição no histórico.<br />
<br />
===Parâmetros disponíveis no SQL===<br />
<br />
*''':FILIAL''' – código da filial atual;<br />
*''':DATA_DE''' ou ''':DE''' – data de início do período;<br />
*''':DATA_ATE''' ou ''':ATE''' – data de fim do período;<br />
*''':REENVIO''' – <code>'S'</code> ou <code>'N'</code>. No envio manual reflete a opção "Permitir reenvio" marcada na tela; no envio automático vem sempre <code>'N'</code>. Útil para o SQL decidir se deve ou não repetir registros já enviados.<br />
<br />
===Regra de controle de reenvio===<br />
<br />
O sistema filtra automaticamente registros que já foram enviados com sucesso, comparando REFERENCIA e categoria na tabela NOTIF_HISTORICO. Assim, o mesmo registro não é enviado duas vezes no automático nem no manual (quando a opção de reenvio não está marcada).<br />
<br />
===Validação de placeholders===<br />
<br />
Ao salvar o template de um tipo personalizado, o sistema valida se todas as variáveis usadas no texto ({...}) são campos efetivamente retornados pelo SQL cadastrado. Se um placeholder não existir no SQL, a gravação é bloqueada com mensagem indicando os campos disponíveis.<br />
<br />
==Permissões==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Módulo!!Descrição<br />
|-<br />
|'''Central de Notificações – Tipos Personalizados''' (324)||Habilita a aba de Tipos Personalizados na Central de Notificações. Sem esta permissão, a aba fica oculta.<br />
|}<br />
<br />
==Comportamentos importantes==<br />
<br />
===Mensagem não chega por WhatsApp===<br />
Conferir, nesta ordem:<br />
<br />
1. Se a instância está conectada (botão '''Consultar Status''' deve mostrar "Conectado").<br />
<br />
2. Se o número do cliente possui WhatsApp ativo – o sistema valida antes do envio.<br />
<br />
3. Se o template de WhatsApp da categoria está preenchido.<br />
<br />
4. Se o canal WhatsApp está habilitado nos canais selecionados no momento do envio.<br />
<br />
===Mensagem não chega por e-mail===<br />
Conferir:<br />
<br />
1. Configurações de SMTP (servidor, porta, criptografia, usuário e senha) usando o botão '''Testar E-mail'''.<br />
<br />
2. Se o cliente possui e-mail cadastrado.<br />
<br />
3. Se o template de e-mail da categoria está preenchido.<br />
<br />
===Tipo personalizado não aparece nas categorias===<br />
Conferir:<br />
<br />
1. Se o campo '''Ativo''' do tipo personalizado está marcado.<br />
<br />
2. Se o SQL está salvo corretamente (sem erros de sintaxe).<br />
<br />
A lista de categorias é recarregada automaticamente ao gravar ou excluir um tipo personalizado — não é preciso fechar e reabrir a tela.<br />
<br />
===Envio automático não disparou===<br />
Conferir, nesta ordem:<br />
<br />
1. Se NC_AUTO_ATIVO = 'S' para a filial.<br />
<br />
2. Se o horário configurado já passou no dia corrente.<br />
<br />
3. Se NC_AUTO_ULTIMODIA já está preenchido com a data de hoje (indica que já executou).<br />
<br />
4. Se ao menos um canal (WA ou e-mail) está marcado.<br />
<br />
5. Se ao menos uma categoria está marcada.<br />
<br />
===Registro aparece na consulta mas não é enviado no automático===<br />
Duas causas possíveis:<br />
<br />
*'''A categoria é "OS Pronta"''': essa categoria não é processada pelo envio automático, mesmo aparecendo marcável na aba Automático (ver seção "Envio Automático");<br />
*'''O registro é muito recente''': cada categoria de Cobrança/NF-e/Aniversário tem sua própria regra de corte por data — ver a tabela em "Envio Automático" para saber exatamente quando cada uma passa a ser processada. Isso é intencional, para evitar inconsistência no controle de execução diária.<br />
<br />
==Atualização de banco (estrutura criada pelo módulo)==<br />
<br />
Tabelas criadas:<br />
<br />
*'''NOTIF_CONFIG''' – configuração de WhatsApp e e-mail por filial;<br />
*'''NOTIF_TEMPLATE''' – templates de mensagem por categoria, tipo e filial;<br />
*'''NOTIF_HISTORICO''' – histórico de todos os envios realizados;<br />
*'''NOTIF_TIPO_PERS''' – cadastro dos tipos de notificação personalizados.<br />
<br />
Campos relevantes de NOTIF_CONFIG:<br />
<br />
*NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS, NC_AUTO_ULTIMODIA – controle do envio automático.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Central_de_Notifica%C3%A7%C3%B5es&diff=2388Central de Notificações2026-08-11T17:21:27Z<p>Vitor: </p>
<hr />
<div>==Central de Notificações==<br />
<br />
==Visão funcional==<br />
A Central de Notificações é o módulo responsável pelo envio de mensagens automáticas e manuais aos clientes via WhatsApp e e-mail. O envio pode ocorrer de duas formas: manualmente pelo operador, selecionando destinatários e disparando na hora, ou automaticamente pelo sistema em horário configurado.<br />
<br />
As categorias de notificação disponíveis são:<br />
<br />
*'''Aniversário''' – clientes que fazem aniversário no período;<br />
*'''Cobrança a Vencer''' – títulos do contas a receber com vencimento próximo, com ou sem boleto bancário gerado;<br />
*'''Cobrança Vencida''' – títulos em atraso, com ou sem boleto;<br />
*'''Cobrança Paga''' – títulos quitados;<br />
*'''OS Pronta''' – ordens de serviço com status de pronta;<br />
*'''NF-e''' – notas fiscais eletrônicas emitidas;<br />
*'''Tipos Personalizados''' – categorias criadas pelo próprio usuário com SQL customizado (ver seção específica).<br />
<br />
<small>'''Categorias de OS que existem mas não aparecem na tela:''' o sistema também tem as categorias '''OS Aberta''', '''OS em Andamento''' e '''OS Faturada''' (códigos <code>OS_ABERTA</code>, <code>OS_ANDAMENTO</code>, <code>OS_FATURADA</code>). Só "OS Pronta" fica visível nos combos de categoria, nos templates e no envio automático da tela; as outras três não aparecem em nenhum desses lugares, mas têm rótulo próprio no filtro de '''Histórico''' — ou seja, elas existem para uso via API/integração de outro módulo, e podem aparecer no Histórico sem que o operador tenha configurado nada na Central de Notificações para elas.</small><br />
<br />
<small>'''Nota (versão 4.05.006):''' as categorias "Cobrança a Vencer", "Cobrança Vencida" e "Cobrança Paga" chamavam-se "Boleto a Vencer", "Boleto Vencido" e "Boleto Pago". O nome mudou porque, a partir desta versão, elas passaram a cobrir qualquer título do contas a receber — mesmo os que nunca tiveram boleto bancário gerado, cliente que usa só o contas a receber do sistema. Os códigos internos de categoria (gravados em NOTIF_HISTORICO, NOTIF_TEMPLATE e NC_AUTO_CATEGORIAS) continuam BOLETO_VENCER, BOLETO_VENCIDO e BOLETO_PAGO — só o rótulo exibido mudou, então nada quebra em bases já configuradas.</small><br />
<br />
==Abas da tela==<br />
<br />
===Notificações===<br />
Aba principal de consulta e envio manual. O operador filtra por categoria, filial e período, seleciona os destinatários na lista e aciona o envio por WhatsApp, e-mail ou ambos. O sistema exibe progresso em tempo real e permite cancelar o envio em andamento.<br />
<br />
===Configurações===<br />
Aba com quatro sub-abas de configuração:<br />
<br />
*'''WhatsApp''' – tipo de API, credenciais e intervalo entre envios;<br />
*'''E-mail''' – servidor SMTP, porta, criptografia e credenciais;<br />
*'''Templates''' – mensagens por categoria e canal;<br />
*'''Automático''' – ativação, horário e categorias do envio automático.<br />
<br />
===Histórico===<br />
Exibe registros de todos os envios realizados com filtros por período, tipo (WhatsApp/e-mail) e categoria. O filtro de '''status''' tem apenas as opções '''Todos''', '''Sucesso''' e '''Erro'''; "Reenviado" não é uma opção de filtro — é só um rótulo que aparece na grade para envios que foram reenviados. Permite reenvio de falhas diretamente da tela.<br />
<br />
===Tipos Personalizados===<br />
Gerenciamento das categorias customizadas criadas pelo usuário (ver seção específica). A aba só aparece para usuários com permissão de acesso ao módulo correspondente.<br />
<br />
==Configuração do WhatsApp==<br />
<br />
===Tipo de API===<br />
Existem duas opções de integração com WhatsApp:<br />
<br />
*'''API Oficial (Meta)''' – integração direta com a API oficial da Meta. Exige Phone ID, Token de acesso e versão da API (ex.: v18.0). Não apresenta risco de bloqueio do número;<br />
*'''API Não Oficial (uazapi)''' – emulação web do WhatsApp via uazapi. Exige a criação de uma instância e vinculação do celular por QR Code. Apresenta risco de bloqueio do número em caso de uso inadequado (envio em massa, spam).<br />
<br />
===Campos da API Oficial===<br />
'''Onde ficam'''<br />
<br />
Central de Notificações > Configurações > WhatsApp > grupo '''API Oficial Meta'''<br />
<br />
'''Campos'''<br />
<br />
*'''Phone ID''' (NC_WA_PHONEID)<br />
*'''Token''' (NC_WA_TOKEN)<br />
*'''Versão''' (NC_WA_VERSAO)<br />
<br />
===Campos da API Não Oficial (uazapi)===<br />
'''Onde ficam'''<br />
<br />
Central de Notificações > Configurações > WhatsApp > grupo '''API Não Oficial - uazapi'''<br />
<br />
'''Campos'''<br />
<br />
*'''Servidor''' (NC_WA_UAZ_URL) – endereço do servidor uazapi; em branco, usa o servidor padrão do sistema;<br />
*'''Instância''' (NC_WA_UAZ_INSTANCIA) – gerado automaticamente pelo sistema na primeira abertura; não editável pelo usuário;<br />
*'''Token''' (NC_WA_UAZ_TOKEN) – gerado automaticamente pelo botão '''Criar Instância'''; não aparece como campo editável na tela;<br />
*'''Intervalo entre envios (seg.)''' (NC_WA_INTERVALO) – tempo de espera entre cada mensagem enviada. Campo compartilhado pelos dois tipos de API.<br />
<br />
'''Ações disponíveis'''<br />
<br />
*'''Criar Instância''' – registra a instância no servidor uazapi. Exige que o Admin Token da conta uazapi já esteja gravado em '''NOTIF_CONFIG.NC_WA_UAZ_ADMTOKEN''' (não há campo na tela para isso; precisa ser gravado direto no banco);<br />
*'''Consultar Status''' – verifica se o WhatsApp está conectado;<br />
*'''Conectar (QR Code)''' – exibe o QR Code para leitura pelo celular;<br />
*'''Desconectar''' – encerra a sessão do WhatsApp na instância.<br />
<br />
O indicador de status (luz vermelha/verde) é atualizado automaticamente a cada 15 segundos enquanto a tela estiver aberta.<br />
<br />
==Configuração de E-mail==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > E-mail<br />
<br />
'''Campos'''<br />
<br />
*'''Servidor SMTP''' (NC_EMAIL_SMTP)<br />
*'''Porta''' (NC_EMAIL_PORTA)<br />
*'''Criptografia''' (NC_EMAIL_SSL) – opções: TLS, SSL, None<br />
*'''Usuário''' (NC_EMAIL_USUARIO)<br />
*'''Senha''' (NC_EMAIL_SENHA)<br />
*'''Nome exibido''' (NC_EMAIL_NOME)<br />
*'''E-mail de resposta (Reply-To)''' (NC_EMAIL_REPLY)<br />
*'''Intervalo entre envios (seg.)''' (NC_EMAIL_INTERVALO)<br />
<br />
O botão '''Testar E-mail''' envia uma mensagem de teste para o próprio endereço configurado em Usuário.<br />
<br />
==Templates de mensagem==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > Templates<br />
<br />
Cada categoria possui um template separado para WhatsApp e um para E-mail. O template de e-mail inclui campo de assunto. Os templates são salvos por filial.<br />
<br />
===Variáveis disponíveis===<br />
Todas as categorias suportam as variáveis base:<br />
<br />
*'''{NOME}''' – nome do cliente;<br />
*'''{TELEFONE}''' – telefone do destinatário;<br />
*'''{EMAIL}''' – e-mail do destinatário.<br />
<br />
Variáveis adicionais por categoria:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Variáveis extras<br />
|-<br />
|Aniversário||{DATA_NASC}<br />
|-<br />
|Cobrança a Vencer / Vencida||{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}<br />
|-<br />
|Cobrança Paga||{VENCIMENTO} {VALOR} {DOCUMENTO} <small>(sem {LINK_BOLETO} — ver nota abaixo)</small><br />
|-<br />
|OS Pronta||{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}<br />
|-<br />
|NF-e||{NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO}<br />
|-<br />
|Tipos Personalizados||{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC} + campos retornados pelo SQL<br />
|}<br />
<br />
'''Sobre {LINK_BOLETO} e {LINK_NOTA}/{LINK_NFE}:''' esses placeholders só são efetivamente substituídos por um link no canal '''WhatsApp via API Oficial (Meta)'''. Nos demais casos o comportamento é:<br />
<br />
*'''WhatsApp uazapi''': o boleto/nota vai anexado como documento (não como link); o placeholder é removido do texto;<br />
*'''E-mail''': o boleto/nota sempre vai anexado em PDF; o placeholder é removido do texto;<br />
*'''Título sem boleto gerado''' (ver seção "Cobrança a Vencer, Vencida e Paga"): não há link nem anexo; o placeholder também é removido.<br />
<br />
Como o placeholder é apenas removido (não a frase inteira em volta dele), um template escrito como "...você pode baixar o boleto pelo link: {LINK_BOLETO}" fica com a frase incompleta ("...pelo link:") sempre que o link não é usado. Vale revisar os templates de Cobrança pensando nesse caso.<br />
<br />
'''{LINK_BOLETO} não existe para Cobrança Paga:''' diferente de "a Vencer"/"Vencida", a categoria Cobrança Paga não gera link nem anexo — nunca gerou. Se {LINK_BOLETO} for colocado no template dela, o texto <code>{LINK_BOLETO}</code> aparece literal na mensagem, sem ser substituído por nada.<br />
<br />
==Cobrança a Vencer, Vencida e Paga==<br />
<small>Seção nova (4.05.006) — antes essas categorias trabalhavam apenas com contas a receber que já tinham boleto bancário gerado.</small><br />
<br />
Essas três categorias trabalham em cima do contas a receber (CTARECEB) como um todo. Um título entra na lista independentemente de ter ou não boleto bancário gerado; o que muda é o que é enviado.<br />
<br />
===Título sem boleto bancário gerado===<br />
Quando o título não tem banco vinculado, ou o banco não tem layout de boleto (NOTACAPA) e conta corrente (CONTACORR) configurados para a filial, a notificação é enviada mesmo assim:<br />
<br />
*'''E-mail''': enviado sem anexo, só com o texto do template;<br />
*'''WhatsApp''' (uazapi ou Meta): enviado só com o texto, sem link e sem documento anexado.<br />
<br />
Antes desta versão, esses títulos não eram notificados: o sistema tentava gerar o PDF do boleto, falhava e abortava o envio com o erro "Falha ao gerar o anexo (PDF)".<br />
<br />
===Boleto acumulado (opção "Acumulativo" na impressão de boletos)===<br />
Quando o boleto foi gerado de forma acumulada — várias notas/parcelas agrupadas em um único boleto, pela tela '''Relatórios > Financeiro > Boletos e Duplicatas > Impressão''', marcando '''Acumulativo por Cliente''' ou '''Acumulativo por Cliente/Vencimento''' — a Central de Notificações reconhece o agrupamento automaticamente e:<br />
<br />
*Mostra '''uma única linha''' na listagem, representando o boleto inteiro (não uma linha por conta a receber);<br />
*O '''Valor''' exibido é a soma de todas as contas do grupo (em aberto, para Cobrança a Vencer/Vencida; pagas, para Cobrança Paga);<br />
*O '''Documento''' exibido é o número do boleto acumulado (ex.: <code>AC00033</code>);<br />
*O envio — e-mail ou WhatsApp — leva um '''único PDF''', com o valor total e o mesmo nosso número do boleto que seria impresso pela tela de Boletos e Duplicatas;<br />
*O histórico e o controle de reenvio consideram o boleto acumulado como um todo, então a baixa de uma das contas do grupo não faz a notificação ser enviada de novo por engano.<br />
<br />
Antes desta versão, cada conta do grupo aparecia como uma linha separada e cada envio gerava um PDF individual com o mesmo "nosso número" mas o valor de apenas uma conta — o cliente podia receber vários boletos parecidos, todos referentes ao mesmo boleto real, com valores diferentes.<br />
<br />
===Parcelas de uma mesma venda===<br />
Quando uma venda tem várias parcelas (um título por parcela), a notificação de cada parcela leva '''apenas o boleto daquela parcela'''. Antes desta versão, o PDF anexado trazia todas as parcelas da venda juntas, mesmo quando a notificação era de uma parcela específica.<br />
<br />
==Envio Automático==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > Configurações > Automático<br />
<br />
O sistema verifica a cada minuto se chegou o horário de envio e, se sim, dispara o processamento em segundo plano sem intervenção do usuário.<br />
<br />
===Campos de configuração===<br />
<br />
*'''Ativo''' (NC_AUTO_ATIVO) – habilita ou desabilita o envio automático da filial;<br />
*'''Hora de envio''' (NC_AUTO_HORA / NC_AUTO_MINUTO) – horário em que o envio deve ocorrer (formato HH:MM);<br />
*'''Canais''' (NC_AUTO_CANAIS) – WhatsApp e/ou E-mail;<br />
*'''Categorias''' (NC_AUTO_CATEGORIAS) – quais categorias devem ser processadas automaticamente.<br />
<br />
'''Atenção: "OS Pronta" aparece marcável nesta lista, mas nunca é enviada pelo automático.''' O checklist de categorias mostra toda categoria visível na tela (inclusive OS Pronta), mas o processamento automático só existe, de fato, para: Aniversário, Cobrança a Vencer, Cobrança Vencida, Cobrança Paga, NF-e e Tipos Personalizados. Marcar "OS Pronta" na aba Automático não tem efeito nenhum — essa categoria só é enviada manualmente, pela aba Notificações.<br />
<br />
===Regra de execução===<br />
<br />
*O sistema só executa uma vez por dia por filial (controla pela data em NC_AUTO_ULTIMODIA);<br />
*Categorias não marcadas são ignoradas;<br />
*Se nenhum canal estiver habilitado, o envio é abortado;<br />
*Boleto acumulado é processado como um único envio, mesmo no automático (ver seção "Cobrança a Vencer, Vencida e Paga").<br />
<br />
'''O período processado NÃO é "dia anterior" para todas as categorias.''' O sistema sempre calcula a data de corte como "ontem" (<code>Date - 1</code>), mas cada categoria usa esse valor de um jeito diferente:<br />
<br />
{| class="wikitable"<br />
|-<br />
!Categoria!!Período efetivamente processado<br />
|-<br />
|Aniversário||Ignora a data de corte: sempre processa aniversariantes de '''hoje'''<br />
|-<br />
|Cobrança a Vencer||De ontem até '''hoje''' (inclui vencimentos do dia)<br />
|-<br />
|Cobrança Vencida||Só '''ontem'''<br />
|-<br />
|Cobrança Paga||De ontem até '''hoje''' (inclui pagamentos do dia)<br />
|-<br />
|NF-e||Só '''ontem'''<br />
|}<br />
<br />
Na prática: um aniversário, uma cobrança a vencer ou um pagamento de '''hoje''' já entra no próximo ciclo automático (mesmo dia seguinte de manhã); só Cobrança Vencida e NF-e realmente esperam até o dia seguinte ao registro.<br />
<br />
==Tipos Personalizados==<br />
<br />
'''Onde fica'''<br />
<br />
Central de Notificações > aba '''Tipos Personalizados'''<br />
<br />
Permite criar categorias de notificação próprias, com SQL personalizado definido pelo usuário. Cada tipo personalizado aparece automaticamente nas abas de Notificações (envio manual), Templates e nas categorias do Envio Automático.<br />
<br />
===Campos do cadastro===<br />
<br />
*'''Descrição''' (NP_DESCRICAO) – nome da categoria exibido na interface;<br />
*'''Ativo''' (NP_ATIVO) – somente tipos ativos aparecem nas listas;<br />
*'''Limite de envios''' (NP_LIMIT) – quantidade máxima de registros processados por execução; 0 = sem limite. '''Vale só para o envio automático''' — não restringe disparos manuais pela aba Notificações;<br />
*'''SQL''' (NP_SQL) – consulta SQL que retorna os destinatários;<br />
*'''Col 1 a Col 4''' (NP_COL1_CAPTION a NP_COL4_CAPTION) – rótulos das colunas extras exibidas na listagem de envio manual.<br />
<br />
===Colunas obrigatórias no SQL===<br />
<br />
O SQL deve retornar obrigatoriamente as seguintes colunas:<br />
<br />
*'''CLIENTE_ID''' – código do cliente;<br />
*'''NOME''' – nome do destinatário;<br />
*'''FONE''' – número de WhatsApp;<br />
*'''EMAIL''' – endereço de e-mail;<br />
*'''REFERENCIA''' – identificador único do registro (usado para controle de reenvio).<br />
<br />
Colunas opcionais que alimentam os placeholders do template:<br />
<br />
*'''DETALHE1''' a '''DETALHE4''' – informações extras usadas via {DETALHE1}…{DETALHE4};<br />
*'''REFERENCIA_DOC''' – número de documento para exibição no histórico.<br />
<br />
===Parâmetros disponíveis no SQL===<br />
<br />
*''':FILIAL''' – código da filial atual;<br />
*''':DATA_DE''' ou ''':DE''' – data de início do período;<br />
*''':DATA_ATE''' ou ''':ATE''' – data de fim do período;<br />
*''':REENVIO''' – <code>'S'</code> ou <code>'N'</code>. No envio manual reflete a opção "Permitir reenvio" marcada na tela; no envio automático vem sempre <code>'N'</code>. Útil para o SQL decidir se deve ou não repetir registros já enviados.<br />
<br />
===Regra de controle de reenvio===<br />
<br />
O sistema filtra automaticamente registros que já foram enviados com sucesso, comparando REFERENCIA e categoria na tabela NOTIF_HISTORICO. Assim, o mesmo registro não é enviado duas vezes no automático nem no manual (quando a opção de reenvio não está marcada).<br />
<br />
===Validação de placeholders===<br />
<br />
Ao salvar o template de um tipo personalizado, o sistema valida se todas as variáveis usadas no texto ({...}) são campos efetivamente retornados pelo SQL cadastrado. Se um placeholder não existir no SQL, a gravação é bloqueada com mensagem indicando os campos disponíveis.<br />
<br />
==Permissões==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Módulo!!Descrição<br />
|-<br />
|'''Central de Notificações – Tipos Personalizados''' (324)||Habilita a aba de Tipos Personalizados na Central de Notificações. Sem esta permissão, a aba fica oculta.<br />
|}<br />
<br />
==Comportamentos importantes==<br />
<br />
===Mensagem não chega por WhatsApp===<br />
Conferir, nesta ordem:<br />
<br />
1. Se a instância está conectada (botão '''Consultar Status''' deve mostrar "Conectado").<br />
<br />
2. Se o número do cliente possui WhatsApp ativo – o sistema valida antes do envio.<br />
<br />
3. Se o template de WhatsApp da categoria está preenchido.<br />
<br />
4. Se o canal WhatsApp está habilitado nos canais selecionados no momento do envio.<br />
<br />
===Erro "Invalid payload" ao enviar documento por WhatsApp (uazapi) — corrigido na 4.05.006===<br />
Até a versão 4.05.005, qualquer envio de documento (boleto, DANFE) pelo canal WhatsApp uazapi falhava com <code>400 Invalid payload</code>. A causa era o texto em base64 do arquivo ser gerado com quebras de linha a cada 76 caracteres (padrão MIME do Delphi), o que invalidava o JSON enviado à API. O envio de texto puro não era afetado, por isso mensagens sem anexo sempre funcionaram. Corrigido na 4.05.006: o base64 passou a ser gerado sem quebra de linha. Se o erro voltar a aparecer, o log em <code>Logs\Central Notificacoes\NotifAPI_ddmmyy.log</code> registra o payload enviado (sem o conteúdo do base64) na linha seguinte ao erro.<br />
<br />
===Mensagem não chega por e-mail===<br />
Conferir:<br />
<br />
1. Configurações de SMTP (servidor, porta, criptografia, usuário e senha) usando o botão '''Testar E-mail'''.<br />
<br />
2. Se o cliente possui e-mail cadastrado.<br />
<br />
3. Se o template de e-mail da categoria está preenchido.<br />
<br />
===Tipo personalizado não aparece nas categorias===<br />
Conferir:<br />
<br />
1. Se o campo '''Ativo''' do tipo personalizado está marcado.<br />
<br />
2. Se o SQL está salvo corretamente (sem erros de sintaxe).<br />
<br />
A lista de categorias é recarregada automaticamente ao gravar ou excluir um tipo personalizado — não é preciso fechar e reabrir a tela.<br />
<br />
===Envio automático não disparou===<br />
Conferir, nesta ordem:<br />
<br />
1. Se NC_AUTO_ATIVO = 'S' para a filial.<br />
<br />
2. Se o horário configurado já passou no dia corrente.<br />
<br />
3. Se NC_AUTO_ULTIMODIA já está preenchido com a data de hoje (indica que já executou).<br />
<br />
4. Se ao menos um canal (WA ou e-mail) está marcado.<br />
<br />
5. Se ao menos uma categoria está marcada.<br />
<br />
===Registro aparece na consulta mas não é enviado no automático===<br />
Duas causas possíveis:<br />
<br />
*'''A categoria é "OS Pronta"''': essa categoria não é processada pelo envio automático, mesmo aparecendo marcável na aba Automático (ver seção "Envio Automático");<br />
*'''O registro é muito recente''': cada categoria de Cobrança/NF-e/Aniversário tem sua própria regra de corte por data — ver a tabela em "Envio Automático" para saber exatamente quando cada uma passa a ser processada. Isso é intencional, para evitar inconsistência no controle de execução diária.<br />
<br />
==Atualização de banco (estrutura criada pelo módulo)==<br />
<br />
Tabelas criadas:<br />
<br />
*'''NOTIF_CONFIG''' – configuração de WhatsApp e e-mail por filial;<br />
*'''NOTIF_TEMPLATE''' – templates de mensagem por categoria, tipo e filial;<br />
*'''NOTIF_HISTORICO''' – histórico de todos os envios realizados;<br />
*'''NOTIF_TIPO_PERS''' – cadastro dos tipos de notificação personalizados.<br />
<br />
Campos relevantes de NOTIF_CONFIG:<br />
<br />
*NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS, NC_AUTO_ULTIMODIA – controle do envio automático.<br />
<br />
'''Nota (4.05.006):''' os códigos de categoria gravados em NOTIF_HISTORICO.NH_CATEGORIA, NOTIF_TEMPLATE.NT_CATEGORIA e NC_AUTO_CATEGORIAS continuam <code>BOLETO_VENCER</code>, <code>BOLETO_VENCIDO</code> e <code>BOLETO_PAGO</code> — não foram renomeados junto com o rótulo exibido na tela, para não exigir migração em bases já configuradas. Ao atualizar para a 4.05.006, o assunto padrão dos templates de e-mail dessas categorias é atualizado automaticamente de "Boleto ..." para "Cobrança ..."; templates cujo assunto o cliente já tinha personalizado não são alterados.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Firebird_5&diff=2366Firebird 52026-05-21T19:58:36Z<p>Vitor: /* Firebird 5 — Informações e Migração */</p>
<hr />
<div>==Firebird 5 — Informações e Migração==<br />
<br />
Esta página reúne todas as informações relevantes sobre o Firebird 5 e o processo de migração dos sistemas Office System.<br />
<br />
===Visão Geral===<br />
<br />
O Firebird é o banco de dados utilizado por todos os sistemas Office System. A versão 5.0 traz melhorias significativas de desempenho, segurança e compatibilidade em relação à versão 2.5 anteriormente utilizada.<br />
<br />
{| class="wikitable"<br />
!'''Informação'''<br />
!'''Detalhe'''<br />
|-<br />
|'''Versão'''<br />
|5.0.3<br />
|-<br />
|'''Arquitetura do servidor'''<br />
|64 bits<br />
|-<br />
|'''Arquitetura da DLL (fbclient)'''<br />
|32 bits (aplicações Office System são 32 bits)<br />
|-<br />
|'''Porta de conexão'''<br />
|44680<br />
|-<br />
|'''Banco de segurança'''<br />
|security5.fdb<br />
|-<br />
|'''Serviço Windows'''<br />
|FB50Office<br />
|}<br />
<br />
==Tipos de Servidor==<br />
<br />
O Firebird 5 pode ser instalado em três modos de operação. O modo é definido no momento da instalação e pode ser verificado no arquivo '''firebird.conf''' na pasta de instalação do Firebird.<br />
<br />
<br /><br />
<br />
=== Classic (Recomendado) ===<br />
<br />
*'''Um processo separado''' para cada conexão ativa<br />
*Cada conexão tem seu '''próprio cache''' — maior consumo de memória<br />
*Mais indicado para '''poucas conexões com consultas pesadas'''<br />
*Se uma conexão travar, as demais '''continuam normalmente'''<br />
*Permite acesso local (embedded) ao mesmo banco<br />
*'''Configuração:''' <code>ServerMode = Classic</code><br />
<br />
===Super Server ===<br />
<br />
*'''Um único processo''' para o servidor inteiro<br />
*'''Cache de páginas compartilhado''' entre todas as conexões — menor consumo de memória<br />
*Usa '''threads''' para atender cada conexão simultaneamente<br />
*Melhor opção para ambientes com '''muitas conexões simultâneas'''<br />
*Se o processo travar, todas as conexões são encerradas<br />
*'''Configuração:''' <code>ServerMode = Super</code><br />
<br />
===Super Classic===<br />
<br />
*'''Um único processo''', assim como o Super Server<br />
*Cada conexão tem seu '''próprio cache''', assim como o Classic<br />
*Consumo de memória intermediário entre os dois modos acima<br />
*Permite acesso local (embedded) ao mesmo banco<br />
*'''Configuração:''' <code>ServerMode = SuperClassic</code><br />
<br />
{| class="wikitable"<br />
!'''Característica'''<br />
!'''Super Server'''<br />
!'''Classic'''<br />
!'''Super Classic'''<br />
|-<br />
|Processos<br />
|1<br />
|1 por conexão<br />
|1<br />
|-<br />
|Cache de páginas<br />
|Compartilhado<br />
|Por conexão<br />
|Por conexão<br />
|-<br />
|Uso de memória<br />
|Baixo<br />
|Alto<br />
|Médio<br />
|-<br />
|Isolamento de falha por conexão<br />
|Não<br />
|Sim<br />
|Parcial<br />
|-<br />
|Acesso embedded (local)<br />
|Não<br />
|Sim<br />
|Sim<br />
|}<br />
<br />
==Processo de Migração==<br />
<br />
A migração consiste em converter os bancos de dados do formato ODS (On-Disk Structure) do Firebird 2.5 para o formato do Firebird 5. Esse processo é '''obrigatório,''' bancos no formato antigo '''não funcionam''' no Firebird 5. Existem duas formas de realizar a migração:<br />
<br />
===Forma 1: Via Updater (Automática)===<br />
O Updater dos sistemas Office System realiza todo o processo automaticamente:<br />
<br />
#Atualiza os sistemas para a versão mais recente<br />
#Cria automaticamente um '''ZIP de backup''' dos bancos de dados originais de cada sistema antes de converter<br />
#Converte os bancos para o formato do Firebird 5<br />
#Instala e configura o Firebird 5<br />
<br />
'''Importante:''' O Updater '''sempre tentará migrar para o FB5''' ao ser executado. Caso o cliente precise permanecer no FB2.5, consulte a seção [[#Manter cliente no Firebird 2.5|Manter cliente no Firebird 2.5]].<br />
<br />
===Forma 2: Via BAT Manual===<br />
Indicada para casos em que os sistemas já foram atualizados, mas a migração dos bancos ainda não foi feita.<br />
<br />
#Baixe o arquivo '''[https://files.officesystem.com.br/atualizacoes/migracao-fb5/MigrarParaFB5.bat MigrarParaFB5.bat]'''<br />
#Crie uma pasta em qualquer local da máquina<br />
#Coloque '''todos os bancos de dados''' que o cliente utiliza dentro dessa pasta<br />
#Coloque o '''MigrarParaFB5.bat''' junto com os bancos na mesma pasta<br />
#Execute o BA. Ele irá processar todos os bancos automaticamente<br />
#Os bancos convertidos serão gerados na subpasta '''Convertidos_FB5'''<br />
#Substitua os bancos originais pelos bancos da pasta '''Convertidos_FB5'''<br />
<br />
'''⚠ Atenção:''' Sempre salve uma cópia separada dos bancos originais antes de realizar a conversão. O Updater já faz isso automaticamente, mas na migração manual essa responsabilidade é do técnico.<br />
<br />
==fbclient.dll — Biblioteca do Cliente==<br />
<br />
A fbclient.dll é a biblioteca responsável pela comunicação entre as aplicações e o servidor Firebird. Como o servidor instalado é '''64 bits''', mas as aplicações Office System são '''32 bits''', é obrigatório utilizar a versão '''32 bits''' da fbclient.<br />
<br />
*A fbclient correta normalmente já vem incluída no pacote de atualização dos sistemas<br />
*Caso não tenha vindo no pacote, faça o download em: [https://files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll]<br />
*Após baixar, '''renomeie o arquivo''' de <code>fbclient50.dll</code> para <code>fbclient.dll</code><br />
*Coloque o arquivo dentro da '''pasta do sistema''' (onde fica o executável da aplicação)<br />
<br />
'''Como verificar se a fbclient instalada está correta:'''<br />
<br />
Passe o cursor do mouse sobre o arquivo <code>fbclient.dll</code> na pasta do sistema e verifique:<br />
<br />
*A versão deve ser '''5.0.3'''<br />
*Deve ser '''32 bits'''<br />
<br />
Em caso de qualquer erro de acesso aos sistemas, '''sempre verifique a fbclient primeiro'''.<br />
<br />
==Firebird 2.5 e Firebird 5 Simultâneos==<br />
<br />
O Firebird 2.5 e o Firebird 5 utilizam a '''mesma porta de conexão (44680)''', portanto '''não é possível manter os dois serviços rodando ao mesmo tempo'''.<br />
<br />
*É possível ter os dois instalados na mesma máquina sem problemas<br />
*Porém apenas '''um serviço deve estar ativo por vez'''<br />
*Para alternar entre eles, pare o serviço ativo e inicie o desejado pelo '''Gerenciador de Serviços do Windows''' (<code>services.msc</code>)<br />
<br />
{| class="wikitable"<br />
!<br />
!'''Firebird 2.5'''<br />
!'''Firebird 5.0'''<br />
|-<br />
|Nome do serviço<br />
|FB25Office<br />
|FB50Office<br />
|-<br />
|Porta<br />
|44680<br />
|44680<br />
|-<br />
|Banco de segurança<br />
|security2.fdb<br />
|security5.fdb<br />
|}<br />
<br />
==Manter Cliente no Firebird 2.5==<br />
<br />
As versões atuais dos sistemas Office System ainda são compatíveis com o Firebird 2.5. Em breve será implementada uma '''trava''' que exigirá o Firebird 5.0 obrigatoriamente.<br />
<br />
Caso seja necessário manter um cliente no Firebird 2.5 por ora:<br />
<br />
*'''Não utilize o Updater''' para atualizar os sistemas, pois ele tentará migrar para o FB5 automaticamente<br />
*Realize as atualizações dos sistemas '''manualmente'''<br />
*Fique atento às comunicações sobre a data de entrada em vigor da trava obrigatória do FB5<br />
<br />
==Erros Comuns e Soluções==<br />
<br />
===<big>DBX Error: Driver could not be properly initialized</big>===<br />
<br />
'''Mensagem completa:'''<br />
<br />
<code>DBX Error: Driver could not be properly initialized. Client library may be missing, not installed properly, of the wrong version, or the driver may be missing from the system path.</code><br />
<br />
'''Causa:''' Pacotes redistribuíveis do Visual C++ ausentes ou desatualizados no Windows.<br />
<br />
'''Solução:''' Baixe e instale os dois arquivos abaixo na máquina do cliente:<br />
<br />
*[https://aka.ms/vc14/vc_redist.x64.exe vc_redist.x64.exe] — Visual C++ Redistributable 64 bits<br />
*[https://aka.ms/vc14/vc_redist.x86.exe vc_redist.x86.exe] — Visual C++ Redistributable 32 bits<br />
<br />
Após instalar os dois teste novamente.<br />
<br />
'''Obs.:''' O Updater já instala esses pacotes automaticamente durante a migração.<br />
<br />
===<big>Erros genéricos de acesso ao sistema</big>===<br />
<br />
Em qualquer erro de acesso ou conexão aos sistemas após a migração, siga este checklist antes de escalar:<br />
<br />
#Verifique se o serviço '''FB50Office''' está em execução no <code>services.msc</code><br />
#Confirme que o serviço '''FB25Office''' está '''parado''' (conflito de porta)<br />
#Verifique a '''fbclient.dll''' na pasta do sistema — deve ser versão '''5.0.3, 32 bits'''<br />
#Confirme que os bancos de dados foram '''convertidos para o FB5''' (se estiverem no formato antigo, não abrirão)<br />
#Verifique se os pacotes '''vc_redist.x64''' e '''vc_redist.x86''' estão instalados<br />
<br />
==Downloads==<br />
<br />
Todos os arquivos relacionados à migração estão disponíveis em:<br />
<br />
*'''Página de downloads:''' [https://files.officesystem.com.br/atualizacoes/migracao-fb5 files.officesystem.com.br/atualizacoes/migracao-fb5]</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Firebird_5&diff=2365Firebird 52026-05-21T19:52:34Z<p>Vitor: </p>
<hr />
<div>==Firebird 5 — Informações e Migração==<br />
<br />
Esta página reúne todas as informações relevantes sobre o Firebird 5 e o processo de migração dos sistemas Office System, destinada ao time de suporte.<br />
<br />
===Visão Geral===<br />
<br />
O Firebird é o banco de dados utilizado por todos os sistemas Office System. A versão 5.0 traz melhorias significativas de desempenho, segurança e compatibilidade em relação à versão 2.5 anteriormente utilizada.<br />
<br />
{| class="wikitable"<br />
!'''Informação'''<br />
!'''Detalhe'''<br />
|-<br />
|'''Versão'''<br />
|5.0.3<br />
|-<br />
|'''Arquitetura do servidor'''<br />
|64 bits<br />
|-<br />
|'''Arquitetura da DLL (fbclient)'''<br />
|32 bits (aplicações Office System são 32 bits)<br />
|-<br />
|'''Porta de conexão'''<br />
|44680<br />
|-<br />
|'''Banco de segurança'''<br />
|security5.fdb<br />
|-<br />
|'''Serviço Windows'''<br />
|FB50Office<br />
|}<br />
<br />
==Tipos de Servidor==<br />
<br />
O Firebird 5 pode ser instalado em três modos de operação. O modo é definido no momento da instalação e pode ser verificado no arquivo '''firebird.conf''' na pasta de instalação do Firebird.<br />
<br />
===Super Server (Recomendado)===<br />
*'''Um único processo''' para o servidor inteiro<br />
*'''Cache de páginas compartilhado''' entre todas as conexões — menor consumo de memória<br />
*Usa '''threads''' para atender cada conexão simultaneamente<br />
*Melhor opção para ambientes com '''muitas conexões simultâneas'''<br />
*Se o processo travar, todas as conexões são encerradas<br />
*'''Configuração:''' <code>ServerMode = Super</code><br />
<br />
===Classic===<br />
*'''Um processo separado''' para cada conexão ativa<br />
*Cada conexão tem seu '''próprio cache''' — maior consumo de memória<br />
*Mais indicado para '''poucas conexões com consultas pesadas'''<br />
*Se uma conexão travar, as demais '''continuam normalmente'''<br />
*Permite acesso local (embedded) ao mesmo banco<br />
*'''Configuração:''' <code>ServerMode = Classic</code><br />
<br />
===Super Classic===<br />
*'''Um único processo''', assim como o Super Server<br />
*Cada conexão tem seu '''próprio cache''', assim como o Classic<br />
*Consumo de memória intermediário entre os dois modos acima<br />
*Permite acesso local (embedded) ao mesmo banco<br />
*'''Configuração:''' <code>ServerMode = SuperClassic</code><br />
<br />
{| class="wikitable"<br />
!'''Característica'''<br />
!'''Super Server'''<br />
!'''Classic'''<br />
!'''Super Classic'''<br />
|-<br />
|Processos<br />
|1<br />
|1 por conexão<br />
|1<br />
|-<br />
|Cache de páginas<br />
|Compartilhado<br />
|Por conexão<br />
|Por conexão<br />
|-<br />
|Uso de memória<br />
|Baixo<br />
|Alto<br />
|Médio<br />
|-<br />
|Isolamento de falha por conexão<br />
|Não<br />
|Sim<br />
|Parcial<br />
|-<br />
|Acesso embedded (local)<br />
|Não<br />
|Sim<br />
|Sim<br />
|}<br />
<br />
==Processo de Migração==<br />
<br />
A migração consiste em converter os bancos de dados do formato ODS (On-Disk Structure) do Firebird 2.5 para o formato do Firebird 5. Esse processo é '''obrigatório''' — bancos no formato antigo '''não funcionam''' no Firebird 5. Existem duas formas de realizar a migração:<br />
<br />
===Forma 1: Via Updater (Automática)===<br />
O Updater dos sistemas Office System realiza todo o processo automaticamente:<br />
<br />
#Atualiza os sistemas para a versão mais recente<br />
#Cria automaticamente um '''ZIP de backup''' dos bancos de dados originais de cada sistema antes de converter<br />
#Converte os bancos para o formato do Firebird 5<br />
#Instala e configura o Firebird 5<br />
<br />
'''Importante:''' O Updater '''sempre tentará migrar para o FB5''' ao ser executado. Caso o cliente precise permanecer no FB2.5, consulte a seção [[#Manter cliente no Firebird 2.5|Manter cliente no Firebird 2.5]].<br />
<br />
===Forma 2: Via BAT Manual===<br />
Indicada para casos em que os sistemas já foram atualizados, mas a migração dos bancos ainda não foi feita.<br />
<br />
#Baixe o arquivo '''[https://files.officesystem.com.br/atualizacoes/migracao-fb5/MigrarParaFB5.bat MigrarParaFB5.bat]'''<br />
#Crie uma pasta em qualquer local da máquina<br />
#Coloque '''todos os bancos de dados''' que o cliente utiliza dentro dessa pasta<br />
#Coloque o '''MigrarParaFB5.bat''' junto com os bancos na mesma pasta<br />
#Execute o BAT — ele irá processar todos os bancos automaticamente<br />
#Os bancos convertidos serão gerados na subpasta '''Convertidos_FB5'''<br />
#Substitua os bancos originais pelos bancos da pasta '''Convertidos_FB5'''<br />
<br />
'''⚠ Atenção:''' Sempre salve uma cópia separada dos bancos originais antes de realizar a conversão. O Updater já faz isso automaticamente, mas na migração manual essa responsabilidade é do técnico.<br />
<br />
==fbclient.dll — Biblioteca do Cliente==<br />
<br />
A fbclient.dll é a biblioteca responsável pela comunicação entre as aplicações e o servidor Firebird. Como o servidor instalado é '''64 bits''', mas as aplicações Office System são '''32 bits''', é obrigatório utilizar a versão '''32 bits''' da fbclient.<br />
<br />
*A fbclient correta normalmente já vem incluída no pacote de atualização dos sistemas<br />
*Caso não tenha vindo no pacote, faça o download em: [https://files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll]<br />
*Após baixar, '''renomeie o arquivo''' de <code>fbclient50.dll</code> para <code>fbclient.dll</code><br />
*Coloque o arquivo dentro da '''pasta do sistema''' (onde fica o executável da aplicação)<br />
<br />
'''Como verificar se a fbclient instalada está correta:'''<br />
<br />
Passe o cursor do mouse sobre o arquivo <code>fbclient.dll</code> na pasta do sistema e verifique:<br />
*A versão deve ser '''5.0.3'''<br />
*Deve ser '''32 bits'''<br />
<br />
Em caso de qualquer erro de acesso aos sistemas, '''sempre verifique a fbclient primeiro'''.<br />
<br />
==Firebird 2.5 e Firebird 5 Simultâneos==<br />
<br />
O Firebird 2.5 e o Firebird 5 utilizam a '''mesma porta de conexão (44680)''', portanto '''não é possível manter os dois serviços rodando ao mesmo tempo'''.<br />
<br />
*É possível ter os dois instalados na mesma máquina sem problemas<br />
*Porém apenas '''um serviço deve estar ativo por vez'''<br />
*Para alternar entre eles, pare o serviço ativo e inicie o desejado pelo '''Gerenciador de Serviços do Windows''' (<code>services.msc</code>)<br />
<br />
{| class="wikitable"<br />
!<br />
!'''Firebird 2.5'''<br />
!'''Firebird 5.0'''<br />
|-<br />
|Nome do serviço<br />
|FB25Office<br />
|FB50Office<br />
|-<br />
|Porta<br />
|44680<br />
|44680<br />
|-<br />
|Banco de segurança<br />
|security2.fdb<br />
|security5.fdb<br />
|}<br />
<br />
==Manter Cliente no Firebird 2.5==<br />
<br />
As versões atuais dos sistemas Office System ainda são compatíveis com o Firebird 2.5. Em breve será implementada uma '''trava''' que exigirá o Firebird 5.0 obrigatoriamente.<br />
<br />
Caso seja necessário manter um cliente no Firebird 2.5 por ora:<br />
<br />
*'''Não utilize o Updater''' para atualizar os sistemas, pois ele tentará migrar para o FB5 automaticamente<br />
*Realize as atualizações dos sistemas '''manualmente'''<br />
*Fique atento às comunicações sobre a data de entrada em vigor da trava obrigatória do FB5<br />
<br />
==Erros Comuns e Soluções==<br />
<br />
===<big>DBX Error: Driver could not be properly initialized</big>===<br />
<br />
'''Mensagem completa:'''<br />
<br />
<code>DBX Error: Driver could not be properly initialized. Client library may be missing, not installed properly, of the wrong version, or the driver may be missing from the system path.</code><br />
<br />
'''Causa:''' Pacotes redistribuíveis do Visual C++ ausentes ou desatualizados no Windows.<br />
<br />
'''Solução:''' Baixe e instale os dois arquivos abaixo na máquina do cliente:<br />
<br />
*[https://aka.ms/vc14/vc_redist.x64.exe vc_redist.x64.exe] — Visual C++ Redistributable 64 bits<br />
*[https://aka.ms/vc14/vc_redist.x86.exe vc_redist.x86.exe] — Visual C++ Redistributable 32 bits<br />
<br />
Após instalar os dois, reinicie a máquina e teste novamente.<br />
<br />
'''Obs.:''' O Updater já instala esses pacotes automaticamente durante a migração.<br />
<br />
===<big>Erros genéricos de acesso ao sistema</big>===<br />
<br />
Em qualquer erro de acesso ou conexão aos sistemas após a migração, siga este checklist antes de escalar:<br />
<br />
#Verifique se o serviço '''FB50Office''' está em execução no <code>services.msc</code><br />
#Confirme que o serviço '''FB25Office''' está '''parado''' (conflito de porta)<br />
#Verifique a '''fbclient.dll''' na pasta do sistema — deve ser versão '''5.0.3, 32 bits'''<br />
#Confirme que os bancos de dados foram '''convertidos para o FB5''' (se estiverem no formato antigo, não abrirão)<br />
#Verifique se os pacotes '''vc_redist.x64''' e '''vc_redist.x86''' estão instalados<br />
<br />
==Downloads==<br />
<br />
Todos os arquivos relacionados à migração estão disponíveis em:<br />
<br />
*'''Página de downloads:''' [https://files.officesystem.com.br/atualizacoes/migracao-fb5 files.officesystem.com.br/atualizacoes/migracao-fb5]<br />
<br />
Arquivos disponíveis:<br />
<br />
*[https://files.officesystem.com.br/atualizacoes/migracao-fb5/fbclient50.dll fbclient50.dll] — fbclient 32 bits para FB5 (renomear para fbclient.dll)<br />
*[https://files.officesystem.com.br/atualizacoes/migracao-fb5/MigrarParaFB5.bat MigrarParaFB5.bat] — BAT para conversão manual dos bancos</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Firebird_5&diff=2364Firebird 52026-05-21T19:30:50Z<p>Vitor: Criou página com 'Teste'</p>
<hr />
<div>Teste</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=P%C3%A1gina_principal&diff=2363Página principal2026-05-21T19:30:34Z<p>Vitor: /* Manuais */</p>
<hr />
<div>==MasterKey==<br />
<br />
*[[Menu Movimentações Master Key|Movimentações]]<br />
*[[Financeiro]]<br />
*[[Cadastros Master Key|Cadastros]]<br />
*[[Relatórios]]<br />
*[[Utilitários]]<br />
*[[Configurações Master Key|Configurações / Utilitários]]<br />
**<small>[[Impressoras]]</small><br />
*[[Instalação Atualização|Instalação / Atualização]]<br />
*[[Erros Comuns e Soluções|Erros]]<br />
*[[Bandeiras]]<br />
<br />
==MasterKey PDV==<br />
<br />
*[[PDV]]<br />
*[[PAF ECF]]<br />
*<small>[[Configurações MKPDV|Configurações]]</small><br />
*[[MFE]]<br />
*[[LMC]]<br />
*[[Smart TEF]]<br />
*[[NFCe por API]]<br />
*[[Erros MKPDV|Erros]]<br />
*[[Auto Atendimento]]<br />
<br />
==Master NFe==<br />
<br />
*[[Nota Fiscal]]<br />
*[[Configurações E-mails|Configurações de E-mail]]<br />
*<small>[[Erros Master Nfe|Erros]]</small><br />
<br />
==Integrações==<br />
<br />
*[[Omie|Integra Omie]]<br />
*[[Integra Scanntech]]<br />
*[[Integração Best Way]]<br />
*[[Integração Sites|Integração Sites/eCommerce]]<br />
*[[Integração Scanntech]]<br />
*[[Integração Master Conciliador]]<br />
*[[Integração Mercado (IFood Groceries)|Integração IFood Mercado]]<br />
*[[Integração DOOCA]]<br />
*[[Integração Tray]]<br />
*[[Mercado Livre]]<br />
*[[MK Shops]]<br />
*[[Delivery|Delivery MKFood]]<br />
<br />
==Outros==<br />
<br />
*[[Updater]]<br />
*[[Master MDFe]]<br />
*[[Master CTe]]<br />
*[[Sincroniza]]<br />
*[[SincronizaDBSync|Sincroniza DBSync(NOVO)]]<br />
*[[Etiqueta]]<br />
*[[MK Mobile]]<br />
*[[MK Food]]<br />
*[[MK Backup]]<br />
*[[MKI]]<br />
*[[MKTC]]<br />
*[[MK Analytics]]<br />
*[[SiTef|Sitef]]<br />
*[[Sitef Express Parceiros|Sitef Express Parceiros(NOVO)]]<br />
*[[TI Entrego]]<br />
*[[MGV6]]<br />
*[[BALANÇA E BUSCA PREÇO|Balança e Busca Preço]]<br />
*[[Portal do Contador]]<br />
*[[Imobiliário]]<br />
*[[SEFAZ]]<br />
<br />
==Manuais==<br />
<br />
*[[Manuais do sistema]]<br />
*[[Firebird 5]]<br />
<br />
==Instaladores e Atualizações==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Software!!Instalador!!Atualização<br />
|-<br />
|Master Key||[https://files.officesystem.com.br/instaladores/SetupMK.exe https://files.officesystem.com.br/SetupMK.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MK4.zip<br />
|-<br />
|MKPDV|| ||https://files.officesystem.com.br/atualizacoes/MKPDV.zip<br />
|-<br />
|Master Key + Master NFe||[https://files.officesystem.com.br/instaladores/SetupMKNFe.exe https://files.officesystem.com.br/SetupMKNFe.exe]<nowiki/><nowiki/>||<br />
|-<br />
|Master Nfe||[https://files.officesystem.com.br/instaladores/SetupNFe.exe https://files.officesystem.com.br/SetupNFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterNFe.zip<br />
|-<br />
|Master CT-e||[https://files.officesystem.com.br/instaladores/SetupCTe.exe https://files.officesystem.com.br/SetupCTe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterCTe.zip<br />
|-<br />
|Master MDF-e||[https://files.officesystem.com.br/instaladores/SetupMDFe.exe https://files.officesystem.com.br/SetupMDFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterMDFe.zip<br />
|-<br />
|Master Frota||[https://files.officesystem.com.br/instaladores/SetupFrota.exe https://files.officesystem.com.br/SetupFrota.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MKF.zip<br />
|-<br />
|MKI|| ||https://files.officesystem.com.br/atualizacoes/MKI.zip<br />
|-<br />
|Mobile||Https://files.officesystem.com.br/instaladores/SetupMKMobile.exe <nowiki/>||<br />
|-<br />
|MKTC<br />
|[https://files.officesystem.com.br/atualizacoes/MKTC.zip https://files.officesystem.com.br/atualizacoes/M]<nowiki/>[https://files.officesystem.com.br/atualizacoes/MKTC.zip KTC.zip]<br />
|<br />
|-<br />
|Portal do Contador<br />
|[https://files.officesystem.com.br/instaladores/SetupOfficeSystemService.exe https://files.officesystem.com.br/SetupOfficeSystemService.exe]<br />
|<br />
|-<br />
|MK + NFE+OMIE<br />
|[https://files.officesystem.com.br/instaladores/SetupMKNFeOmie.exe https://files.officesystem.com.br/SetupMKNFeOmie.exe]<br />
|<br />
|-<br />
|LINK<br />
|https://files.officesystem.com.br/instaladores/<br />
|<br />
|}<br />
<br />
==Contribuidores Mais Ativos==<br />
{{Special:ContributionScores/10/365}}</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=P%C3%A1gina_principal&diff=2362Página principal2026-05-21T19:30:18Z<p>Vitor: </p>
<hr />
<div>==MasterKey==<br />
<br />
*[[Menu Movimentações Master Key|Movimentações]]<br />
*[[Financeiro]]<br />
*[[Cadastros Master Key|Cadastros]]<br />
*[[Relatórios]]<br />
*[[Utilitários]]<br />
*[[Configurações Master Key|Configurações / Utilitários]]<br />
**<small>[[Impressoras]]</small><br />
*[[Instalação Atualização|Instalação / Atualização]]<br />
*[[Erros Comuns e Soluções|Erros]]<br />
*[[Bandeiras]]<br />
<br />
==MasterKey PDV==<br />
<br />
*[[PDV]]<br />
*[[PAF ECF]]<br />
*<small>[[Configurações MKPDV|Configurações]]</small><br />
*[[MFE]]<br />
*[[LMC]]<br />
*[[Smart TEF]]<br />
*[[NFCe por API]]<br />
*[[Erros MKPDV|Erros]]<br />
*[[Auto Atendimento]]<br />
<br />
==Master NFe==<br />
<br />
*[[Nota Fiscal]]<br />
*[[Configurações E-mails|Configurações de E-mail]]<br />
*<small>[[Erros Master Nfe|Erros]]</small><br />
<br />
==Integrações==<br />
<br />
*[[Omie|Integra Omie]]<br />
*[[Integra Scanntech]]<br />
*[[Integração Best Way]]<br />
*[[Integração Sites|Integração Sites/eCommerce]]<br />
*[[Integração Scanntech]]<br />
*[[Integração Master Conciliador]]<br />
*[[Integração Mercado (IFood Groceries)|Integração IFood Mercado]]<br />
*[[Integração DOOCA]]<br />
*[[Integração Tray]]<br />
*[[Mercado Livre]]<br />
*[[MK Shops]]<br />
*[[Delivery|Delivery MKFood]]<br />
<br />
==Outros==<br />
<br />
*[[Updater]]<br />
*[[Master MDFe]]<br />
*[[Master CTe]]<br />
*[[Sincroniza]]<br />
*[[SincronizaDBSync|Sincroniza DBSync(NOVO)]]<br />
*[[Etiqueta]]<br />
*[[MK Mobile]]<br />
*[[MK Food]]<br />
*[[MK Backup]]<br />
*[[MKI]]<br />
*[[MKTC]]<br />
*[[MK Analytics]]<br />
*[[SiTef|Sitef]]<br />
*[[Sitef Express Parceiros|Sitef Express Parceiros(NOVO)]]<br />
*[[TI Entrego]]<br />
*[[MGV6]]<br />
*[[BALANÇA E BUSCA PREÇO|Balança e Busca Preço]]<br />
*[[Portal do Contador]]<br />
*[[Imobiliário]]<br />
*[[SEFAZ]]<br />
<br />
==Manuais==<br />
<br />
*[[Manuais do sistema]]<br />
*Firebird 5<br />
<br />
==Instaladores e Atualizações==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Software!!Instalador!!Atualização<br />
|-<br />
|Master Key||[https://files.officesystem.com.br/instaladores/SetupMK.exe https://files.officesystem.com.br/SetupMK.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MK4.zip<br />
|-<br />
|MKPDV|| ||https://files.officesystem.com.br/atualizacoes/MKPDV.zip<br />
|-<br />
|Master Key + Master NFe||[https://files.officesystem.com.br/instaladores/SetupMKNFe.exe https://files.officesystem.com.br/SetupMKNFe.exe]<nowiki/><nowiki/>||<br />
|-<br />
|Master Nfe||[https://files.officesystem.com.br/instaladores/SetupNFe.exe https://files.officesystem.com.br/SetupNFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterNFe.zip<br />
|-<br />
|Master CT-e||[https://files.officesystem.com.br/instaladores/SetupCTe.exe https://files.officesystem.com.br/SetupCTe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterCTe.zip<br />
|-<br />
|Master MDF-e||[https://files.officesystem.com.br/instaladores/SetupMDFe.exe https://files.officesystem.com.br/SetupMDFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterMDFe.zip<br />
|-<br />
|Master Frota||[https://files.officesystem.com.br/instaladores/SetupFrota.exe https://files.officesystem.com.br/SetupFrota.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MKF.zip<br />
|-<br />
|MKI|| ||https://files.officesystem.com.br/atualizacoes/MKI.zip<br />
|-<br />
|Mobile||Https://files.officesystem.com.br/instaladores/SetupMKMobile.exe <nowiki/>||<br />
|-<br />
|MKTC<br />
|[https://files.officesystem.com.br/atualizacoes/MKTC.zip https://files.officesystem.com.br/atualizacoes/M]<nowiki/>[https://files.officesystem.com.br/atualizacoes/MKTC.zip KTC.zip]<br />
|<br />
|-<br />
|Portal do Contador<br />
|[https://files.officesystem.com.br/instaladores/SetupOfficeSystemService.exe https://files.officesystem.com.br/SetupOfficeSystemService.exe]<br />
|<br />
|-<br />
|MK + NFE+OMIE<br />
|[https://files.officesystem.com.br/instaladores/SetupMKNFeOmie.exe https://files.officesystem.com.br/SetupMKNFeOmie.exe]<br />
|<br />
|-<br />
|LINK<br />
|https://files.officesystem.com.br/instaladores/<br />
|<br />
|}<br />
<br />
==Contribuidores Mais Ativos==<br />
{{Special:ContributionScores/10/365}}</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2358Conciliação de cartões2026-05-14T20:05:29Z<p>Vitor: </p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41), os arquivos tem as seguintes extensões: .BJR76, BJR06.<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.<br />
*'''Stone''', arquivo no formato CSV, gerado no portal da stone na parte de recebimentos (não é de vendas, é de recebimentos). Para conseguir o arquivo: Recebimentos --> Relatorio --> Lista de Recebimentos --> Continuar --> CSV --> Seleciona o periodo --> Enviar Relatório.<br />
*'''Rede''', suporta três tipos de arquivo posicional/CSV fornecidos pela administradora: - EEVC: arquivo posicional com informações de vendas a crédito (parcelado e rotativo) - EEVD: arquivo CSV com informações de vendas a débito - EEFI: arquivo posicional com informações financeiras (ajustes e débitos bancários)</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2356Auto Atendimento2026-04-30T20:00:46Z<p>Vitor: /* Módulo administrativo do Autoatendimento (nome oficial) */</p>
<hr />
<div>==PDV Autoatendimento==<br />
<br />
==Visão funcional==<br />
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:<br />
<br />
*seleção de itens;<br />
*conferência de peso (quando aplicável);<br />
*escolha de forma de pagamento;<br />
*finalização da venda.<br />
<br />
Além do fluxo do cliente, existe o módulo administrativo interno chamado '''Área Restrita''' (do Autoatendimento), usado para ações de administração, como configuração de balança e liberações conforme permissão.<br />
<br />
==Marquinhas e parâmetros obrigatórios==<br />
<br />
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar PDV Autoatendimento''' (US_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = usuário entra no PDV em modo Autoatendimento.<br />
*Desmarcado = usuário segue no PDV normal.<br />
<br />
===2) Marquinha do Usuário para Balança===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = Autoatendimento usa leitura da balança para conferência.<br />
*Desmarcado = fluxo sem conferência por balança.<br />
<br />
===3) Marquinha do Tipo de Pagamento===<br />
'''Onde fica'''<br />
<br />
Cadastro de Tipos de Pagamento > aba '''PDV'''<br />
<br />
'''Campo'''<br />
<br />
*'''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Só aparece no Autoatendimento se esta marquinha estiver marcada.<br />
*Além disso, o tipo também precisa estar ativo e com atalho preenchido.<br />
*Tipos sem atalho não entram na listagem do Autoatendimento.<br />
<br />
===4) Marquinha de Peso Variável (produto/subgrupo)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Subgrupos de Produtos<br />
<br />
'''Campo'''<br />
<br />
*'''Peso variável''' (SG_PESOVARIAVEL)<br />
<br />
'''Regra'''<br />
<br />
*Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.<br />
*Subgrupo não marcado segue como item comum (sem conferência de peso variável).<br />
<br />
===5) Parâmetros de Peso do Autoatendimento===<br />
'''Onde fica'''<br />
<br />
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''<br />
<br />
'''Campos'''<br />
<br />
*'''Verificação''' (AUTOATEND_VERIF_PESO)<br />
**Item por Item (I)<br />
**Final (F)<br />
*'''Margem toler. (%)''' (AUTOATEND_MARGEM)<br />
<br />
'''Regra'''<br />
<br />
*Define como e quando o peso será validado.<br />
*A margem é percentual inteiro (ex.: 5 = 5%).<br />
<br />
==Módulo administrativo do Autoatendimento==<br />
O nome do módulo administrativo é '''Acesso Área Restrita Autoatendimento'''.<br />
<br />
'''Onde acessar'''<br />
<br />
Dentro da tela do Autoatendimento, botão '''Área Restrita'''.<br />
<br />
'''Para que serve'''<br />
<br />
*Configurar porta COM da balança no próprio Autoatendimento;<br />
*Executar ações administrativas protegidas por permissão;<br />
*Permitir liberações operacionais quando o usuário tiver permissão.<br />
<br />
==Fluxo de configuração==<br />
1. Atualizar sistema e banco.<br />
<br />
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.<br />
<br />
3. Se houver balança, marcar '''Utilizar balança para conferência de peso''' no usuário.<br />
<br />
4. Em Subgrupos, marcar '''Peso variável''' nos subgrupos corretos.<br />
<br />
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.<br />
<br />
6. Em Parâmetros Específicos, ajustar:<br />
<br />
*Verificação (Item por Item ou Final)<br />
*Margem toler. (%)<br />
<br />
7. No módulo '''Área Restrita''' do Autoatendimento, configurar porta COM da balança.<br />
<br />
8. Executar teste de ponta a ponta.<br />
<br />
==Comportamentos importantes==<br />
<br />
===Pagamentos não aparecem===<br />
Conferir, nesta ordem:<br />
<br />
1. Marquinha TP_AUTOATEND no tipo de pagamento.<br />
<br />
2. Tipo não está inativo.<br />
<br />
3. Tipo possui atalho preenchido.<br />
<br />
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).<br />
<br />
===Item não passa por conferência de peso===<br />
Conferir:<br />
<br />
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).<br />
<br />
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).<br />
<br />
3. Parâmetro de verificação e margem em Parâmetros Específicos.<br />
<br />
4. Porta COM configurada corretamente no módulo '''Área Restrita'''.<br />
<br />
===Não consegue acessar funções administrativas===<br />
Conferir:<br />
<br />
1. Se o usuário tem permissão de '''Acesso Área Restrita Autoatendimento'''.<br />
<br />
2. Se o usuário tem permissão para '''Permite divergência de peso no Autoatendimento''' (quando aplicável ao cenário).<br />
<br />
==Atualização de banco (estrutura criada pela versão)==<br />
Na entrega do Autoatendimento, a atualização adiciona:<br />
<br />
*US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;<br />
*TP_AUTOATEND em TIPOPGTO;<br />
*AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;<br />
*SG_PESOVARIAVEL em SUBGRUPOS;</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2355Auto Atendimento2026-04-30T19:58:31Z<p>Vitor: </p>
<hr />
<div>==PDV Autoatendimento==<br />
<br />
==Visão funcional==<br />
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:<br />
<br />
*seleção de itens;<br />
*conferência de peso (quando aplicável);<br />
*escolha de forma de pagamento;<br />
*finalização da venda.<br />
<br />
Além do fluxo do cliente, existe o módulo administrativo interno chamado '''Área Restrita''' (do Autoatendimento), usado para ações de administração, como configuração de balança e liberações conforme permissão.<br />
<br />
==Marquinhas e parâmetros obrigatórios==<br />
<br />
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar PDV Autoatendimento''' (US_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = usuário entra no PDV em modo Autoatendimento.<br />
*Desmarcado = usuário segue no PDV normal.<br />
<br />
===2) Marquinha do Usuário para Balança===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = Autoatendimento usa leitura da balança para conferência.<br />
*Desmarcado = fluxo sem conferência por balança.<br />
<br />
===3) Marquinha do Tipo de Pagamento===<br />
'''Onde fica'''<br />
<br />
Cadastro de Tipos de Pagamento > aba '''PDV'''<br />
<br />
'''Campo'''<br />
<br />
*'''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Só aparece no Autoatendimento se esta marquinha estiver marcada.<br />
*Além disso, o tipo também precisa estar ativo e com atalho preenchido.<br />
*Tipos sem atalho não entram na listagem do Autoatendimento.<br />
<br />
===4) Marquinha de Peso Variável (produto/subgrupo)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Subgrupos de Produtos<br />
<br />
'''Campo'''<br />
<br />
*'''Peso variável''' (SG_PESOVARIAVEL)<br />
<br />
'''Regra'''<br />
<br />
*Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.<br />
*Subgrupo não marcado segue como item comum (sem conferência de peso variável).<br />
<br />
===5) Parâmetros de Peso do Autoatendimento===<br />
'''Onde fica'''<br />
<br />
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''<br />
<br />
'''Campos'''<br />
<br />
*'''Verificação''' (AUTOATEND_VERIF_PESO)<br />
**Item por Item (I)<br />
**Final (F)<br />
*'''Margem toler. (%)''' (AUTOATEND_MARGEM)<br />
<br />
'''Regra'''<br />
<br />
*Define como e quando o peso será validado.<br />
*A margem é percentual inteiro (ex.: 5 = 5%).<br />
<br />
==Módulo administrativo do Autoatendimento (nome oficial)==<br />
O nome do módulo administrativo é '''Área Restrita'''.<br />
<br />
'''Onde acessar'''<br />
Dentro da tela do Autoatendimento, botão '''Área Restrita'''.<br />
<br />
'''Para que serve'''<br />
*Configurar porta COM da balança no próprio Autoatendimento;<br />
*Executar ações administrativas protegidas por permissão;<br />
*Permitir liberações operacionais quando o usuário tiver permissão.<br />
<br />
==Fluxo de configuração recomendado (ordem para implantação)==<br />
1. Atualizar sistema e banco.<br />
<br />
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.<br />
<br />
3. Se houver balança, marcar '''Utilizar balança para conferência de peso''' no usuário.<br />
<br />
4. Em Subgrupos, marcar '''Peso variável''' nos subgrupos corretos.<br />
<br />
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.<br />
<br />
6. Em Parâmetros Específicos, ajustar:<br />
<br />
*Verificação (Item por Item ou Final)<br />
*Margem toler. (%)<br />
<br />
7. No módulo '''Área Restrita''' do Autoatendimento, configurar porta COM da balança.<br />
<br />
8. Executar teste de ponta a ponta.<br />
<br />
==Comportamentos importantes para suporte==<br />
<br />
===Pagamentos não aparecem===<br />
Conferir, nesta ordem:<br />
<br />
1. Marquinha TP_AUTOATEND no tipo de pagamento.<br />
<br />
2. Tipo não está inativo.<br />
<br />
3. Tipo possui atalho preenchido.<br />
<br />
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).<br />
<br />
===Item não passa por conferência de peso===<br />
Conferir:<br />
<br />
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).<br />
<br />
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).<br />
<br />
3. Parâmetro de verificação e margem em Parâmetros Específicos.<br />
<br />
4. Porta COM configurada corretamente no módulo '''Área Restrita'''.<br />
<br />
===Não consegue acessar funções administrativas===<br />
Conferir:<br />
<br />
1. Se o usuário tem permissão de '''Acesso Área Restrita Autoatendimento'''.<br />
<br />
2. Se o usuário tem permissão para '''Permite divergência de peso no Autoatendimento''' (quando aplicável ao cenário).<br />
<br />
==Permissões administrativas (Área Restrita)==<br />
O módulo '''Área Restrita''' possui controle de permissões para ações administrativas no Autoatendimento, incluindo:<br />
<br />
*permissão para divergência de peso;<br />
*acesso à área restrita do Autoatendimento.<br />
<br />
Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.<br />
<br />
==Atualização de banco (estrutura criada pela versão)==<br />
Na entrega do Autoatendimento, a atualização adiciona:<br />
<br />
*US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;<br />
*TP_AUTOATEND em TIPOPGTO;<br />
*AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;<br />
*SG_PESOVARIAVEL em SUBGRUPOS;<br />
<br />
com defaults e atualização de nulos para evitar inconsistência inicial.<br />
<br />
==Roteiro de teste de homologação (obrigatório)==<br />
1. Logar com usuário marcado para Autoatendimento.<br />
<br />
2. Confirmar abertura do PDV em modo Autoatendimento.<br />
<br />
3. Inserir item comum (sem peso variável) e validar fluxo normal.<br />
<br />
4. Inserir item de subgrupo com peso variável e validar conferência.<br />
<br />
5. Testar cenário dentro da margem e fora da margem.<br />
<br />
6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND.<br />
<br />
7. Acessar '''Área Restrita''', validar acesso e configurar/testar porta COM da balança.<br />
<br />
8. Concluir venda.<br />
<br />
9. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2354Auto Atendimento2026-04-30T19:53:31Z<p>Vitor: </p>
<hr />
<div>==PDV Autoatendimento==<br />
<br />
==Visão funcional==<br />
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:<br />
<br />
*seleção de itens;<br />
*conferência de peso (quando aplicável);<br />
*escolha de forma de pagamento;<br />
*finalização da venda.<br />
<br />
==Marquinhas e parâmetros obrigatórios==<br />
<br />
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar PDV Autoatendimento''' (US_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = usuário entra no PDV em modo Autoatendimento.<br />
*Desmarcado = usuário segue no PDV normal.<br />
<br />
===2) Marquinha do Usuário para Balança===<br />
'''Onde fica'''<br />
<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
<br />
*'''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)<br />
<br />
'''Regra'''<br />
<br />
*Marcado = Autoatendimento usa leitura da balança para conferência.<br />
*Desmarcado = fluxo sem conferência por balança.<br />
<br />
===3) Marquinha do Tipo de Pagamento===<br />
'''Onde fica'''<br />
<br />
Cadastro de Tipos de Pagamento > aba '''PDV'''<br />
<br />
'''Campo'''<br />
<br />
*'''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)<br />
<br />
'''Regra'''<br />
<br />
*Só aparece no Autoatendimento se esta marquinha estiver marcada.<br />
*Além disso, o tipo também precisa estar ativo e com atalho preenchido.<br />
*Tipos sem atalho não entram na listagem do Autoatendimento.<br />
<br />
===4) Marquinha de Peso Variável (produto/subgrupo)===<br />
'''Onde fica'''<br />
<br />
Cadastro de Subgrupos de Produtos<br />
<br />
'''Campo'''<br />
<br />
*'''Peso variável''' (SG_PESOVARIAVEL)<br />
<br />
'''Regra'''<br />
<br />
*Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.<br />
*Subgrupo não marcado segue como item comum (sem conferência de peso variável).<br />
<br />
===5) Parâmetros de Peso do Autoatendimento===<br />
'''Onde fica'''<br />
<br />
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''<br />
<br />
'''Campos'''<br />
<br />
*'''Verificação''' (AUTOATEND_VERIF_PESO)<br />
**Item por Item (I)<br />
**Final (F)<br />
*'''Margem toler. (%)''' (AUTOATEND_MARGEM)<br />
<br />
'''Regra'''<br />
<br />
*Define como e quando o peso será validado.<br />
*A margem é percentual inteiro (ex.: 5 = 5%).<br />
<br />
==Fluxo de configuração recomendado (ordem para implantação)==<br />
1. Atualizar sistema e banco.<br />
<br />
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.<br />
<br />
3. Se houver balança, marcar '''Utilizar balança para conferência de peso''' no usuário.<br />
<br />
4. Em Subgrupos, marcar '''Peso variável''' nos subgrupos corretos.<br />
<br />
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.<br />
<br />
6. Em Parâmetros Específicos, ajustar:<br />
<br />
*Verificação (Item por Item ou Final)<br />
*Margem toler. (%)<br />
<br />
7. No painel administrativo do Autoatendimento, configurar porta COM da balança.<br />
8. Executar teste de ponta a ponta.<br />
<br />
==Comportamentos importantes para suporte==<br />
<br />
===Pagamentos não aparecem===<br />
Conferir, nesta ordem:<br />
<br />
1. Marquinha TP_AUTOATEND no tipo de pagamento.<br />
<br />
2. Tipo não está inativo.<br />
<br />
3. Tipo possui atalho preenchido.<br />
<br />
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).<br />
<br />
===Item não passa por conferência de peso===<br />
Conferir:<br />
<br />
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).<br />
<br />
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).<br />
<br />
3. Parâmetro de verificação e margem em Parâmetros Específicos.<br />
<br />
4. Porta COM configurada corretamente no painel administrativo.<br />
<br />
==Permissões administrativas (Área Restrita)==<br />
O módulo possui controle de permissões para ações administrativas no Autoatendimento, incluindo:<br />
<br />
*permissão para divergência de peso;<br />
*acesso à área restrita do Autoatendimento.<br />
<br />
Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.<br />
<br />
==Atualização de banco (estrutura criada pela versão)==<br />
Na entrega do Autoatendimento, a atualização adiciona:<br />
<br />
*US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;<br />
*TP_AUTOATEND em TIPOPGTO;<br />
*AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;<br />
*SG_PESOVARIAVEL em SUBGRUPOS;<br />
<br />
com defaults e atualização de nulos para evitar inconsistência inicial.<br />
<br />
==Roteiro de teste de homologação (obrigatório)==<br />
1. Logar com usuário marcado para Autoatendimento.<br />
<br />
2. Confirmar abertura do PDV em modo Autoatendimento.<br />
<br />
3. Inserir item comum (sem peso variável) e validar fluxo normal.<br />
<br />
4. Inserir item de subgrupo com peso variável e validar conferência.<br />
<br />
5. Testar cenário dentro da margem e fora da margem.<br />
<br />
6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND.<br />
<br />
7. Concluir venda.<br />
<br />
8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.<br />
<br />
==Pesquisa na tela de Parâmetros (apoio ao suporte)==<br />
A tela de Parâmetros Específicos possui pesquisa por termo com botão '''Consultar''', navegação por próximo/anterior e contador de ocorrências, para localizar rapidamente os itens do Autoatendimento (ex.: "autoatend", "peso", "margem").</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2353Auto Atendimento2026-04-30T19:49:43Z<p>Vitor: </p>
<hr />
<div>==PDV Autoatendimento (Guia completo para Suporte)==<br />
<br />
==Objetivo==<br />
Documentar a configuração completa do PDV Autoatendimento para implantação, conferência e atendimento de chamados, incluindo onde fica cada marquinha obrigatória.<br />
<br />
==Visão funcional==<br />
No modo Autoatendimento, o PDV entra em fluxo próprio (tela dedicada), com:<br />
* seleção de itens;<br />
* conferência de peso (quando aplicável);<br />
* escolha de forma de pagamento;<br />
* finalização da venda.<br />
<br />
==Marquinhas e parâmetros obrigatórios==<br />
<br />
===1) Marquinha do Usuário (habilita modo Autoatendimento no PDV)===<br />
'''Onde fica'''<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
* '''Utilizar PDV Autoatendimento''' (US_AUTOATEND)<br />
<br />
'''Regra'''<br />
* Marcado = usuário entra no PDV em modo Autoatendimento.<br />
* Desmarcado = usuário segue no PDV normal.<br />
<br />
===2) Marquinha do Usuário para Balança===<br />
'''Onde fica'''<br />
Cadastro de Usuários > aba '''Autoatendimento'''<br />
<br />
'''Campo'''<br />
* '''Utilizar balança para conferência de peso''' (US_AUTOATEND_BALANCA)<br />
<br />
'''Regra'''<br />
* Marcado = Autoatendimento usa leitura da balança para conferência.<br />
* Desmarcado = fluxo sem conferência por balança.<br />
<br />
===3) Marquinha do Tipo de Pagamento===<br />
'''Onde fica'''<br />
Cadastro de Tipos de Pagamento > aba '''PDV'''<br />
<br />
'''Campo'''<br />
* '''Disponível no PDV de Autoatendimento''' (TP_AUTOATEND)<br />
<br />
'''Regra'''<br />
* Só aparece no Autoatendimento se esta marquinha estiver marcada.<br />
* Além disso, o tipo também precisa estar ativo e com atalho preenchido.<br />
* Tipos sem atalho não entram na listagem do Autoatendimento.<br />
<br />
===4) Marquinha de Peso Variável (produto/subgrupo)===<br />
'''Onde fica'''<br />
Cadastro de Subgrupos de Produtos<br />
<br />
'''Campo'''<br />
* '''Peso variável''' (SG_PESOVARIAVEL)<br />
<br />
'''Regra'''<br />
* Subgrupo marcado como peso variável entra na lógica de conferência de peso no Autoatendimento.<br />
* Subgrupo não marcado segue como item comum (sem conferência de peso variável).<br />
<br />
===5) Parâmetros de Peso do Autoatendimento===<br />
'''Onde fica'''<br />
Parâmetros Específicos > grupo '''Autoatendimento - Peso'''<br />
<br />
'''Campos'''<br />
* '''Verificação''' (AUTOATEND_VERIF_PESO)<br />
** Item por Item (I)<br />
** Final (F)<br />
* '''Margem toler. (%)''' (AUTOATEND_MARGEM)<br />
<br />
'''Regra'''<br />
* Define como e quando o peso será validado.<br />
* A margem é percentual inteiro (ex.: 5 = 5%).<br />
<br />
==Fluxo de configuração recomendado (ordem para implantação)==<br />
1. Atualizar sistema e banco.<br />
2. Conferir usuário com marquinha '''Utilizar PDV Autoatendimento'''.<br />
3. Se houver balança, marcar '''Utilizar balança para conferência de peso''' no usuário.<br />
4. Em Subgrupos, marcar '''Peso variável''' nos subgrupos corretos.<br />
5. Em Tipos de Pagamento, marcar '''Disponível no PDV de Autoatendimento''' nos tipos permitidos.<br />
6. Em Parâmetros Específicos, ajustar:<br />
* Verificação (Item por Item ou Final)<br />
* Margem toler. (%)<br />
7. No painel administrativo do Autoatendimento, configurar porta COM da balança.<br />
8. Executar teste de ponta a ponta.<br />
<br />
==Comportamentos importantes para suporte==<br />
<br />
===Pagamentos não aparecem===<br />
Conferir, nesta ordem:<br />
1. Marquinha TP_AUTOATEND no tipo de pagamento.<br />
2. Tipo não está inativo.<br />
3. Tipo possui atalho preenchido.<br />
4. Não é o tipo "VALE" (não entra na listagem do Autoatendimento).<br />
<br />
===Item não passa por conferência de peso===<br />
Conferir:<br />
1. Marquinha de usuário para balança (US_AUTOATEND_BALANCA).<br />
2. Marquinha de subgrupo peso variável (SG_PESOVARIAVEL).<br />
3. Parâmetro de verificação e margem em Parâmetros Específicos.<br />
4. Porta COM configurada corretamente no painel administrativo.<br />
<br />
===Usuário não entra no Autoatendimento===<br />
Conferir:<br />
1. Marquinha '''Utilizar PDV Autoatendimento''' no usuário (US_AUTOATEND).<br />
2. Login realizado com o usuário correto.<br />
<br />
==Permissões administrativas (Área Restrita)==<br />
O módulo possui controle de permissões para ações administrativas no Autoatendimento, incluindo:<br />
* permissão para divergência de peso;<br />
* acesso à área restrita do Autoatendimento.<br />
<br />
Em chamados de bloqueio de ação administrativa, validar as permissões do usuário/perfil antes de tratar como erro técnico.<br />
<br />
==Atualização de banco (estrutura criada pela versão)==<br />
Na entrega do Autoatendimento, a atualização adiciona:<br />
* US_AUTOATEND e US_AUTOATEND_BALANCA em USUARIOS;<br />
* TP_AUTOATEND em TIPOPGTO;<br />
* AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP;<br />
* SG_PESOVARIAVEL em SUBGRUPOS;<br />
com defaults e atualização de nulos para evitar inconsistência inicial.<br />
<br />
==Roteiro de teste de homologação (obrigatório)==<br />
1. Logar com usuário marcado para Autoatendimento.<br />
2. Confirmar abertura do PDV em modo Autoatendimento.<br />
3. Inserir item comum (sem peso variável) e validar fluxo normal.<br />
4. Inserir item de subgrupo com peso variável e validar conferência.<br />
5. Testar cenário dentro da margem e fora da margem.<br />
6. Ir para pagamento e confirmar que só aparecem tipos com marquinha TP_AUTOATEND.<br />
7. Concluir venda.<br />
8. Repetir com usuário sem marquinha US_AUTOATEND e validar PDV normal.<br />
<br />
==Pesquisa na tela de Parâmetros (apoio ao suporte)==<br />
A tela de Parâmetros Específicos possui pesquisa por termo com botão '''Consultar''', navegação por próximo/anterior e contador de ocorrências, para localizar rapidamente os itens do Autoatendimento (ex.: "autoatend", "peso", "margem").</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2352Auto Atendimento2026-04-30T19:44:00Z<p>Vitor: </p>
<hr />
<div>==PDV Autoatendimento==<br />
<br />
==O que é?==<br />
O PDV Autoatendimento é o modo de venda em que o próprio cliente realiza a compra no terminal touch, sem depender do operador para conduzir cada etapa.<br />
<br />
Neste modo, o cliente:<br />
* seleciona os produtos;<br />
* visualiza carrinho e total;<br />
* passa pela validação de peso (quando aplicável);<br />
* escolhe forma de pagamento disponível;<br />
* finaliza a compra.<br />
<br />
==Como funciona (visão geral)==<br />
# O cliente inicia o atendimento no terminal.<br />
# Seleciona produtos e adiciona ao carrinho.<br />
# Se houver item de pesagem, o sistema realiza conferência de peso conforme parâmetros.<br />
# O cliente segue para pagamento.<br />
# O sistema exibe somente as formas de pagamento habilitadas para Autoatendimento.<br />
# A venda é finalizada no próprio terminal.<br />
<br />
==Requisitos==<br />
* Master Key / Master Key PDV com módulo de Autoatendimento.<br />
* Terminal com tela touch (recomendado).<br />
* Balança serial instalada (quando houver venda de item pesável).<br />
* Permissão para alterar Parâmetros Específicos, Tipos de Pagamento e Cadastro de Produtos.<br />
<br />
==Configuração obrigatória==<br />
<br />
===1) Parâmetros Específicos (empresa)==<br />
No grupo de Autoatendimento, configurar:<br />
<br />
'''1.1) Verificar peso'''<br />
Habilita ou desabilita a conferência de peso no fluxo do Autoatendimento.<br />
<br />
'''1.2) Margem de peso'''<br />
Define a tolerância usada na validação do peso.<br />
<br />
Observação:<br />
Essas configurações são por empresa (Parâmetros Específicos), e não por usuário.<br />
<br />
===2) Tipos de Pagamento (marquinha)==<br />
No cadastro de tipos de pagamento, habilitar a '''marquinha''' de uso no Autoatendimento.<br />
<br />
Regra:<br />
* Se não estiver marcado, o tipo de pagamento não aparece no fechamento do Autoatendimento.<br />
* Se estiver marcado, ele fica disponível para o cliente selecionar no terminal.<br />
<br />
===3) Produto com peso variável (marquinha)==<br />
No cadastro do produto, habilitar a '''marquinha de peso variável''' para itens que dependem de balança.<br />
<br />
Regra:<br />
* Produto com marquinha de peso variável entra no fluxo de conferência de peso.<br />
* Produto sem marquinha segue como item comum (sem conferência de peso da balança).<br />
<br />
===4) Porta da balança (painel administrativo do Autoatendimento)==<br />
No painel administrativo interno do Autoatendimento:<br />
# Abrir a configuração da balança.<br />
# Selecionar a porta COM correta.<br />
# Confirmar e testar leitura.<br />
<br />
Observação:<br />
O seletor de porta foi otimizado para touch (janela, lista e botões com área maior de toque).<br />
<br />
==Fluxo funcional completo==<br />
<br />
===Etapa 1 - Seleção de itens===<br />
* Cliente navega por categorias/produtos.<br />
* Adiciona itens ao carrinho.<br />
* Total parcial é atualizado.<br />
<br />
===Etapa 2 - Regras de pesagem===<br />
Quando o item estiver marcado como peso variável:<br />
* o sistema obtém leitura da balança;<br />
* aplica validação conforme "Verificar peso" e "Margem de peso";<br />
* permite continuidade ou bloqueia/sinaliza divergência conforme regra.<br />
<br />
===Etapa 3 - Pagamento===<br />
* O sistema mostra somente os tipos de pagamento com marquinha habilitada para Autoatendimento.<br />
* Cliente seleciona forma de pagamento.<br />
* Venda é concluída.<br />
<br />
==Checklist de implantação (suporte)==<br />
# Conferir se o módulo Autoatendimento está disponível no PDV.<br />
# Configurar Parâmetros Específicos de peso (verificar + margem).<br />
# Habilitar marquinha nos tipos de pagamento desejados.<br />
# Habilitar marquinha de peso variável nos produtos pesáveis.<br />
# Configurar porta COM da balança no painel administrativo.<br />
# Executar teste de ponta a ponta.<br />
<br />
==Roteiro de testes (homologação)==<br />
<br />
===Teste A - Item sem peso===<br />
# Incluir item comum.<br />
# Confirmar que não entra em conferência de balança.<br />
# Validar finalização.<br />
<br />
===Teste B - Item com peso variável===<br />
# Incluir item com marquinha de peso variável.<br />
# Confirmar leitura da balança.<br />
# Testar cenário dentro da margem.<br />
# Testar cenário fora da margem.<br />
<br />
===Teste C - Formas de pagamento===<br />
# Ir ao fechamento.<br />
# Confirmar que aparecem somente tipos com marquinha de Autoatendimento.<br />
# Validar conclusão da venda.<br />
<br />
==Operação do suporte (diagnóstico rápido)==<br />
<br />
===1) Item pesável não valida peso===<br />
Verificar nesta ordem:<br />
# Produto está com marquinha de peso variável.<br />
# Parâmetros de peso estão configurados.<br />
# Porta COM da balança está correta.<br />
# Balança está conectada/comunicando.<br />
<br />
===2) Forma de pagamento não aparece===<br />
# Confirmar marquinha do tipo de pagamento para Autoatendimento.<br />
# Salvar cadastro e reabrir fluxo de fechamento.<br />
<br />
===3) Divergência frequente de peso===<br />
# Revisar margem de tolerância.<br />
# Validar leitura real da balança.<br />
# Repetir teste com item padrão de referência.<br />
<br />
===4) Não lê peso no terminal===<br />
# Testar outra COM.<br />
# Validar cabo/alimentação da balança.<br />
# Confirmar disponibilidade da porta serial no Windows.<br />
<br />
==Pesquisa de parâmetros (apoio ao suporte)==<br />
Na tela de Parâmetros Específicos existe pesquisa para localizar rapidamente configurações do Autoatendimento.<br />
<br />
Como usar:<br />
# Digitar termo (ex.: autoatend, peso, margem).<br />
# Clicar em '''Consultar'''.<br />
# Navegar entre resultados com próximo/anterior.<br />
# Usar contador de ocorrência para validar todas as posições encontradas.<br />
<br />
==Resumo de regra de negócio==<br />
* Parâmetro de peso: define comportamento global da empresa.<br />
* Marquinha de peso variável: define se o produto exige conferência de balança.<br />
* Marquinha de tipo de pagamento: define o que aparece para o cliente no fechamento.<br />
* Porta COM correta: condição obrigatória para leitura da balança.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2351Auto Atendimento2026-04-30T19:41:44Z<p>Vitor: </p>
<hr />
<div>==Escopo desta entrega (PDV Autoatendimento)==<br />
Este conteúdo descreve exatamente o que foi implementado nesta sequência de ajustes, para suporte técnico e implantação.<br />
<br />
===1) Migração de configuração de peso para Parâmetros Específicos===<br />
A configuração de validação de peso do Autoatendimento deixou de ser por usuário e passou para Parâmetros Específicos da empresa.<br />
<br />
'''Campos novos em PARAMESP'''<br />
* AUTOATEND_VERIF_PESO<br />
* AUTOATEND_MARGEM<br />
<br />
'''Comportamento da atualização'''<br />
* A atualização de banco cria os campos em PARAMESP.<br />
* Os valores antigos são migrados para PARAMESP.<br />
* O fluxo do Autoatendimento passa a ler esses campos em PARAMESP.<br />
<br />
'''Importante para suporte'''<br />
* Se cliente atualizar e a tela não refletir os valores, validar se os campos existem em PARAMESP e se houve migração dos dados.<br />
* A configuração antiga por usuário não é mais a referência principal para peso no Autoatendimento.<br />
<br />
===2) Ajustes no painel administrativo do Autoatendimento (touch)==<br />
Foram feitos ajustes de usabilidade no painel administrativo para operação em tela touch.<br />
<br />
'''O que mudou'''<br />
* Seleção da porta da balança com janela maior.<br />
* Lista de portas com itens maiores (melhor toque).<br />
* Botões de ação (confirmar/cancelar) maiores.<br />
* Ajuste visual do botão Fechar no painel administrativo para facilitar identificação/uso.<br />
<br />
'''Importante para suporte'''<br />
* Em caso de erro de leitura de peso, sempre revisar primeiro a porta COM selecionada no painel administrativo do Autoatendimento.<br />
<br />
===3) Fluxo de pesagem no Autoatendimento===<br />
O fluxo considera os parâmetros centralizados em PARAMESP.<br />
<br />
'''Regras'''<br />
* Se AUTOATEND_VERIF_PESO estiver habilitado, o sistema valida o peso.<br />
* A tolerância usa AUTOATEND_MARGEM.<br />
* Produto de pesagem precisa estar com a '''marquinha de peso variável''' habilitada no cadastro do produto para entrar no fluxo de conferência de peso.<br />
<br />
===4) Tipos de pagamento no Autoatendimento===<br />
No fechamento da compra no Autoatendimento, só devem aparecer formas de pagamento com a '''marquinha''' habilitada para esse uso.<br />
<br />
'''Importante para suporte'''<br />
* Se um tipo de pagamento "sumiu" no Autoatendimento, validar a marquinha do tipo de pagamento.<br />
* Se item de balança não está validando peso, validar a marquinha de peso variável no produto.<br />
<br />
==Como configurar (passo a passo para suporte)==<br />
===A) Parâmetros Específicos===<br />
1. Abrir Parâmetros Específicos.<br />
2. Localizar grupo de Autoatendimento.<br />
3. Configurar:<br />
* '''Verificar peso''' (habilita/desabilita conferência)<br />
* '''Margem de peso''' (tolerância)<br />
4. Salvar.<br />
<br />
===B) Tipo de pagamento (marquinha)==<br />
1. Abrir cadastro de Tipos de Pagamento.<br />
2. Marcar os tipos permitidos no Autoatendimento.<br />
3. Salvar.<br />
4. Testar no fechamento da venda do Autoatendimento.<br />
<br />
===C) Produto com peso variável (marquinha)==<br />
1. Abrir cadastro do produto.<br />
2. Marcar como peso variável (quando aplicável).<br />
3. Salvar.<br />
4. Testar inclusão e conferência no Autoatendimento.<br />
<br />
===D) Porta da balança no painel administrativo===<br />
1. Entrar no painel administrativo do Autoatendimento.<br />
2. Abrir seleção de porta da balança.<br />
3. Selecionar COM correta.<br />
4. Confirmar.<br />
5. Executar teste com produto de peso variável.<br />
<br />
==Fluxo de teste obrigatório (suporte)==<br />
1. Testar item comum (sem peso variável): deve seguir sem conferência de peso.<br />
2. Testar item com peso variável:<br />
* com peso dentro da margem: deve permitir continuidade;<br />
* com peso fora da margem: deve aplicar regra de bloqueio/alerta do fluxo.<br />
3. Ir para pagamento e confirmar se só aparecem os tipos com marquinha de Autoatendimento.<br />
4. Concluir venda de ponta a ponta.<br />
<br />
==Erros comuns e checagem rápida==<br />
===1) Não lê peso===<br />
Verificar nesta ordem:<br />
1. Porta COM no painel administrativo.<br />
2. Comunicação física da balança.<br />
3. Produto está com marquinha de peso variável.<br />
4. Parâmetros AUTOATEND_VERIF_PESO / AUTOATEND_MARGEM.<br />
<br />
===2) Tipo de pagamento não aparece===<br />
1. Conferir marquinha do tipo de pagamento para Autoatendimento.<br />
2. Reabrir fluxo de fechamento após salvar cadastro.<br />
<br />
===3) Configuração de peso "sumiu" após atualização===<br />
1. Validar existência de AUTOATEND_VERIF_PESO e AUTOATEND_MARGEM em PARAMESP.<br />
2. Validar se migração de dados foi aplicada no banco.<br />
3. Confirmar se o cliente não está consultando a configuração antiga por usuário.<br />
<br />
==Ajuste adicional entregue na tela de Parâmetros (apoio ao suporte)==<br />
Foi adicionada pesquisa na tela de Parâmetros Específicos para facilitar localizar configurações de Autoatendimento.<br />
<br />
'''Como funciona'''<br />
* Digita o termo e clica em '''Consultar'''.<br />
* Navega pelas ocorrências com botões de próximo/anterior.<br />
* Exibe contador de ocorrência.<br />
* Expande seções automaticamente quando necessário.<br />
* Foi corrigido o posicionamento da rolagem para ocorrências em controles desabilitados (Enabled=False), evitando salto para local incorreto.<br />
<br />
'''Uso prático'''<br />
* Pesquisar por termos como: "autoatend", "peso", "margem", "estoque", etc.<br />
```<br />
<br />
Se quiser, eu já te mando uma segunda versão mais curta (estilo "checklist de atendimento"), para ficar como seção separada no final da wiki.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2350Auto Atendimento2026-04-30T19:38:59Z<p>Vitor: </p>
<hr />
<div>==O que é?==<br />
É o módulo de PDV Autoatendimento do Master Key / Master Key PDV, criado para operação em terminal touch, permitindo que o cliente faça o próprio atendimento com seleção de produtos, pesagem (quando aplicável) e fechamento da compra.<br />
<br />
==Como funciona?==<br />
Ao abrir o Autoatendimento no PDV, o cliente navega pelas categorias, adiciona produtos ao carrinho e conclui a venda no próprio terminal.<br />
<br />
Para itens de pesagem, o sistema lê a balança e valida o peso conforme os parâmetros configurados (verificação de peso + margem de tolerância).<br />
<br />
==O que foi implementado==<br />
* Módulo de Autoatendimento com fluxo touch;<br />
* Painel administrativo interno para ajustes rápidos;<br />
* Melhoria no seletor de porta da balança (tela maior e botões maiores para toque);<br />
* Parâmetros de validação de peso no sistema;<br />
* Controle por "marquinha" para habilitação de tipos de pagamento no Autoatendimento;<br />
* Controle por "marquinha" para produtos com peso variável.<br />
<br />
==Benefícios==<br />
* Atendimento mais rápido no PDV;<br />
* Menor dependência do operador durante a venda;<br />
* Melhor experiência de uso em tela touch;<br />
* Mais segurança na venda de itens pesáveis;<br />
* Configuração operacional simples para suporte e implantação.<br />
<br />
==Requisitos==<br />
* Master Key / PDV atualizado com o recurso de Autoatendimento;<br />
* Terminal touch (recomendado);<br />
* Balança instalada e ativa em porta serial (COM), quando houver pesagem;<br />
* Permissão para alterar Parâmetros Específicos e cadastros relacionados.<br />
<br />
==Como configurar==<br />
===1) Parâmetros Específicos===<br />
Configurar os parâmetros do Autoatendimento relacionados à pesagem:<br />
<br />
'''1.1) Verificação de peso''': habilitar quando a loja utiliza conferência de peso no Autoatendimento.<br />
<br />
'''1.2) Margem de tolerância''': informar a margem permitida para diferença de peso.<br />
<br />
===2) Painel administrativo do Autoatendimento===<br />
No próprio Autoatendimento:<br />
<br />
'''2.1) Porta da balança''': selecionar a COM correta.<br />
<br />
'''2.2) Confirmar''': salvar e validar em teste prático de pesagem.<br />
<br />
===3) Tipos de pagamento (marquinha)===<br />
No cadastro de tipos de pagamento, marcar os que poderão aparecer no Autoatendimento.<br />
<br />
'''Importante''': se não estiver marcado, o tipo de pagamento não será disponibilizado no fechamento da compra no terminal de Autoatendimento.<br />
<br />
===4) Produto com peso variável (marquinha)===<br />
Nos produtos que devem ser tratados por pesagem, marcar a opção de peso variável.<br />
<br />
'''Importante''': sem essa marcação, o item não entra no fluxo de leitura/validação de peso da balança no Autoatendimento.<br />
<br />
==Fluxo operacional==<br />
# Cliente inicia atendimento no terminal.<br />
# Seleciona produtos e adiciona ao carrinho.<br />
# Se houver item com peso variável (marcado), o sistema lê e valida o peso.<br />
# Cliente segue para pagamento.<br />
# No pagamento, o sistema exibe somente os tipos de pagamento marcados para Autoatendimento.<br />
# Venda é concluída normalmente.<br />
<br />
==Roteiro de validação (suporte)==<br />
# Validar se o terminal abre o Autoatendimento corretamente.<br />
# Incluir item comum (sem peso) e validar fluxo.<br />
# Incluir item com marquinha de peso variável e validar leitura da balança.<br />
# Testar validação com peso dentro e fora da margem.<br />
# Ir ao fechamento e confirmar se aparecem somente os tipos de pagamento marcados.<br />
# Concluir uma venda de teste ponta a ponta.<br />
<br />
==Erros comuns==<br />
1) Item pesável não pede leitura de peso.<br />
* Verificar se a marquinha de peso variável está habilitada no produto;<br />
* Verificar parâmetros de verificação de peso;<br />
* Verificar comunicação da balança (porta COM).<br />
<br />
2) Tipo de pagamento não aparece no fechamento.<br />
* Verificar se o tipo está com a marquinha habilitada para Autoatendimento;<br />
* Revisar permissões e sincronização de cadastro, se aplicável.<br />
<br />
3) Não lê peso.<br />
* Porta COM incorreta;<br />
* Balança desconectada/cabo com falha;<br />
* Problema de driver/comunicação serial no Windows.<br />
<br />
4) Bloqueio frequente por diferença de peso.<br />
* Margem de tolerância muito restrita para a operação da loja;<br />
* Ajustar margem e repetir testes controlados.<br />
<br />
==Boas práticas==<br />
* Configurar e validar primeiro em homologação;<br />
* Registrar quais tipos de pagamento ficaram marcados por loja;<br />
* Registrar quais produtos usam marquinha de peso variável;<br />
* Treinar equipe local para ajuste rápido de porta COM e validação básica de pesagem.<br />
<br />
==Resumo para suporte==<br />
Se houver problema no Autoatendimento, validar primeiro:<br />
# Parâmetros de peso;<br />
# Porta COM da balança;<br />
# Marquinha de tipo de pagamento;<br />
# Marquinha de peso variável no produto.<br />
Na maioria dos casos, a causa está em uma dessas quatro configurações.<br />
```</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2349Auto Atendimento2026-04-30T19:38:49Z<p>Vitor: </p>
<hr />
<div>```text<br />
==O que é?==<br />
É o módulo de PDV Autoatendimento do Master Key / Master Key PDV, criado para operação em terminal touch, permitindo que o cliente faça o próprio atendimento com seleção de produtos, pesagem (quando aplicável) e fechamento da compra.<br />
<br />
==Como funciona?==<br />
Ao abrir o Autoatendimento no PDV, o cliente navega pelas categorias, adiciona produtos ao carrinho e conclui a venda no próprio terminal.<br />
<br />
Para itens de pesagem, o sistema lê a balança e valida o peso conforme os parâmetros configurados (verificação de peso + margem de tolerância).<br />
<br />
==O que foi implementado==<br />
* Módulo de Autoatendimento com fluxo touch;<br />
* Painel administrativo interno para ajustes rápidos;<br />
* Melhoria no seletor de porta da balança (tela maior e botões maiores para toque);<br />
* Parâmetros de validação de peso no sistema;<br />
* Controle por "marquinha" para habilitação de tipos de pagamento no Autoatendimento;<br />
* Controle por "marquinha" para produtos com peso variável.<br />
<br />
==Benefícios==<br />
* Atendimento mais rápido no PDV;<br />
* Menor dependência do operador durante a venda;<br />
* Melhor experiência de uso em tela touch;<br />
* Mais segurança na venda de itens pesáveis;<br />
* Configuração operacional simples para suporte e implantação.<br />
<br />
==Requisitos==<br />
* Master Key / PDV atualizado com o recurso de Autoatendimento;<br />
* Terminal touch (recomendado);<br />
* Balança instalada e ativa em porta serial (COM), quando houver pesagem;<br />
* Permissão para alterar Parâmetros Específicos e cadastros relacionados.<br />
<br />
==Como configurar==<br />
===1) Parâmetros Específicos===<br />
Configurar os parâmetros do Autoatendimento relacionados à pesagem:<br />
<br />
'''1.1) Verificação de peso''': habilitar quando a loja utiliza conferência de peso no Autoatendimento.<br />
<br />
'''1.2) Margem de tolerância''': informar a margem permitida para diferença de peso.<br />
<br />
===2) Painel administrativo do Autoatendimento===<br />
No próprio Autoatendimento:<br />
<br />
'''2.1) Porta da balança''': selecionar a COM correta.<br />
<br />
'''2.2) Confirmar''': salvar e validar em teste prático de pesagem.<br />
<br />
===3) Tipos de pagamento (marquinha)===<br />
No cadastro de tipos de pagamento, marcar os que poderão aparecer no Autoatendimento.<br />
<br />
'''Importante''': se não estiver marcado, o tipo de pagamento não será disponibilizado no fechamento da compra no terminal de Autoatendimento.<br />
<br />
===4) Produto com peso variável (marquinha)===<br />
Nos produtos que devem ser tratados por pesagem, marcar a opção de peso variável.<br />
<br />
'''Importante''': sem essa marcação, o item não entra no fluxo de leitura/validação de peso da balança no Autoatendimento.<br />
<br />
==Fluxo operacional==<br />
# Cliente inicia atendimento no terminal.<br />
# Seleciona produtos e adiciona ao carrinho.<br />
# Se houver item com peso variável (marcado), o sistema lê e valida o peso.<br />
# Cliente segue para pagamento.<br />
# No pagamento, o sistema exibe somente os tipos de pagamento marcados para Autoatendimento.<br />
# Venda é concluída normalmente.<br />
<br />
==Roteiro de validação (suporte)==<br />
# Validar se o terminal abre o Autoatendimento corretamente.<br />
# Incluir item comum (sem peso) e validar fluxo.<br />
# Incluir item com marquinha de peso variável e validar leitura da balança.<br />
# Testar validação com peso dentro e fora da margem.<br />
# Ir ao fechamento e confirmar se aparecem somente os tipos de pagamento marcados.<br />
# Concluir uma venda de teste ponta a ponta.<br />
<br />
==Erros comuns==<br />
1) Item pesável não pede leitura de peso.<br />
* Verificar se a marquinha de peso variável está habilitada no produto;<br />
* Verificar parâmetros de verificação de peso;<br />
* Verificar comunicação da balança (porta COM).<br />
<br />
2) Tipo de pagamento não aparece no fechamento.<br />
* Verificar se o tipo está com a marquinha habilitada para Autoatendimento;<br />
* Revisar permissões e sincronização de cadastro, se aplicável.<br />
<br />
3) Não lê peso.<br />
* Porta COM incorreta;<br />
* Balança desconectada/cabo com falha;<br />
* Problema de driver/comunicação serial no Windows.<br />
<br />
4) Bloqueio frequente por diferença de peso.<br />
* Margem de tolerância muito restrita para a operação da loja;<br />
* Ajustar margem e repetir testes controlados.<br />
<br />
==Boas práticas==<br />
* Configurar e validar primeiro em homologação;<br />
* Registrar quais tipos de pagamento ficaram marcados por loja;<br />
* Registrar quais produtos usam marquinha de peso variável;<br />
* Treinar equipe local para ajuste rápido de porta COM e validação básica de pesagem.<br />
<br />
==Resumo para suporte==<br />
Se houver problema no Autoatendimento, validar primeiro:<br />
# Parâmetros de peso;<br />
# Porta COM da balança;<br />
# Marquinha de tipo de pagamento;<br />
# Marquinha de peso variável no produto.<br />
Na maioria dos casos, a causa está em uma dessas quatro configurações.<br />
```</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2348Auto Atendimento2026-04-30T19:35:17Z<p>Vitor: </p>
<hr />
<div>==O que é?==<br />
É o módulo de PDV Autoatendimento do Master Key, desenvolvido para operação em terminal touch, permitindo que o cliente realize o próprio atendimento com seleção de produtos, pesagem (quando aplicável) e fechamento da compra.<br />
<br />
==Como funciona?==<br />
Ao iniciar o Autoatendimento no PDV, o cliente navega por categorias e produtos, adiciona itens ao carrinho e finaliza a compra no próprio terminal.<br />
<br />
Quando houver produto com controle de peso, o sistema faz a leitura da balança e valida o peso conforme as configurações definidas nos Parâmetros Específicos (verificação de peso e margem de tolerância).<br />
<br />
Também existe um painel administrativo no próprio Autoatendimento para ajustes operacionais, incluindo a configuração da porta de comunicação da balança.<br />
<br />
==Benefícios==<br />
*Fluxo mais simples para o cliente em ambiente touch;<br />
*Redução de intervenção do operador no processo de venda;<br />
*Suporte a produtos pesáveis com validação por parâmetros;<br />
*Configuração da porta da balança diretamente no painel administrativo;<br />
*Melhor usabilidade no painel administrativo (janela maior e botões maiores para toque);<br />
*Maior padronização operacional entre lojas com configuração central por parâmetros.<br />
<br />
==Requisitos==<br />
Master Key / PDV atualizado com o módulo de Autoatendimento.<br />
<br />
Terminal com tela touch (recomendado).<br />
<br />
Balança instalada e comunicando via porta serial (COM), para cenários com produto pesável.<br />
<br />
==Como configurar==<br />
===Parâmetros Específicos===<br />
Configurar os parâmetros de Autoatendimento relacionados à pesagem:<br />
<br />
'''1) Verificação de peso''': Habilitar ou desabilitar a validação de peso no fluxo de autoatendimento.<br />
<br />
'''2) Margem de tolerância''': Definir a margem aceita na comparação de peso.<br />
<br />
===Painel administrativo do Autoatendimento===<br />
No próprio módulo de Autoatendimento:<br />
<br />
'''1) Selecionar porta da balança''': Escolher a porta COM correta da balança.<br />
<br />
'''2) Confirmar configuração''': Salvar e validar leitura de peso em teste prático.<br />
<br />
==Fluxo operacional==<br />
'''1) Início''': Abrir o modo Autoatendimento no PDV.<br />
<br />
'''2) Seleção de produtos''': Cliente seleciona os itens desejados.<br />
<br />
'''3) Pesagem (quando houver)''': Sistema lê e valida o peso conforme parâmetros.<br />
<br />
'''4) Fechamento''': Cliente conclui a compra no terminal.<br />
<br />
==Validação rápida (suporte)==<br />
1) Abrir o Autoatendimento e incluir itens sem pesagem.<br />
<br />
2) Incluir item com pesagem e confirmar leitura da balança.<br />
<br />
3) Validar comportamento com peso dentro e fora da margem configurada.<br />
<br />
4) Confirmar conclusão normal do fluxo de venda.<br />
<br />
==Erros comuns==<br />
1) Não lê peso no Autoatendimento.<br />
<br />
Verificar:<br />
*Porta COM selecionada incorretamente;<br />
*Balança desconectada;<br />
*Problema físico de cabo/comunicação serial.<br />
<br />
2) Bloqueio indevido na validação de peso.<br />
<br />
Verificar:<br />
*Margem de tolerância muito baixa para a operação da loja;<br />
*Parâmetro de verificação habilitado com configuração inadequada.<br />
<br />
3) Dificuldade de uso no touch.<br />
<br />
Verificar:<br />
*Escala/resolução do terminal;<br />
*Calibração do touch no sistema operacional.<br />
<br />
==Observações==<br />
As configurações de peso e margem do Autoatendimento devem ser mantidas conforme a operação real da loja, para evitar bloqueios indevidos e garantir fluidez no atendimento.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2347Auto Atendimento2026-04-30T19:33:47Z<p>Vitor: </p>
<hr />
<div>```markdown<br />
h1. PDV Autoatendimento - Guia Completo para Suporte<br />
<br />
h2. Objetivo<br />
O módulo de PDV Autoatendimento permite que o cliente finalize compras de forma autônoma em terminal touch, com fluxo de seleção de itens, pesagem (quando aplicável) e fechamento da venda.<br />
<br />
Este material orienta o suporte em:<br />
* Entender o fluxo funcional<br />
* Configurar corretamente<br />
* Validar funcionamento<br />
* Diagnosticar problemas comuns<br />
<br />
h2. Visão geral do fluxo<br />
# Operador abre o modo Autoatendimento no PDV.<br />
# Cliente navega por categorias e produtos na interface touch.<br />
# Cliente adiciona itens ao carrinho.<br />
# Para itens com pesagem, o sistema lê a balança e aplica validação de peso conforme parâmetros.<br />
# Cliente confirma os itens e segue para fechamento.<br />
# Sistema conclui a venda conforme regras padrão do PDV.<br />
<br />
h2. O que foi implementado<br />
* Criação do módulo de Autoatendimento para operação em tela touch.<br />
* Melhorias de usabilidade no painel administrativo interno.<br />
* Ajuste do seletor de porta da balança para toque:<br />
** Janela maior<br />
** Itens com maior altura<br />
** Botões maiores<br />
* Parametrização da validação de peso em Parâmetros Específicos.<br />
* Ajustes para reduzir erros operacionais no uso da balança.<br />
<br />
h2. Pré-requisitos<br />
* PDV atualizado com módulo de Autoatendimento.<br />
* Balança instalada e comunicando via serial.<br />
* Porta COM identificada no Windows.<br />
* Permissão para alterar Parâmetros Específicos.<br />
* Terminal touch recomendado.<br />
<br />
h2. Configuração inicial<br />
<br />
h3. 1) Configurar porta da balança<br />
No painel administrativo do Autoatendimento:<br />
# Abrir configuração de balança.<br />
# Selecionar a porta COM correta.<br />
# Confirmar.<br />
# Validar leitura de peso no fluxo de venda.<br />
<br />
Dica de suporte: se houver mais de uma COM, testar leitura rápida até identificar a correta.<br />
<br />
h3. 2) Configurar validação de peso<br />
Em Parâmetros Específicos:<br />
# Localizar parâmetros de Autoatendimento relacionados a peso.<br />
# Definir se a verificação de peso será utilizada.<br />
# Definir margem de tolerância.<br />
<br />
Recomendação: iniciar com margem conservadora em homologação e ajustar após testes reais.<br />
<br />
h2. Fluxo operacional detalhado<br />
<br />
h3. Itens sem pesagem<br />
* Cliente seleciona item.<br />
* Item é adicionado ao carrinho.<br />
* Total é atualizado normalmente.<br />
<br />
h3. Itens com pesagem<br />
* Cliente seleciona item com controle por peso.<br />
* Sistema consulta peso da balança.<br />
* Sistema compara leitura com regra configurada:<br />
** Verificação habilitada: valida usando margem.<br />
** Verificação desabilitada: segue sem bloqueio por peso.<br />
* Item é aceito ou sinalizado conforme resultado.<br />
<br />
h2. Roteiro de validação (homologação)<br />
# Abrir Autoatendimento.<br />
# Incluir itens sem peso.<br />
# Incluir item com peso e validar leitura.<br />
# Testar cenário dentro e fora da margem.<br />
# Confirmar fechamento da venda.<br />
# Confirmar alteração de porta COM no painel administrativo.<br />
<br />
h2. Diagnóstico rápido<br />
<br />
h3. Problema: não lê peso<br />
Possíveis causas:<br />
* Porta COM incorreta<br />
* Balança desconectada<br />
* Driver/serial indisponível<br />
<br />
Ações:<br />
# Reconfigurar porta COM no painel administrativo.<br />
# Testar cabo e conexão física.<br />
# Confirmar disponibilidade da porta no Windows.<br />
<br />
h3. Problema: bloqueio indevido em item pesado<br />
Possíveis causas:<br />
* Margem configurada muito baixa<br />
* Variação operacional normal fora da margem<br />
<br />
Ações:<br />
# Revisar parâmetros de verificação e margem.<br />
# Repetir teste com item padrão conhecido.<br />
<br />
h3. Problema: dificuldade de uso no touch<br />
Possíveis causas:<br />
* Escala/resolução inadequada<br />
* Touch sem calibração<br />
<br />
Ações:<br />
# Validar resolução e escala.<br />
# Recalibrar touch no sistema operacional.<br />
<br />
h2. Boas práticas de implantação<br />
* Executar primeiro ciclo em homologação.<br />
* Registrar porta COM e margem por loja.<br />
* Treinar equipe local para:<br />
** Acessar painel administrativo<br />
** Trocar porta COM quando necessário<br />
** Diferenciar falha física de falha de configuração<br />
<br />
h2. Script rápido para atendimento<br />
# Confirmar versão com Autoatendimento atualizado.<br />
# Verificar conexão da balança e porta COM.<br />
# Revisar parâmetros de verificação de peso e margem.<br />
# Executar teste com item sem peso e com peso.<br />
# Ajustar parâmetros, se necessário.<br />
# Registrar configuração final e evidência de teste.<br />
<br />
h2. Resultado esperado<br />
* Operação autônoma do cliente com baixa intervenção.<br />
* Validação consistente para itens pesáveis.<br />
* Ajuste rápido de COM em ambiente touch.<br />
* Redução de chamados por configuração de balança e margem.<br />
```</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2346Auto Atendimento2026-04-30T19:31:01Z<p>Vitor: </p>
<hr />
<div># PDV Autoatendimento<br />
<br />
## Objetivo<br />
O módulo de PDV Autoatendimento foi criado para permitir que o cliente finalize compras de forma autônoma em terminal touch, com fluxo simples de seleção de itens, pesagem (quando aplicável) e fechamento da venda.<br />
<br />
Este documento explica:<br />
- O fluxo funcional completo<br />
- Como configurar<br />
- Como validar se está funcionando<br />
- Como tratar dúvidas e problemas comuns em atendimento<br />
<br />
## Visão geral do fluxo<br />
1. O operador abre o modo Autoatendimento no PDV.<br />
2. O cliente navega pelas categorias e produtos na interface touch.<br />
3. O cliente adiciona itens ao carrinho.<br />
4. Para itens com pesagem, o sistema faz a leitura da balança e aplica validação de peso conforme parâmetros.<br />
5. O cliente confirma os itens e segue para fechamento.<br />
6. O sistema conclui a venda conforme regras já existentes do PDV.<br />
<br />
## O que foi implementado no projeto<br />
- Criação do módulo de Autoatendimento para uso em tela touch.<br />
- Melhorias de usabilidade no painel administrativo interno do Autoatendimento.<br />
- Ajuste do seletor de porta da balança para facilitar uso por toque:<br />
- Janela maior<br />
- Itens com altura maior<br />
- Botões maiores<br />
- Parametrização da validação de peso no conjunto de Parâmetros Específicos do sistema.<br />
- Ajustes de comportamento para reduzir erro operacional no uso da balança.<br />
<br />
## Pré-requisitos<br />
- PDV com módulo de Autoatendimento disponível na versão atualizada.<br />
- Balança instalada e comunicando via porta serial.<br />
- Porta COM identificada no Windows.<br />
- Permissão para alterar Parâmetros Específicos no sistema.<br />
- Terminal com tela touch recomendado.<br />
<br />
## Configuração inicial<br />
<br />
### 1) Configurar a porta da balança<br />
No painel administrativo do Autoatendimento:<br />
1. Abrir a configuração de balança.<br />
2. Selecionar a porta COM correta.<br />
3. Confirmar.<br />
4. Validar se a leitura de peso está retornando no fluxo de venda.<br />
<br />
Dica de suporte:<br />
- Se houver mais de uma porta COM, testar leitura rápida em cada uma até confirmar a correta.<br />
<br />
### 2) Configurar validação de peso<br />
Nos Parâmetros Específicos:<br />
1. Localizar os parâmetros de Autoatendimento relacionados a peso.<br />
2. Definir se a verificação de peso será utilizada.<br />
3. Definir a margem de tolerância de peso.<br />
<br />
Recomendação prática:<br />
- Começar com margem mais conservadora para ambiente de teste.<br />
- Após validação em loja real, ajustar para o valor operacional ideal.<br />
<br />
## Fluxo operacional detalhado<br />
<br />
### Inclusão de itens sem pesagem<br />
- Cliente seleciona item.<br />
- Item é adicionado ao carrinho.<br />
- Total é atualizado normalmente.<br />
<br />
### Inclusão de itens com pesagem<br />
- Cliente seleciona item com controle por peso.<br />
- Sistema consulta peso da balança.<br />
- Sistema compara leitura com regra configurada:<br />
- Verificação de peso habilitada: aplica validação com margem.<br />
- Verificação de peso desabilitada: segue sem bloqueio por peso.<br />
- Item é aceito ou sinalizado conforme resultado da validação.<br />
<br />
## Como o suporte deve validar em homologação<br />
1. Abrir Autoatendimento.<br />
2. Selecionar alguns itens sem peso e confirmar inclusão.<br />
3. Selecionar item com peso e validar leitura.<br />
4. Testar cenário dentro da margem e fora da margem.<br />
5. Confirmar que o fechamento segue normal.<br />
6. Confirmar que o painel administrativo permite alterar porta COM sem travas.<br />
<br />
## Diagnóstico rápido de problemas<br />
<br />
### Problema: Não lê peso<br />
Possíveis causas:<br />
- Porta COM incorreta<br />
- Balança desconectada<br />
- Driver/serial indisponível no sistema operacional<br />
<br />
Ação:<br />
- Reconfigurar porta COM no painel administrativo<br />
- Testar cabo/conexão física<br />
- Confirmar disponibilidade da porta no Windows<br />
<br />
### Problema: Bloqueio indevido de item pesado<br />
Possíveis causas:<br />
- Verificação de peso habilitada com margem muito baixa<br />
- Variação operacional normal fora da margem<br />
<br />
Ação:<br />
- Revisar parâmetros de verificação e margem<br />
- Repetir teste com item padrão conhecido<br />
<br />
### Problema: Fluxo touch com dificuldade de seleção<br />
Possíveis causas:<br />
- Escala/resolução inadequada do terminal<br />
- Ambiente sem calibração touch<br />
<br />
Ação:<br />
- Validar resolução e escala do terminal<br />
- Recalibrar touch no sistema operacional<br />
<br />
## Boas práticas para implantação<br />
- Fazer primeiro ciclo em homologação com roteiros de teste.<br />
- Registrar porta COM e margem aplicada por loja.<br />
- Treinar equipe local para:<br />
- Entrar no painel administrativo<br />
- Trocar porta COM quando necessário<br />
- Identificar quando o problema é físico (balança/cabo) versus parâmetro<br />
<br />
## Script curto para atendimento de suporte<br />
1. Confirma versão com Autoatendimento atualizado.<br />
2. Verifica se a balança está conectada e porta COM correta.<br />
3. Verifica parâmetros de validação de peso e margem.<br />
4. Executa teste guiado com item sem peso e item com peso.<br />
5. Ajusta parâmetro se necessário.<br />
6. Registra resultado do teste e configuração final.<br />
<br />
## Resultado esperado após configuração correta<br />
- Cliente opera o Autoatendimento sem intervenção constante.<br />
- Itens com pesagem são validados de forma consistente.<br />
- Painel administrativo permite ajustes rápidos em ambiente touch.<br />
- Redução de chamados por erro de seleção de porta e por configuração de validação de peso.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Auto_Atendimento&diff=2345Auto Atendimento2026-04-30T19:28:54Z<p>Vitor: Criou página com 'Teste'</p>
<hr />
<div>Teste</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=P%C3%A1gina_principal&diff=2344Página principal2026-04-30T19:28:38Z<p>Vitor: /* MasterKey PDV */</p>
<hr />
<div>==MasterKey==<br />
<br />
*[[Menu Movimentações Master Key|Movimentações]]<br />
*[[Financeiro]]<br />
*[[Cadastros Master Key|Cadastros]]<br />
*[[Relatórios]]<br />
*[[Utilitários]]<br />
*[[Configurações Master Key|Configurações / Utilitários]]<br />
**<small>[[Impressoras]]</small><br />
*[[Instalação Atualização|Instalação / Atualização]]<br />
*[[Erros Comuns e Soluções|Erros]]<br />
*[[Bandeiras]]<br />
<br />
==MasterKey PDV==<br />
<br />
*[[PDV]]<br />
*[[PAF ECF]]<br />
*<small>[[Configurações MKPDV|Configurações]]</small><br />
*[[MFE]]<br />
*[[LMC]]<br />
*[[Smart TEF]]<br />
*[[NFCe por API]]<br />
*[[Erros MKPDV|Erros]]<br />
*[[Auto Atendimento]]<br />
<br />
==Master NFe==<br />
<br />
*[[Nota Fiscal]]<br />
*[[Configurações E-mails|Configurações de E-mail]]<br />
*<small>[[Erros Master Nfe|Erros]]</small><br />
<br />
==Integrações==<br />
<br />
*[[Omie|Integra Omie]]<br />
*[[Integra Scanntech]]<br />
*[[Integração Best Way]]<br />
*[[Integração Sites|Integração Sites/eCommerce]]<br />
*[[Integração Scanntech]]<br />
*[[Integração Master Conciliador]]<br />
*[[Integração Mercado (IFood Groceries)|Integração IFood Mercado]]<br />
*[[Integração DOOCA]]<br />
*[[Integração Tray]]<br />
*[[Mercado Livre]]<br />
*[[MK Shops]]<br />
*[[Delivery|Delivery MKFood]]<br />
<br />
==Outros==<br />
<br />
*[[Updater]]<br />
*[[Master MDFe]]<br />
*[[Master CTe]]<br />
*[[Sincroniza]]<br />
*[[SincronizaDBSync|Sincroniza DBSync(NOVO)]]<br />
*[[Etiqueta]]<br />
*[[MK Mobile]]<br />
*[[MK Food]]<br />
*[[MK Backup]]<br />
*[[MKI]]<br />
*[[MKTC]]<br />
*[[MK Analytics]]<br />
*[[SiTef|Sitef]]<br />
*[[Sitef Express Parceiros|Sitef Express Parceiros(NOVO)]]<br />
*[[TI Entrego]]<br />
*[[MGV6]]<br />
*[[BALANÇA E BUSCA PREÇO|Balança e Busca Preço]]<br />
*[[Portal do Contador]]<br />
*[[Imobiliário]]<br />
*[[SEFAZ]]<br />
<br />
==Manuais==<br />
<br />
*[[Manuais do sistema]]<br />
<br />
==Instaladores e Atualizações==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Software!!Instalador!!Atualização<br />
|-<br />
|Master Key||[https://files.officesystem.com.br/instaladores/SetupMK.exe https://files.officesystem.com.br/SetupMK.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MK4.zip<br />
|-<br />
|MKPDV|| ||https://files.officesystem.com.br/atualizacoes/MKPDV.zip<br />
|-<br />
|Master Key + Master NFe||[https://files.officesystem.com.br/instaladores/SetupMKNFe.exe https://files.officesystem.com.br/SetupMKNFe.exe]<nowiki/><nowiki/>||<br />
|-<br />
|Master Nfe||[https://files.officesystem.com.br/instaladores/SetupNFe.exe https://files.officesystem.com.br/SetupNFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterNFe.zip<br />
|-<br />
|Master CT-e||[https://files.officesystem.com.br/instaladores/SetupCTe.exe https://files.officesystem.com.br/SetupCTe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterCTe.zip<br />
|-<br />
|Master MDF-e||[https://files.officesystem.com.br/instaladores/SetupMDFe.exe https://files.officesystem.com.br/SetupMDFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterMDFe.zip<br />
|-<br />
|Master Frota||[https://files.officesystem.com.br/instaladores/SetupFrota.exe https://files.officesystem.com.br/SetupFrota.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MKF.zip<br />
|-<br />
|MKI|| ||https://files.officesystem.com.br/atualizacoes/MKI.zip<br />
|-<br />
|Mobile||Https://files.officesystem.com.br/instaladores/SetupMKMobile.exe <nowiki/>||<br />
|-<br />
|MKTC<br />
|[https://files.officesystem.com.br/atualizacoes/MKTC.zip https://files.officesystem.com.br/atualizacoes/M]<nowiki/>[https://files.officesystem.com.br/atualizacoes/MKTC.zip KTC.zip]<br />
|<br />
|-<br />
|Portal do Contador<br />
|[https://files.officesystem.com.br/instaladores/SetupOfficeSystemService.exe https://files.officesystem.com.br/SetupOfficeSystemService.exe]<br />
|<br />
|-<br />
|MK + NFE+OMIE<br />
|[https://files.officesystem.com.br/instaladores/SetupMKNFeOmie.exe https://files.officesystem.com.br/SetupMKNFeOmie.exe]<br />
|<br />
|-<br />
|LINK<br />
|https://files.officesystem.com.br/instaladores/<br />
|<br />
|}<br />
<br />
==Contribuidores Mais Ativos==<br />
{{Special:ContributionScores/10/365}}</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2307Conciliação de cartões2025-10-23T19:04:42Z<p>Vitor: </p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41), os arquivos tem as seguintes extensões: .BJR76, .BJR06.<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2306Conciliação de cartões2025-10-23T18:57:47Z<p>Vitor: </p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41) e arquivo com a extensão .BJR76.<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2288Conciliação de cartões2025-08-14T19:13:50Z<p>Vitor: /* Tipos de arquivos aceitos para importação */</p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVCA1). (Arquivo com informações por posição, sem caracteres para separação, semelhante aos arquivos de retorno de bancos)<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2287Conciliação de cartões2025-07-23T20:24:40Z<p>Vitor: /* Tipos de arquivos aceitos para importação */</p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41). (Arquivo com informações por posição, sem caracteres para separação, semelhante aos arquivos de retorno de bancos)<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.<br />
*'''GetNet''', arquivo no formato CSV, que contém os seguintes campos: EC CENTRALIZADOR, ESTABELECIMENTO COMERCIAL, CPF / CNPJ, DATA DE VENCIMENTO, BANDEIRA / MODALIDADE, TIPO DE LANÇAMENTO, LANÇAMENTO, VALOR LÍQUIDO, VALOR LIQUIDADO, NÚMERO DO CARTÃO, AUTORIZAÇÃO, NÚMERO COMPROVANTE DE VENDA (NSU), TERMINAL LÓGICO, DATA DA VENDA, HORA DA VENDA, VALOR DA VENDA, PARCELAS, VALOR DA PARCELA, DESCONTOS, VALOR LIQUIDO DA PARCELA, DATA DA CONTRATAÇÃO DO CONTRATO, INSTITUIÇÃO NEGOCIADORA, CONTRATO REGISTRADORA, VALOR ATUAL DO CONTRATO, VALOR LIQUIDADO DO CONTRATO, VALOR A LIQUIDAR DO CONTRATO.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Mercado_(IFood_Groceries)&diff=2285Integração Mercado (IFood Groceries)2025-07-17T18:26:49Z<p>Vitor: </p>
<hr />
<div>O iFood Mercado é a vertical de e-commerce do iFood voltada para supermercados, farmácias, pet shops e lojas de conveniência. Lançado em 2019, o serviço permite que consumidores façam compras completas de itens de mercado diretamente pelo app do iFood, com entrega rápida e experiência integrada. Com o crescimento acelerado do setor, o iFood adquiriu a plataforma SiteMercado em 2020, fortalecendo sua presença no segmento de supermercados e expandindo sua base de parceiros no Brasil. O iFood Groceries é a plataforma de integração que permite que sistemas de terceiros (como ERPs, PDVs ou soluções próprias) se conectem ao iFood Mercado. Essa integração é feita por meio da Merchant-API, uma API modular e pública que oferece recursos para:<br />
<br />
- Gestão de produtos: atualização de preços, estoques<br />
<br />
- Recebimento de pedidos<br />
<br />
- Controle de separação de pedidos (via App Separador)<br />
<br />
Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.<br />
<br />
<br /><br />
<br />
===Liberação===<br />
<br />
*Inicialmente, o cliente deve possuir uma conta ativa no iFood com uma loja do tipo '''MERCADO''' devidamente configurada. O CNPJ da empresa deve ser repassado ao setor de programação (Office System), que será responsável por enviar um convite para esse CNPJ. Após o cliente aceitar o convite no portal do parceiro do iFood, o '''código da loja''' será liberado, devendo ser preenchido no sistema integrador para que a integração seja concluída. (https://portal.ifood.com.br/login)<br />
<br />
===Configuração do integrador===<br />
'''Campos''':<br />
<br />
*Tempo de sincronização: Recomendado deixar em 30s que é o padrão que o IFood recomenda para verificar se tem pedidos novos.<br />
*Máximo de eventos: Número máximo de registros de logs que é salvo do integrador, ao passar deste número, o sistema irá excluir os arquivos de logs antigos.<br />
*Filial: Número da filial que utilizará a integração.<br />
*Vendedor Padrão: Número do vendedor que será inserido no pedido.<br />
*Praça Padrão: Número da praça padrão para o cadastro de clientes.<br />
*Tipo de Atividade Padrão: Número do tipo de atividade para o cadastro de clientes.<br />
*Código da loja: Este código será retornado pela programação após ser o cliente aceitar o convite de parceria no portal de parceiros do IFood. (https://portal.ifood.com.br/login)<br />
*Tabelas de Preço: É possível selecionar a tabela de preço padrão de onde será obtido o valor do produto enviado ao iFood. Caso o produto não exista na tabela de preço selecionada, o valor será enviado como R$ 0,00.<br />
*Estoque Produtos > Filial Somatórios: Filiais que o sistema irá considerar para a quantidade do estoque do produto que será enviado para o IFood.<br />
<br />
<br /><br />
<br />
===O que enviamos?===<br />
'''Produtos''':<br />
<br />
*É obrigatório que cada produto tenha o '''código de barras''' preenchido, pois, ao chegar no site do iFood, alguns dados do produto são automaticamente completados. O iFood possui uma base de informações vinculadas aos códigos de barras e, com isso, realiza a atualização automática da '''imagem''' e demais dados do produto diretamente no site.<br />
*Não enviamos a imagem do produto, pois a imagem é atualizada pelo IFood automaticamente quando recebida no site.<br />
*Não é possível '''"desintegrar"''' um produto diretamente pelo nosso sistema, pois a API do iFood disponibiliza apenas a rota de '''POST''' para envio de produtos. Não fixamos um relacionamento direto entre o item do sistema e o produto no iFood, pois, ao receber um pedido, o próprio iFood retorna o '''código interno do produto''' no Master Key, permitindo identificar a qual item o pedido se refere. No entanto, '''não é possível realizar exclusões''' de produtos via integração. Caso não deseje mais enviar ou atualizar um produto, é necessário marcá-lo como '''INDISPONÍVEL''' na aba de e-commerce do cadastro do produto no '''Master Key''' e, em seguida, '''bloquear a venda''' manualmente no portal do iFood.<br />
<br />
===O que recebemos?===<br />
'''Pedidos:'''<br />
<br />
*Importamos apenas os pedidos que já foram separados pelo APP separador (com status SPE). (https://separador.ifood.com.br/).<br />
*Portanto, é de extrema importância explicar ao cliente que '''todos os procedimentos devem ser realizados primeiro no App Separador'''. Somente após o pedido ser totalmente separado no aplicativo, ele será '''importado automaticamente pelo integrador''' para o sistema.<br /><br />
<br />
<br /><br />
<br />
===Link importantes===<br />
Documentação da API: https://developer.ifood.com.br/pt-BR/docs/references/<br />
<br />
APP Separador: https://separador.ifood.com.br/<br />
<br />
Portal do Parceiro: https://portal.ifood.com.br/login</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=P%C3%A1gina_principal&diff=2280Página principal2025-06-06T14:01:27Z<p>Vitor: </p>
<hr />
<div>==MasterKey==<br />
<br />
*[[Menu Movimentações Master Key|Movimentações]]<br />
*[[Financeiro]]<br />
*[[Cadastros Master Key|Cadastros]]<br />
*[[Relatórios]]<br />
*[[Utilitários]]<br />
*[[Configurações Master Key|Configurações / Utilitários]]<br />
**<small>[[Impressoras]]</small><br />
*[[Instalação Atualização|Instalação / Atualização]]<br />
*[[Erros Comuns e Soluções|Erros]]<br />
*[[Bandeiras]]<br />
<br />
==MasterKey PDV==<br />
<br />
*[[PDV]]<br />
*[[PAF ECF]]<br />
*<small>[[Configurações MKPDV|Configurações]]</small><br />
*[[MFE]]<br />
*[[LMC]]<br />
*[[Smart TEF]]<br />
*[[NFCe por API]]<br />
*[[Erros MKPDV|Erros]]<br />
<br />
==Master NFe==<br />
<br />
*[[Nota Fiscal]]<br />
*[[Configurações E-mails|Configurações de E-mail]]<br />
*<small>[[Erros Master Nfe|Erros]]</small><br />
<br />
==Integrações==<br />
<br />
*[[Omie|Integra Omie]]<br />
*[[Integra Scanntech]]<br />
*[[Integração Best Way]]<br />
*[[Integração Sites|Integração Sites/eCommerce]]<br />
*[[Integração Scanntech]]<br />
*[[Integração Master Conciliador]]<br />
*[[Integração Mercado (IFood Groceries)|Integração IFood Mercado]]<br />
*[[Integração DOOCA]]<br />
*[[Integração Tray]]<br />
*[[Mercado Livre]]<br />
*[[MK Shops]]<br />
*[[Delivery|Delivery MKFood]]<br />
<br />
==Outros==<br />
<br />
*[[Updater]]<br />
*[[Master MDFe]]<br />
*[[Master CTe]]<br />
*[[Sincroniza]]<br />
*[[SincronizaDBSync|Sincroniza DBSync(NOVO)]]<br />
*[[Etiqueta]]<br />
*[[MK Mobile]]<br />
*[[MK Food]]<br />
*[[MK Backup]]<br />
*[[MKI]]<br />
*[[MKTC]]<br />
*[[MK Analytics]]<br />
*[[SiTef|Sitef]]<br />
*[[Sitef Express Parceiros|Sitef Express Parceiros(NOVO)]]<br />
*[[TI Entrego]]<br />
*[[MGV6]]<br />
*[[BALANÇA E BUSCA PREÇO|Balança e Busca Preço]]<br />
*[[Portal do Contador]]<br />
*[[Imobiliário]]<br />
*[[SEFAZ]]<br />
<br />
==Manuais==<br />
<br />
*[[Manuais do sistema]]<br />
<br />
==Instaladores e Atualizações==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Software!!Instalador!!Atualização<br />
|-<br />
|Master Key||[https://files.officesystem.com.br/instaladores/SetupMK.exe https://files.officesystem.com.br/SetupMK.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MK4.zip<br />
|-<br />
|MKPDV|| ||https://files.officesystem.com.br/atualizacoes/MKPDV.zip<br />
|-<br />
|Master Key + Master NFe||[https://files.officesystem.com.br/instaladores/SetupMKNFe.exe https://files.officesystem.com.br/SetupMKNFe.exe]<nowiki/><nowiki/>||<br />
|-<br />
|Master Nfe||[https://files.officesystem.com.br/instaladores/SetupNFe.exe https://files.officesystem.com.br/SetupNFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterNFe.zip<br />
|-<br />
|Master CT-e||[https://files.officesystem.com.br/instaladores/SetupCTe.exe https://files.officesystem.com.br/SetupCTe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterCTe.zip<br />
|-<br />
|Master MDF-e||[https://files.officesystem.com.br/instaladores/SetupMDFe.exe https://files.officesystem.com.br/SetupMDFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterMDFe.zip<br />
|-<br />
|Master Frota||[https://files.officesystem.com.br/instaladores/SetupFrota.exe https://files.officesystem.com.br/SetupFrota.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MKF.zip<br />
|-<br />
|MKI|| ||https://files.officesystem.com.br/atualizacoes/MKI.zip<br />
|-<br />
|Mobile||Https://files.officesystem.com.br/instaladores/SetupMKMobile.exe <nowiki/>||<br />
|-<br />
|MKTC<br />
|[https://files.officesystem.com.br/atualizacoes/MKTC.zip https://files.officesystem.com.br/atualizacoes/M]<nowiki/>[https://files.officesystem.com.br/atualizacoes/MKTC.zip KTC.zip]<br />
|<br />
|-<br />
|Portal do Contador<br />
|[https://files.officesystem.com.br/instaladores/SetupOfficeSystemService.exe https://files.officesystem.com.br/SetupOfficeSystemService.exe]<br />
|<br />
|-<br />
|MK + NFE+OMIE<br />
|[https://files.officesystem.com.br/instaladores/SetupMKNFeOmie.exe https://files.officesystem.com.br/SetupMKNFeOmie.exe]<br />
|<br />
|-<br />
|LINK<br />
|https://files.officesystem.com.br/instaladores/<br />
|<br />
|}<br />
<br />
==Contribuidores Mais Ativos==<br />
{{Special:ContributionScores/10/365}}</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Mercado_(IFood_Groceries)&diff=2279Integração Mercado (IFood Groceries)2025-06-06T13:49:10Z<p>Vitor: </p>
<hr />
<div>O iFood Mercado é a vertical de e-commerce do iFood voltada para supermercados, farmácias, pet shops e lojas de conveniência. Lançado em 2019, o serviço permite que consumidores façam compras completas de itens de mercado diretamente pelo app do iFood, com entrega rápida e experiência integrada. Com o crescimento acelerado do setor, o iFood adquiriu a plataforma SiteMercado em 2020, fortalecendo sua presença no segmento de supermercados e expandindo sua base de parceiros no Brasil. O iFood Groceries é a plataforma de integração que permite que sistemas de terceiros (como ERPs, PDVs ou soluções próprias) se conectem ao iFood Mercado. Essa integração é feita por meio da Merchant-API, uma API modular e pública que oferece recursos para:<br />
<br />
- Gestão de produtos: atualização de preços, estoques<br />
<br />
- Recebimento de pedidos<br />
<br />
- Controle de separação de pedidos (via App Separador)<br />
<br />
Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.<br />
<br />
<br /><br />
<br />
===Liberação===<br />
<br />
*Inicialmente, o cliente deve possuir uma conta ativa no iFood com uma loja do tipo '''MERCADO''' devidamente configurada. O CNPJ da empresa deve ser repassado ao setor de programação (Office System), que será responsável por enviar um convite para esse CNPJ. Após o cliente aceitar o convite no portal do parceiro do iFood, o '''código da loja''' será liberado, devendo ser preenchido no sistema integrador para que a integração seja concluída. (https://portal.ifood.com.br/login)<br />
<br />
===Configuração do integrador===<br />
'''Campos''':<br />
<br />
*Tempo de sincronização: Recomendado deixar em 30s que é o padrão que o IFood recomenda para verificar se tem pedidos novos.<br />
*Máximo de eventos: Número máximo de registros de logs que é salvo do integrador, ao passar deste número, o sistema irá excluir os arquivos de logs antigos.<br />
*Filial: Número da filial que utilizará a integração.<br />
*Vendedor Padrão: Número do vendedor que será inserido no pedido.<br />
*Praça Padrão: Número da praça padrão para o cadastro de clientes.<br />
*Tipo de Atividade Padrão: Número do tipo de atividade para o cadastro de clientes.<br />
*Código da loja: Este código será retornado pela programação após ser o cliente aceitar o convite de parceria no portal de parceiros do IFood. (https://portal.ifood.com.br/login)<br />
*Estoque Produtos > Filial Somatórios: Filiais que o sistema irá considerar para a quantidade do estoque do produto que será enviado para o IFood.<br />
<br />
<br /><br />
<br />
===O que enviamos?===<br />
'''Produtos''':<br />
<br />
*É obrigatório que cada produto tenha o '''código de barras''' preenchido, pois, ao chegar no site do iFood, alguns dados do produto são automaticamente completados. O iFood possui uma base de informações vinculadas aos códigos de barras e, com isso, realiza a atualização automática da '''imagem''' e demais dados do produto diretamente no site.<br />
*Não enviamos a imagem do produto, pois a imagem é atualizada pelo IFood automaticamente quando recebida no site.<br />
*Não é possível '''"desintegrar"''' um produto diretamente pelo nosso sistema, pois a API do iFood disponibiliza apenas a rota de '''POST''' para envio de produtos. Não fixamos um relacionamento direto entre o item do sistema e o produto no iFood, pois, ao receber um pedido, o próprio iFood retorna o '''código interno do produto''' no Master Key, permitindo identificar a qual item o pedido se refere. No entanto, '''não é possível realizar exclusões''' de produtos via integração. Caso não deseje mais enviar ou atualizar um produto, é necessário marcá-lo como '''INDISPONÍVEL''' na aba de e-commerce do cadastro do produto no '''Master Key''' e, em seguida, '''bloquear a venda''' manualmente no portal do iFood.<br />
<br />
===O que recebemos?===<br />
'''Pedidos:'''<br />
<br />
*Importamos apenas os pedidos que já foram separados pelo APP separador (com status SPE). (https://separador.ifood.com.br/).<br />
*Portanto, é de extrema importância explicar ao cliente que '''todos os procedimentos devem ser realizados primeiro no App Separador'''. Somente após o pedido ser totalmente separado no aplicativo, ele será '''importado automaticamente pelo integrador''' para o sistema.<br /><br />
<br />
<br /><br />
<br />
=== Link importantes ===<br />
Documentação da API: https://developer.ifood.com.br/pt-BR/docs/references/<br />
<br />
APP Separador: https://separador.ifood.com.br/<br />
<br />
Portal do Parceiro: https://portal.ifood.com.br/login</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Mercado_(IFood_Groceries)&diff=2278Integração Mercado (IFood Groceries)2025-06-06T13:44:57Z<p>Vitor: </p>
<hr />
<div>O iFood Mercado é a vertical de e-commerce do iFood voltada para supermercados, farmácias, pet shops e lojas de conveniência. Lançado em 2019, o serviço permite que consumidores façam compras completas de itens de mercado diretamente pelo app do iFood, com entrega rápida e experiência integrada. Com o crescimento acelerado do setor, o iFood adquiriu a plataforma SiteMercado em 2020, fortalecendo sua presença no segmento de supermercados e expandindo sua base de parceiros no Brasil. O iFood Groceries é a plataforma de integração que permite que sistemas de terceiros (como ERPs, PDVs ou soluções próprias) se conectem ao iFood Mercado. Essa integração é feita por meio da Merchant-API, uma API modular e pública que oferece recursos para:<br />
<br />
- Gestão de produtos: atualização de preços, estoques<br />
<br />
- Recebimento de pedidos<br />
<br />
- Controle de separação de pedidos (via App Separador)<br />
<br />
Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.<br />
<br />
<br /><br />
<br />
=== Liberação ===<br />
<br />
* Inicialmente, o cliente deve possuir uma conta ativa no iFood com uma loja do tipo '''MERCADO''' devidamente configurada. O CNPJ da empresa deve ser repassado ao setor de programação (Office System), que será responsável por enviar um convite para esse CNPJ. Após o cliente aceitar o convite no portal do parceiro do iFood, o '''código da loja''' será liberado, devendo ser preenchido no sistema integrador para que a integração seja concluída. (https://portal.ifood.com.br/login)<br />
<br />
=== Configuração do integrador ===<br />
'''Campos''':<br />
<br />
* Tempo de sincronização: Recomendado deixar em 30s que é o padrão que o IFood recomenda para verificar se tem pedidos novos.<br />
* Máximo de eventos: Número máximo de registros de logs que é salvo do integrador, ao passar deste número, o sistema irá excluir os arquivos de logs antigos.<br />
* Filial: Número da filial que utilizará a integração.<br />
* Vendedor Padrão: Número do vendedor que será inserido no pedido.<br />
* Praça Padrão: Número da praça padrão para o cadastro de clientes.<br />
* Tipo de Atividade Padrão: Número do tipo de atividade para o cadastro de clientes.<br />
* Código da loja: Este código será retornado pela programação após ser o cliente aceitar o convite de parceria no portal de parceiros do IFood. (https://portal.ifood.com.br/login)<br />
* Estoque Produtos > Filial Somatórios: Filiais que o sistema irá considerar para a quantidade do estoque do produto que será enviado para o IFood.<br />
<br />
<br /><br />
<br />
=== O que enviamos? ===<br />
'''Produtos''':<br />
<br />
* É obrigatório que cada produto tenha o '''código de barras''' preenchido, pois, ao chegar no site do iFood, alguns dados do produto são automaticamente completados. O iFood possui uma base de informações vinculadas aos códigos de barras e, com isso, realiza a atualização automática da '''imagem''' e demais dados do produto diretamente no site.<br />
* Não enviamos a imagem do produto, pois a imagem é atualizada pelo IFood automaticamente quando recebida no site.<br />
* Não é possível '''"desintegrar"''' um produto diretamente pelo nosso sistema, pois a API do iFood disponibiliza apenas a rota de '''POST''' para envio de produtos. Não fixamos um relacionamento direto entre o item do sistema e o produto no iFood, pois, ao receber um pedido, o próprio iFood retorna o '''código interno do produto''' no Master Key, permitindo identificar a qual item o pedido se refere. No entanto, '''não é possível realizar exclusões''' de produtos via integração. Caso não deseje mais enviar ou atualizar um produto, é necessário marcá-lo como '''INDISPONÍVEL''' na aba de e-commerce do cadastro do produto no '''Master Key''' e, em seguida, '''bloquear a venda''' manualmente no portal do iFood.<br />
<br />
=== O que recebemos? ===<br />
'''Pedidos:'''<br />
<br />
* Importamos apenas os pedidos que já foram separados pelo APP separador (com status SPE). (https://separador.ifood.com.br/).<br />
* Portanto, é de extrema importância explicar ao cliente que '''todos os procedimentos devem ser realizados primeiro no App Separador'''. Somente após o pedido ser totalmente separado no aplicativo, ele será '''importado automaticamente pelo integrador''' para o sistema.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Mercado_(IFood_Groceries)&diff=2277Integração Mercado (IFood Groceries)2025-06-06T11:38:59Z<p>Vitor: </p>
<hr />
<div>O iFood Mercado é a vertical de e-commerce do iFood voltada para supermercados, farmácias, pet shops e lojas de conveniência. Lançado em 2019, o serviço permite que consumidores façam compras completas de itens de mercado diretamente pelo app do iFood, com entrega rápida e experiência integrada .<br />
<br />
Com o crescimento acelerado do setor, o iFood adquiriu a plataforma SiteMercado em 2020, fortalecendo sua presença no segmento de supermercados e expandindo sua base de parceiros no Brasil <br />
<br />
O iFood Groceries é a plataforma de integração que permite que sistemas de terceiros (como ERPs, PDVs ou soluções próprias) se conectem ao iFood Mercado. Essa integração é feita por meio da Merchant-API, uma API modular e pública que oferece recursos para:<br />
<br />
- Gestão de produtos: atualização de preços, estoques<br />
- Recebimento de pedidos<br />
- Controle de separação de pedidos (via App Separador)<br />
<br />
Essa API unifica os modelos de integração anteriores e é compatível com as plataformas iFood Marketplace, iFood Shop e soluções White Label.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Mercado_(IFood_Groceries)&diff=2276Integração Mercado (IFood Groceries)2025-06-06T11:25:27Z<p>Vitor: Criou página com 'Teste'</p>
<hr />
<div>Teste</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=P%C3%A1gina_principal&diff=2275Página principal2025-06-06T11:24:22Z<p>Vitor: </p>
<hr />
<div>==MasterKey==<br />
<br />
*[[Menu Movimentações Master Key|Movimentações]]<br />
*[[Financeiro]]<br />
*[[Cadastros Master Key|Cadastros]]<br />
*[[Relatórios]]<br />
*[[Utilitários]]<br />
*[[Configurações Master Key|Configurações / Utilitários]]<br />
**<small>[[Impressoras]]</small><br />
*[[Instalação Atualização|Instalação / Atualização]]<br />
*[[Erros Comuns e Soluções|Erros]]<br />
*[[Bandeiras]]<br />
<br />
==MasterKey PDV==<br />
<br />
*[[PDV]]<br />
*[[PAF ECF]]<br />
*<small>[[Configurações MKPDV|Configurações]]</small><br />
*[[MFE]]<br />
*[[LMC]]<br />
*[[Smart TEF]]<br />
*[[NFCe por API]]<br />
*[[Erros MKPDV|Erros]]<br />
<br />
==Master NFe==<br />
<br />
*[[Nota Fiscal]]<br />
*[[Configurações E-mails|Configurações de E-mail]]<br />
*<small>[[Erros Master Nfe|Erros]]</small><br />
<br />
==Integrações==<br />
<br />
*[[Omie|Integra Omie]]<br />
*[[Integra Scanntech]]<br />
*[[Integração Best Way]]<br />
*[[Integração Sites|Integração Sites/eCommerce]]<br />
*[[Integração Scanntech]]<br />
*[[Integração Master Conciliador]]<br />
*[[Integração Mercado (IFood Groceries)|Integração Site Mercado]]<br />
*[[Integração DOOCA]]<br />
*[[Integração Tray]]<br />
*[[Mercado Livre]]<br />
*[[MK Shops]]<br />
*[[Delivery|Delivery MKFood]]<br />
<br />
==Outros==<br />
<br />
*[[Updater]]<br />
*[[Master MDFe]]<br />
*[[Master CTe]]<br />
*[[Sincroniza]]<br />
*[[SincronizaDBSync|Sincroniza DBSync(NOVO)]]<br />
*[[Etiqueta]]<br />
*[[MK Mobile]]<br />
*[[MK Food]]<br />
*[[MK Backup]]<br />
*[[MKI]]<br />
*[[MKTC]]<br />
*[[MK Analytics]]<br />
*[[SiTef|Sitef]]<br />
*[[Sitef Express Parceiros|Sitef Express Parceiros(NOVO)]]<br />
*[[TI Entrego]]<br />
*[[MGV6]]<br />
*[[BALANÇA E BUSCA PREÇO|Balança e Busca Preço]]<br />
*[[Portal do Contador]]<br />
*[[Imobiliário]]<br />
*[[SEFAZ]]<br />
<br />
==Manuais==<br />
<br />
*[[Manuais do sistema]]<br />
<br />
==Instaladores e Atualizações==<br />
<br />
{| class="wikitable"<br />
|-<br />
!Software!!Instalador!!Atualização<br />
|-<br />
|Master Key||[https://files.officesystem.com.br/instaladores/SetupMK.exe https://files.officesystem.com.br/SetupMK.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MK4.zip<br />
|-<br />
|MKPDV|| ||https://files.officesystem.com.br/atualizacoes/MKPDV.zip<br />
|-<br />
|Master Key + Master NFe||[https://files.officesystem.com.br/instaladores/SetupMKNFe.exe https://files.officesystem.com.br/SetupMKNFe.exe]<nowiki/><nowiki/>||<br />
|-<br />
|Master Nfe||[https://files.officesystem.com.br/instaladores/SetupNFe.exe https://files.officesystem.com.br/SetupNFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterNFe.zip<br />
|-<br />
|Master CT-e||[https://files.officesystem.com.br/instaladores/SetupCTe.exe https://files.officesystem.com.br/SetupCTe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterCTe.zip<br />
|-<br />
|Master MDF-e||[https://files.officesystem.com.br/instaladores/SetupMDFe.exe https://files.officesystem.com.br/SetupMDFe.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MasterMDFe.zip<br />
|-<br />
|Master Frota||[https://files.officesystem.com.br/instaladores/SetupFrota.exe https://files.officesystem.com.br/SetupFrota.exe]<nowiki/><nowiki/>||https://files.officesystem.com.br/atualizacoes/MKF.zip<br />
|-<br />
|MKI|| ||https://files.officesystem.com.br/atualizacoes/MKI.zip<br />
|-<br />
|Mobile||Https://files.officesystem.com.br/instaladores/SetupMKMobile.exe <nowiki/>||<br />
|-<br />
|MKTC<br />
|[https://files.officesystem.com.br/atualizacoes/MKTC.zip https://files.officesystem.com.br/atualizacoes/M]<nowiki/>[https://files.officesystem.com.br/atualizacoes/MKTC.zip KTC.zip]<br />
|<br />
|-<br />
|Portal do Contador<br />
|[https://files.officesystem.com.br/instaladores/SetupOfficeSystemService.exe https://files.officesystem.com.br/SetupOfficeSystemService.exe]<br />
|<br />
|-<br />
|MK + NFE+OMIE<br />
|[https://files.officesystem.com.br/instaladores/SetupMKNFeOmie.exe https://files.officesystem.com.br/SetupMKNFeOmie.exe]<br />
|<br />
|-<br />
|LINK<br />
|https://files.officesystem.com.br/instaladores/<br />
|<br />
|}<br />
<br />
==Contribuidores Mais Ativos==<br />
{{Special:ContributionScores/10/365}}</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2263Integração Site Mercado2025-04-28T18:23:38Z<p>Vitor: /* Como Funciona a Integração dos produtos? */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Observações:<br />
<br />
- Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
<br />
- Os produtos que forem enviados sem código de barras, não aparecerão no cadastro de produtos do site.<br /><br />
<br />
===Como Funciona a Integração dos pedidos?===</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Concilia%C3%A7%C3%A3o_de_cart%C3%B5es&diff=2262Conciliação de cartões2025-04-16T12:56:34Z<p>Vitor: </p>
<hr />
<div>A conciliação de cartões serve para garantir que os valores das vendas feitas com cartões de crédito e débito estão sendo corretamente recebidos pelo estabelecimento. Esse processo é fundamental para que as empresas possam verificar se os valores pagos pelas operadoras de cartões (bandeiras) correspondem aos valores efetivamente vendidos, de acordo com as taxas e prazos combinados.<br />
<br />
<br />
Desta forma, no Master Key 4, conseguimos importar um arquivo fornecido pela administradora de cartões com essa informação. Assim, podemos relacioná-lo ao NSU salvo da transação dentro do sistema e quitar as contas em aberto das transações, registrando o movimento bancário no sistema.<br />
<br />
<br /><br />
<br />
===Tipos de arquivos aceitos para importação===<br />
<br />
*'''Cielo'''<br />
*'''Vero,''' arquivo "Previsão de Crédito" dos tipos (BJRVCC1 ou BJRVC41). (Arquivo com informações por posição, sem caracteres para separação, semelhante aos arquivos de retorno de bancos)<br />
*'''Sicredi (Fiserv),''' arquivo "Movimento Financeiro" no formato JSON.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2256Integração Site Mercado2025-03-31T13:40:07Z<p>Vitor: /* Como Funciona a Integração dos Pedidos? */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Observações:<br />
<br />
- Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2255Integração Site Mercado2025-03-31T13:40:00Z<p>Vitor: /* Como Funciona a Integração dos produtos? */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Observações:<br />
<br />
- Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2254Integração Site Mercado2025-03-31T13:39:23Z<p>Vitor: </p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Observações:<br />
<br />
- Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
O sistema ERP no nosso caso MK4 (Master Key 4), possui os itens cadastrado, ele faz a integração com o sistema IntegraSiteMercado e após ele envia as informações para a plataforma SiteMercado(IFood).<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2253Integração Site Mercado2025-03-31T13:38:04Z<p>Vitor: /* Como Funciona a Integração dos Pedidos? */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Após, você precisa verificar se o produto possui ESTOQUE positivo.<br />
<br />
#Abra o cadastro do produto.<br />
#selecione a aba ESTOQUE.<br />
#e verifique o campo SALDO ATUAL.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site do produto.<br />
<br />
O sistema ERP no nosso caso MK4 (Master Key 4), possui os itens cadastrado, ele faz a integração com o sistema IntegraSiteMercado e após ele envia as informações para a plataforma SiteMercado(IFood).<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida.</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2252Integração Site Mercado2025-03-31T13:37:56Z<p>Vitor: /* Como Funciona a Integração dos produtos? */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Após, você precisa verificar se o produto possui ESTOQUE positivo.<br />
<br />
#Abra o cadastro do produto.<br />
#selecione a aba ESTOQUE.<br />
#e verifique o campo SALDO ATUAL.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site do produto.<br />
<br />
O sistema ERP no nosso caso MK4 (Master Key 4), possui os itens cadastrado, ele faz a integração com o sistema IntegraSiteMercado e após ele envia as informações para a plataforma SiteMercado(IFood).<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida. Como o Exemplo Abaixo.<br />
[[Arquivo:IntegraçãoSiteMercadoPedidos.jpg|borda|centro|miniaturadaimagem|635x635px]]</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2251Integração Site Mercado2025-03-31T13:37:30Z<p>Vitor: /* Instalações: */</p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Após, você precisa verificar se o produto possui ESTOQUE positivo.<br />
<br />
#Abra o cadastro do produto.<br />
#selecione a aba ESTOQUE.<br />
#e verifique o campo SALDO ATUAL.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site do produto.<br />
<br />
O sistema ERP no nosso caso MK4 (Master Key 4), possui os itens cadastrado, ele faz a integração com o sistema IntegraSiteMercado e após ele envia as informações para a plataforma SiteMercado(IFood). Como o Exemplo abaixo.<br />
[[Arquivo:IntegraçãoProdutoSiteMercado.jpg|borda|centro|miniaturadaimagem]]<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida. Como o Exemplo Abaixo.<br />
[[Arquivo:IntegraçãoSiteMercadoPedidos.jpg|borda|centro|miniaturadaimagem|635x635px]]</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Integra%C3%A7%C3%A3o_Site_Mercado&diff=2250Integração Site Mercado2025-03-31T13:37:10Z<p>Vitor: </p>
<hr />
<div>==Introdução:==<br />
Nessa pagina você ira conseguir Instalar, configurar e entender um pouco mais sobre a integração Site Mercado (IFood).<br />
<br />
===Oque é o Site Mercado?===<br />
É um MarketPlace de supermercados, que permite as pessoas realizarem suas compras de forma 100% online. É uma espécie de iFood destinado às compras de supermercado.<br />
<br />
As pessoas entram pelo site ou pelo app, escolhem um estabelecimento e realizam todas suas comprar por lá.<br />
<br />
===Quem está por traz do Site Mercado?===<br />
O SiteMercado hoje é uma empresa do Grupo IFood.<br />
<br />
==Instalações:==<br />
- Primeiros passos para fazer a instalação do SiteMercado é verificar se o sistema está em uma versão mais atual, ou fazer a atualização do sistema por esse Link [ [[Instalação Atualização]] ].<br />
<br />
===Instalação do IntegraSiteMercado===<br />
<br />
#Baixe o IntegraSiteMercado no seguinte link https://files.officesystem.com.br/atualizacoes/IntegraSiteMercado.zip<br />
#Extraia ele dentro da pasta MK4 (Por padrão C:\Sistema\MK4\ ).<br />
#Após, execute o Integrador.<br /><br />
<br />
<br /><br />
<br />
==Configurações:==<br />
<br />
===Configuração do IntegraSiteMercado:===<br />
- Passo a passo de como fazer a configuração do SiteMercado.<br />
<br />
#Abra o IntegraSiteMercado (Encontra-se por padrão em C:\Sistema\MK4\ ).<br />
#Após o sistema está aberto, Entre na opção Configurações.<br />
#*Por Padrão o sistema é configurado dessa forma.<br />
#**Tempo para Exportar = 600Seg<br />
#**Máximo de Eventos = 500<br />
#**Filial = 1<br />
#**Vendedor Padrão = 1<br />
#**Praça Padrão = 1<br />
#**Tipo de Atividade Padrão = 1<br />
#**Client ID = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Client Secret = <u>Esse ID o SiteMercado Envia por e-mail quando é feito a liberação.</u><br />
#**Authorization Code = <u>Após preencher o ID e o Secret e realizar a primeira sincronização, você será redirecionado para o site do iFood para fazer login e conceder permissão ao integrador. Ao aceitar, um código será gerado, e este é o código que precisa ser preenchido neste campo.</u><br />
#**Estoque<br />
#***Filial Somatórias = Selecione a opção 1 (ou equivalente a empresa)<br />
#*Click em SALVAR.<br />
<br />
<br /><br />
<br />
===Configuração para sincronizar os Produtos:===<br />
- Para sincronizar os produtos do MK4 (Master Key 4) para o SiteMercado siga esses passos.<br />
<br />
*Como selecionar o status disponível.<br />
<br />
#Abra o sistema MK4<br />
#Vá para Cadastros > Produtos > Cadastramento<br />
#Procure e abra o cadastro do produto que você precisa enviar para o SiteMercado.<br />
#Click em "Dados para E-commerce" (Fica abaixo da imagem do produto.)<br />
#Após, em STATUS, Selecione a opção "Disponível".<br />
#Depois é só fechar o tela que salva a configuração.<br />
<br />
Após, você precisa verificar se o produto possui ESTOQUE positivo.<br />
<br />
#Abra o cadastro do produto.<br />
#selecione a aba ESTOQUE.<br />
#e verifique o campo SALDO ATUAL.<br />
<br />
==Funcionamento:==<br />
<br />
===Como Funciona a Integração dos produtos?===<br />
Para colocar imagens nos produtos, o cliente precisa colocar diretamente no site do produto.<br />
<br />
O sistema ERP no nosso caso MK4 (Master Key 4), possui os itens cadastrado, ele faz a integração com o sistema IntegraSiteMercado e após ele envia as informações para a plataforma SiteMercado(IFood). Como o Exemplo abaixo.<br />
[[Arquivo:IntegraçãoProdutoSiteMercado.jpg|borda|centro|miniaturadaimagem]]<br />
<br /><br />
<br />
===Como Funciona a Integração dos Pedidos?===<br />
A integração de Pedidos é utilizada quando o sistema parceiro deseja possuir integração com seu sistema emissor de cupom/nota fiscal. Através desta integração, é possível que o integrador SMI crie um arquivo (ou insira em uma tabela de banco de dados) com os dados do pedido para que o PDV/Emissor fiscal consuma as informações do pedido e gere o documento fiscal de forma mais rápida. Como o Exemplo Abaixo.<br />
[[Arquivo:IntegraçãoSiteMercadoPedidos.jpg|borda|centro|miniaturadaimagem|635x635px]]</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=DAYCOVAL&diff=2233DAYCOVAL2025-02-13T21:01:53Z<p>Vitor: </p>
<hr />
<div> <br />
===Cadastro de Bancos:===<br />
====Nro do Banco:====<br />
707<br />
<br />
====Nome do Banco==== <br />
DAYCOVAL<br />
<br />
====Agência:====<br />
XXXX-X (Agencia 4 dígitos + DV) <br />
====Código Cedente:====<br />
Aqui neste campo precisa ser preenchido a conta corrente.<br />
<br />
Exemplo:<br />
<br />
XXXXXXX-X (7 dígitos + DV)<br />
<br />
====Cód. Ocorrência:====<br />
01 – Remessa<br />
<br />
====Espécie/Tipo Doc:====<br />
01 – Duplicata<br />
<br />
====Código de operação:====<br />
Preencher com o código de operação recebido pelo email do pessoal do banco (Esse número faz parte do controle para impressão do boleto / código de barras)<br />
'''Convênio:'''<br />
Código de 16 digitos<br />
<br />
====Instruções de Protesto:====<br />
09 – Protestar<br />
<br />
<br /><br />
====Observações====<br />
- Este banco não utiliza a sequencia de NSA cobrança.<br />
- Juros de Mora deve ser encaminhado por e-mail ao gerente Daycoval para cadastro fixo em sistema (Juros a.m.), não preencher no Master Key.<br />
- É recomendado que seja gerado apenas um arquivo de remessa por dia, caso queira gerar mais, é sempre necessário aumentar um no ultimo digito do nome do arquivo, exemplo: DAY12021 --> DAY12022 --> DAY12023.<br />
- Prazo para protesto deve ser encaminhado ao gerente Daycoval para cadastro fixo em sistema, não preencher no Master Key.<br />
<br />
Email para homologação: layout.validacao@bancodaycoval.com.br<br />
<br /><br />
<br />
==Configurador de Documentos:==<br />
<br />
====Espécie Doc:====<br />
DM<br />
====Espécie:====<br />
DM<br />
====Carteira:====<br />
Código de 3 dígitos recebido pelo banco<br />
====Aceite:====<br />
N<br />
====Moeda:====<br />
R$<br />
====Local de pagamento:====<br />
Pagável em qualquer rede bancária, mesmo após o vencimento</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=DAYCOVAL&diff=2232DAYCOVAL2025-02-13T19:20:19Z<p>Vitor: Criou página com ' ===Cadastro de Bancos:=== ====Nro do Banco:==== 748-X<br /> ====Nome do Banco==== Bansicredi<br /> ====Agência:==== XXXXXX (Agencia 4 dígitos + Posto Avançado 2 dí...'</p>
<hr />
<div> <br />
===Cadastro de Bancos:===<br />
====Nro do Banco:====<br />
748-X<br /><br />
<br />
====Nome do Banco==== <br />
Bansicredi<br /><br />
<br />
====Agência:====<br />
XXXXXX (Agencia 4 dígitos + Posto Avançado 2 dígitos) <br />
(Lajeado Centro - 017906 / Lajeado São CRI - 017909 / Lajeado Florestal - 017914 / Estrela 011908 / Univates - 017912 / Arroio do Meio – 013671 / Teutônia - 011910)<br /><br />
<br />
====Código Cedente:====<br />
XXXXX (Contas Antigas é a Conta Corrente sem o digito verificador) (No bloqueto vai ficar assim: ‘0179.15.00000’)<br /><br />
<br />
====Cód. Ocorrência:====<br />
01 – Inclusão de Títulos<br /><br />
<br />
====Espécie/Tipo Doc:====<br />
A – Duplicata Mercantil<br /><br />
<br />
====Instruções de Protesto:====<br />
00 – Não protestar automaticamente <br />
06 – Protestar automaticamente Nro de Dias para protesto: XX no mínimo 03 (Quando 03 ou 04 dias o sistema comandará protesto em dias úteis após o vencimento. Quando preenchido acima de 04 dias, o sistema comandará protesto em dias corridos após o vencimento)<br /><br />
<br />
'''Instruções de Negativação:''' (Posição 193 a 194 do Manual)<br />
00 – Não negativar automaticamente <br />
06 – Negativar Automaticamente <br />
Dias para Negativação valor minimo 3 (posição 195 a 196)<br />
<br />
====Observações====<br />
No MK4 cadastrar a conta corrente: XXXXXX (5 dígitos + DV) Agência XXXX <br />
Validação: Enviar arquivos por email para o gerente da conta. Alguns fazem a validação outros pedem que façamos elas pelo site.<br />
Link: https://www.sicredi.com.br/cobranca-validacao/<br />
<br />
Usuario e senha no OfficeCT/Office Atendimentos<br />
<br />
<br />
<br /><br />
<br />
==Configurador de Documentos:==<br />
<br />
====Local do Pagamento:====<br />
PAGÁVEL PREFERENCIALMENTE NAS COOPERATIVAS DE CREDITO DO SICREDI<br />
<br />
====Espécie / Espécie Doc:====<br />
DM<br />
====Carteira:====<br />
Não vai nada<br />
====Aceite:====<br />
N ou NÃO<br />
====Moeda:====<br />
R$</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Bandeiras&diff=2188Bandeiras2024-11-12T14:56:00Z<p>Vitor: </p>
<hr />
<div>*'''Dias para vencimento''': essa configuração permite controlar a data em que a parcela da transação de cartão será incluída nas contas a receber. Para entender melhor como essa configuração funciona de acordo com o tipo de transação, consulte o diagrama abaixo.<br />
<br />
[[Arquivo:Lançamento financeiro cartão - MKey e MKPDV.png|borda|centro|900x900px]]<br />
<br /></div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Arquivo:Lan%C3%A7amento_financeiro_cart%C3%A3o_-_MKey_e_MKPDV.png&diff=2187Arquivo:Lançamento financeiro cartão - MKey e MKPDV.png2024-11-12T14:54:50Z<p>Vitor: </p>
<hr />
<div>Diagrama de atividades data de vencimento parcelas TEF</div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Bandeiras&diff=2186Bandeiras2024-11-12T14:52:19Z<p>Vitor: Criou página com '* '''Dias para vencimento''': essa configuração permite controlar a data em que a parcela da transação de cartão será incluída nas contas a receber. Para entender melho...'</p>
<hr />
<div>* '''Dias para vencimento''': essa configuração permite controlar a data em que a parcela da transação de cartão será incluída nas contas a receber. Para entender melhor como essa configuração funciona de acordo com o tipo de transação, consulte o diagrama abaixo.<br />
<br />
[[Arquivo:Lançamento financeiro cartão.png|centro|miniaturadaimagem]]<br />
<br /></div>Vitorhttps://wiki.officesystem.com.br/index.php?title=Arquivo:Lan%C3%A7amento_financeiro_cart%C3%A3o.png&diff=2185Arquivo:Lançamento financeiro cartão.png2024-11-12T14:51:57Z<p>Vitor: </p>
<hr />
<div>Diagrama de atividade que explica um pouco sobre o lançamento financeiro de uma transação de cartão no MKey e no PDV</div>Vitor