Histórico da Página
CRIAR INTEGRAÇÃO FIDELIZZE 2.2
NOME DO REQUISITO / ÉPICO
(Obrigatório)
Informações Gerais
Linha de Produto: | Informe a linha de produtoPC Sistemas | ||||||||||||
Segmento Executor: | Informe o segmentoD&L | ||||||||||||
Módulo: | Informe o móduloFarma | ||||||||||||
Rotina: |
| ||||||||||||
Chamado/Ticket: | HIS.01690.2018 | ||||||||||||
Requisito/Story/Issue: | MED-1687 | ||||||||||||
País: | ( x ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||||||||||||
Outros: | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos>. |
(Obrigatório)
Objetivo
<Nesta etapa informar o objetivo da especificação do requisito, ou seja, o que a funcionalidade deve fazer - Detalhamento do Epic. Exemplo: Permitir que o usuário defina o percentual mínimo em espécie (dinheiro), a referência mínima para cálculo dos débitos do aluno e o período de validade do parâmetro de negociação>.
(Obrigatório)
Definição da Regra de Negócio
Versão/Release: | Rotina 2300 - 28.07.26 Rotina 2302 - 28.07.15 |
Objetivo
Criar Tipo da mudança
Mudança prevista
Funcionalidade desejada:
Eu, como gestor de TI, preciso que crie a integração Fidelize2.2 com processo Wholesaler que é similar ao processo de pedidos via portal, como modo de contingência para o projeto Sanofi Hospitalar, onde o pedido será digitado no portal da Indústria e ficará disponível para o distribuidor recebe-lo via API.
Motivos da alteração:
Critérios de aceitação:
Processo Wholesaler da integração Fidelize2.2 :
- Deve documentar os APIs, as requisições poderão ser acessadas no Menu “Docs”;
- Deve gerar a requisição Orders que é uma query utilizada para verificar os pedidos disponíveis e também os
pedidos que já foram lidos, ou um pedido específico pelo código de pedido na indústria;
- Deve gerar a requisição para marcar quando o pedido já foi importado;
- Deve gerar a requisição para envio do retorno de pedido à Fidelize.
- Deve gerar a requisição para envio da nota do pedido à Fidelize.
- Deve gerar a requisição para envio do cancelamento do pedido à Fidelize.
- Deve gerar a requisição Order é uma query utilizada para consultar um pedido específico, nos status (responses, invoices, cancellations).
- Deve gerar a requisição response é uma query utilizada para consultar somente o retorno do pedido.
- Deve gerar a requisição invoices é uma query utilizada para consultar as notas/ressarcimento de um pedido.
- Deve gerar a requisição createInvoiceReversal ser informadode qual pedido será cancelada a nota, e quais são os dados da nova nota.
<Regra de negócio é o que define a forma de fazer o negócio, o processo definido e/ou as regras que devem ser contempladas. Devem ser descritas restrições, validações, condições e exceções do processo. Incluir as telas do sistema com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software. Caso necessário, incluir neste capítulo também regras de integridade que devem ser observadas no momento do desenvolvimento - É o Detalhamento das Story linkadas no Epic>.
<Na tabela abaixo informe quais são as rotinas envolvidas, o tipo de operação, a opção de menu e se necessário uma breve descrição das regras de negócio relacionadas a rotina>.
.
Definição da Regra de Negócio
- Processo Wholesaler da integração Fidelize2.2 :
- Deve documentar os APIs, as requisições poderão ser acessadas no Menu “Docs”;
- Deve gerar a requisição Orders que é uma query utilizada para verificar os pedidos disponíveis e também os pedidos que já foram lidos, ou um pedido específico pelo código de pedido na indústria;
- Deve gerar a requisição para marcar quando o pedido já foi importado;
- Deve gerar a requisição para envio do retorno de pedido à Fidelize;
- Deve gerar a requisição para envio da nota do pedido à Fidelize;
- Deve gerar a requisição para envio do cancelamento do pedido à Fidelize;
- Deve gerar a requisição Order é uma query utilizada para consultar um pedido específico, nos status (responses, invoices, cancellations);
- Deve gerar a requisição response é uma query utilizada para consultar somente o retorno do pedido;
- Deve gerar a requisição invoices é uma query utilizada para consultar as notas/ressarcimento de um pedido;
- Deve gerar a requisição createInvoiceReversal ser informadode qual pedido será cancelada a nota, e quais são os dados da nova nota.
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros] | [Alteração] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA050 – Negociação Financeira] | [Envolvida] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA060 – Cadastro de Pedidos] | [Criação] | [Atualizações -> Acadêmico-> Cadastros] | - |
Exemplo de Aplicação:
- Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
- Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades como a referência mínima para calcular o débito total do aluno.
- Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
- O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar
- FI9 – Controle de Emissão de DARF>.
(Opcional)
Procedimento para Utilização
*CÓDIGO - NOME DA ROTINA:*PCSIS2300
PCSIS2302
*VERSÃO DA ROTINA:*
PCSIS2300 – 28.07.26 / 28.08.03 / 29.00.03 / 29.01.03
PCSIS2302 - 28.07.15 / 29.00.03 / 29.01.03
*TABELAS UTILIZADAS:*
N/A
*NECESSITA DE PERMISSÃO OU PARAMETRIZAÇÃO? QUAIS?*
N/A
*ATUALIZAÇÃO A SER REALIZADA:*
Atualizar a rotina 2300:
Selecionar na Aba "Criação/Alteração de Colunas", Sub-Aba "Diversos", a Opção "2302 - Importação/Exportação OL"
Selecionar na Aba "Criação/Alteração de Procedures/Functions", a Opção "INTEGRADORA_MED [3]"
Selecionar na Aba "Dicionário de Dados", a Opção "Motivos de Não Atendimento do Operador Logístico/EDI"
Selecionar na Aba "Dicionário de Dados", a Opção "Dicionário de Dados da API do Operador Logístico"
Na rotina 2302, no cadastro da integradora, no campo “Layout” terá a opção “Fidelize API”, para ela deve ser informado os diretórios e terá que informar também o diretório de “Transmitidos”.
Na aba “Dados”, informar a
2300 - Atualizar Banco de Dados | Envolvida | Menu WinThor > 2300 |
2302 - Importação/Exportação OL | Alteração | Menu WinThor > 2302 |
Procedimento para Configuração
- Atualize a rotina 2302 para a versão 28.07.15 ou superior
Você sabe como atualizar as rotinas do WinThor?
- Acesse a rotina 2300 na versão 28.07.15, ou superior, aba Criação/Alteração de Colunas e marque a opção 2302 - Importação/Exportação OL;
- Acesse a aba Criação/Alteração de Procedures/Functions e marque as opções INTEGRADORA_MED[3] e PRC_MED_PBTEM_DESC_INTEGRADORA[5];
- Acesse a aba Dados do Dicionário, marque a opção Dicionário de Dados API do Operador Logístico e clique o botão Confirmar.
Procedimento para Utilização
- No cadastro da integradora, campo Layout selecione a opção Fidelize API;
- Na aba diretórios informe Todos os diretórios habilitados;
- Acesse a aba Dados Conexão informe a URL da integradora para acessar a base de dados
- ;
- Informe o usuário e senha de acesso a base de dados da integradora e clique o botão Gravar Integradora.
Ao importar pedidos
Observações:
- No momento da importação dos dados, os pedidos disponibilizados pela integradora serão salvos em arquivos nas pastas do diretório e depois
- serão importados para o Winthor
- ;
- Os arquivos de retorno
- e cancelamento de nota fiscal serão exportados do
- WinThor, para arquivos dentro das pastas do diretório informado e depois encaminhado para a base de dados da integradora
- ;
- Todos os arquivos recebidos ou enviados serão copiados para a pasta de
- Transmitidos;
- As demais configurações como plano de pagamento,
*ALTERAÇÃO EFETUADA NA ROTINA:*
Rotina 2300
- Alteração de Banco de Dados
- Criação do Dicionário de Dados da API
Rotina 2302
- Criação do novo Layout API Fidelize
- Além dos diretórios padrões, foi adicionado diretório para salvar os arquivos transmitidos.
- No cadastro da Integradora, adicionada nova Aba para configuração da conexão com a API da Fidelize
-Novo Processo de Conexão com a API
- Criado nova funcionalidade para baixar o Pedido da API
- Criada nova funcionalidade para transmitir as respostas do pedido (Retorno, Cancelamento do Pedido e Nota Fiscal)
*PROCEDIMENTOS A SEREM EXECUTADOS:*
N/A
*OBSERVAÇÕES:*
Site para testar requisições
chrome-extension://mcbfdonlkfpbfdpimkjilhdneikhfklp/index.html
Criar Token
mutation createToken { createToken(login: "xxxxx", password: "xxxxx") { token } }
Configurar Token de autorização para execução das querys no GraphIQL Feen
Authorization
Bearer <TOKEN>
Consultar Pedidos no GraphIQL Feen
query orders {
orders(current_page: 1, per_page: 10, imported: false) {
total
from
to
data {
id
status
order_code
industry_code
customer_code
customer_alternative_code
distribution_center_code
products {
ean
amount
discount_percentage
net_value
monitored
payment_term
}
}
}
}
Consultar Respostas no GraphIQL Feen
query { responses(imported:false) {
data {
order_code
industry_code
wholesaler_order_code
}
}
}
Consultar Cancelamentos no GraphIQL Feen
query cancellations {
orders(current_page: 1, per_page: 10, imported: true) {
total
from
to
data {
id
industry_code
is_free_good_discount
order_code
products {
ean
}
}
}
}
Consultar Espelhos no GraphIQL Feen
query invoices {
invoices(current_page: 1, per_page: 10, imported: false) {
total
from
to
data {
id
status
order_code
industry_code
customer_code
products {
ean
invoice_amount
payment_term
}
}
}
}
<Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações;
Localização da rotina no menu;
Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
Caso seja necessário ter algum cadastro feito previamente, faça uma observação
Se necessário, utilizar prints de tela>.
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas
Descrição
Nome:
Tipo:
Informe o Tipo do parâmetro
Cont. Por.:
Informe o Conteúdo padrão
Descrição:
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu
Informe o Menu em que estará localizada a rotina
Submenu
Informe o Submenu em que estará localizada a rotina
Nome da Rotina
Informe o Título da rotina
Programa
Informe o Fonte da rotina
Módulo
Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”
Tipo
Informe a Função
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Opcional
Dicionário de Dados
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice
Chave
01
<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>
02
<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>
03
<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>
Campo
<AAA_PERESP>
Tipo
<N>
Tamanho
<6>
Valor Inicial
<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>.
Mandatório
Sim ( ) Não ( )
Descrição
<Referência Mínima para Cálculo>
Título
<Ref.Calc.>
Picture
<@E999.99>
Help de Campo
<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>
- permanecerão com o atual comportamento.
HTML |
---|
<script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-91324488-1', 'auto', 'newTracker'); ga('newTracker.send', 'pageview');</script><script> ga('create', 'UA-91324488-1', 'auto', 'newTracker'); ga('newTracker.send', 'pageview');</script> |