Consolidação funcional

Projeto Alchimia

Visão integrada das funcionalidades farmacêuticas, regras operacionais, fluxos entre Balcão, PBMs, SNGPC, servidor e PDV, além dos principais impactos do projeto.

14fluxos funcionais documentados
4PBMs citadas nas especificações
Ponta a pontado atendimento à finalização da venda
Rastreáveltela, banco, API, XML e impressão
01

O que é o Projeto Alchimia

Visão consolidada a partir das demandas e documentos funcionais analisados.

O Projeto Alchimia reúne funcionalidades voltadas ao atendimento farmacêutico dentro do ecossistema Emporium. O projeto conecta a operação do Balcão Farmácia ao cadastro de clientes e medicamentos, às regras de receita e posologia, às integrações com PBMs, ao registro de medicamentos controlados no SNGPC, à geração de pedidos e à finalização da venda no PDV.
01

Atendimento orientado

Organiza a jornada do operador desde a identificação do cliente até a geração do pedido.

02

Regras farmacêuticas

Aplica informações de receita, prescritor, posologia, controle de estoque e medicamentos controlados.

03

Integração operacional

Conecta Balcão, APIs, PBMs, banco, XML, etiquetas, servidor e PDV.

02

Ecossistema envolvido

O Alchimia não atua como uma tela isolada; os dados percorrem módulos e integrações diferentes.

Balcão FarmáciaCliente, produto, convênio, receita, prescritor, posologia, autorização e geração do pedido.
→
Serviços e registrosEmporiumAPI, PBMs, banco de dados, SNGPC, arquivos de receita e XML.
→
PDV e documentosResgate da autorização, finalização, cupom, etiqueta, comprovantes e histórico.
03

Diretrizes do projeto

Princípios que devem ser preservados em todas as funcionalidades.

↔

Consistência

O mesmo dado deve permanecer coerente entre tela, banco, API, XML e impressão.

◎

Associação correta

Cliente, produto, receita, prescritor, autorização e pedido não podem ser misturados.

🔒

Segurança

Receitas e dados pessoais devem respeitar permissões na interface e no backend.

⛓

Rastreabilidade

Cada movimentação precisa ser identificável do início do atendimento à venda concluída.

✓

Validação clara

Campos inválidos ou ausentes devem bloquear o ponto correto e orientar o operador.

⟳

Preservação regressiva

Novas regras não devem alterar fluxos comuns, outras PBMs ou operações fora do escopo.

⚙

Configuração controlada

Versões, parâmetros, lojas, produtos, usuários e credenciais fazem parte da solução.

◇

Escopo formal

Regras fiscais, formatos, máscaras e layouts não definidos devem permanecer como pendências.

04

Processo geral do Alchimia

Jornada ponta a ponta, com caminhos diferentes conforme o tipo de medicamento e atendimento.

Fluxo geral de atendimento
Iniciar atendimentoAcessar o Balcão Farmácia.
→
Identificar clienteDocumento, cadastro e convênio.
→
Selecionar produtoProduto, foto, estoque e atributos.
→
Qual regra se aplica?Comum, receita, PBM ou SNGPC.
→
Preencher dadosReceita, prescritor, posologia e quantidade.
→
Gerar pedidoPedido e autorização, quando aplicável.
→
Finalizar no PDVResgate, pagamento, impressão e registros.
Caminhos possíveis: atendimento sem convênio; consulta PBM; medicamento com receita; saída SNGPC; pedido com produtos de regras diferentes.
05

Funcionalidades e fluxos intuitivos

Cada funcionalidade apresenta sua finalidade, regras documentadas e fluxo operacional.

01

Atendimento no Balcão Farmácia

Fluxo central
Cliente · Produto · Pedido

O que é

É o ponto de entrada da jornada farmacêutica. Nele são identificados o cliente, o medicamento, o tipo de atendimento e os dados necessários para gerar o pedido.

Regras principais

  • Os dados devem permanecer associados ao cliente e ao item corretos.
  • O fluxo pode seguir sem convênio, com PBM, com receita ou para registro SNGPC.
  • Alterações em um produto não podem modificar as informações de outro item.
  • O pedido só deve avançar quando as exigências aplicáveis estiverem atendidas.
Fluxo do Balcão
Abrir BalcãoInício do atendimento.
→
Informar clienteCPF/documento e convênio.
→
Pesquisar produtoSelecionar o item correto.
→
Aplicar regrasReceita, PBM, posologia ou SNGPC.
→
Revisar pedidoItens, quantidades e valores.
→
Gerar pedidoDisponibilizar para finalização.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 01: Tela de seleção de produtos e geração do pedido no Balcão Farmácia.
Imagem 1. Tela de seleção de produtos e geração do pedido no Balcão Farmácia.
Fonte visual: checklist de telas do Projeto Alchimia
02

Exibição da foto do produto

Consulta 70961
UI · Conferência visual

O que é

Apresenta a imagem do medicamento na seleção do item para apoiar a identificação visual pelo operador, tanto no atendimento sem convênio quanto no fluxo com PBM.

Regras principais

  • A foto deve corresponder exatamente ao produto selecionado.
  • Ao trocar de produto, a imagem deve ser atualizada e não manter a foto anterior.
  • A imagem deve permanecer enquadrada, legível e sem sobreposição.
  • A ausência ou falha da mídia não pode quebrar a tela nem impedir a operação.
Fluxo da imagem do produto
Pesquisar itemLocalizar o medicamento.
→
Selecionar produtoAbrir o modal do item.
→
Existe foto?Verificar mídia cadastrada.
→
Exibir imagemFoto correta e enquadrada.
→
Sem imagemManter a tela estável.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 02: Modal do produto com imagem do medicamento e opções de atendimento com ou sem convênio.
Imagem 1. Modal do produto com imagem do medicamento e opções de atendimento com ou sem convênio.
Fonte visual: checklist de telas do Projeto Alchimia
03

Digitalização de receita por produto

Consulta 72341
VidaLink · Receita

O que é

Permite anexar a receita diretamente no item quando o produto está vinculado a uma classe terapêutica configurada com exigência de prescrição.

Regras principais

  • Prescrição = Sim deve apresentar anexo, data, validade e tipo de receita.
  • Sem o arquivo obrigatório, o sistema deve impedir a inclusão do item.
  • O nome do arquivo anexado deve ficar perceptível ao operador.
  • A receita deve permanecer vinculada ao produto correto e seguir na integração aplicável.
  • A remoção do item não deve deixar dados de receita associados ao carrinho.
Fluxo da receita no item
Selecionar produtoProduto com atributos de farmácia.
→
Exige prescrição?Classe terapêutica com Prescrição = Sim.
→
Exibir camposArquivo, data, validade e tipo.
→
Anexar receitaVincular o documento ao item.
→
Dados válidos?Validar obrigatoriedade e datas.
→
Aplicar itemContinuar autorização/pré-venda.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 03: Fluxo documentado para digitalização da receita diretamente na linha do item.
Imagem 1. Fluxo documentado para digitalização da receita diretamente na linha do item.
Tela de referência da funcionalidade 03: Cadastro de classes terapêuticas com o indicador de prescrição que determina a exigência da receita.
Imagem 2. Cadastro de classes terapêuticas com o indicador de prescrição que determina a exigência da receita.
Fonte visual: checklist de telas do Projeto Alchimia
Ponto documental: formatos permitidos, tamanho máximo e tratamento de arquivo corrompido devem seguir a regra formal da funcionalidade. Não se deve generalizar a regra de uma consulta para outra.
04

Criptografia e controle de acesso à receita

Consulta 70797
Segurança · Permissão

O que é

Protege os documentos de receita armazenados e restringe a consulta ou descriptografia aos usuários autorizados.

Regras principais

  • Somente usuário autorizado pode consultar ou descriptografar o documento.
  • A permissão deve ser verificada na interface e também no backend.
  • O acesso por URL direta não pode contornar a autorização.
  • A importação prevista nessa funcionalidade aceita somente PDF.
  • Mensagens devem ser claras e não expor erro técnico bruto.
Fluxo seguro da receita
Importar PDFSelecionar documento válido.
→
Armazenar protegidoManter o conteúdo criptografado.
→
Solicitar consultaInterface ou rota do documento.
→
Tem permissão?Validar usuário no backend.
→
DescriptografarExibir somente ao autorizado.
→
Bloquear acessoInformar falta de permissão.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 04: Atributos de Farmácia utilizados para relacionar o produto à classe terapêutica.
Imagem 1. Atributos de Farmácia utilizados para relacionar o produto à classe terapêutica.
Tela de referência da funcionalidade 04: Modal do item com os campos de arquivo, data, validade e tipo da receita.
Imagem 2. Modal do item com os campos de arquivo, data, validade e tipo da receita.
Tela de referência da funcionalidade 04: Parâmetros de armazenamento e criptografia das receitas por loja.
Imagem 3. Parâmetros de armazenamento e criptografia das receitas por loja.
Tela de referência da funcionalidade 04: Diretório do servidor contendo os documentos de receita armazenados.
Imagem 4. Diretório do servidor contendo os documentos de receita armazenados.
Tela de referência da funcionalidade 04: Tela de manutenção e consulta das prescrições importadas.
Imagem 5. Tela de manutenção e consulta das prescrições importadas.
Fonte visual: checklist de telas do Projeto Alchimia
05

Cálculo da posologia e quantidade a vender

Consulta 71712
Cálculo · XML

O que é

Utiliza quantidade por caixa, consumo diário e duração do tratamento para calcular a cobertura de cada embalagem, a quantidade total necessária e o número de caixas a vender.

Regras principais

  • Entradas básicas: quantidade da caixa, posologia diária e dias de tratamento.
  • O sistema calcula dias por caixa, quantidade necessária e quantidade de venda.
  • Zero, valor negativo, texto, campo vazio ou divisão por zero devem ser bloqueados.
  • Após edição, todos os resultados derivados devem ser recalculados.
  • O XML deve receber somente os valores finais e manter os dados separados por item.
  • A quantidade calculada deve permanecer coerente no fluxo sem convênio e no fluxo PBM.
Fluxo do cálculo da posologia
Informar embalagemQuantidade de unidades por caixa.
→
Informar consumoQuantidade utilizada por dia.
→
Informar tratamentoDuração em dias.
→
Dados válidos?Bloquear valores incoerentes.
→
CalcularDias/caixa, unidades e caixas.
→
Aplicar quantidadeAtualizar a venda do item.
→
Registrar no XMLSomente os valores finais.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 05: Fluxo operacional documentado para captura e envio dos dados do Balcão.
Imagem 1. Fluxo operacional documentado para captura e envio dos dados do Balcão.
Tela de referência da funcionalidade 05: Identificação do cliente, vendedor e convênio no início do atendimento.
Imagem 2. Identificação do cliente, vendedor e convênio no início do atendimento.
Tela de referência da funcionalidade 05: Modal de cálculo da posologia com os dados de embalagem, consumo e tratamento.
Imagem 3. Modal de cálculo da posologia com os dados de embalagem, consumo e tratamento.
Tela de referência da funcionalidade 05: Resultado aplicado na grade do pedido, com quantidade e posologia relacionadas ao item.
Imagem 4. Resultado aplicado na grade do pedido, com quantidade e posologia relacionadas ao item.
Fonte visual: checklist de telas do Projeto Alchimia
Exemplo documentado: caixa com 30 unidades, consumo de 2 unidades por dia e tratamento de 30 dias resulta em 15 dias por caixa e necessidade de 2 caixas.
06

Consulta e autorização por PBM

Integrações Alchimia
API · Benefícios

O que é

Consulta benefícios, preços, descontos e condições de venda junto ao programa de benefício selecionado, gerando autorização para continuidade do pedido.

Regras principais

  • PBMs citadas: VidaLink, Funcional, Interplayers/Seven e E-Pharma.
  • Cliente, produto e credenciais precisam estar aptos à consulta.
  • Autorização, valores e descontos devem permanecer vinculados ao pedido correto.
  • Dados adicionais, como receita e posologia, não podem alterar indevidamente preço ou benefício.
  • A disponibilidade da PBM externa é uma dependência do fluxo.
Fluxo da autorização PBM
Selecionar PBMEscolher o convênio aplicável.
→
Enviar consultaCliente, produto e dados exigidos.
→
Parceiro responde?Validar retorno da API.
→
Receber benefícioPreço, desconto e condições.
→
Gerar autorizaçãoCódigo vinculado à pré-venda.
→
Gerar pedidoDisponibilizar para o PDV.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 06: Modal do produto com as opções de atendimento e seleção da PBM.
Imagem 1. Modal do produto com as opções de atendimento e seleção da PBM.
Tela de referência da funcionalidade 06: Voucher gerado com número do pedido, código de autorização PBM e promoções disponíveis.
Imagem 2. Voucher gerado com número do pedido, código de autorização PBM e promoções disponíveis.
Fonte visual: checklist de telas do Projeto Alchimia
07

Registro de medicamentos controlados no SNGPC

Registro de saídas
Paciente · Prescritor · Receita

O que é

Registra a movimentação de saída de medicamentos controlados, reunindo dados do produto, lote, paciente, prescritor, conselho, receita, quantidade e estoque.

Regras principais

  • Campos obrigatórios de paciente, médico e receita devem continuar sendo validados.
  • Produto, lote e quantidade precisam pertencer à mesma movimentação.
  • Os dados devem permanecer disponíveis para consulta, impressão e integrações previstas.
  • Uma movimentação não pode herdar informações da operação anterior.
  • Regras adicionais dependem do enquadramento e da configuração da loja.
Fluxo do Registro de Controlados
Acessar SNGPCAbrir Registrar Saídas.
→
Selecionar produtoProduto, lote e quantidade.
→
Informar pacienteDados do cliente/comprador.
→
Informar prescritorConselho, número e UF.
→
Informar receitaTipo, número, data e validade.
→
Dados completos?Validar obrigatórios e estoque.
→
Registrar saídaPersistir e gerar documentos.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 07: Fluxo da operação SNGPC, desde o acesso ao registro até a consulta da saída e geração da etiqueta.
Imagem 1. Fluxo da operação SNGPC, desde o acesso ao registro até a consulta da saída e geração da etiqueta.
Tela de referência da funcionalidade 07: Tela de registro da saída com produto, paciente, médico, conselho e dados da receita.
Imagem 2. Tela de registro da saída com produto, paciente, médico, conselho e dados da receita.
Tela de referência da funcionalidade 07: Grade de consulta de Controlados/Antimicrobianos.
Imagem 3. Grade de consulta de Controlados/Antimicrobianos.
Tela de referência da funcionalidade 07: Detalhamento da movimentação registrada, incluindo receita, lote, paciente, telefone, médico e conselho.
Imagem 4. Detalhamento da movimentação registrada, incluindo receita, lote, paciente, telefone, médico e conselho.
Fonte visual: checklist de telas do Projeto Alchimia

Informações sobre receitas registradas no checklist

O checklist reúne orientações para diferenciar os modelos de receita utilizados na operação. O conteúdo abaixo foi organizado sem substituir a regra formal de cada fluxo ou a validação regulatória aplicável.

Notificações de Receita com numeração oficial
  • O checklist informa que os modelos oficiais passaram a utilizar numeração de 14 dígitos no contexto de rastreamento pelo SNCR.
  • Notificação A (amarela): indicada no material para entorpecentes e psicotrópicos fortes.
  • Notificação B/B2 (azul): indicada para psicotrópicos e anorexígenos.
  • Notificação Especial (branca): modelos específicos numerados para substâncias controladas muito restritas.
Receita de Controle Especial - branca comum
  • Descrita como receita em duas vias para antidepressivos, ansiolíticos comuns, anticonvulsivantes e anabolizantes.
  • Não possui numeração oficial de fábrica da Anvisa.
  • Clínicas e hospitais podem utilizar código interno ou número de prontuário, sem equivalência à numeração oficial.
Receita simples - branca
  • Utilizada para medicamentos de uso cotidiano, conforme os exemplos apresentados no checklist.
  • Não possui numeração obrigatória do governo.
Receita de antimicrobiano em duas vias
  • O checklist informa que não exige número oficial de receita.
  • A primeira via é retida pela farmácia.
  • No registro interno, o campo Número da Receita pode permanecer em branco ou seguir a marcação definida pelo sistema e pela regra aprovada.
Dados obrigatórios destacados para antimicrobianos
  • Paciente: nome completo, idade e sexo.
  • Médico: nome, número do CRM, endereço do consultório e assinatura.
  • Medicamento: nome, dosagem, posologia e quantidade total.
  • Data de emissão: utilizada para a contagem do prazo de validade.
Uso contínuo ou prolongado

Conforme descrito no checklist, a receita deve indicar claramente “Uso Contínuo” ou “Uso Prolongado” e discriminar a quantidade de caixas ou frascos necessária para cada período de 30 dias.

Aplicação no sistema: o tratamento do campo Número da Receita, inclusive o uso de campo vazio ou marcação padrão, deve seguir a regra funcional formalmente aprovada para o tipo de receita.
08

Controle de estoque configurável no SNGPC

Consulta 70859
Parâmetro por loja

O que é

Permite que a loja defina se o registro da saída SNGPC deverá ou não considerar o saldo disponível em estoque como condição de gravação.

Regras principais

  • Parâmetro = Não: permitir a saída com estoque zerado, insuficiente ou negativo.
  • Parâmetro = Sim: impedir a gravação quando não houver saldo suficiente.
  • Com saldo suficiente e parâmetro Sim, a operação deve ser permitida.
  • Paciente, médico e receita continuam obrigatórios em ambas as configurações.
  • A configuração deve ser persistida e respeitada no contexto da loja.
Fluxo de decisão do estoque
Ler parâmetroControle de estoque da loja.
→
Está habilitado?Sim ou Não.
→
NãoNão bloquear por saldo.
→
SimComparar saída x estoque.
→
Saldo suficiente?Quantidade disponível atende?
→
RegistrarQuando a regra permitir.
→
BloquearQuando habilitado e insuficiente.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 08: Parâmetro de controle de estoque do Balcão Farmácia configurado por loja.
Imagem 1. Parâmetro de controle de estoque do Balcão Farmácia configurado por loja.
Tela de referência da funcionalidade 08: Tela de registro de saída submetida à regra de estoque configurada.
Imagem 2. Tela de registro de saída submetida à regra de estoque configurada.
Fonte visual: checklist de telas do Projeto Alchimia
09

Inclusão do CRM no conselho do prescritor

Consulta 71960
SNGPC · Médico

O que é

Disponibiliza a opção CRM no campo Conselho durante o preenchimento dos dados do profissional responsável pela prescrição.

Regras principais

  • A opção CRM deve estar disponível na lista de conselhos.
  • O operador deve informar o número de registro e a UF correspondente.
  • Os dados devem permanecer associados ao prescritor e à movimentação.
  • Os demais conselhos existentes não podem ser removidos ou alterados.
  • A nomenclatura deve ser padronizada em tela, banco, etiqueta e XML.
Fluxo do conselho CRM
Informar médicoPreencher dados do prescritor.
→
Abrir ConselhoConsultar opções disponíveis.
→
Selecionar CRMConselho Regional de Medicina.
→
Informar registroNúmero e UF.
→
Dados válidos?Validar preenchimento.
→
Associar à saídaPersistir na movimentação.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 09: Fluxo operacional esperado para selecionar o conselho CRM e gravar o registro.
Imagem 1. Fluxo operacional esperado para selecionar o conselho CRM e gravar o registro.
Tela de referência da funcionalidade 09: Tela de Registro de Controlados com o campo Conselho no cadastro do médico.
Imagem 2. Tela de Registro de Controlados com o campo Conselho no cadastro do médico.
Fonte visual: checklist de telas do Projeto Alchimia
Padronização: a solicitação original utilizava “CRMS”, enquanto a opção validada foi “CRM”. A documentação funcional deve adotar uma nomenclatura única e aprovada.
10

Dados complementares, etiqueta e XML SNGPC

Consulta 71983
Nascimento · Sexo · Telefone

O que é

Amplia o registro de saída com data de nascimento, sexo e telefone do cliente/comprador, refletindo os valores na etiqueta e preparando sua utilização no XML SNGPC.

Regras principais

  • Os novos dados devem ficar associados à movimentação correta.
  • A etiqueta deve apresentar os valores registrados sem troca, corte ou truncamento.
  • Devem existir áreas identificadas para assinatura do farmacêutico e do cliente.
  • Campos vazios não devem imprimir valores técnicos como null ou undefined.
  • Operações fora do escopo devem manter o comportamento anterior.
  • O XML somente pode ser validado após aprovação do layout, tags, schema e tratamento de falha.
Fluxo dos novos dados SNGPC
Registrar saídaIniciar movimentação controlada.
→
Preencher clienteNascimento, sexo e telefone.
→
Dados válidos?Aplicar regras aprovadas.
→
PersistirAssociar à movimentação.
→
Gerar etiquetaDados e áreas de assinatura.
→
Preparar XMLConforme layout aprovado.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 10: Modelo de etiqueta SNGPC com medicamento, paciente, receita, prescritor, conselho e áreas de assinatura.
Imagem 1. Modelo de etiqueta SNGPC com medicamento, paciente, receita, prescritor, conselho e áreas de assinatura.
Fonte visual: checklist de telas do Projeto Alchimia
Definições pendentes registradas: obrigatoriedade dos campos, origem dos dados, domínio de sexo, máscara do telefone, tags e schema do XML, envio automático, tratamento de falha, acionamento e layout final da etiqueta.
11

Geração e resgate do pedido no PDV

Consulta 70349
Servidor · Autorização · PDV

O que é

Conclui no PDV a pré-venda autorizada no Balcão, recuperando os itens por meio do pedido e do código de autorização da PBM.

Regras principais

  • O operador deve acessar a função da PBM correspondente.
  • O número pode ser digitado ou escaneado, conforme o fluxo disponível.
  • O PDV deve listar os itens pertencentes à venda recuperada.
  • Produtos adicionais devem ser finalizados separadamente após o pedido PBM.
  • Após a conclusão, o pedido finalizado deve ser enviado à PBM responsável.
Fluxo de resgate no PDV
Gerar pré-pedidoBalcão cria pedido e autorização.
→
Acessar PDVSelecionar a função da PBM.
→
Informar códigosPedido e autorização.
→
Resgatar itensListar produtos autorizados.
→
Há itens extras?Separar mercadorias adicionais.
→
Finalizar vendaCupom e confirmação à PBM.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 11: Tela do PDV na função de resgate de pedido, com opções de PBM e entrada do código.
Imagem 1. Tela do PDV na função de resgate de pedido, com opções de PBM e entrada do código.
Tela de referência da funcionalidade 11: Tela de pagamento no PDV após a recuperação e conclusão do pedido.
Imagem 2. Tela de pagamento no PDV após a recuperação e conclusão do pedido.
Fonte visual: checklist de telas do Projeto Alchimia
12

Histórico de compras e tratamento do cliente

Consultas 71712 / 71185
Dados consolidados

O que é

Consolida informações da venda concluída para formar o histórico do cliente, reunindo dados comerciais e farmacêuticos do atendimento.

Regras principais

  • A venda deve estar concluída e vinculada a um cliente identificado.
  • Data, quantidade e valor podem ser obtidos da NFC-e/XML.
  • Nome e princípio ativo dependem do cadastro do produto e do Alchimia.
  • Receita, CRM e dados controlados podem vir do SNGPC.
  • Posologia, quantidade calculada, uso contínuo e vendedor devem permanecer vinculados ao item.
  • Produtos diferentes no mesmo pedido não podem compartilhar dados indevidamente.
Fluxo de formação do histórico
Concluir vendaPedido finalizado no PDV.
→
Identificar clienteRelacionar a venda ao cadastro.
→
Coletar dadosNFC-e, produto, Balcão e SNGPC.
→
Associar por itemReceita, posologia e valores.
→
Dados consistentes?Comparar fontes e vínculos.
→
Disponibilizar históricoConsulta e relatório do cliente.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 12: Tela de Histórico de Cliente com filtros e registros das vendas relacionadas.
Imagem 1. Tela de Histórico de Cliente com filtros e registros das vendas relacionadas.
Fonte visual: checklist de telas do Projeto Alchimia
13

Consulta e reimpressão de pedido por CPF

Consulta 70239
Multiloja · Rastreabilidade

O que é

Localiza pedidos efetivados a partir do CPF/documento do cliente e permite reimprimir o documento correspondente, inclusive quando o pedido pertence a outra loja.

Regras principais

  • A consulta deve retornar somente pedidos ligados ao CPF informado.
  • A busca não deve ficar restrita à loja do usuário.
  • Não pode haver duplicidade inconsistente ou associação a cliente incorreto.
  • A reimpressão deve permitir relacionar CPF, cliente, pedido e itens.
  • Pedidos sem vínculo não podem aparecer como pertencentes ao cliente pesquisado.
Fluxo da reimpressão
Acessar PedidosAbrir consulta/reimpressão.
→
Informar CPFDocumento válido do cliente.
→
Pesquisar lojasConsultar pedidos efetivados.
→
Pedido pertence ao CPF?Validar vínculo e cliente.
→
Selecionar pedidoConferir dados apresentados.
→
ReimprimirDocumento rastreável.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 13: Parâmetro de layout da tela de pedido e configuração de impressão.
Imagem 1. Parâmetro de layout da tela de pedido e configuração de impressão.
Tela de referência da funcionalidade 13: Consulta de pedidos no Emporium.
Imagem 2. Consulta de pedidos no Emporium.
Tela de referência da funcionalidade 13: Documento reimpresso com dados do cliente, CPF, loja, pedido e itens.
Imagem 3. Documento reimpresso com dados do cliente, CPF, loja, pedido e itens.
Fonte visual: checklist de telas do Projeto Alchimia
14

Ofertas da loja e impressão condicionada ao CPF

Consulta 69984
Pré-venda · Compras extras

O que é

Controla a liberação da impressão do documento de autorização da pré-venda e das ofertas relacionadas às compras extras da farmácia.

Regras principais

  • Sem CPF informado, a impressão deve permanecer bloqueada.
  • Com CPF válido informado e salvo, a impressão pode ser liberada.
  • Nome, cartão convênio ou outra identificação não substituem a exigência do CPF.
  • A opção de não informar não deve contornar o bloqueio.
  • A impressão deve continuar ligada ao atendimento e ao cliente corretos.
Fluxo de liberação da impressão
Iniciar pré-vendaSelecionar item e oferta.
→
Identificar clienteAcessar Cliente & Convênio.
→
CPF informado?Validar documento salvo.
→
NãoBloquear impressão e orientar.
→
SimLiberar autorização e ofertas.

Telas e evidências visuais da funcionalidade

As imagens abaixo correspondem às telas e aos materiais de referência apresentados no checklist funcional do Projeto Alchimia.

Tela de referência da funcionalidade 14: Tela de promoções disponíveis no atendimento.
Imagem 1. Tela de promoções disponíveis no atendimento.
Tela de referência da funcionalidade 14: Pré-visualização e impressão das promoções vinculadas ao atendimento.
Imagem 2. Pré-visualização e impressão das promoções vinculadas ao atendimento.
Fonte visual: checklist de telas do Projeto Alchimia
06

Impactos do projeto

As funcionalidades alteram a operação, os dados, as integrações e a conformidade do atendimento farmacêutico.

DimensãoImpacto positivo esperadoRisco quando a regra não é preservada
OperaçãoAtendimento mais organizado, com informações reunidas no fluxo.Bloqueios indevidos, retrabalho, demora e abandono da venda.
ClienteMelhor identificação, aplicação de benefícios e continuidade do tratamento.Produto, quantidade, desconto ou histórico associados incorretamente.
EstoqueAplicação da política definida por loja para produtos controlados.Saída indevida, saldo inconsistente ou bloqueio contrário à configuração.
RegulatórioMaior rastreabilidade de paciente, prescritor, receita e movimentação.Etiqueta ou XML divergente, informação incompleta e risco de não conformidade.
SegurançaProteção de documentos e dados pessoais por perfil de acesso.Exposição de receita, acesso por URL direta ou vazamento em logs.
TecnologiaIntegração entre Balcão, APIs, PBMs, banco, servidor e PDV.Inconsistência entre versões, parâmetros, retorno externo e dados persistidos.
QualidadeConferência ponta a ponta por tela, banco, XML, etiqueta e cupom.Aprovação parcial de uma tela sem validar o resultado final da operação.
07

Restrições, dependências e cuidados

Condições que influenciam o funcionamento e a validação das funcionalidades.

V

Versões e arquivos

Moderator, EmporiumAPI, scripts, arquivos PHP/JS e parâmetros precisam estar compatíveis com a consulta implantada.

P

PBMs externas

Credenciais, produtos elegíveis, cadastros e disponibilidade dos parceiros condicionam a execução do fluxo.

D

Dados de teste

Cliente, produto, lote, estoque, prescritor, receita, loja e autorização devem estar preparados.

X

XML e regra fiscal

Tags, schema, versão, envio e tratamento de falha precisam de aprovação formal antes do aceite definitivo.

I

Impressão física

Etiqueta, cupom e autorização devem ser conferidos na impressora e mídia homologadas.

A

Alteração de escopo

Mudanças em campos, regras ou integrações exigem revisão da especificação, impacto, testes e cronograma.

Diretriz documental: este material apresenta uma visão funcional consolidada. As DEFs, guias e regras específicas de cada consulta continuam sendo a referência para implementação e aceite, especialmente quando houver diferenças entre funcionalidades.
08

Base documental consolidada

Principais consultas utilizadas para estruturar a visão do projeto e seus fluxos.

  • 69984 — Inserir ofertas / impressão condicionada ao CPF.
  • 70239 — Reimpressão de pedido por CPF.
  • 70349 — PDV consulta e resgate de PBM.
  • 70797 — Criptografia e permissão de acesso à receita.
  • 70859 — Controle de estoque no SNGPC.
  • 70961 — Exibição da foto do produto.
  • 71712 — Adaptação do fluxo do Balcão, posologia e dados para histórico.
  • 71960 — Inclusão do CRM no SNGPC.
  • 71983 — Inclusão de campos, etiqueta e XML SNGPC.
  • 72341 — Digitalização da receita por produto no fluxo VidaLink.