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