introdução - bionexomanuais.bionexo.com.br/integracao/plannexo/mv/versao_0.1... · web...

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

Upload: others

Post on 06-Aug-2020

4 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

MANUAL DE IMPLEMENTAÇÃOPLANNEXO

Envio e recebimento de dados

Page 2: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

Versão Data Descrição

0.1.1 21/05/2018 Criação do documento0.1.2 26/06/2018 Alterado requisites de Hardware e software0.1.3 06/08/2018 Alterado script de grants

Page 3: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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

Page 4: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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

Hardware do Servidor de Integração (Servidor dedicado ou virtual)

● Sistema Operacional Windows ou Linux ● 4GB de RAM ● 20GB espaço em disco disponível

Software do Servidor de Integração

● JDK ou JRE-1.8.0 ou superior Conectividade ● Servidor deve ter acesso a internet ● Servidor deve ter acesso a base dados

Page 5: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

Diagrama de Arquitetura da solução

Instruções de configuração do schema “PLC”Abaixo, informações detalhadas sobre a execução dos scripts de configuração do

banco de dados, 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, entre em contato com 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:

● Ítens, depósitos, estabelecimentos

● Grupos, subgrupos e categorias

● Usuários e fornecedores

● Operações de entrada e consumo

Page 6: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

● Posição de estoque

● Solicitação e ordens de compra

● 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 MV®.

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 DROP ANY INDEX TO PLC;GRANT DROP ANY PROCEDURE TO PLC;GRANT DROP ANY SEQUENCE TO PLC;GRANT DROP ANY TABLE TO PLC;GRANT DROP ANY TRIGGER TO PLC;GRANT DROP ANY VIEW TO PLC;

GRANT SELECT ON DBAMV.ESPECIE TO PLC;GRANT SELECT ON DBAMV.CLASSE TO PLC;GRANT SELECT ON DBAMV.SUB_CLAS TO PLC;GRANT SELECT ON DBAMV.MVTO_ESTOQUE TO PLC;GRANT SELECT ON DBAMV.ITMVTO_ESTOQUE TO PLC;GRANT SELECT ON DBAMV.ENT_PRO TO PLC;GRANT SELECT ON DBAMV.ITENT_PRO TO PLC;GRANT SELECT ON DBAMV.SOL_COM TO PLC;GRANT SELECT ON DBAMV.ORD_COM TO PLC;GRANT SELECT ON DBAMV.ITORD_PRO TO PLC;GRANT SELECT ON DBAMV.EMPRESA_PRODUTO TO PLC;GRANT SELECT ON DBAMV.EST_PRO TO PLC;GRANT SELECT ON DBAMV.ESTOQUE TO PLC;GRANT SELECT ON DBAMV.FORNECEDOR TO PLC;GRANT SELECT ON DBAMV.ITSOL_COM TO PLC;GRANT SELECT ON DBAMV.PRODUTO TO PLC;GRANT SELECT ON DBAMV.PRODUTO_ULTIMAS_COMPRAS TO PLC;GRANT SELECT ON DBAMV.UNI_PRO TO PLC;GRANT SELECT ON DBAMV.PARCELA_ITORD_PRO TO PLC;GRANT SELECT ON DBAMV.ELEMENTOS TO PLC;GRANT SELECT ON DBAMV.RESERVA TO PLC;GRANT SELECT ON DBAMV.RESERVA_ENDERECO_PRODUTO TO PLC;

GRANT SELECT, INSERT, UPDATE, DELETE ON DBAMV.PARCELA_ITSOL_COM TO PLC;GRANT SELECT, INSERT, UPDATE, DELETE ON DBAMV.SOL_COM TO PLC;GRANT SELECT, INSERT, UPDATE, DELETE ON DBAMV.ITSOL_COM TO PLC;

GRANT SELECT ON DBAMV.SEQ_SOL_COM TO PLC;

Page 7: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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.

Page 8: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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_INVENTORYColumn name type Size description

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

CD_PRODUTOvarchar2 255 bytes Código do item

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento (Hospital)

CD_LOCALIZACAO

varchar2 255 bytes Código do Depósito

QT_ESTOQUE_ATUAL

number 22,4 Quantidade de estoque

SIT_MIXnumber 22,0 Status Misto

QT_ESTOQUE_MINIMO

number 22,0 Quantidade de Estoque Mínimo

QT_ESTOQUE_MAXIMO

number 22,0 Quantidade de Estoque Máximo

Page 9: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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

ERP_INVOICEColumn name type size description

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

CD_ORD_COMvarchar2

255 bytes Identificação da Fatura

NR_DOCUMENTOvarchar2

255 bytes Nº da Fatura

CD_PRODUTOvarchar2

255 bytes Código do item

CD_ESTABELECIMENTO number 22,0 Código do Estabelecimento (Hospital)CD_FORNECEDOR number 22,0 Identificação do FornecedorDT_EMISSAO date Data da FaturaDT_ENTRADA date Data do Recebimento da FaturaSOLICITACAO number Número do Pedido de CompraDATA_SOLICITACAO date Data do Pedido de CompraDATA_MAXIMA date Data de Entrega Esperada do Pedido de CompraQUANTIDADE_SOLICITACAO number Quantidade do Pedido de CompraQT_ENTRADA number Quantidade da FaturaVAL_UNIT_ORDER float 126 Valor Unitário do Pedido de CompraVL_UNITARIO float 126 Valor Unitário da Fatura

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

ERP_LOCALColumn name type size description

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

CD_ESTOQUEvarchar2 255 bytes Código do Depósito

DS_ESTOQUEvarchar2 255 bytes Descrição do Depósito

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento (Hospital)

Page 10: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

ERP_PURCHASE_ORDER (Ordens/Pedidos de Compra)o Processos de compra em abertoo O layout deve incluir informações de Ordem x Itemo Carga Inicial + Incremental diário

ERP_PURCHASE_ORDERColumn name type size description

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

CD_ORD_COMvarchar2 100 bytes Identificação do Pedido de Compra

NR_DOCUMENTO

number 22,0 Número do Pedido de Compra

PRODUTOvarchar2 255 bytes Código do Item

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento (Hospital)

DT_ORD_COM date Data do Pedido de CompraQUANTIDADE_COMPRADA_PARCELA

number 22,0 Quantidade da Parcela de Entrega

QUANTIDADE_RECEBIDA

number 22,0 Quantidade de Recebimento

DATA_PREVISAO_ENTREGA date Data esperada de RecebimentoDT_ENTRADA date Data de Recebimento

FORNECEDORvarchar2 255 bytes Identificação do Fornecedor

NUM_SOLICITACAO

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

DATA_SOLICITACAO date Data da RequisiçãoVALOR_UNITARIO 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_REQColumn name type size description

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

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

SOLICITACAOnumber 22,0 Número da Requisição

ITEM_SOLICITAC numbe 22,0 Número do Item na Requisição

Page 11: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

AO_INTEGRACAO rNUMERO_PARCELA

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

PRODUTOvarchar2 255 bytes Código do Item

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento

SETORvarchar2 255 bytes Código do Depósito

QUANTIDADE_PARCELA

number 22,0 Quantidade de Parcelas

DATA_PREVISAO_ENTREGA date Data de Recebimento EsperadaDATA_SOLICITACAO date Data da Requisição

ERP_RESERVEo Carga Inicial + Incremental

ERP_RESERVEColumn name type size description

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

CD_ITSOLSAI_PROvarchar2

100 bytes Identificação da Reserva

CD_PRODUTOvarchar2

255 bytes Código do Item

CD_ESTOQUEvarchar2

255 bytes Código do Depósito

DATE_REQ date Data da RequisiçãoQT_RESERVA float 126 Quantidade da RequisiçãoTYPE_RESERVE_PK char 1 byte Tipo da Reserva

OBSERVATIONvarchar2

255 bytes Observação

CD_ESTABELECIMENTO

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_SKUColumn name type size description

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

Page 12: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

r

CD_PRODUTOvarchar2

255 bytes Código do Item

CD_ESTABELECIMENTOvarchar2

255 bytes Código do Estabelecimento

DS_PRODUTOvarchar2

255 bytes Descrição do item

DS_DESCRICAOvarchar2

255 bytes Descrição do Estabelecimento

VL_ULTIMA_ENTRADA float 22 Valor unitário do SKUQT_ENTRADA float 22 Quantidade da Última EntregaVL_CUSTO_REAL float 22 Valor da Última EntregaDT_ENTRADA date Data da Última EntregaTP_CLASSIFICACAO_ABC char 1 byte Curva ABCTP_CLASSIFICACAO_XYZ char 1 byte Curva XYZQT_ESTOQUE_MAXIMO float 22 Quantidade de Estoque MáximoQT_ESTOQUE_MINIMO float 22 Quantidade de Estoque MínimoQT_PONTO_DE_PEDIDO float 22 Quantidade de Ponto de PedidoQT_CONSUMO_MEDIO_MENSAL_PLANEJ float 22 Quantidade Média de ConsumoSN_ATIVO char 1 byte Yes ou No para identificar se a SKU está ativa.

CD_UNIDADEvarchar2 30 bytes Código Unidade de medida Padrão

DS_UNIDADEvarchar2

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

DT_CADASTRO date Data de criaçãoSN_MESTRE char 1 byte Yes ou No para item pai.

COD_ITEM_PARENTvarchar2

255 bytes Código do Item Pai.

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

CD_CLASSEvarchar2

255 bytes Código do agrupamento 1

CD_ESPECIEvarchar2

255 bytes Código do agrupamento 2

CD_SUB_CLAvarchar2

255 bytes Código do agrupamento 3

COD_GROUP4varchar2

255 bytes Código do agrupamento 4

COD_GROUP5varchar2

255 bytes Código do agrupamento 5

COD_GROUP6varchar2

255 bytes Código do agrupamento 6

COD_GROUP7varchar2

255 bytes Código do agrupamento 7

COD_GROUP8varchar2

255 bytes Código do agrupamento 8

COD_GROUP9varchar2

255 bytes Código do agrupamento 9

COD_GROUP10varchar2

255 bytes Código do agrupamento 10

COD_GROUP11varchar2

255 bytes Código do agrupamento 11

Page 13: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

COD_GROUP12varchar2

255 bytes Código do agrupamento 12

DESC_GROUP1varchar2

400 bytes Descrição do Agrupamento 1

DESC_GROUP2varchar2

400 bytes Descrição do Agrupamento 2

DESC_GROUP3varchar2

400 bytes Descrição do Agrupamento 3

DESC_GROUP4varchar2

400 bytes Descrição do Agrupamento 4

DESC_GROUP5varchar2

400 bytes Descrição do Agrupamento 5

DESC_GROUP6varchar2

400 bytes Descrição do Agrupamento 6

DESC_GROUP7varchar2

400 bytes Descrição do Agrupamento 7

DESC_GROUP8varchar2

400 bytes Descrição do Agrupamento 8

DESC_GROUP9varchar2

400 bytes Descrição do Agrupamento 9

DESC_GROUP10varchar2

400 bytes Descrição do Agrupamento10

DESC_GROUP11varchar2

400 bytes Descrição do Agrupamento 11

DESC_GROUP12varchar2

400 bytes Descrição do Agrupamento 12

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

QTY_MULT_ORDER float 22 Embalagem do item.

COD_ORDER_UNITvarchar2 30 bytes Código do Pedido Unitário

DESC_ORDER_UNITvarchar2

255 bytes Descrição do Pedido Unitário

CD_ESTOQUEvarchar2

255 bytes Local Padrão

CD_PRODUTO_ENTRADA_CONJUGADA

number 22,0 Último Pedido de Compra

CD_FORNECEDORvarchar2

255 bytes Último Fornecedor do Pedido de Compra

DT_ENTRADA date Última Data de Pedido de CompraVL_UNITARIO float 22 Último Preço do Pedido de CompraQT_ENTRADA float 22 Última Quantidade do Pedido de CompraQTY_MIN_BATCH float 22 Quantidade de Lote MínimoQTY_MULT_BATCH float 22 Quantidade de Lote Múltiplo

VL_TEMPO_DE_REPOSICAOvarchar2

255 bytes Lead Time do Comprador

LT_SUPPLIERvarchar2

255 bytes Lead Time do Fornecedor

FIELD1varchar2

255 bytes Informação adicional 1 (opcional)

FIELD2varchar2

255 bytes Informação adicional 2 (opcional)

FIELD3varchar2

255 bytes Informação adicional 3 (opcional)

Page 14: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

ERP_SUPPLIERo Carga Inicial + Incremental diário

ERP_SUPPLIERColumn name type size description

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

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

CD_FORNECEDORvarchar2 255 bytes Código do Fornecedor

NM_FORNECEDORvarchar2 255 bytes Descrição do Fronecedor

NM_CONTATOvarchar2 255 bytes Nome do Contato do Fornecedor

DS_ENDERECO_EMAILvarchar2 60 bytes E-mail do Fornecedor

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

ERP_TRANSACTION_INColumn name type size description

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

CD_ENT_PROnumber 22,0 Código da transação

CD_PRODUTOvarchar2 255 bytes Código do Item

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento

DT_ENTRADA date Data da TransaçãoQT_ENTRADA float 22 Quantidade da TransaçãoTP_DOCUMENTO_ENTRADA 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

Page 15: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

Column name type size description

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

CD_PRODUTOvarchar2 255 bytes Código do Item

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento

CD_ESTOQUEvarchar2 255 bytes Código do Local

CD_ESTOQUE_DESTINO

varchar2 255 bytes Código do Local Destino

CD_SETORvarchar2 255 bytes Código do Setor

CD_TP_MVTO_ESTOQUE

varchar2 4 bytes Tipo da Transação

DT_MVTO_ESTOQUE date Data da TransaçãoQTD_MOVIMENTACAO float 22 Quantidade da TransaçãoTP_USO_PRODUTO 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_FKnumber 22,0 Número de Identificação do Hospital

CD_PRODUTOvarchar2

22 bytes Código do Item

CD_ESTABELECIMENTO

varchar2

22 bytes Código do Estabelecimento

CD_ESTOQUEvarchar2

22 bytes Código do Local

CD_ESTOQUE_DESTINO

varchar2

22 bytes Código do Local Destino

CD_SETORvarchar2

22 bytes Código do Setor

CD_TP_MVTO_ESTOQUE

varchar2 2 bytes Tipo da Transação

QT_CONSUMO_MES date Mês da Transação

QTY_TRANS float 22 Quantidade da Transação

TP_USO_PRODUTO char 1 byte Yes ou No para consume.

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

WES_PENDING

Page 16: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

Column name type size description

ID_WESnumber 22,0

WES_TABLEvarchar2 25 bytes

WES_ACTIONvarchar2 10 bytes

WES_STATUSnumber 22,0

PK01varchar2 22 bytes

PK02varchar2 22 bytes

PK03varchar2 22 bytes

PK04varchar2 22 bytes

PK05varchar2 22 bytes

PK06varchar2 22 bytes

PK07varchar2 22 bytes

PK08varchar2 22 bytes

WES_DATE_CREATED date

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

WES_PENDING_LOGColumn name type size description

ID_WESnumber 22,0

WES_TABLEvarchar2 25 bytes

WES_ACTIONvarchar2 10 bytes

WES_STATUSnumber 22,0

PK01varchar2 22 bytes

PK02varchar2 22 bytes

PK03varchar2 22 bytes

PK04varchar2 22 bytes

PK05varchar2 22 bytes

PK06varchar2 22 bytes

Page 17: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

PK07varchar2 22 bytes

PK08varchar2 22 bytes

WES_DATE_CREATED dateWES_DATE_LOGGED date

WES_ERRORvarchar2

4000 bytes

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

WES_SCHEDULERColumn name type size description

ID_SCHEDULER_PK number 22,0

WES_TABLE varchar2300 bytes

DH_STARTtimestamp 6

DH_ENDtimestamp 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_HEADERColumn name type size description

ID_INT_PLCnumber 22,0

DATA_MAXIMA date Data Esperada

SETORvarchar2 200 bytes Código do Setor

ESTOQUEvarchar2 200 bytes Código do Local

MOTIVO_PEDIDOvarchar2 200 bytes Código do Motivo

COD_BUYERvarchar2 200 bytes Código do Comprador

SOLICITANTEvarchar2 200 bytes Código do Usuário

URGENTE char 1 byte Yes ou No para pedido Urgente.

SITUACAOnumber 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)

DATA_INTEGRACAO date Data de integraçãoID_REQ_ERP numbe 22,0 Identificação da Requisição do ERP (ID da gravação no ERP caso tenha

Page 18: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

r ocorrido com sucesso)

HEADER_LOGvarchar2

2000 bytes

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

CD_ESTABELECIMENTO

varchar2 255 bytes Código do Estabelecimento

OBSERVACAOvarchar2

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_ITEMColumn name type size description

ID_INT_PLC number 22,0

PRODUTOvarchar2 255 bytes Código do Item

QUANTIDADE_SOLICITADA float 22 Quantidade da Parcela de Entrega

UNIDADEvarchar2 255 bytes Unidade Padrão

ITEM_LOGvarchar2 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_PARCColumn name type size description

ID_INT_PLC number 22,0CD_PRODUTO

varchar2

255 bytes Código do Item

NR_PARCELA number 22,0 Número da ParcelaDT_PARCELA date Data da ParcelaQT_PARCELAS float 22 Quantidade da Parcela

Page 19: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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 OpenVPNo 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

Page 20: Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/MV/versao_0.1... · Web viewProcesso de carga de dados (envio e retorno) Processo de envio gerado pela equipe Bionexo:

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

● Agendar os schedulers no sistema

Observaçõesa. 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 MV, os campos da tabela de SKU do ERP abaixo são usados para identificar os

itens ativos ou inativos: : produto.tp_ativo = 'S'

sn_movimentacao = 'S'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.