manual de implementaÇÃo...

19
MANUAL DE IMPLEMENTAÇÃO PLANNEXO Envio e recebimento de dados

Upload: others

Post on 24-Aug-2020

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

MANUAL DE IMPLEMENTAÇÃO PLANNEXO

Envio e recebimento de dados

Page 2: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Versão Data Descrição0.1.1 24/11/2017 Criaçãododocumento

0.1.2 23/04/2018 Adicionadoobservaçõesedescriçãodoscamposatualizados

0.1.3 24/05/2018 AlteradoConfiguraçõesdeHardwareeConectividade0.1.4 06/08/2018 Revisadoscriptseremovidorepositóriogit

Page 3: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Sumário Introdução 4 Requisitos de infraestrutura 4 Recomendações mínimas de Hardware e Software 4 Diagrama de Arquitetura da solução 5 Instruções de configuração do schema “PLC” 5 Processo de carga de dados (envio e retorno) 7 Processo de envio gerado pela equipe Bionexo: 7 Envio executado pelo cliente: 7 Processo de retorno gerado pela equipe Bionexo: 7 Retorno executado pelo cliente: 7 Dicionário de Dados 8 ERP_INVENTORY (inventários) 8 ERP_INVOICE(Faturas) 8 ERP_LOCAL(Depósitos) 9 ERP_PURCHASE_ORDER (Ordens/Pedidos de Compra) 9 ERP_PURCHASE_REQ (Requisições/Solicitações de Compra) 10 ERP_RESERVE 11 ERP_SKU (Tabela de Item x Estabelecimento) 11 ERP_SUPPLIER 13 ERP_TRANSACTION_IN(Movimentações de Entrada) 13 ERP_TRANSACTION_OUT_DAY (Movimentações de Saída diárias) 14 ERP_TRANSACTION_OUT_MONTH(Movimentações de Saída mensal) 14 WES_PENDING 15 WES_PENDING_LOG 15 WES_SCHEDULER 16 WES_SUGGESTION_HEADER (Capa da sugestão de compra) 16 WES_SUGGESTION_ITEM (Item da sugestão de Compra) 17 WES_SUGGESTION_PARC (Parcela da Sugestão de Compra) 17 Recomendações finais 18 Backup 18 Segurança e disponibilidade 18 Instruções de configuração do servidor de Aplicação FCC da solução PLANNEXO 18 Observações 19

Page 4: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Introdução Este documento tem como objetivo explicar o processo de tráfego de dados entre o sistema PLANNEXO e o ERP do cliente, com orientações relativas aos processos de instalação e configuração destas etapas.

Requisitos de infraestrutura Abaixo descrevemos as necessidades de infraestrutura para a correta instalação do serviço de troca de dados que captura do ERP e os envia para o sistema PLANNEXO e vice-versa.

Este documento exemplifica as ações inferindo utilização de bancos de dados Oracle®, PostgreSql ou SQLServer®. Mas a solução PLANNEXO também pode ser implementada em outros SGDBs (Verifique com a equipe Bionexo). A aplicação responsável pela transferência dos dados foi desenvolvida em liguagem JAVA e portanto pode rodar em servidores com qualquer sistema operacional que tenha suporte a JVM. Acessos desta aplicação à rede do Banco de Dados do ERP (fonte dos dados), são necessárias. Criação de schema, tabelas, views, configurações de jobs e procedures fazem parte da solução de transferência e serão detalhados a seguir.

Recomendações mínimas de Hardware e Software

● Sistema Operacional Windows ou Linux A versão do Linux, deve ter suporte ao .NET Core 2.x As seguintes versões/distribuições do Linux são compatíveis: ◦ Red Hat Enterprise Linux 7, 6 – 64 bits (x86_64 ou md64) ◦ CentOS 7 – 64 bits (x86_64 ou amd64) ◦ Oracle Linux 7 – 64 bits (x86_64 ou amd64) ◦ Fedora 28, 27 – 64 bits (x86_64 ou amd64) ◦ Debian 9 (64 bits, arm32), 8.7 ou versões posteriores – 64 bits (x86_64 ou ◦ amd64) ◦ Ubuntu 18.04 (64 bits arm32), 16.04, 14.04 - 64 bits (x86_64 ou amd64) ◦ Linux Mint 18, 17 – 64 bits (x86_64 ou amd64) ◦ openSUSE 42.3 ou versões posteriores – 64 bits (x86_64 ou amd64) ◦ SLES (SUSE Linux Enterprise Server) 12 Service Pack 2 ou posterior – 64 bits ◦ (x86_64 ou amd64 ◦ Alpine Linux 3.7 ou versões posteriores – 64 bits (x86_64 ou amd64)

● Mínimo 4GB de RAM ● 20GB espaço em disco disponível

Software do Servidor de Integração

● Servidor deve ter acesso a internet ● Servidor deve ter acesso a base dados

Acesso remoto ao servidor

● Preferencialmente acesso por TeamViewer, senão for possível, por Remote Desktop, VPN ou SSH (linux).

Page 5: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Diagrama de Arquitetura da solução

Instruções de configuração do schema “PLC” Abaixodescrevemosasnecessidadesdeinfraestruturaparaacorretainstala..odoservi.odetrocade

dadosquecapturadoERPeosenviaparaosistemaPLANNEXOevice-versa.

Abaixo, descrevemos informações detalhadas sobre a execução deste mesmo script, de forma a orientar o administrador do Banco de Dados. Em casos de necessidades de execuções manuais ou qualquer solicitação de mudanças, contacte a equipe da Bionexo.

Os comandos a seguir fazem referência à utilização de um SGDB Oracle®.

Para a transferência das informações do ERP ao sistema PLANNEXO, utilizamos rotinas de atualização de um novo schema, normalmente criado no mesmo SGDB da fonte.

Page 6: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

CREATE TABLESPACE PLANNEXO_DATA DATAFILE '+X' SIZE 32727M; CREATE TABLESPACE PLANNEXO_INDEX DATAFILE '+X' SIZE 32727M; CREATE USER PLC IDENTIFIED BY "<insira uma senha aqui>" DEFAULT TABLESPACE PLANNEXO_DATA;

Após a criação do usuário, precisamos liberar os acessos aos seguintes dados e transações do ERP:

o Ítens, depósitos, estabelecimentoso Grupos, subgrupos e categoriaso Usuários e fornecedoreso Operações de entrada e consumoo Posição de estoqueo Solicitação e ordens de comprao Notas fiscais

Estes acessos e a nomenclatura das tabelas podem variar conforme a versão do ERP utilizado (contacte a

equipe Bionexo, caso precise de auxílio). Para este exemplo, consideramos o ERP Tasy®. GRANT "CONNECT" TO PLC; GRANT CREATE ANY INDEX TO PLC; GRANT CREATE ANY JOB TO PLC; GRANT CREATE ANY PROCEDURE TO PLC; GRANT CREATE INDEXTYPE TO PLC; GRANT CREATE JOB TO PLC; GRANT CREATE PROCEDURE TO PLC; GRANT CREATE SEQUENCE TO PLC; GRANT CREATE TABLE TO PLC; GRANT CREATE TRIGGER TO PLC; GRANT CREATE VIEW TO PLC; GRANT SELECT ON TASY.estabelecimento TO PLC; GRANT SELECT ON TASY.unidade_medida TO PLC; GRANT SELECT ON TASY.unidade_medida_adic_compra_v TO PLC; GRANT SELECT ON TASY.pessoa_juridica_v TO PLC; GRANT SELECT ON TASY.movimento_estoque_v TO PLC; GRANT SELECT ON TASY.solic_compra_item_entr_v TO PLC; GRANT SELECT ON TASY.usuario TO PLC; GRANT SELECT ON TASY.solic_compra TO PLC; GRANT SELECT ON TASY.solic_compra_item TO PLC; GRANT SELECT ON TASY.solic_compra_item_entrega TO PLC; GRANT SELECT ON TASY.material_v TO PLC; GRANT SELECT ON TASY.estrutura_material_v TO PLC; GRANT SELECT ON TASY.material_estab_v TO PLC; GRANT SELECT ON TASY.saldo_estoque_v2 TO PLC; GRANT SELECT ON TASY.ordem_compra_item_entr_v TO PLC; GRANT SELECT ON TASY.local_estoque_v2 TO PLC; GRANT SELECT ON TASY.padrao_estoque_local_v TO PLC; GRANT EXECUTE ON TASY.obter_pessoa_fisica_usuario TO PLC; GRANT SELECT ON TASY.solic_compra_seq TO PLC; GRANT SELECT ON TASY.NOTA_FISCAL TO PLC; GRANT SELECT ON TASY.NOTA_FISCAL_ITEM TO PLC; GRANT INSERT, UPDATE, DELETE ON tasy.solic_compra TO PLC; GRANT INSERT, UPDATE, DELETE ON tasy.solic_compra_item TO PLC; GRANT INSERT, UPDATE, DELETE ON tasy.solic_compra_item_entrega TO PLC; GRANT EXECUTE ON TASY.OBTER_MAIOR_VALOR_COMPRA TO PLC; GRANT EXECUTE ON TASY.OBTER_CM_MAT_CONVERTIDO TO PLC; GRANT EXECUTE ON TASY.OBTER_SALDO_ESTOQUE_NUVEM TO PLC; GRANT EXECUTE ON TASY.OBTER_DADOS_MATERIAL TO PLC; GRANT EXECUTE ON TASY.OBTER_CUSTO_MEDIO_MATERIAL TO PLC;

Page 7: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

GRANT EXECUTE ON TASY.OBTER_QUANTIDADE_CONVERTIDA TO PLC; GRANT EXP_FULL_DATABASE TO PLC; O script cria objetos como: tabelas, views, procedures e jobs.

Processo de carga de dados (envio e retorno)

Processo de envio gerado pela equipe Bionexo:

Utilizamos duas etapas para execução da carga de dados do ERP (fonte de dados) para que o sistema PLANNEXO possa iniciar as operações de planejamento.

Inicial: A carga inicial de dados busca alimentar o sistema PLANNEXO com informações históricas.

Idealmente executada após a implementação, busca dados de aproximadamente 3 anos

Incremental: As atualizações incrementais ocorrem uma vez ao dia, conforme agendamento no servidores de

aplicação e banco de dados.

Envio executado pelo cliente:

Clientes que utilizem ERPs ainda não suportados pelos scripts de automação da Bionexo, devem implementar manualmente processos para a carga, utilizando-se dos modelos abaixo.

Para as etapas inicias e periódicas, deve-se utilizar o dicionário de dados abaixo. Aconselhamos a construção em diferentes etapas. Uma para a carga inicial, contemplando os últimos 3 anos

de dados, e as cargas periódicas (uma vez ao dia).

Processo de retorno gerado pela equipe Bionexo: O sistema PLANNEXO irá disponibilizar as sugestões de compras no schema PLC, que serão posteriormente

gravadas, através de jobs agendados. Para os sistemas Tasy e Mv, a procedure de gravação está inclusa no script disponibilizado anteriormente.

Retorno executado pelo cliente: Para sistemas de ERPs ainda não suportados, o cliente precisará desenvolver a leitura dos dados no schema

PLC e gravação nas tabelas do ERP.

Page 8: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

As leituras ocorrerão nas seguintes tabelas do schema PLC: ● WES_SUGGESTION_HEADER● WES_SUGGESTION_ITEM● WES_SUGGESTION_PARC

As especificações destas tabelas se encontram no Dicionário de dados abaixo. Sugerimos uma periodicidade de gravação de 3 em 3 minutos.

Dicionário de Dados

ERP_INVENTORY (inventários) o Saldo em estoque do item por local de estoque (depósito / estabelecimento)o Trazer apenas itens x estabelecimento x depósito que possuem saldo estoque maior que zeroo Carga Inicial + Incremental

ERP_INVENTORY

Column name type Size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_ITEM_PK varchar2 255 bytes Código do item

COD_ESTAB_PK varchar2 255 bytes Código do Estabelecimento (Hospital)

COD_LOCAL_PK varchar2 255 bytes Código do Depósito

QTY_INV number 22,4 Quantidade de estoque

SIT_MIX number 22,0 Status Misto

QTY_MIN number 22,0 Quantidade de Estoque Mínimo

QTY_MAX number 22,0 Quantidade de Estoque Máximo

ERP_INVOICE(Faturas) o Carga Inicial + Incremental diário

Page 9: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

ERP_INVOICE

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

ID_INVOICE_PK varchar2 255 bytes Identificação da Fatura

NUM_INVOICE varchar2 255 bytes Nº da Fatura

COD_ITEM varchar2 255 bytes Código do item

COD_ESTAB number 22,0 Código do Estabelecimento (Hospital)

ID_SUPPLIER number 22,0 Identificação do Fornecedor

DATE_INVOICE date Data da Fatura

DATE_INVOICE_RECEIVED date Data do Recebimento da Fatura

NUM_ORDER number Número do Pedido de Compra

DATE_ORDER date Data do Pedido de Compra

DATE_ORDER_EXP date Data de Entrega Esperada do Pedido de Compra

QTY_ORDER number Quantidade do Pedido de Compra

QTY_INVOICE number Quantidade da Fatura

VAL_UNIT_ORDER float 126 Valor Unitário do Pedido de Compra

VAL_UNIT_INVOICE float 126 Valor Unitário da Fatura

ERP_LOCAL(Depósitos) o Carga Inicial + Incremental diário

ERP_LOCAL

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_LOCAL_PK varchar2 255 bytes Código do Depósito

DESC_LOCAL varchar2 255 bytes Descrição do Depósito

COD_ESTAB_PK varchar2 255 bytes Código do Estabelecimento (Hospital)

ERP_PURCHASE_ORDER (Ordens/Pedidos de Compra)

o Processos de compra em abertoo O layout deve incluir informações de Ordem x Item

Page 10: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

o Carga Inicial + Incremental diário

ERP_PURCHASE_ORDER

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

ID_ORDER_PK varchar2 100 bytes Identificação do Pedido de Compra

NUM_ORDER number 22,0 Número do Pedido de Compra

COD_ITEM varchar2 255 bytes Código do Item

COD_ESTAB varchar2 255 bytes Código do Estabelecimento (Hospital)

DATE_ORDER date Data do Pedido de Compra

QTY_PARC number 22,0 Quantidade da Parcela de Entrega

QTY_REC number 22,0 Quantidade de Recebimento

DATE_EXP date Data esperada de Recebimento

DATE_REAL date Data de Recebimento

ID_SUPPLIER varchar2 255 bytes Identificação do Fornecedor

NUM_REQ number 22,0 Número da Requisição

DATE_REQ date Data da Requisição

VAL_UNIT float 126 Valor Unitário do Item

ERP_PURCHASE_REQ (Requisições/Solicitações de Compra) o Solicitações de compra em abertoo O layout deve incluir informações de Solicitação x Itemo Carga Inicial + Incremental diário

ERP_PURCHASE_REQ

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

ID_REQ_PK varchar2 122 bytes Número de Identificação da Requisição

NUM_REQ number 22,0 Número da Requisição

NUM_ITEM_REQ number 22,0 Número do Item na Requisição

NUM_PARC_REQ number 22,0 Número da Parcela na Requisição

COD_ITEM varchar2 255 bytes Código do Item

COD_ESTAB varchar2 255 bytes Código do Estabelecimento

COD_LOCAL varchar2 255 bytes Código do Depósito

QTY_PARC number 22,0 Quantidade de Parcelas

DATE_EXP date Data de Recebimento Esperada

Page 11: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

DATE_REQ date Data da Requisição

ERP_RESERVE o Carga Inicial + Incremental

ERP_RESERVE

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

ID_RESERVE_PK varchar2 100 bytes Identificação da Reserva

COD_ITEM varchar2 255 bytes Código do Item

COD_LOCAL varchar2 255 bytes Código do Depósito

DATE_REQ date Data da Requisição

QTY_REQ float 126 Quantidade da Requisição

TYPE_RESERVE_PK char 1 byte Tipo da Reserva

OBSERVATION varchar2 255 bytes Observação

COD_ESTAB varchar2 255 bytes Código do Estabelecimento

ERP_SKU (Tabela de Item x Estabelecimento) o Layout disponibiliza a base cadastral de relacionamentos Item x Estabelecimentoo Carga Inicial + Incremental

ERP_SKU

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_ITEM_PK varchar2 255 bytes Código do Item

COD_ESTAB_PK varchar2 255 bytes Código do Estabelecimento

DESC_ITEM varchar2 255 bytes Descrição do item

DESC_ESTAB varchar2 255 bytes Descrição do Estabelecimento

VAL_UNIT_SKU float 22 Valor unitário do SKU

QTY_LAST_ARR float 22 Quantidade da Última Entrega

VAL_LAST_ARR float 22 Valor da Última Entrega

DATE_LAST_ARR date Data da Última Entrega

CURVE_ABC char 1 byte Curva ABC

CURVE_XYZ char 1 byte Curva XYZ

QTY_MAX float 22 Quantidade de Estoque Máximo

Page 12: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

QTY_MIN float 22 Quantidade de Estoque Mínimo

QTY_PP float 22 Quantidade de Ponto de Pedido

QTY_AVG_CONS float 22 Quantidade Média de Consumo

YN_SKU_ACTIVE char 1 byte Yes ou No para identificar se a SKU está ativa.

COD_STD_UNIT varchar2 30 bytes Código Unidade de medida Padrão

DESC_STD_UNIT varchar2 255 bytes Descrição da Unidade de medida Padrão

DATE_ADDED date Data de criação

YN_PARENT char 1 byte Yes ou No para item pai.

COD_ITEM_PARENT varchar2 255 bytes Código do Item Pai.

COD_ITEM_RANK number 22,0 Prioridade de classificação para item filho.

COD_GROUP1 varchar2 255 bytes Código do agrupamento 1

COD_GROUP2 varchar2 255 bytes Código do agrupamento 2

COD_GROUP3 varchar2 255 bytes Código do agrupamento 3

COD_GROUP4 varchar2 255 bytes Código do agrupamento 4

COD_GROUP5 varchar2 255 bytes Código do agrupamento 5

COD_GROUP6 varchar2 255 bytes Código do agrupamento 6

COD_GROUP7 varchar2 255 bytes Código do agrupamento 7

COD_GROUP8 varchar2 255 bytes Código do agrupamento 8

COD_GROUP9 varchar2 255 bytes Código do agrupamento 9

COD_GROUP10 varchar2 255 bytes Código do agrupamento 10

COD_GROUP11 varchar2 255 bytes Código do agrupamento 11

COD_GROUP12 varchar2 255 bytes Código do agrupamento 12

DESC_GROUP1 varchar2 400 bytes Descrição do Agrupamento 1

DESC_GROUP2 varchar2 400 bytes Descrição do Agrupamento 2

DESC_GROUP3 varchar2 400 bytes Descrição do Agrupamento 3

DESC_GROUP4 varchar2 400 bytes Descrição do Agrupamento 4

DESC_GROUP5 varchar2 400 bytes Descrição do Agrupamento 5

DESC_GROUP6 varchar2 400 bytes Descrição do Agrupamento 6

DESC_GROUP7 varchar2 400 bytes Descrição do Agrupamento 7

DESC_GROUP8 varchar2 400 bytes Descrição do Agrupamento 8

DESC_GROUP9 varchar2 400 bytes Descrição do Agrupamento 9

DESC_GROUP10 varchar2 400 bytes Descrição do Agrupamento10

DESC_GROUP11 varchar2 400 bytes Descrição do Agrupamento 11

DESC_GROUP12 varchar2 400 bytes Descrição do Agrupamento 12

Page 13: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

SIT_SUPPLIER_AVAIL number 22,0 Situação do Fornecedor (Avaliação)

QTY_MULT_ORDER float 22 Embalagem do item.

COD_ORDER_UNIT varchar2 30 bytes Código do Pedido Unitário

DESC_ORDER_UNIT varchar2 255 bytes Descrição do Pedido Unitário

DEFAULT_LOCAL varchar2 255 bytes Local Padrão

LAST_PURCHASE_ORDER number 22,0 Último Pedido de Compra

LAST_PURCHASE_SUPPLIER varchar2 255 bytes Último Fornecedor do Pedido de Compra

LAST_PURCHASE_DATE date Última Data de Pedido de Compra

LAST_PURCHASE_PRICE float 22 Último Preço do Pedido de Compra

LAST_PURCHASE_QTY float 22 Última Quantidade do Pedido de Compra

QTY_MIN_BATCH float 22 Quantidade de Lote Mínimo

QTY_MULT_BATCH float 22 Quantidade de Lote Múltiplo

LT_BUYER varchar2 255 bytes Lead Time do Comprador

LT_SUPPLIER varchar2 255 bytes Lead Time do Fornecedor

FIELD1 varchar2 255 bytes Informação adicional 1 (opcional)

FIELD2 varchar2 255 bytes Informação adicional 2 (opcional)

FIELD3 varchar2 255 bytes Informação adicional 3 (opcional)

ERP_SUPPLIER o Carga Inicial + Incremental diário

ERP_SUPPLIER

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

ID_SUPPLIER_PK varchar2 255 bytes Número de Identificação do Fornecedor

COD_SUPPLIER varchar2 255 bytes Código do Fornecedor

DESC_SUPPLIER varchar2 255 bytes Descrição do Fronecedor

SUPPLIER_CONTACT_NAME varchar2 255 bytes Nome do Contato do Fornecedor

EMAIL_SUPPLIER varchar2 60 bytes E-mail do Fornecedor

ERP_TRANSACTION_IN(Movimentações de Entrada) o Carga Inicial + Incremental 31 dias atrás

ERP_TRANSACTION_IN

Page 14: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_TRANS_PK number 22,0 Código da transação

COD_ITEM varchar2 255 bytes Código do Item

COD_ESTAB varchar2 255 bytes Código do Estabelecimento

DATE_TRANS date Data da Transação

QTY_TRANS float 22 Quantidade da Transação

TYPE_TRANS char 1 byte Tipo da Transação

ERP_TRANSACTION_OUT_DAY (Movimentações de Saída diárias) o Movimentações de saída (demanda) agrupadas por diao Utilizadas para composição do cálculo estatístico de longo prazo.o Carga inicial de 3 anos de histórico. Isso permite análise de sazonalidade e aumenta a acuracidade da

previsão estatísticao No dia-a-dia enviar apenas o incremental 10 dias para trás.

ERP_TRANSACTION_OUT_DAY

Column name type size description

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_ITEM_PK varchar2 255 bytes Código do Item

COD_ESTAB_PK varchar2 255 bytes Código do Estabelecimento

COD_LOCAL_PK varchar2 255 bytes Código do Local

COD_LOCAL_DEST_PK varchar2 255 bytes Código do Local Destino

COD_SECTOR_PK varchar2 255 bytes Código do Setor

TYPE_TRANS_PK varchar2 4 bytes Tipo da Transação

DATE_TRANS_PK date Data da Transação

QTY_TRANS float 22 Quantidade da Transação

YN_CONS char 1 byte Yes ou No para consume.

ERP_TRANSACTION_OUT_MONTH(Movimentações de Saída mensal) o Carga Inicial + Incremental 31 dias para trás

ERP_TRANSACTION_OUT_MONTH

Column name type size description

Page 15: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

ID_COMPANY_FK number 22,0 Número de Identificação do Hospital

COD_ITEM_PK varchar2 22 bytes Código do Item

COD_ESTAB_PK varchar2 22 bytes Código do Estabelecimento

COD_LOCAL_PK varchar2 22 bytes Código do Local

COD_LOCAL_DEST_PK varchar2 22 bytes Código do Local Destino

COD_SECTOR_PK varchar2 22 bytes Código do Setor

TYPE_TRANS_PK varchar2 2 bytes Tipo da Transação

MONTH_TRANS_PK date Mês da Transação

QTY_TRANS float 22 Quantidade da Transação

YN_CONS char 1 byte Yes ou No para consume.

WES_PENDING o Tabela auxiliar para sincronização de dados. Não deve ser populada pelo cliente.

WES_PENDING

Column name type size description

ID_WES number 22,0

WES_TABLE varchar2 25 bytes

WES_ACTION varchar2 10 bytes

WES_STATUS number 22,0

PK01 varchar2 22 bytes

PK02 varchar2 22 bytes

PK03 varchar2 22 bytes

PK04 varchar2 22 bytes

PK05 varchar2 22 bytes

PK06 varchar2 22 bytes

PK07 varchar2 22 bytes

PK08 varchar2 22 bytes

WES_DATE_CREATED date

WES_PENDING_LOG o Tabela auxiliar para sincronização de dados. Não deve ser populada pelo cliente.

Page 16: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

WES_PENDING_LOG

Column name type size description

ID_WES number 22,0

WES_TABLE varchar2 25 bytes

WES_ACTION varchar2 10 bytes

WES_STATUS number 22,0

PK01 varchar2 22 bytes

PK02 varchar2 22 bytes

PK03 varchar2 22 bytes

PK04 varchar2 22 bytes

PK05 varchar2 22 bytes

PK06 varchar2 22 bytes

PK07 varchar2 22 bytes

PK08 varchar2 22 bytes

WES_DATE_CREATED date

WES_DATE_LOGGED date

WES_ERROR varchar2 4000 bytes

WES_SCHEDULER o Tabela auxiliar para sincronização de dados. Não deve ser populada pelo cliente.

WES_SCHEDULER

Column name type size description

ID_SCHEDULER_PK number 22,0

WES_TABLE varchar2 300 bytes

DH_START timestamp 6

DH_END timestamp 6

WES_SUGGESTION_HEADER (Capa da sugestão de compra) o Tabela de retorno de dados para o ERP. Deve ser lida e gravada na capa da sugestão de compra.

WES_SUGGESTION_HEADER

Column name type size description

ID_INT_PLC number 22,0

Page 17: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

DATE_EXPECTED date Data Esperada

COD_SECTOR varchar2 200 bytes Código do Setor

COD_LOCAL varchar2 200 bytes Código do Local

COD_REASON varchar2 200 bytes Código do Motivo

COD_BUYER varchar2 200 bytes Código do Comprador

COD_USER varchar2 200 bytes Código do Usuário

YN_URGENT char 1 byte Yes ou No para pedido Urgente.

SIT_REQ number 22,0 Situação da Requisição (1-Esperando gravação no ERP, 2-gravação efetuada com sucesso, 3-Erro na gravação da Sugestão de Compra)

DATE_INT date Data de integração

ID_REQ_ERP number 22,0 Identificação da Requisição do ERP (ID da gravação no ERP caso tenha ocorrido com sucesso)

HEADER_LOG varchar2 2000 bytes Log do Cabeçalho(Este campo é utilizado como log das mensagens de gravação no ERP, descrevendo o erro ou o sucesso.)

COD_ESTAB varchar2 255 bytes Código do Estabelecimento

OBS_HEADER varchar2 2000 bytes Observação do Cabeçalho

WES_SUGGESTION_ITEM (Item da sugestão de Compra) o Tabela de retorno de dados para o ERP. Deve ser lida e gravada no item de cada sugestão de compra.

WES_SUGGESTION_ITEM

Column name type size description

ID_INT_PLC number 22,0

COD_ITEM varchar2 255 bytes Código do Item

QTY_PARC float 22 Quantidade da Parcela de Entrega

STD_UNIT varchar2 255 bytes Unidade Padrão

ITEM_LOG varchar2 2000 bytes Log Item

ITEM_ORDER number 22,0 Pedido de Compra do Item

WES_SUGGESTION_PARC (Parcela da Sugestão de Compra) o Tabela de retorno de dados para o ERP. Deve ser lida e gravada na parcela de cada sugestão de compra.

WES_SUGGESTION_PARC

Column name type size description

ID_INT_PLC number 22,0

COD_ITEM varchar2 255 bytes Código do Item

NUM_PARC number 22,0 Número da Parcela

Page 18: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

DATE_PARC date Data da Parcela

QTY_PARC float 22 Quantidade da Parcela

Recomendações finais

Backup

Recomendamos a implantação de rotinas de backups de todos os módulos do sistema, em horários de pouca utilização para evitar sobrecarga.

Segurança e disponibilidade

A responsabilidade pela infraestrutura da solução, ex: servidores físicos e virtuais, conectividade de rede, configuração e atualização de sistemas operacionais, drivers ou falta de acessos são de inteira responsabilidade do cliente.

Em caso de problemas com as execuções, contacte a equipe Bionexo ([email protected])

Instruções de configuração do servidor de Aplicação FCC da solução PLANNEXO

Abaixo especificamos os requisitos para a correta implementação do servidor de aplicação da solução:

● Criar usuário ‘plannexo’ com permissões administrativas no Sistema Operacional● Testar conectividade do servidor de aplicação com o servidor de banco de dados● Testar conectividade do servidor de aplicação com a internet● Instalar OpenVPN

o Efetuar download, conforme versão do Sistema Operacional▪ https://openvpn.net/index.php/open-source/downloads.html

o Configurar o client com a chave privada (contacte o time Bionexo para obtê-la)o Configurar para que o serviço seja iniciado automaticamente em caso de reboot do servidor

● Instalar JRE (ou JDK)o Efetuar download, conforme versão do Sistema Operacional

▪ https://www.java.com/pt_BR/download/o Executar a instalação

● Instalar a aplicação FCC (contacte o time Bionexo para obtê-la)

Page 19: MANUAL DE IMPLEMENTAÇÃO PLANNEXOmanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao_atual/M… · Preferencialmente acesso por TeamViewer, ... Diagrama de Arquitetura da solução

Agendar os schedulers no sistema

Observações

a. Não há ordem específica de gravação dos dados nas nas tabelasb. A periodicidade recomendada de gravação/migração dos dados na tabela é de três vezes ao dia (isto pode

influenciar a performance do servidor local)c. A recomendação para atualização/importação de sugestão de compras do Plannexo para o ERP é a cada 3

minutos.d. A carga inicial deve ter dados de 3 anos, as cargas subsequentes serão incrementais, no caso das tabelas

ERP_TRANSACTION_IN, ERP_TRANSACTION_OUT_DAY E ERP_TRANSACTION_OUT_MONTH a carga incremental sempre deve trazer dados dos últimos 30 dias, visto que as transações podem ser alteradas durante esse período.

e. Existe uma procedure para limpeza dos dados periódicamente conforme necessidade do cliente. A recomendação é que tenhamos 1 ano de dados na base auxiliar para histórico, porém esse período pode ser ajustado.

f. Os dados carregados no schema PLC serão enviados ao Plannexo pelo FCC instalado na máquina disponibilizada pelo cliente, agendadas pelo scheduler do windows. Esses dados são comparados com o lado do servidor Plannexo e inseridos/autalizados(MERGE).

g. São considerados na importação SKUs ativos e inativos para identificação dos status. Como exemplo, no TASY, os campos da tabela de SKU do ERP abaixo são usados para identificar os itens ativos ou inativos : ie_situacao = 'A' ie_padronizado = 'S'

ie_material_estoque = 'S'

ie_ressuprimento = 'S'

h. No Retorno da sugestão de compra do Plannexo para o ERP as tabelas utlizadas são as seguintes: WES_SUGGESTION_HEADER(Capa do Pedido), WES_SUGGESTION_ITEM(Itens do Pedido) e WES_SUGGESTION_PARC(Programação de Entrega). A sugestão chega a essa tabela pelo FCC e contém o status inicial = 1 (Aguardando gravação no ERP, tabela WES_SUGGESTION_HEADER campo SIT_REQ), assim que o registro for consumido e gravado com sucesso no ERP deve-se gravar na mesma tabela o status 2 (Incluído com sucesso) e também o campo ID_REQ_ERP com o id da sugestão de compra gravado no ERP. Caso a gravação gere algum erro, deve-se gravar o status = 3 (Erro na gravação do ERP) e também o campo ITEM_LOG contendo a descrição do erro para posterior tratamento.