Documentação de Release/2025/VERSÃO 5.2.10.30

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.

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.

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

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:

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.

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.

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”.

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:

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

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

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.

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”. 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.

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”

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