Páginas filhas
  • DT Integração Fidelize 2.2

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CRIAR INTEGRAÇÃO FIDELIZZE 2.2

 Informações Gerais

 

Linha de Produto:

PC Sistemas

Segmento Executor:D&L

Módulo:

Farma

Rotina:

Rotina

Nome Técnico

2302

Importação/Exportação OL




Rotina(s) envolvida(s)

Nome Técnico

2300

Atualizar Banco de Dados

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

 *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 "


  • 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 "
  • ;

    Image Added


  • Acesse a aba Criação/Alteração de Procedures/Functions
", a Opção "
  • 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];

    Image Added

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

    Image Added





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

 

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

  1. No cadastro da integradora, campo Layout selecione a opção Fidelize API;
  2. Na aba diretórios informe  Todos os  diretórios habilitados;

    Image Added

  3. Acesse a aba Dados Conexão informe a  URL da integradora para acessar a base de dados;
  4. Informe o usuário e senha de acesso a base de dados da integradora e  clique o botão Gravar Integradora.

    Image Added

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>