Histórico da Página
CRIAR INTEGRAÇÃO FIDELIZZE 2.2
Informações Gerais
Linha de Produto: | PC Sistemas | ||||||||||
Segmento Executor: | D&L | ||||||||||
Módulo: | Farma | ||||||||||
Rotina: |
| ||||||||||
Chamado/Ticket: | HIS.01690.2018 | ||||||||||
Requisito/Story/Issue: | MED-1687 | ||||||||||
País: | ( x ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||||||||||
Versão/Release: | Rotina 2300 - 28.07.26 Rotina 2302 - 28.07.15 |
Objetivo
Criar a integração Fidelize2.2 com processo Wholesaler.
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.
<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>.
Rotina | Tipo de Operação | Opção de Menu |
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?
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 "
- 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
Selecionar na Aba "
- ;
- Acesse a aba Criação/Alteração de Procedures/Functions
- e marque as opções 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"
- ] 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.
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 URL da integradora para acessar a base de dados, informar o usuário e senha de acesso a base de dados da integradora.
Ao importar pedidos, os pedidos disponibilizados pela integradora serão salvos em arquivos nas pastas do diretório e depois será importado para o Winthor.
Os arquivos de retorno, cancelamento de nota fiscal serão exportados do Winthor, para arquivos dentro das pastas do diretório 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, permanece como é hoje.
*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>
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.
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, permanecerão com o atual comportamento.
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>
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> |