Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao... · Web viewA carga...

MANUAL DE IMPLEMENTAÇÃOPLANNEXO

Envio e recebimento de dados

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

0.1.2 23/04/2018Adicionado observações e descrição dos campos atualizados

0.1.3 24/05/2018 Alterado Configurações de Hardware e Conectividade0.1.4 06/08/2018 Revisado scripts e removido repositório git

SumárioIntrodução 3Requisitos 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: 7Dicionário de Dados 8ERP_INVENTORY (inventários) 8ERP_INVOICE(Faturas) 8ERP_LOCAL(Depósitos) 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(Movimentações de Entrada) 13ERP_TRANSACTION_OUT_DAY (Movimentações de Saída diárias) 14ERP_TRANSACTION_OUT_MONTH(Movimentações de Saída mensal) 14WES_PENDING 15WES_PENDING_LOG 15WES_SCHEDULER 16WES_SUGGESTION_HEADER (Capa da sugestão de compra) 16WES_SUGGESTION_ITEM (Item da sugestão de Compra) 17WES_SUGGESTION_PARC (Parcela da Sugestão de Compra) 17Recomendações finais 18Backup 18Segurança e disponibilidade 18Instruções de configuração do servidor de Aplicação FCC da solução PLANNEXO 18Observaçõ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”Abaixo descrevemos as necessidades de infraestrutura para a correta instala..o do

servi.o de troca dedados que captura do ERP e os envia para o sistema PLANNEXO e vice-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_INVENTORYColumn name type Size description

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

COD_ITEM_PKvarchar2 255 bytes Código do item

COD_ESTAB_PKvarchar2 255 bytes Código do Estabelecimento (Hospital)

COD_LOCAL_PKvarchar2 255 bytes Código do Depósito

QTY_INVnumber 22,4 Quantidade de estoque

SIT_MIXnumber 22,0 Status Misto

QTY_MIN numbe 22,0 Quantidade de Estoque Mínimo

r

QTY_MAXnumber 22,0 Quantidade de Estoque Máximo

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

ID_INVOICE_PKvarchar2

255 bytes Identificação da Fatura

NUM_INVOICEvarchar2

255 bytes Nº da Fatura

COD_ITEMvarchar2

255 bytes Código do item

COD_ESTAB number 22,0 Código do Estabelecimento (Hospital)ID_SUPPLIER number 22,0 Identificação do FornecedorDATE_INVOICE date Data da FaturaDATE_INVOICE_RECEIVED date Data do Recebimento da FaturaNUM_ORDER number Número do Pedido de CompraDATE_ORDER date Data do Pedido de CompraDATE_ORDER_EXP date Data de Entrega Esperada do Pedido de CompraQTY_ORDER number Quantidade do Pedido de CompraQTY_INVOICE number Quantidade da FaturaVAL_UNIT_ORDER float 126 Valor Unitário do Pedido de CompraVAL_UNIT_INVOICE float 126 Valor Unitário da Fatura

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

ERP_LOCALColumn name type size description


COD_LOCAL_PKvarchar2 255 bytes Código do Depósito

DESC_LOCALvarchar2 255 bytes Descrição do Depósito

COD_ESTAB_PKvarchar2 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 Itemo Carga Inicial + Incremental diário

ERP_PURCHASE_ORDERColumn name type size description


ID_ORDER_PKvarchar2 100 bytes Identificação do Pedido de Compra

NUM_ORDERnumber 22,0 Número do Pedido de Compra

COD_ITEMvarchar2 255 bytes Código do Item

COD_ESTABvarchar2 255 bytes Código do Estabelecimento (Hospital)

DATE_ORDER date Data do Pedido de Compra

QTY_PARCnumber 22,0 Quantidade da Parcela de Entrega

QTY_RECnumber 22,0 Quantidade de Recebimento

DATE_EXP date Data esperada de RecebimentoDATE_REAL date Data de Recebimento

ID_SUPPLIERvarchar2 255 bytes Identificação do Fornecedor

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

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


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

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

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

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


COD_ESTABvarchar2 255 bytes Código do Estabelecimento

COD_LOCALvarchar2 255 bytes Código do Depósito

QTY_PARCnumber 22,0 Quantidade de Parcelas

DATE_EXP date Data de Recebimento EsperadaDATE_REQ 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

ID_RESERVE_PKvarchar2

100 bytes Identificação da Reserva

COD_ITEMvarchar2

255 bytes Código do Item

COD_LOCALvarchar2

255 bytes Código do Depósito

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

OBSERVATIONvarchar2

255 bytes Observação

COD_ESTABvarchar2

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


COD_ITEM_PKvarchar2


COD_ESTAB_PKvarchar2


DESC_ITEMvarchar2

255 bytes Descrição do item

DESC_ESTABvarchar2

255 bytes Descrição do Estabelecimento

VAL_UNIT_SKU float 22 Valor unitário do SKUQTY_LAST_ARR float 22 Quantidade da Última EntregaVAL_LAST_ARR float 22 Valor da Última EntregaDATE_LAST_ARR date Data da Última EntregaCURVE_ABC char 1 byte Curva ABCCURVE_XYZ char 1 byte Curva XYZQTY_MAX float 22 Quantidade de Estoque MáximoQTY_MIN float 22 Quantidade de Estoque MínimoQTY_PP float 22 Quantidade de Ponto de PedidoQTY_AVG_CONS float 22 Quantidade Média de ConsumoYN_SKU_ACTIVE char 1 byte Yes ou No para identificar se a SKU está ativa.

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

DESC_STD_UNITvarchar2

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

DATE_ADDED date Data de criaçãoYN_PARENT 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.

COD_GROUP1varchar2

255 bytes Código do agrupamento 1

COD_GROUP2varchar2


COD_GROUP3varchar2


COD_GROUP4varchar2


COD_GROUP5varchar2


COD_GROUP6varchar2


COD_GROUP7 varchar 255 Código do agrupamento 7

2 bytes

COD_GROUP8varchar2


COD_GROUP9varchar2


COD_GROUP10varchar2


COD_GROUP11varchar2


COD_GROUP12varchar2


DESC_GROUP1varchar2

400 bytes Descrição do Agrupamento 1

DESC_GROUP2varchar2


DESC_GROUP3varchar2


DESC_GROUP4varchar2


DESC_GROUP5varchar2


DESC_GROUP6varchar2


DESC_GROUP7varchar2


DESC_GROUP8varchar2


DESC_GROUP9varchar2


DESC_GROUP10varchar2

400 bytes Descrição do Agrupamento10





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

DEFAULT_LOCALvarchar2

255 bytes Local Padrão

LAST_PURCHASE_ORDERnumber 22,0 Último Pedido de Compra

LAST_PURCHASE_SUPPLIERvarchar2

255 bytes Último Fornecedor do Pedido de Compra

LAST_PURCHASE_DATE date Última Data de Pedido de CompraLAST_PURCHASE_PRICE float 22 Último Preço do Pedido de CompraLAST_PURCHASE_QTY 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

LT_BUYERvarchar2

255 bytes Lead Time do Comprador

LT_SUPPLIERvarchar2

255 bytes Lead Time do Fornecedor

FIELD1varchar2

255 bytes Informação adicional 1 (opcional)

FIELD2varchar2


FIELD3varchar2


ERP_SUPPLIERo Carga Inicial + Incremental diário

ERP_SUPPLIERColumn name type size description


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

COD_SUPPLIERvarchar2 255 bytes Código do Fornecedor

DESC_SUPPLIERvarchar2 255 bytes Descrição do Fronecedor

SUPPLIER_CONTACT_NAMEvarchar2 255 bytes Nome do Contato do Fornecedor

EMAIL_SUPPLIERvarchar2 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


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



DATE_TRANS date Data da TransaçãoQTY_TRANS float 22 Quantidade da TransaçãoTYPE_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_DAYColumn name type size description


COD_ITEM_PKvarchar2 255 bytes Código do Item

COD_ESTAB_PKvarchar2 255 bytes Código do Estabelecimento

COD_LOCAL_PKvarchar2 255 bytes Código do Local

COD_LOCAL_DEST_PKvarchar2 255 bytes Código do Local Destino

COD_SECTOR_PKvarchar2 255 bytes Código do Setor

TYPE_TRANS_PKvarchar2 4 bytes Tipo da Transação

DATE_TRANS_PK date Data da TransaçãoQTY_TRANS float 22 Quantidade da TransaçãoYN_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


COD_ITEM_PKvarchar2


COD_ESTAB_PKvarchar2


COD_LOCAL_PKvarchar2

22 bytes Código do Local

COD_LOCAL_DEST_PKvarchar2

22 bytes Código do Local Destino

COD_SECTOR_PKvarchar2

22 bytes Código do Setor

TYPE_TRANS_PKvarchar2 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_PENDINGo Tabela auxiliar para sincronização de dados. Não deve ser populada pelo cliente.

WES_PENDINGColumn name type size description

ID_WESnumber 22,0

WES_TABLEvarchar2 25 bytes

WES_ACTIONvarchar2 10 bytes

WES_STATUSnumber 22,0

PK01varchar2 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_STATUS numbe 22,0

r









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

DATE_EXPECTED date Data Esperada

COD_SECTORvarchar2 200 bytes Código do Setor

COD_LOCALvarchar2 200 bytes Código do Local

COD_REASONvarchar2 200 bytes Código do Motivo

COD_BUYERvarchar2 200 bytes Código do Comprador

COD_USERvarchar2 200 bytes Código do Usuário

YN_URGENT char 1 byte Yes ou No para pedido Urgente.

SIT_REQnumber 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_ERPnumber 22,0

Identificação da Requisição do ERP (ID da gravação no ERP caso tenha 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.)


OBS_HEADERvarchar2

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


WES_SUGGESTION_ITEMColumn name type size description

ID_INT_PLC number 22,0


QTY_PARC float 22 Quantidade da Parcela de Entrega

STD_UNITvarchar2 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


WES_SUGGESTION_PARCColumn name type size description

ID_INT_PLC number 22,0

COD_ITEMvarchar2


NUM_PARC number 22,0 Número da ParcelaDATE_PARC date Data da ParcelaQTY_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.

Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao... · Web viewA carga...

Documents

Transcript of Introdução - Bionexomanuais.bionexo.com.br/integracao/PLANnexo/TASY/versao... · Web viewA carga...