01. DADOS GERAIS
| Produto: | TOTVS Distribuição e Varejo |
|---|---|
| Linha de Produto: | Linha Winthor |
| Segmento: | Distribuição |
| Módulo: | 23 - Medicamentos |
| Função: | Integração API / Tratamento de Pedidos |
| País: | Brasil |
| Ticket: | NA |
| Requisito/Story/Issue: | DDVENDAS-52256 |
02. SITUAÇÃO/REQUISITO
- Aprimorar a comunicação com a API da BAYER, para garantir que apenas os pedidos e notas fiscais pertinentes ao fluxo de pré-autorização da indústria sejam enviados. Isso evita o envio de informações desnecessárias ou incorretas, como pedidos de órgãos públicos ou notas fiscais consignadas, otimizando o processo e reduzindo erros na integração.
- As necessidades de negócio incluem:
- Excluir do envio pedidos de órgão público.
- Não enviar notas fiscais consignadas (Condição de Venda 20).
- Ter a opção de não enviar pedidos de transferência (Condição de Venda 10).
- As vendas de fato efetivadas a clientes consignados, geradas pela rotina 2344, devem ser enviadas.
- Restringir a alteração de pedidos de venda consignada na rotina 2316 apenas quando houver erro de autorização.
- Bloquear o faturamento de um pedido até que a indústria o autorize.
03. SOLUÇÃO
Foram implementados controles e validações diretamente na API da BAYER e nas rotinas do Winthor para gerenciar o fluxo de pedidos e faturamento, assegurando a conformidade com os requisitos da ONCOEXO e da indústria.
As principais funcionalidades entregues são:
- Utilização de campos da tabela PCCLIENTE para identificar e não gerar pré-pedido para órgão público.
- Validação da CONDVENDA para excluir notas fiscais consignadas (20) e, opcionalmente, pedidos de transferência (10) do envio.
- Tratamento para que as vendas geradas pela rotina 2344, quando a venda é efetivada para o cliente consignado, sejam enviadas para pré-autorização.
- Bloqueio na rotina 2316 que permite a alteração de pedidos de venda consignada somente se o status for "erro de autorização".
- Integração na Rotina 2302 para configurar o layout customizado da API, incluindo a definição dos status de rejeição e autorização da indústria.
- Implementação do fluxo de pré-pedido gerado a partir da rotina 2344, gravando-o com SITUACAO "P – Pendente" nas tabelas PCPEDCOMPRAOPERLOGCAB e PCPEDCOMPRAOPERLOGITE.
- Funcionalidade na rotina 2344 (botão "Pré-Pedidos") para "Solicitar nova autorização" após correções na 2316.
- Bloqueio na rotina de Faturamento de Medicamentos que impede a geração da nota fiscal para pedidos que ainda não foram autorizados pela indústria.
- Desbloqueio automático do faturamento ao receber a autorização da indústria.
Atualize as rotinas abaixo a partir das versões indicadas ou versões superiores:
Serviço winthor-logistic-operator: Logistic_Operator - Versão: 1.37.3.3
Rotina 2344 -Devolver Venda Consignada - Versão: 37.0.1.21
Rotina 2316 - Digitar Pedido de Venda - Versão: 37.0.1.240
Rotina 2302 - Importação/Exportação OL - Versão: 37.0.1.15
Rotina 2300 - Atualizar Banco de Dados - Versão: 37.0.21.25
Para configurar e utilizar as funcionalidades implementadas nos tratamentos da API da BAYER no Winthor, siga os passos abaixo. Foco total em como aprimorar o seu fluxo de trabalho e garantir a qualidade das informações enviadas.
- Atualize o Winthor:
- Execute a Rotina 814 - Atualizador de Objeto para garantir que os Packages PKG_GRAVACAO_PEDIDO_MED, PKG_FATURAMENTO e as tabelas PCPEDC, PCPEDI, PCPEDRETORNO, PCLAYOUTINTEGRAVERSOPERLOG estejam nas versões compatíveis (a partir da 37.0).
- Atualize o Serviço winthor-logistic-operator utilizando a Rotina 801, para versões a partir da 1.37.3.2.
- Atualize as rotinas PCSIS2302, PCSIS2316, e PCSIS2344 para as versões mínimas indicadas (a partir da 37.0).
Layout Customizado de API:
- Acessar na Rotina 2302 o cadastro de layout customizado de API.
Configurar os quatro novos campos:
Ignorar geração de pré-pedidos
Ignorar geração de pré-pedidos para clientes órgão público:
- O cliente pode ser classificado na rotina 302 por órgão público municipal, estadual ou federal
- Por padrão é gerado pré-pedido de de venda para órgão público.
- Com a nova parametrização será ignorada a geração do pré-pedido
Ignorar geração de pré-pedidos para venda consignada
- Por padrão é gerado pré-pedido de venda consignada (TV20).
- Com a nova parametrização será ignorada a geração do pré-pedido
Ignorar geração de pré-pedidos para transferência
- Por padrão é gerado pré-pedido de transferência (TV10).
- Com a nova parametrização será ignorada a geração do pré-pedido
Gerar Pré-Pedido a partir do pedido de venda de devolução simbólica
- O novo processo depende da edição do pedido de devolução simbólica para correção de descontos, portando o Pedido TV20 deve ser gerado com tipo de política Promoções.
Habilitar a geração do pré-pedido na Devolução Simbólica da Rotina 2344
- Para a 2344 utilizar a nova funcionalidade de pré-pedido sem gerar impacto no processo padrão do Winthor deverá ser ativado o processo no Layout customizado.
Marcação de Devolução Simbólica
- Selecionar a opção Devolução Simbólica
Inclusão do Produto e trava do faturamento automático
- Incluir o produto
- Quando existem produtos com Integradora para pré-autorização do desconto com a indústria, a opção de faturar automaticamente é desabilitada, e se porventura tinha sido marcada, o sistema desmarca automaticamente, porque somente pode ocorrer o faturamento se a indústria autorizar o pedido.
Gravação do Pedido e mensagem de autorização pendente
- Quando for vinculada uma autorização de desconto da indústria, uma mensagem de alerta será apresentada junto à informação do pedido gerado: "Aguardando autorização da indústria para o faturamento!"
API de Pré-Pedido
Listar Pré-Pedido na API
- Após gravado o Pedido na rotina 2344, o Pré-Pedido é gravado nas tabelas PCPEDCOMPRAOPERLOGCAB e PCPEDCOMPRAOPERLOGITE com a SITUACAO "P – Pendente".
- O Preço e desconto aplicado na requisição da API será da PCPEDI
- A partir desse momento o Pré-Pedido fica disponível para envio para a Indústria pela API.
Rejeição de um Pedido pela Indústria
- Quando um dos status retornado pela API da Indústria estiver contido num destes valores definidos no layout, o pedido é considerado não autorizado.
Solicitar nova autorização
- Após a edição do pedido de venda gerado na 2344 na 2316 e ajustar o preço e/ou desconto:
- Acessar a rotina 2344 para solicitar nova autorização através do botão "Pré-Pedidos" (este botão somente estará visível se houver ao menos uma integradora do Canal Autorizador de Pré-Pedidos)
- Clicar em "Solicitar nova autorização" sobre o Pré-Pedido que não foi autorizado.
Autorização de um Pedido pela Indústria
- Faço uma nova devolução simbólica:
- Consultar o Status do Pré-Pedido:
- Pré-Pedido disponível na API para transmissão
- Quando um dos status retornado pela API da Indústria estiver contido num destes valores definidos no layout, o pedido é considerado autorizado.
- Consulto novamente o Status do Pré-Pedido:
Bloquear edição de pedidos em processo de autorização na 2316
Realizar uma devolução simbólica na 2344 com Canal Autorizador de Pré-Pedidos:
Bloquear a Edição do Pedido na 2316:
- Na tela de pesquisa de pedidos para edição:
Na tela de Pedidos e Contas a Receber:
Bloquear na gravação da Edição do Pedido na 2316 o faturamento automático do consignado
- Atualmente ao gravar a edição de um pedido de devolução simbólica, é apresentada uma pergunta para faturar o pedido:
- Se o pedido estiver com autorização pendente, não poderá faturar, portanto não apresentar essa confirmação.
Fluxo da edição sem apresentar a confirmação
Bloqueio de Faturamento de Pedidos não autorizados pela indústria na Rotina 2344
- Ao gravar um pedido de venda de devolução simbólica com necessidade de autorização da indústria, o mesmo será gravado bloqueado para faturamento.
Aplicação do Bloqueio no Faturamento Medicamentos:
- Ao tentar faturar um pedido bloqueado para o faturamento, uma exeção ocorrerá e o sistema não permitirá a geração da nota fiscal.
Desbloqueio do Faturamento na autorização da indústria
- Ao receber a autorização da indústria, é realizado o desbloqueio do faturamento.
Após a execução da requisição
- Após o desbloqueio é permitido o faturamento Mantenha o WinThor Atualizado, assim você proporciona o crescimento da sua empresa através de soluções criadas especialmente para o seu negócio!
04. DEMAIS INFORMAÇÕES
Importante
As versões estarão disponíveis para download no CCW.
https://centraldecontrole.pcinformatica.com.br/
Mantenha suas rotinas sempre atualizadas!
05. ASSUNTOS RELACIONADOS
- NA

























































