Upload
others
View
1
Download
0
Embed Size (px)
Citation preview
MANUAL DE IMPLEMENTAÇÃO PLANNEXO
Envio e recebimento de dados
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
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
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).
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.
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;
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.
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
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
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
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
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
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
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
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.
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
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
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)
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.