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ção do WMS. |
| Parâmetros de Entrada | pi_id: id da tabela TWMS_SAIDAS. NUMBER; pi_lote: código do lote. VARCHAR2; pi_qtde: quantidade do lote. NUMBER; pi_tipo_doc: 1=Saída (Separação), 2=Entrada (Recebimento). NUMBER |
| Parâmetros de Saída | Não se aplica. |
INSERE_RETORNO_ITEM_VOLUME¶
INSERE_RETORNO_ITEM_CONF_VOL
| Objetivo | Procedure utilizada para inserir os retornos dos volumes dos itens do pedido de venda para conferência no ERP. |
| Parâmetros de Entrada | pi_wms_saidas_id: ID da TWMS_SAIDAS.; pi_volume: número do volume do item.; pi_qtde: quantidade de itens no volume; pi_peso_volume: Peso do volume; pi_embalagem_id: id da TITENS_COMERCIAL |
| Parâmetros de Saída | Não se aplica. |
RETORNA_INV_ITENS¶
RETORNA_INV_ITENS
| Objetivo | Atualizar as tabelas de inventário do FoccoWMS a partir do retorno do WMS. Esta procedure será utilizada pelo próprio WMS somente em situações onde o processo é INV_ITENS (solicitação de inventário por item). |
| Parâmetros de Entrada | pi_wms_inv_id: ID da TWMS_INVENTARIO.; pi_qtde_wms: quantidade saldo do WMS.; Pi_cod_lote: Informar somente quando o item possuir lote.; pi_status: status da solicitação de inventário, informar apenas para finalizar o retorno. Para retornar mais de um lote, informar null. |
| Parâmetros de Saída | Não se aplica. |
RETORNA_INV_GERAL¶
RETORNA_INV_GERAL
| Objetivo | Atualizar as tabelas de inventário do FoccoWMS a partir do retorno do WMS. Esta procedure será utilizada pelo próprio WMS somente em situações onde o processo é INV_GERAL (solicitação de inventário geral de todo estoque no WMS). |
| Parâmetros de Entrada | pi_empresa: id da empresa; pi_cod_item: código do item; pi_mascara: ID da máscara do item; pi_cod_lote: código do lote; pi_cod_almox: código do almoxarifado; pi_qtde_wms: quantidade saldo do WMS |
| Parâmetros de Saída | Não se aplica. |
RETORNA_COMPONENTES_ITEM¶
RETORNA_INV_GERAL
| Objetivo | Retornar os componentes (estrutura) de itens comerciais |
| Parâmetros de Entrada | pi_empr_id: Id da empreda; pi_itempr_id: id do item da tabela TITENS_EMPR; pi_tmasc_item_id: Id da mascara do item |
| Parâmetros de Saída | TP_TAB_MAN_ENG_ESTRUTURA PIPELINED |
Considerações¶
Para realizar o acesso às tabelas e views, deverá ser utilizado o usuário FOCCOMOBILE que será criado por nossa infrasserviços, mediante solicitação, juntamente com a chave pré cadastrada no FoccoERP conforme explicado anteriormente.