Administrator: Criou página com '=== 1. Integração Interplayers Pfizer - Habilitação da Integração === ==== 1.1 Finalidade ==== Desenvolver integração para recepção de pedidos a serem aprovados e recebidos pela plataforma de pedidos da Interplayers-Pfizer. ==== 1.2 Adição da nova INtegração na Configuração de Parâmetro - Gerenciamento ==== Para habilitar, foi adicionada na tela de Integrações > Gerenciamento, da Configuração de Parâmetros a opção com o nome Interplayers ''API''...'

2025-12-02T14:06:42Z

Criou página com '=== 1. Integração Interplayers Pfizer - Habilitação da Integração === ==== 1.1 Finalidade ==== Desenvolver integração para recepção de pedidos a serem aprovados e recebidos pela plataforma de pedidos da Interplayers-Pfizer. ==== 1.2 Adição da nova INtegração na Configuração de Parâmetro - Gerenciamento ==== Para habilitar, foi adicionada na tela de Integrações > Gerenciamento, da Configuração de Parâmetros a opção com o nome Interplayers ''API''...'

Página nova

=== 1. Integração Interplayers Pfizer - Habilitação da Integração ===

==== 1.1 Finalidade ====
Desenvolver integração para recepção de pedidos a serem aprovados e recebidos pela plataforma de pedidos da Interplayers-Pfizer.

==== 1.2 Adição da nova INtegração na Configuração de Parâmetro - Gerenciamento ====
Para habilitar, foi adicionada na tela de Integrações > Gerenciamento, da Configuração de Parâmetros a opção com o nome Interplayers ''API''. Para que a integração fique ativa, é necessário que o campo Habilitada possua o indicador “Sim” conforme imagem ilustrativa.

[[Arquivo:5.2.10.30-1.png|1000x1000px]]

==== 1.3 Criação dos parâmetros necessários para integração ====
Quando a integração apresentada no menu anterior estiver habilitada (coluna ''habilitada = sim''), será disponibilizado o menu: Ferramentas => Configurações de Parâmetros => Integrações => Interplayers API.

[[Arquivo:5.2.10.30-2.png]]

Ao clicar nesse menu, será exibida a janela de configuração descrita abaixo:

[[Arquivo:5.2.10.30-3.png|1000x1000px]]

Na parte superior da janela o sistema apresentará os seguintes campos:

'''Empresa:''' apresenta a informação do nome da empresa presente do parâmetro.

'''CNPJ/CPF:''' apresenta a informação do CNPJ da empresa presente do parâmetro.

No grid “Configuração” da janela o sistema apresentará os seguintes campos:

'''Configuração JSON:''' armazena o JSON usado na configuração da integração.

'''Data último envio de estoque:''' campo somente leitura, utilizado para registrar a data do último envio de estoque pela API.

No grid “Informações Padrão para Pré-Pedido”, na janela, o sistema utilizará os dados definidos nesses campos como parâmetros padrão durante a aceitação dos pré-pedidos. São eles:

'''Tipo de Pedido'''

'''Vendedor'''

'''Condição de Pagamento'''

'''Forma de cobrança'''

Ainda no grid “Informações Padrão para o Pré-Pedido”, existem os '''checkboxes''' que, quando marcados, fazem com que o sistema utilize as informações diretamente do '''Cadastro do Cliente''', em vez de aplicar os valores definidos nos campos padrão para a Aceitação do Pré-Pedido. São eles:

'''Buscar Vendedor do Cadastro do Cliente'''

'''Buscar Condição de Pagamento do Cadastro do Cliente'''

'''Buscar Forma de Cobrança do Cadastro do Cliente'''

No grid “Informações Gerais da Operação”, o usuário poderá configurar informações padrões referentes ao transporte e plataforma de integração do Pré-Pedido para compor o XML da Nota Fiscal. São eles:

'''Indicador de Presença do Comprador'''

'''Indicador de Intermediador'''

'''CNPJ Intermediador da Operação'''

'''Identificação na Plataforma'''

==== 1.4 Configuração do tipo de pedido para integração ====
Foi adicionado ao tipo de pedido um campo indicador da Integração para que o usuário determine quais tipos de pedidos serão integrados, conforme imagem abaixo:

[[Arquivo:5.2.10.30-4.png]]

=== 2. Integração Interplayers Pfizer - Envio de Pedidos gerados pelo Distribuidor ===

==== 2.1 Finalidade ====
Criar dentro do Supramais opções para o envio do pedido criado pelo Distribuidor para a Integração Interplayers-Pfizer.

==== 2.2 Configuração do menu pop up na tela do pedido ====
No pedido, foi criado o menu pop-up “Integração Interplayers API”, acompanhado do sub-menu “Pfizer”, para realizar a consulta do pedido na Integração.

[[Arquivo:5.2.10.30-5.png|1000x1000px]]

Ao fazer a consulta o sistema abrirá a tela abaixo e a resposta da Integração pode indicar diferentes situações: pedido aceito, rejeitado, ou em análise.

[[Arquivo:5.2.10.30-6.png|1000x1000px]]

Na parte superior da janela teremos os seguintes campos:

'''Número:''' Campo somente leitura e será preenchido pelo sistema de forma sequencial

'''Data Emissão:''' Campo somente leitura e será preenchido pelo sistema

'''Data Programada:''' Campo somente leitura e será preenchido pelo sistema

'''Situação:''' Campo somente leitura e será preenchido pelo sistema de acordo com as seguintes opções:

– Aguardando aceitação

– Aguardando Aprovação

– Aguardando Confirmação

– Rejeitado pelo Laboratório

– Confirmação Enviada

– Confirmação Aprovada

– Nota Fiscal Enviada

– Cancelado

'''Código cliente:''' Campo somente leitura e será preenchido pelo sistema.

'''Pedido Cliente:''' Campo somente leitura e será preenchido pelo sistema.

'''Pedido Portal:''' Campo somente leitura e será preenchido pelo sistema.

'''Informação API:''' Campo somente leitura e será preenchido pelo sistema.

No grid dos produtos o sistema exibirá as seguintes colunas:

'''Item:''' Campo somente leitura e será preenchido pelo sistema.

'''Codigo:''' Campo somente leitura e será preenchido pelo sistema.

'''Nome do Produto:''' Campo somente leitura e será preenchido pelo sistema.

'''EAN:''' Campo somente leitura e será preenchido pelo sistema.

'''Qtd Env:''' Campo somente leitura e será preenchido pelo sistema.

'''Valor Unitário Env:''' Campo somente leitura e será preenchido pelo sistema.

'''Qtd lab''': Campo somente leitura e será preenchido pelo sistema.

'''% Desc Lab:''' Campo somente leitura e será preenchido pelo sistema.

'''Valor Unitário Lab:''' Campo somente leitura e será preenchido pelo sistema.

'''Qtd Confirmada:''' Este campo aceitará edição, mas somente quando a situação for Aguardando confirmação.

'''Valor Confirmado:''' Campo somente leitura e será preenchido pelo sistema.

'''Informação de Motivo de atendimento:''' Campo somente leitura e será preenchido pelo sistema, com as seguintes opções:

– Produto OK

– Problemas Cadastrais

– Falta de Limite de Crédito

– Não alcançou valor mínimo

– Layout incorreto

– Produto não cadastrado/desativado/EAN incorreto

– Falta de estoque

– Estoque insuficiente

– Cliente sem alvará/vencido

– Cliente inválido

– Produto Bloqueado

– Produto não cadastrado no projeto

– Pedido já enviado

– Cliente bloqueado

– Pedido não processado por horário ultrapassado

– Motivo não especificado

– Distribuidor Encerrou Atividade

– CD Incorreto

– Item reprovado pelo consultor

Para alterar esta informação deve ser usado o menu pop-up do item no grid “Alterar Motivo de Atendimento”.

[[Arquivo:5.2.10.30-7.png]]

Ao clicar na setinha o sistema listará todas as opções disponíveis para o usuário selecionar. Se o usuário marcar a opção “'''Replicar motivo para outros itens”''', todos os itens terão o motivo substituído.

Na parte inferior da janela serão exibidos os seguintes botões com suas finalidades:

'''Cancelar:''' Botão com ação de cancelar pedido.

'''Consultar Situação:''' Botão com ação de consultar pedido.

'''Confirmar Atendimento:''' Botão com ação de confirmar o atendimento.

==== 2.3 Envio da nota fiscal vinculada ao pedido ====
Ao emitir a nota fiscal de um pedido vinculado à integração, será realizada uma validação verificando se o pedido está com status de “Aprovação Confirmada”. Caso o status esteja diferente, o sistema exibirá a seguinte mensagem:

'''“O pedido vinculado à integração com a Pfizer não está apto para o envio da nota. Sugerimos que retorne o pedido e consulte a situação para forçar a atualização. Para que a nota seja enviada, o pedido deve estar com a situação 'Confirmação Aprovada'.”'''

Essa situação não impede a emissão da nota, somente não envia a nota para a Integração.

Para sanar tal situação foi criado na nota fiscal, a opção de “Enviar arquivo Integração => NFe Interplayers- Pfizer” no menu pop-up conforme imagem abaixo:

[[Arquivo:5.2.10.30-8.png|1000x1000px]]

'''Importante: A Interplayers informou que a Pfizer não aceitará cancelamento de nota.'''

=== 3. Integração Interplayers Pfizer - Aceitação e Envio de Pedidos gerados pela Indústria ===

==== 3.1 Finalidade ====
Criar dentro do Supramais opções para a recepção e posteriormente o envio do pedido criado pelo Laboratório para a Integração Interplayers-Pfizer.

3.2 Adição de opção no Menu Integrações para receber pré-pedidos gerado pelo laboratório.

No menu Integrações, foi adicionada a opção: Pedidos Interplayers API > Pfizer

[[Arquivo:5.2.10.30-9.png]]

Ao clicar na opção do menu o sistema SupraMais abrirá a seguinte janela:

[[Arquivo:5.2.10.30-10.png|1000x1000px]]

No cabeçalho da janela conterá campos de filtro para:

'''Código do cliente:''' Ao clicar na “mãozinha” do cliente, será aberta a tela de pesquisa do Cadastro de Clientes

'''Cliente:''' exibirá o nome do cliente selecionado na “mãozinha”.

'''Data inicial/final de emissão:''' filtram os pedidos gravados cuja data de emissão esteja dentro do período informado.

'''Data inicial/final de programação de entrega:''' filtram os pedidos gravados cuja data programada esteja dentro do período informado.

'''Localizar:''' ao clicar neste botão o sistema buscará novos pedidos na Integração.

'''Limpar:''' ao clicar neste botão o sistema limpará todos os filtros utilizados.

No Grid de Pedidos da janela o sistema exibirá as seguintes colunas:

'''Aceitar: ''' Permite ao usuário selecionar a aceitação do pedido.

'''Rejeitar:''' Permite ao usuário selecionar a rejeição do pedido.

'''Data:''' campo de somente leitura e exibe a data de emissão do pré-pedido.

'''Data Programada:''' campo de somente leitura e exibe a data programada do pré-pedido.

'''Cliente:''' exibe o nome do cliente. Caso não exista o cliente previamente cadastrado no sistema, o usuário terá duas opções no menu pop-up para selecionar o cliente do pré-pedido. São eles:

* '''Selecionar cliente''': Esta ação permite indicar o cliente cadastrado para geração do pedido.
* '''Cadastrar Cliente:''' Esta ação permite cadastrar o cliente abrindo a tela de cadastro para que o usuário proceda com o cadastro do mesmo.

[[Arquivo:5.2.10.30-11.png]]

'''CNPJ:''' campo de somente leitura e exibe o CNPJ do cliente.

'''Valor do pedido:''' exibe a soma dos itens do grid de produtos, considerando os descontos.

'''Forma de cobrança:''' exibe a forma de cobrança baseado no cadastro do cliente ou no Parâmetro, mas com opção de edição pelo usuário.

'''Condição de pagamento:''' exibe a condição de pagamento baseado no cadastro do cliente ou no Parâmetro, mas com opção de edição pelo usuário.

'''Pedido original:''' campo somente leitura e exibe o número do pedido no portal da Integração.

Ainda no Grid de Pedidos, existem alguns botões cuja finalidade será descrita abaixo:

'''Aceitar todos:''' Marca todos os check box da coluna “Aceitar” e desmarca todos check box da coluna “Rejeitar”.

'''Rejeitar todos:''' Marca todos os check box da coluna “Rejeitar” e desmarca todos check box da coluna “Aceitar”.

'''Desmarcar Pedidos:''' Limpa todos os check boxes.

No Grid de Produtos da janela o sistema exibirá as seguintes colunas:

'''Item:''' campo somente leitura e exibe o número do item no pré-pedido.

'''Código:''' exibe o código do produto no pedido. Em caso de o produto não ser identificado na captura do pré-pedido na api, o sistema permitirá ao usuário clicar no campo e vincular o produto, pois ele pode estar cadastrado, porém não identificado com código de barras, esta vinculação deve ser através do menu pop_up “Identificar produto não localizado”.

'''Produto:''' exibe o nome do produto no pré-pedido. Em caso do produto que não foi identificado, o sistema deixará o campo em branco até que seja feita a vinculação do produto cadastrado.

'''Código de barras:''' campo somente leitura e exibe o código de barras do produto.

'''Und'''.: exibe a unidade do produto permitindo edição quando o produto não for localizado.

'''Qtd. Solicitada:''' campo somente leitura e exibe a quantidade do produto no pré-pedido.

'''Qtd. Aceitar:''' sugere a mesma quantidade da coluna Qtd. Solicitada, mas permite edição pelo usuário.

'''Desc. Lab:''' campo somente leitura e exibe o desconto no pré-pedido.

'''Qtd Lab:''' campo somente leitura e exibe a quantidade no pré-pedido.

'''Vlr Unitário:''' campo somente leitura e exibe o valor unitário do produto no pré-pedido.

'''Vlr Unitário final:''' campo somente leitura e exibe o valor unitário do produto subtraindo o desconto no pré-pedido.

'''Valor Total:''' campo somente leitura e o sistema exibirá o resultado da coluna valor unitário final multiplicado pela coluna qtd. Aceitar.

'''Motivo de atendimento:''' o campo exibirá o texto correspondente, conforme a tabela abaixo:

– Produto OK

– Problemas Cadastrais

– Falta de Limite de Crédito

– Não alcançou valor mínimo

– Layout incorreto

– Produto não cadastrado/desativado/EAN incorreto

– Falta de estoque

– Estoque insuficiente

– Cliente sem alvará/vencido

– Cliente inválido

– Produto Bloqueado

– Produto não cadastrado no projeto

– Pedido já enviado

– Cliente bloqueado

– Pedido não processado por horário ultrapassado

– Motivo não especificado

– Distribuidor Encerrou Atividade

– CD Incorreto

– Item reprovado pelo consultor

Para alterar esta informação deve ser usado o menu pop-up do item no grid “Alterar Motivo de Atendimento”.
[[Arquivo:5.2.10.30-7.png]]
Ao clicar na setinha o sistema listará todas as opções disponíveis para o usuário selecionar. Se o usuário marcar a opção “'''Replicar motivo para outros itens”''', todos os itens terão o motivo substituído.

Os botões da Barra Inferior, tem como finalidade gravar as alterações e/ou fechar a tela, mas para isso o sistema fará validações antes de processar as alterações, conforme descrito abaixo:

'''Processar:''' Ao clicar neste botão o sistema fará as seguintes validações:

- O campo Qtd. Aceitar deve estar preenchido, ou seja, quantidade diferente de zero (0).

- Se a Qtd. Aceitar for menor que o valor do campo Qtd. Lab o motivo de atendimento deve ser diferente de “Produto OK”.

- Se o cliente não foi identificado no pedido, e caso não exista o vínculo, o sistema bloqueará a aceitação do pré-pedido.

- Pedidos só podem ser aceitos se TODOS os itens e o cliente estiverem identificados.

- Pedidos incompletos podem apenas ser rejeitados.

'''Fechar:''' Ao clicar neste botão o sistema fechará a janela de Aceitação de pré-pedido.

Com todas as validações corretas, o sistema fará a geração do pedido dos pré-pedidos aceitos, validando os campos Vendedor e Tipo de Pedido configurados no Cadastro do Cliente ou no Parâmetro e enviará à Integração a confirmação do pedido.

O envio da Nota Fiscal será feito baseado no tópico 2.3 deste manual.

=== 4. Integração Interplayers Pfizer - Envio da Ordem de Compra ===

==== 4.1 Finalidade ====
Desenvolver opções para o envio de ordens de compras a serem aprovados pela plataforma da Interplayers, para a indústria Pfizer.

===== 4.2 Tipo de Ordem de Compra para envio =====
Foi adicionado na tela do Tipo de ordem de compra que se encontra no caminho Tabelas => Compras=> Tipo de Ordem de Compra um indicador da integração, conforme imagem abaixo. O ''checkbox'' aparecerá somente quando a integração estiver habilitada.

[[Arquivo:5.2.10.30-13.png]]

4.3 Adição do Menu pop-up na tela da Ordem de Compra

Na Ordem de Compra, foi adicionado o menu pop-up '''“Integração Interplayers API => Pfizer”'''

[[Arquivo:5.2.10.30-14.png|1000x1000px]]

Este menu pop -up somente aparecerá quando o tipo de ordem tiver a marcação da integração e funcionará somente com a Ordem de compra já gravada.

Na parte superior da janela teremos os seguintes campos:

'''Número:''' Campo somente leitura e será preenchido pelo sistema de forma sequencial.

'''Data Emissão:''' Campo somente leitura e será preenchido pelo sistema.

'''Data Programada:''' Campo somente leitura e será preenchido pelo sistema.

'''Situação:''' Campo somente leitura e será preenchido pelo sistema de acordo com as seguintes opções:

– Aguardando aprovação

– Ordem de compra aprovada

'''Código cliente:''' Campo somente leitura e será preenchido pelo sistema.

'''Pedido Cliente:''' Campo somente leitura e será preenchido pelo sistema.

'''Pedido Portal:''' Campo somente leitura e será preenchido pelo sistema.

'''Informação API:''' Campo somente leitura e será preenchido pelo sistema.

No grid dos produtos o sistema exibirá as seguintes colunas:

'''Item:''' Campo somente leitura e será preenchido pelo sistema.

'''Codigo:''' Campo somente leitura e será preenchido pelo sistema.

'''Nome do Produto:''' Campo somente leitura e será preenchido pelo sistema.

'''EAN:''' Campo somente leitura e será preenchido pelo sistema.

'''Qtd Env:''' Campo somente leitura e será preenchido pelo sistema.

'''Valor Unitário Env:''' Campo somente leitura e será preenchido pelo sistema.

'''Qtd lab''': Campo somente leitura e será preenchido pelo sistema.

'''% Desc Lab:''' Campo somente leitura e será preenchido pelo sistema.

'''Valor Unitário Lab:''' Campo somente leitura e será preenchido pelo sistema.

'''Valor Confirmado:''' Campo somente leitura e será preenchido pelo sistema.

Na parte inferior da janela será exibido o botão de '''“Consultar Situação”''' que tem como funcionalidade consultar e atualizar sempre a situação da ordem de compra no portal, isto é necessário porque nem sempre a ordem de compra é aceita imediatamente, existem ordens de compra que caem para análise humana e depende da intervenção da Pfizer para serem aprovadas.

Documentação de Release/2025/VERSÃO 5.2.10.30 - Histórico de revisão