Ir para o conteúdo

FoccoWMS x FoccoERP

Objetivos da Integração

A integração tem como objetivo trocar informações atualizadas entre os produtos FoccoERP e FoccoWMS.

Escopo da Integração

  • Os processos suportados pelo FoccoWMS x FoccoERP são:

  • Centralização das informações no FoccoERP;

  • Envio de solicitações de separação do FoccoERP para o FoccoWMS;

  • Envio de cadastros de itens e seus derivados e transportadoras;

  • Consulta da situação de separação;

  • Sincronismo de saldo de estoque nos almoxarifados controlados pelo FoccoWMS.

Layouts de Entrada de Dados - FoccoERP

A seguir, estão descritas as views com seus respectivos campos onde o FoccoWMS recebe as informações do sistema FoccoERP.

IMPORTANTE: Sempre antes de consultar as views deve-se setar a chave do produto na sessão atual, conforme exemplo abaixo:

PKGINT_WMS.SET_CHAVE(pi_chave =>  [Chave pré cadastrada no FoccoERP]);

View Transportadoras

VWMS_TRANSPORTADORAS

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) ID da tabela TFORNECEDORES
COD_TRANSP VARCHAR2 (20 Byte) Código do fornecedor
DESCRICAO VARCHAR2 (70 Byte) Descrição do fornecedor
CNPJ NUMBER (14) CNPJ do fornecedor
CPF NUMBER (11) CPF do fornecedor
INSC_EST VARCHAR2 (18 Byte) Inscrição estadual do fornecedor
ENDERECO VARCHAR2 (50 Byte) Endereço do fornecedor
BAIRRO VARCHAR2 (40 Byte) Bairro do fornecedor
CIDADE VARCHAR2 (50 Byte) Cidade do fornecedor
UF VARCHAR2 (3 Byte) UF do fornecedor
CEP VARCHAR2 (10 Byte) CEP do fornecedor
EMPR_ID NUMBER (10) Empresa do fornecedor

View Itens

VWMS_ITENS

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) Id da tabela TITENS_EMPR
COD_ITEM VARCHAR2 (20 Byte) Código do item + id da máscara
DESC_TECNICA VARCHAR2 (100 Byte) Descrição técnica do item
REFERENCIA VARCHAR2 (20 Byte) Referência do item
UM VARCHAR2 (3 Byte) Unidade de medida
PESO NUMBER Peso
LOTE_MULT NUMBER Lote múltiplo
INDIC_ESTQ_VALIDADE VARCHAR2 (1 Byte) Indicador se controla validade do produto
INDIC_ESTQ_SERIE VARCHAR2 (1 Byte) Indicador se controla o número de série do produto
INDIC_ESTQ_LOTE VARCHAR2 (1 Byte) Indicador se controla o número de lote do produto
SITUACAO CHAR (1 Byte) Situação do item global (A – Ativo / I – Inativo)
CUBAGEM NUMBER Volume em m³
QTDE_LASTRO NUMBER Quantidade de lastros por palet
QTDE_CAIXAS_PALET NUMBER Quantidade de caixas por lastros
ROT_INSPECAO VARCHAR2 (1 Byte) Indicador se o item sofre inspeção (S/N)
EMPR_ID NUMBER (10) Empresa em que o item está ligado
PERC_TOL_MAIS NUMBER Percentual de tolerância aceitável para mais
PERC_TOL_MENOS NUMBER Percentual de tolerância aceitável para menos
INDIC_QTDE_VARIAVEL NUMBER Indicador se item possui quantidade variável
DIAS_VALIDADE NUMBER Dias de validade
TMASC_ITEM_ID NUMBER Id da TMASC_ITEM
TP_ESTRUTURA VARCHAR2(1) Tipo da estrutura (I – Industrial / C – Comercial)

View Codigo de barras dos itens

VWMS_ITENS_COD_BARRAS

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) ID da tabela TITENS_EMPR
COD_ITEM VARCHAR2 (61 Byte) Código do item + id da máscara
TIPO NUMBER Tipo do código de barras, sempre = 1
COD_BARRA VARCHAR2 (500 Byte) Código de barras do produto
QTDE_UNID_EMB NUMBER Quantidade de produtos por embalagem
EMPR_ID NUMBER (10) Empresa vinculado ao código de barras do item

View Etiquetas

VWMS_ETIQUETAS

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) Id da tabela TLEITURAS_ETIQ
COD_ITEM VARCHAR2 (61 Byte) Código do item + id da máscara
LOTE VARCHAR2 (20 Byte) Código do lote da etiqueta Conforme informado na tabela TLEITURAS_ETIQ
QTDE NUMBER (19,8) Quantidade da etiqueta Conforme informado na tabela TLEITURAS_ETIQ
VALIDADE VARCHAR2 (0 Byte) NULL
EMPR_ID NUMBER (10) Empresa vinculada a etiqueta
ALMOX VARCHAR2 (5 Byte) Código do almoxarifado

View Estoques

VWMS_ESTOQUES

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) ID da tabela TITENS_EMPR
COD_ITEM VARCHAR2 (61 Byte) Código do item + ID máscara
LOTE VARCHAR2 (20 Byte) Código do lote
QTDE NUMBER Saldo do estoque do item
TP_EST NUMBER (1) Tipo de estoque (disponível ou indisponível)
CUSTO_COMPRA NUMBER Custo médio do item
EMPR_ID NUMBER (10) Empresa vinculada ao saldo de estoque
COD_ALMOX VARCHAR2 (5 Byte) Código do almoxarifado do saldo de estoque do item
ITEM VARCHAR2(20) Código do item
TMASC_ITEM_ID NUMBER ID da TMASC_ITEM

View Solicitação de separação de itens – PDV

Busca apenas os itens de pedidos não processados da tabela TWMS_SAIDA, ou seja, SIT_WMS igual a 0 e TP_DOC igual a PDV.

VWMS_SAIDAS_ITEM_PDV

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) ID da tabela TWMS_SAIDAS
NUM_DOCUMENTO NUMBER (10) Número do pedido de venda
NUM_ITEM NUMBER (5) Número da linha do item do pedido
DT_EMISSAO DATE Data de emissão
DT_ENTREGA DATE Data de entrega
DESC_CLIENTE VARCHAR2 (70 Byte) Cliente
CNPJ NUMBER (14) CNPJ
ENDERECO VARCHAR2 (50 Byte) Endereço de entrega
BAIRRO VARCHAR2 (100 Byte) Bairro de entrega
CIDADE VARCHAR2 (70 Byte) Cidade de entrega
UF VARCHAR2 (3 Byte) UF de entrega
CEP NUMBER (8) CPD de entrega
OBS VARCHAR2 (2000 Byte) OBS do item do pedido ou do pedido de venda
COD_TRANSP NUMBER (6) Código da transportadora
PLACA VARCHAR2 (1000 Byte) Placa do veículo
PESO_BRUTO_TOTAL NUMBER Peso bruto do item multiplicado pela quantidade
VALOR_TOTAL NUMBER Valor unitário do item multiplicado pela quantidade
COD_ITEM VARCHAR2 (61 Byte) Código do item + id da máscara
QTDE_ENVIADA NUMBER (19,8) Quantidade solicitada
QTDE_MAX_EMB NUMBER (19,8) Quantidade máxima por embalagem
TIPO NUMBER Tipo sempre 1
PRIORIDADE NUMBER (3) Prioridade conforme a transportadora
DESCR_COMPL VARCHAR2 (1000 Byte) Descrição complementar do item
OBS_ITEM VARCHAR2 (1000 Byte) Observação do item, da tabela TITENS_COMERCIAL caso não possua dados, utilizar a OBS da TITENS_EMPR, caso não possua dados utilizar a OBS da TITENS, do contrário NULL
EMPR_ID NUMBER (10) Empresa da solicitação
COD_ALMOX VARCHAR2 (5 Byte) Almoxarifado de WMS
NUM_WMS NUMBER Identificador de uso interno do sistema WMS
NUM_CARGA NUMBER Código da Carga
SEQ_CARGA NUMBER Sequência da carga
SIT_WMS NUMBER Situação do WMS

View Solicitação de separação de itens – REQ ou REP

Buscar apenas os itens não processados da tabela TWMS_SAIDAS, ou seja, SIT_WMS igual a 0 e TP_DOC igual a REQ ou REP.

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER (10) ID da tabela TWMS_SAIDAS
NUM_DOCUMENTO NUMBER Número do documento Tipo de documento = REP – número da ordem de fabricação; Tipo de documento = REQ - 0
DT_EMISSAO DATE Data atual
DT_ENTREGA DATE Data atual
DESC_CLIENTE VARCHAR2 (70 Byte) Própria empresa
CNPJ NUMBER (14) Própria empresa
ENDERECO VARCHAR2 (50 Byte) Própria empresa
BAIRRO VARCHAR2 (20 Byte) Própria empresa
CIDADE VARCHAR2 (70 Byte) Própria empresa
UF VARCHAR2 (3 Byte) Própria empresa
CEP NUMBER (8) Própria empresa
OBS VARCHAR2 (500 Byte) REP – Observação da ordem de fabricação – REQ – observação da requisição
COD_TRANSP VARCHAR2 (0 Byte) NULL
PLACA VARCHAR2 (0 Byte) NULL
PESO_BRUTO_TOTAL NUMBER Peso bruto total do item
VALOR_TOTAL NUMBER Valor do custo médio multiplicado pela quantidade
COD_ITEM VARCHAR2 (61 Byte) Código do item + id máscara
QTDE_ENVIADA NUMBER (19,8) Quantidade solicitada
QTDE_MAX_EMB NUMBER (19,8) Quantidade máxima por embalagem
TIPO NUMBER Sempre 1
PRIORIDADE NUMBER Sempre 99
DESCR_COMPL VARCHAR2 (1000 Byte) Descrição complementar do item
TIPO_DOC VARCHAR2 (3 Byte) Tipo de documento REQ ou REP
OBS_ITEM VARCHAR2 (1000 Byte) Observação do item, da tabela TITENS_COMERCIAL caso não possua dados, utilizar a OBS da TITENS_EMPR, caso não possua dados utilizar a OBS da TITENS, do contrário NULL
EMPR_ID NUMBER (10) Empresa da solicitação
COD_ALMOX VARCHAR2 (5 Byte) Almoxarifado de WMS
NUM_WMS NUMBER Identificador de uso interno do sistema WMS
SIT_WMS NUMBER Situação do WMS

View Volumes

VWMS_VOLUMES_NF

Nome do Campo Tipo do Campo Descrição Observações
EMPR_ID NUMBER Empresa vinculada a nota fiscal
PDV_ID NUMBER(10) ID do pedido de venda
NUM_PEDIDO NUMBER Código do pedido de venda
SERIE_NF VARCHAR Série da nota fiscal emitida
NUM_NF NUMBER Número da nota fiscal emitida
VOLUMES_NF NUMBER Volume informado na nota fiscal
PESO_NF NUMBER Peso informado
NUM_WMS NUMBER Situação do WMS

View Embalagens

VWMS_EMBALAGENS

Nome do Campo Tipo do Campo Descrição Observações
ITCM_ID NUMBER(10) ID da tabela TITENS_COMERCIAL
COD_ITEM VARCHAR Código do produto + id mascara
DESCRICAO VARCHAR Descrição técnica + mascara
REFERENCIA VARCHAR Referência do item
SITUACAO NUMBER Situação do item
EMPR_ID NUMBER(10) ID da empresa

View Fila de processamento

VWMS_FILA_PROCESSAMENTO

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER(10) ID da tabela TWMS_FILA_PROCESSAMENTO
PROCESSO VARCHAR Nome do processo EXP_ITENS' -Exportação de Itens/Máscaras; EXP_TRANSP' -Exportação de Transportadoras; EXP_COMPONENTES' -Exportação de Estrutura do Item; EXP_COD_BARRAS -Exportação de Códigos de Barra; PDV – Exportação de Pedidos de Venda; REQ – Exportação de requisição não planejada ; REP – Exportação de requisição planejada; EXP_VOLUMES_NF – Exportação dos volumes da nota fiscal; INV_ITENS – Inventário de itens.; INV_GERAL – Inventário de todos os itens.
PROCESSO_ID NUMBER(10) ID referente ao processo EXP_ITENS – ID da TITENS_EMPR; EXP_TRANSP – ID da TFORNECEDORES; EXP_COMPONENTES – ID da TITENS_EMPR; EXP_COD_BARRAS – ID da TITENS_EMPR; PDV – ID da TWMS_SAIDAS; REQ – ID da TWMS_SAIDAS; REP – ID da TWMS_SAIDAS; EXP_VOLUMES_NF – ID da TNFS_SAIDA; INV_ITENS – ID da TWMS_INVENTARIO; INV_GERAL - ID da Empresa, para retornar todos os itens apenas da empresa passada por parâmetro. Observação: remover o processo da fila apenas depois de retornar todos os itens.
STATUS NUMBER Status do envio/recebimento
DT_INCLUSAO DATE Data da inclusão do processo na fila

View Inventário

VWMS_INVENTARIO

Nome do Campo Tipo do Campo Descrição Observações
ID NUMBER(10) Chave primária da TWMS_INVENTARIO
DATA DATE Data da inclusão da solicitação
COD_ITEM VARCHAR(40) Código do item + Id da máscara
COD_ALMOX VARCHAR(20) Código do almoxarifado
EMPR_ID NUMBER ID da Empresa

Layouts de Saída de Dados – FoccoWMS

Toda a entrada de dados ocorrerá através de procedimentos agrupados na package PKGINT_WMS, o objetivo desta package é encapsular as rotinas do ERP que podem ser acessadas pelo WMS. Para garantir a segurança de acesso, deverá ser utilizada uma estrutura de chave de acesso do FoccoIntegrador. Dessa forma, é necessário que o WMS informe uma chave de acesso pré-cadastrada no ERP (programa FINT0200) para se autenticar e ter acesso as rotinas, conforme exemplo abaixo:

PKGINT_WMS.SET_CHAVE(pi_chave =>  [Chave pré cadastrada no FoccoERP]); 

IMPORTANTE: As mensagens de erro tratadas pela Focco serão retornadas sempre através de uma Exception com o código ORA-20999.

GRAVA_RETORNO_ITEM_PEDIDO

GRAVA_RETORNO_ITEM_PEDIDO

Objetivo Procedure utilizada para gravar os retornos das situações dos itens de pedido do WMS.
Parâmetros de Entrada pi_id: id da tabela TWMS_SAIDAS. pi_sit_wms: situação no WMS. pi_qtde_wms: quantidade lida pelo WMS. pi_cod_onda: código da onda.
Parâmetros de Saída Não se aplica.

REMOVE_PROCESSO_FILA

REMOVE_PROCESSO_FILA

Objetivo Procedure utilizada para remover um registro da fila de processamento depois de concluído.
Parâmetros de Entrada pi_id: id da fila de processamento. pi_status_retorno: status retornado após o processamento.
Parâmetros de Saída Não se aplica.

INSERE_RETORNO_ITEM_LOTE

INSERE_RETORNO_ITEM_LOTE

Objetivo Procedure utilizada para inserir os retornos dos lotes dos itens da solicitação de requisiç