01. DADOS GERAIS
| Produto: | | Solucoes_totvs |
|---|
| Solucao | TOTVS Distribuição e Varejo |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| 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.
| Totvs custom tabs box |
|---|
| tabs | Saiba como Utilizar |
|---|
| ids | 1 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | Saiba como Utilizar |
|---|
| 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: |
|
...
- Não enviar pedidos de órgão público, fazendo o uso dos campos correspondentes da PCCLIENTE
- Não enviar notas consignadas, validando o CONDVENDA que não deve ser igual a 20
- Opção de não pedidos de transferência, validando o CONDVENDA que não deve ser igual a 10
* Padronizar com o canal autorizador
- Enviar as vendas feitas pela rotina 2344 (Quando realmente a venda é efetivada para o cliente que compra consignado)
- Somente alterar o pedido de venda consignada na 2316 enquanto estiver com o status de erro de autorização
- Não permitir Faturar o pedido enquanto o mesmo não é autorizado pela indústria
...
| | Tabela de Alterações |
Data | Versão | Descrição |
02/04/2025 | v.1.0 | Criação do documento |
| | |
...
- Atualizar Objetos de Banco de Dados (Rotina 814) a partir da versão 37.0:
- Tabela PCLAYOUTINTEGRAVERSOPERLOG
- Tabela PCPEDC
- Package PKG_GRAVACAO_PEDIDO_MED
- Package PKG_FATURAMENTO
- Atualizar Serviço (Rotina 801) a partir da versão 37.0: Serviço winhtor-logistic-operator
- Atualizar as rotinas a partir da versão 37.0:
- 2302 – Importação/Exportação OL
- 2316 – Digitar Pedido de Venda
- 2344 – Devolver Venda Consignada
...
- Acessar na Rotina 2302 o cadastro de layout customizado de API.
 Image Modified
 Image Modified
 Image Modified
Configurar os quatro novos campos
|
|
...
:
 Image Modified |
|
...
...
Ignorar geração de pré-pedidos |
|
...
...
...
...
Ignorar geração de pré-pedidos para venda consignada- Por padrão é gerado pré-pedido de venda consignada (TV20).
 Image Modified
 Image Modified
- Com a nova parametrização será ignorada a geração do pré-pedido
 Image Modified
 Image Modified
|
|
...
...
Ignorar geração de pré-pedidos para transferência- Por padrão é gerado pré-pedido de transferência (TV10).
 Image Modified
 Image Modified
- Com a nova parametrização será ignorada a geração do pré-pedido
 Image Modified
 Image Modified
|
|
...
...
Gerar Pré-Pedido a partir do pedido de venda de devolução simbólica Image Modified
- 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.
 Image Modified
|
|
...
...
Marcação de Devolução Simbólica- Selecionar a opção Devolução Simbólica
|
|
...
-
 Image Added
Inclusão do Produto e trava do faturamento automático- Incluir o produto
 Image Modified
- 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.
 Image Modified
|
|
...
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!"
 Image Modified
|
|
...
...
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".
 Image Modified
 Image Modified
- O Preço e desconto aplicado na requisição da API será da PCPEDI
 Image Modified
- A partir desse momento o Pré-Pedido fica disponível para envio para a Indústria pela API.
 Image Modified
 Image Modified
|
|
...
 Image Added
|
|
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.
 Image Modified
 Image Modified
|
|
...
...
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:
 Image Modified
- 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)
 Image Modified
- Clicar em "Solicitar nova autorização" sobre o Pré-Pedido que não foi autorizado.
 Image Modified
 Image Modified
|
|
...
...
Autorização de um Pedido pela Indústria- Faço uma nova devolução simbólica:
 Image Modified
 Image Modified
- Consultar o Status do Pré-Pedido:
 Image Modified
 Image Modified
- Pré-Pedido disponível na API para transmissão
 Image Modified
- Quando um dos status retornado pela API da Indústria estiver contido num destes valores definidos no layout, o pedido é considerado autorizado.
 Image Modified
 Image Modified - Consulto novamente o Status do Pré-Pedido:
 Image Modified
|
|
...
...
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: Image Modified
 Image Modified
|
|
...
...
Bloquear a Edição do Pedido na 2316:- Na tela de pesquisa de pedidos para edição:
 Image Modified
Na tela de Pedidos e Contas a Receber:
 Image Modified
|
|
...
...
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:
 Image Modified
- 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
 Image Modified
 Image Modified
 Image Modified
 Image Modified
|
|
...
...
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.
 Image Modified
 Image Modified
|
|
...
...
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.
 Image Modified
|
|
...
...
Desbloqueio do Faturamento na autorização da indústria- Ao receber a autorização da indústria, é realizado o desbloqueio do faturamento.
 Image Modified
Após a execução da requisição
 Image Modified
- Após o desbloqueio é permitido o faturamento
|
|
...
 Image Modified Mantenha o WinThor Atualizado, assim você proporciona o crescimento da sua empresa através de soluções criadas especialmente para o seu negócio!
 Image Modified
|
|
...
05. ASSUNTOS RELACIONADOS |
