Objetivo
Transformar um pedido de venda pago em requisição de produção no sistema de produção, gerando a REQ que será usada em todas as etapas seguintes (conferência, triagem, manipulação, conferências). Este é o ponto onde o mundo comercial (pedido de venda) encontra o mundo técnico (pedido de produção).
Este documento cobre dois momentos distintos: (1) a criação do PV e definição do tipo de envio, que varia conforme a origem da prescrição; e (2) a geração da REQ após pagamento, que é o mesmo para todos os tipos.
Posição no fluxo do ERP
- Etapa de entrada do PV: Criado — etapa 1 (a criação do PV e tipo de envio acontecem aqui)
- Etapa de entrada da REQ: Pago — etapa 4. O pagamento foi confirmado pelo webhook. É neste momento que o ERP calcula a previsão de produção.
- Etapa de saída: Aguardando impressão — etapa 5. O Atendente atribuiu a REQ e sinalizou que o pedido está pronto para produção.
- Padrão de avanço: Manual por pedido. O Atendente decide avançar após criar a REQ e atribuí-la.
Este é o ponto de cristalização dos dados: a partir de Ag. Impressão, os rótulos serão gerados com base nos dados consolidados entre OCR, Pedido e REQ. Qualquer erro precisa ser corrigido ANTES desta transição.
Quando acontece
Diariamente, para cada pedido que recebe confirmação de pagamento. O Atendente monitora os pedidos em status Pago e processa cada um.
Criação do PV e tipo de envio — varia conforme a origem
O PV nasce de formas diferentes dependendo de como a prescrição chega. O tipo de envio é definido já na criação do PV, porque ele determina o cálculo de previsão de produção que acontecerá no momento do Pago. Ver Cálculo automático da data de previsão de produção para as regras de cálculo.
Executivo com retirada de receita
Quando a Neofarma precisa retirar a receita física (ex: receita controle especial que precisa ser recolhida):
- Atendente identifica necessidade de retirada → cria PV com tipo de envio “retirada”
- PV entra no romaneio de retiradas — filtrado por data de previsão de produção. Regra da retirada: pediu hoje → data de amanhã
- Retirada acontece → receita física chega à Neofarma
- Atendente muda tipo de envio para o definitivo (12h, 15h, 17h ou 19h) e anexa a receita (OCR)
- Atendente coloca produtos no PV com base na receita
- Atendente libera para pagamento → pagamento → previsão de produção é calculada com o tipo de envio definitivo
- Segue fluxo normal de geração de REQ (Fases 1-3 abaixo)
O ponto chave: o PV nasce antes da receita chegar, justamente para organizar a retirada. A previsão de produção real só é calculada depois, quando o tipo de envio muda para o definitivo e o pedido é pago.
Executivo com receita digital (foto/PDF)
Fluxo mais direto — a receita já chegou (foto ou PDF por WhatsApp, email, plataforma):
- Receita chega → Atendente cria PV, já anexa a receita (OCR), já coloca os produtos, e define tipo de envio definitivo (12h, 15h, 17h, 19h, ou esporádico)
- Define destinatário e frete → avança para Orçado → cliente recebe link de checkout
- Libera para pagamento → pagamento → previsão de produção calculada
- Segue fluxo normal de geração de REQ (Fases 1-3 abaixo)
Consultivo
No consultivo, a receita é gerada pela própria Neofarma. O PV nasce com os dados do contexto, não da receita:
- Atendente coloca: cliente, prescritor, paciente, destinatário no PV
- Atendente gera a receita (prescrição consultiva) → profissional assina
- Com a receita assinada, Atendente define tipo de envio definitivo e produtos
- Libera para pagamento → pagamento → previsão de produção calculada
- Segue fluxo normal de geração de REQ (Fases 1-3 abaixo)
Ver ciclo-pedido-consultivo para o processo completo de geração da prescrição consultiva.
Urgência (sem pagamento)
Quando um pedido é urgente e não pode esperar o gateway de pagamento, o fluxo muda — a Gerente de Atendimento assume:
- Atendente cria PV e REQ normalmente (tipo de envio, produtos, receita)
- Gerente de Atendimento analisa PV e REQ, confirma que o pedido está correto
- Gerente marca prioridade no PV → previsão vira hoje
- Gerente registra Pago manualmente — meio de pagamento: “crédito cliente” (sem webhook)
- Segue fluxo normal de Fases 1-3 abaixo
Ver Fluxo de urgência (pedido sem pagamento) para o detalhamento completo e as regras de autonomia.
Resumo: o que cada tipo traz ao PV antes do pagamento
| Tipo | Quando o PV nasce | Quando a receita é anexada | Quando o tipo de envio é definitivo | Quem registra Pago |
|---|---|---|---|---|
| Executivo retirada | Na necessidade de retirada | Depois da retirada | Depois da retirada (antes era “retirada”) | Gateway (webhook) |
| Executivo digital | Na chegada da receita | Na criação do PV | Na criação do PV | Gateway (webhook) |
| Consultivo | Na demanda do profissional | Depois da assinatura | Depois da assinatura | Gateway (webhook) |
| Urgência | Na demanda urgente | Conforme tipo (digital/consultivo) | Conforme tipo | Gerente de Atendimento (manual, crédito cliente) |
Registro de entrega especial (flag por produto, envio 19h)
Pedidos com tipo de envio 19h podem conter produtos que exigem registro de entrega — uma guia de transporte gerada pelo sistema. Quem cria o PV e REQ é responsável por sinalizar no produto do PV que aquele produto é especial.
- Quando marcar: O produto exige guia de transporte especial (regulatório, tipo de ativo, condição de transporte)
- Onde marcar: No produto dentro do PV — flag “registro de entrega” no campo do item
- O que acontece depois: O sistema gera automaticamente a guia de transporte quando o flag existe. O Setor de Impressão imprime o registro de entrega junto com todos os outros documentos do PV (ver Documentos disponíveis no PV após Ag. Impressão). Na Conferência 2, o Conferente verifica se o registro de entrega está no pacote impresso — se não estiver (fallback), imprime neste ponto
- Responsabilidade: Quem cria o PV (Atendente ou Gerente de Atendimento) é responsável por marcar o flag. Se não marcar, a guia não existe em nenhum lugar — o produto segue sem ela
⚠️ Este flag é por produto (não por pedido) — num mesmo pedido 19h, pode haver produtos com e sem registro de entrega especial.
Geração da REQ (após Pago)
A partir daqui, o fluxo é idêntico para todos os tipos de pedido (executivo retirada, executivo digital, consultivo). O PV está pago, a previsão de produção foi calculada, e a Atendente gera a REQ.
Fase 1 — Criar pedido de produção no sistema
O Atendente acessa o sistema de produção e cria um pedido de produção a partir dos dados do pedido de venda. Nesta fase, além dos dados do pedido, a Atendente define a data e hora de retirada — que será a data operacional da produção e o critério de priorização.
- Quem executa: Atendente
- O que faz (físico): Acessa o sistema de produção, insere os dados do pedido (composição, volume, paciente, prescritor para cada produto). Define a data de retirada e a hora de retirada para o pedido de produção.
- O que muda (ERP de produção): Pedido de produção criado. Sistema gera a REQ — número de 6 dígitos (ex: 204583). Cada produto do pedido recebe uma série sequencial dentro da REQ (ex: 204583-1, 204583-2, 204583-3). A série é o identificador único do produto dentro da REQ e será usado em todas as etapas seguintes para rastrear cada item individualmente. A data e hora de retirada ficam registradas em todos os dígitos da REQ.
- Entregável: REQ gerada com número atribuído, séries por produto, e data/hora de retirada definidas.
Regras para definir data de retirada
A Atendente consulta a data de previsão de produção no PV (calculada automaticamente a partir do status Pago) e define a data de retirada no REQ. Ver regras-datas-filtros-producao para detalhamento completo.
| Cenário | Ação | Aprovação necessária |
|---|---|---|
| Retirada = Previsão | Caso padrão, nenhuma ação adicional | Não |
| Retirada > Previsão | Legítimo (cliente pediu para depois, logística) | Não |
| Retirada < Previsão | Solicitar marcação de prioridade para a gerente de atendimento | Sim — gerente marca prioridade no ERP |
Regras para definir hora de retirada
A hora codifica o tipo de envio e determina a prioridade na fila da produção. Ver Tipos de envio e a hora como critério de priorização.
| Tipo de envio | Hora no REQ | Observação |
|---|---|---|
| Regular (4 tipos) | 12:00, 15:00, 17:00 ou 19:00 | Deve ser consistente com tipo de envio do PV |
| Esporádico | hh:30 (qualquer hora com :30) | Envio fora dos 4 pacotes regulares |
| Extra 17h ou 19h | 17:30 ou 19:30 | Fora do pacote regular, diferenciado pelo :30 |
Todos os dígitos da REQ devem ter a mesma data e hora de retirada.
Fase 2 — Atribuir séries e REQ ao pedido de venda
O Atendente volta ao ERP de vendas e registra os dados da REQ no pedido de venda. Dentro do pedido em status Pago, existem campos para atribuir o número da REQ e a série correspondente a cada produto. Essa atribuição é o que conecta os dois sistemas (vendas ↔ produção) e permite a conferência cruzada posterior.
- Quem executa: Atendente
- O que faz (ERP de vendas): No pedido de venda em status Pago, preenche: (1) o campo de número da REQ, (2) o campo de série para cada produto do pedido. A série vincula cada item do pedido de venda ao produto correspondente no pedido de produção.
- Campos disponíveis na etapa Pago: Número da REQ (campo global do pedido) + série por produto (campo em cada item).
- Entregável: Pedido de venda com REQ e séries atribuídas. A partir daqui, o casamento Pedido ↔ REQ é determinístico (reqNumber + reqSerie).
Fase 3 — Avançar para Aguardando impressão
Ao avançar, o Atendente declara: “gerei a REQ, atribuí as séries, os 3 documentos estão prontos”. Este avanço dispara automaticamente a conferência automática — o agente verificador analisa todas as conformidades entre os três documentos (OCR × Pedido × REQ) e gera o JSON consolidado se aceito, ou rejeita o pedido de volta para Pago se encontrar inconsistências.
- Quem executa: Atendente
- O que muda (ERP): Status avança de Pago para Aguardando impressão. Webhook dispara conferência automática.
- Entregável: Pedido em Ag. Impressão, aguardando veredito da conferência automática.
- Se conferência aceita: JSON consolidado disponível para impressão de rótulos. Ver conferencia-automatica-ag-impressao.
- Se conferência rejeita: Pedido volta para Pago. Atendente recebe motivo detalhado e corrige antes de tentar novamente.
Resumo RACI
| Fase | R (Executa) | A (Presta contas) | C (Consulta) | I (Informado) |
|---|---|---|---|---|
| 1. Criar pedido de produção | Atendente | Atendente | — | — |
| 2. Atribuir REQ ao pedido de venda | Atendente | Atendente | — | — |
| 3. Avançar para Ag. Impressão | Atendente | Atendente | — | — |
Regras de decisão e escalação
- Dados divergentes entre pedido de venda e o que vai para produção: Se o Atendente perceber divergência ao criar a REQ (ex: composição no pedido diferente do que o OCR indica), corrigir ANTES de avançar. Após Ag. Impressão, os dados cristalizam no rótulo.
- Pedido com produtos de diferentes complexidades: Todos os produtos do pedido entram na mesma REQ. Os dígitos sequenciais identificam cada produto.
- Pedido pago mas com pendência comercial (endereço, observação): Resolver a pendência antes de gerar REQ. Não avançar com dados incompletos.
Exceções conhecidas
- Pedido parcialmente pago: Não gerar REQ até pagamento integral, salvo autorização explícita.
- Pedido que precisa ser corrigido após pagamento: Se dados do OCR, Pedido ou REQ precisam de ajuste, corrigir nos três documentos antes de avançar.
- Urgência sem pagamento: Gerente de Atendimento analisa PV+REQ, marca prioridade, registra Pago manual (crédito cliente). Ver seção “Urgência” acima e Fluxo de urgência (pedido sem pagamento).
- Registro de entrega especial (19h): Quem cria o PV marca o flag “registro de entrega” nos produtos que exigem guia de transporte. Flag é por produto. Sistema gera a guia automaticamente (botão do avião). Setor de Impressão imprime como regra; Conferência 2 é fallback (só imprime se não veio no pacote).
Detalhes de sistema
Mecanismos automáticos que operam neste processo. Referência completa em referencia-sistema-erp.
Numeração da REQ: O sistema de produção gera automaticamente um número de 6 dígitos (ex: 204583). Cada produto do pedido recebe uma série sequencial (204583-1, 204583-2). A série é o identificador único do produto em todas as etapas seguintes.
Campos disponíveis na etapa Pago: Dentro do pedido em status Pago no ERP de vendas, existem campos para atribuir o número da REQ (campo global do pedido) e a série correspondente a cada produto (campo no item). Essa atribuição é o que conecta os dois sistemas (vendas ↔ produção) — o casamento passa a ser determinístico por reqNumber + reqSerie.
Cálculo automático de previsão: A previsão de produção é calculada pelo ERP no instante do status Pago (webhook). Variáveis: hora do pagamento (corte 14h) + tipo de envio. A previsão cristaliza neste momento — mudar tipo de envio depois do Pago não recalcula. Ver Cálculo automático da data de previsão de produção.
Trava de consistência hora × tipo de envio: Ao definir a hora de retirada no REQ, o sistema trava se hora :00 for inconsistente com tipo de envio do PV (ex: hora 15:00 mas tipo 12h). Horas :30 desativam a trava (esporádicos/extras). Todos os dígitos da REQ devem ter a mesma hora e data — se diferentes, trava. Ver 10. Trava de consistência hora × tipo de envio.
Webhook de Ag. Impressão: Ao avançar de Pago para Ag. Impressão, um webhook dispara a conferência automática dos 3 documentos. Se aceito, gera JSON consolidado + PDFs dos rótulos. Se rejeitado, volta para Pago. Ver conferencia-automatica-ag-impressao.
Flag de registro de entrega: Para envios 19h, o campo “registro de entrega” no item do PV sinaliza que o sistema deve gerar guia de transporte. É por produto (não por pedido). Se não marcou, a guia não existe. Ver 9. Flag de registro de entrega (por produto).
Relação com outros processos
- Etapa dentro de: Ciclo do Pedido — Fluxo Executivo (fase 2)
- Dispara: Conferência Automática na Entrada de Ag. Impressão — webhook ao avançar para Ag. Impressão
- Alimenta: Conferência de Pedidos — a REQ é um dos três documentos conferidos
- Precede: Impressão de rótulos → Triagem técnica → Manipulação
- Regras de datas e filtros: regras-datas-filtros-producao — define como a data e hora de retirada inseridas aqui regem toda a produção
- Mapa de responsabilidades: Mapa de Responsabilidades por Etapa
- Mecanismos de sistema: referencia-sistema-erp — numeração REQ, webhook, travas, flags
- Automação: automacao-req-pad-erp — PAD que gera PDF da ficha via UI automation no ERP Delphi
- Automação: contexto-print-service-neofarma — Print Service que orquestra impressão de fita, fichas e rótulos na transição Pago → Ag. Impressão
Histórico de evolução
| Data | Mudança | Motivação |
|---|---|---|
| 2026-04-01 | Criação do documento. Processo identificado como P03 na tabela de processos, formalizado a partir do contexto das etapas do ERP | Sessão de arquitetura com João — mapeamento Pago→Ag. Impressão |
| 2026-04-02 | Detalhamento da atribuição de séries (Fase 2), link para conferência automática (Fase 3), campos disponíveis na etapa Pago | Criação do processo de conferência automática — conexão entre REQ e verificação |
| 2026-04-06 | Adicionadas regras de data de retirada (previsão vs. retirada, prioridade), hora como tipo de envio (regulares + esporádico + extras :30), link para regras-datas-filtros-producao | 2026-04-06-processos-sem-regras-datas-filtros-envio |
| 2026-04-06 | Adicionados: variante de urgência (Gerente de Atendimento registra Pago manual com crédito cliente), registro de entrega especial (flag por produto em envios 19h, sistema gera guia, Conf. 2 imprime). Tabela resumo expandida com coluna “Quem registra Pago” e linha Urgência | Detalhamento com João — urgências e registro de entrega |
| 2026-04-06 | Adicionada seção “Criação do PV e tipo de envio” com 3 fluxos (executivo retirada, executivo digital, consultivo), tipo de envio “retirada” e romaneio de retiradas, regra de cálculo de previsão no momento do Pago | Sessão de detalhamento com João — fluxo PV→REQ por tipo de envio |
| 2026-04-06 | Registro de entrega corrigido: Setor de Impressão imprime como regra, Conferência 2 é fallback (só imprime se não veio no pacote). Cadeia de responsabilidade atualizada. Anchors corrigidos | Detalhamento com João — documentos do Setor de Impressão |
| 2026-04-06 | Adicionada seção “Detalhes de sistema” separando: numeração REQ, campos na etapa Pago, cálculo de previsão, trava hora×tipo, webhook Ag. Impressão, flag registro de entrega. Link para referencia-sistema-erp | Agregação de detalhes de sistema na documentação de processos |