Integrações ERP CORE (2.0)

Utilizando a atual arquitetura desenvolvida para gerenciar a integração dos ERPs TOTVS com o WMS SaaS, a integração CORE foi desenvolvida para facilitar a integração entre os sistemas fora do ecossistema TOTVS com WMS SaaS.

Sua estrutura contém as principais funções necessárias para integrar com o WMS SaaS, com uma arquitetura desenvolvida para não somente conectar, mas apoiar na gestão do processo entre os dois sistemas.

Os DE X PARA entre os sistemas, são registrados no CORE mitigando a quantidade de desenvolvimentos nas integrações e nos sistemas que serão integrados. Assim como parametrizar as unidades do WMS, tipos de estoque e características em parametrizações embedadas no próprio WMS SaaS.

Outra característica importante do processo, é o processo de cadastro automático via contexto de informações no WMS. O cadastro via contexto, valida as informações do produto, transportadora e fornecedor, que são obrigatórios no WMS para integração do documento e se necessário realiza o cadastro no WMS. Este processo é importante, pois evita a necessidade de realizar integrações de cadastros entre os dois sistemas.

De forma resumida o processo core, consome de forma ativa (GET) as APIs REST dos ERPs, disponibilizadas (publicadas) no layout estipulado no Swagger da integração CORE. Esse consumo, gera a fila de execução com o WMS SaaS, apresentando os registros de documentos integrados no monitor de integração do WMS SaaS, assim permitindo o acompanhamento dos processos e gerenciamento das informações.

As operações WMS SaaS que precisam ser integradas com o ERP, a integração realiza a captura destes dados e executa o retorno do processo executando (POST) nas APIs REST do ERP.

A camada CORE de integração, além gerenciar e suavizar os processo de integração, centraliza as informações entre os sistemas que estão sendo integrados, pois utilizando os GETs com ERP, centraliza os registros da integrações e execuções, assim como possíveis erros e monitoramento da disponibilidade do ambiente Rest do cliente. Embedado no WMS, existe o monitor de integração, que permite acompanhar os documentos integrados permitindo a rastreabilidade das integrações. Este monitor além de visualizar e quantificar os documentos, permite avaliar as possíveis divergências de informações, retornos das APIs, reprocessar integrações e acompanhar o status do ambiente REST.

Caso as APIs executadas, tanto do ERP como WMS SaaS, apresentem alguma situação que impeça a execução, esta informação é apresentada de forma destacada. Permitindo a análise e se necessário, executar novamente a transação.

As situações divergentes de cadastros, saldos, etc, são nomeadas de erros de negócio. Situações técnicas como queda dos serviços Rest, internet, etc, são nomeadas como erros técnicos.

Os principais processo integrados disponíveis com o WMS e a integração CORE, são:

• Recebimento: Integração das notas fiscais de entrada, para realizar o processo de recebimento, conferência e armazenamento.
• Pedidos: Integração de pedidos para separação, conferência e packing.
• Estoque: Inventário (WMS p/ ERP), Entrada/saída Simplificada (WMS p/ ERP)
• Manufatura Matéria primas: requisição e devolução
• Manufatura entrada de produto acabado.

No WMS, no acesso ao monitor Integração, existe o botão configuração onde será necessário cadastrar:

Organização: neste cadastro deve ser informado qual o estabelecimento ou filial relacionada ao ERP, para que sempre que executado um GET no filtro seja repassada esta informação para que o sistema consiga relacionar a Unidade de negócio do WMS, com o estabelecimento/Filial do ERP.

O conceito de Estabelecimento/Filial, pode ser considerado a unidade fiscal da empresa.

Tipo de estoque: O WMS permite relacionar o saldo do produto a um tipo de estoque, que sendo um tributo do saldo, engloba qualquer produto, endereço, lote, etc…Conceitualmente, este tipo de estoque, deve refletir o saldo do depósito/armazém no ERP. Ex: Supondo que o saldo do ERP esteja no depósito EXP este saldo deve estar no WMS com o Tipo de estoque EXP, assim como por exemplo o saldo em um depósito/armazém ou status CQ, no WMS este deve estar relacionado ao tipo de estoque CQ.

Os nomes entre os depósito/armazém e os tipos de estoques não precisam ser iguais, mas o cadastro deve estar relacionado. Este cadastro permite que o saldo de determinado depósito/armazém, seja no recebimento ou na integração, respeite as informações originadas no ERP. EX: Supondo que uma nota fiscal de entrada esteja tenha a sequência 01 com o produto para o depósito/armazém EXP e a sequência 02 esteja para o depósito/armazém CQ. A configuração interpreta esta informação e busca no DE X PARA cadastrado na configuração esta informação, registrando na nota fiscal esta informação, pois o WMS com esta informação registrada respeita os processos direcionados ao tipo de estoque.

Para o processo de expedição também ocorre o mesmo processo. Ex: Supondo que o pedido esteja com a sequência 01 com o produto para o depósito/armazém VEN e a sequência 02 esteja para o depósito/armazém EXP. A integração deve preencher no campo tipo de estoque a informação relacionada, para que o WMS somente atenda com os saldos para cada tipo de estoque informado.

Autenticação: As integrações ocorrem em chamadas REST, assim o AUTHORIZATION: basic_auth HTTP: basic_auth HTTP Authorization Scheme: basic O Ambiente onde a integração CORE deverá chamar as APIs, o tipo deve ser o basic_auth que corresponde no envio das informações necessárias para o login no ERP que será integrado. Muito importante este usuário e senha estar cadastrado como NÃO EXPIRA a senha. As informações de usuário e senha, deve ser incluída no cadastro disponível na configuração do ERP, conforme mencionado no tópico de parametrizações.

Endereço de execução: No documento, serão definidas as localizações e caminhos para os endereços das APIs. è muito importante seguir este padrão para que as chamadas consigam interagir com as APIs. Ex: a API REST que será realizado o GET Buscar a lista de documentos de recebimento, deve estar no caminho /wms/api/v1/documentos.

O processo de recebimento tem como objetivo integrar as notas fiscais de recebimento com o fluxo do WMS de gestão de documentos de recebimento.

Dica de negócio: Como as notas fiscais apresentam várias sequências e muitas vezes são necessários diferentes direcionamentos para estas sequências, uma sugestão e para definição de quais sequências serão integradas com o WMS, sejam por depósito ou armazém no ERP. Pois permite a flexibilidade do processo, pois permite, por exemplo, destinar itens para outros processos que não precisam passar pelo WMS.

A liberação para integração, deve registrar o data TIME (Ex: 2023-08-19 11:10:12), o qual denominamos STAMP, que uma das chaves do filtro.

O processo está dividido em dois GETs para buscar os documentos:

• O primeiro GET é Buscar a lista de documentos de recebimento que buscamos o cabeçalho dos documentos que pretendemos integrar e colocamos em uma fila de execução dentro do sistema de gestão de integrações. Caso ocorra alguma divergência de integração, esta informação é apresentada no monitor, permitindo o reprocessamento.

• A fila gerada, executa o outro GET Buscar documento de recebimento completo, que busca o documento completo cabeçalho + itens, para assim executar as APIs do WMS para gerar os documentos. Caso ocorra alguma divergência de integração, esta informação é apresentada no monitor, permitindo o reprocessamento.

Esta arquitetura permite “suavizar” o fluxo de informações e as execuções das APIs, assim como o tamanho dos arquivos trafegados, mitigando possíveis capacidades de execução.

Dica de negócio: É importante a API somente disponibilizar no GET os documentos que não serão alterados quando liberados para integração, para evitar divergência de informações entre os sistemas. Normalmente para o sistema do cliente pode ser um status diferente no documento, que pode ser atualizado por um operador ou um processo automatizado. Este status normalmente é chamado de “Liberado para integração”, assim evita que o documento seja integrado enquanto estiver sendo atualizado no sistema do cliente, evitando ir somente uma parte do documento, pois normalmente um documento de nota fiscal de entrada, podem conter várias sequências. O documento estando no status “Liberado para integração” deve estar bloqueado para alterações, para evitar divergências de informações entre os sistemas e é sugerido via processo de Cancelar/Inativar documento de entrada que volte ao status anterior ao “Liberado para integração”.

Efetuado com sucesso o GET Buscar documento de recebimento completo e consequentemente o documento no WMS, a camada CORE retorna a mensagem de sucesso, via POST Atualizar documento de entrada para integrado para que no sistema de origem da informação, possa acompanhar os status dos processos. Este registro que o documento foi integrado, é importante estar na tabela onde são gravados os documentos disponíveis para integração, pois quando executado o GET de para buscar os documentos para integrar(Buscar a lista de documentos de recebimento), este documento não poderá estar disponibilizado para integrar.

Dica de negócio: Sugerimos neste POST atualizar o status do atual “Liberado para integração” para “integrado WMS”.

Uma vez no WMS, o documento segue as rotinas do WMS, sendo que no último processo, denominado Finalização da conferência, ao monitoramento ativo das transações realizada pelo CORE na nuvem do WMS SaaS, busca as informações do documento e produtos (quantidades, características, etc) para realizar o POST na API Finalizar conferência do documento de entrada para que seja possível atualizar as informações da nota fiscal. Este processo é importante para que caso exista alguma divergência entre o fiscal e físico, o sistema do cliente possa realizar as consistências. Dica de negócio: Sugerimos neste POST atualizar o status do atual “Integrado” para “WMS Retornou SEM divergência” e caso exista divergência fique “WMS Retornou COM divergência”, para que o responsável pelo processo de recebimento possa realizar as ações pertinentes ao processo ou caso exista alguma automatizações, esta fique transparente para o operador.

Para manter a integridade entre os sistemas, ainda temos disponíveis a API Cancelar/Inativar documento de entrada que permite o WMS informar o sistema do cliente que o processo de recebimento do documento foi cancelado. Este procedimento normalmente é utilizado para que sejam realizadas alterações no documento no sistema do cliente e reintegrado o documento com o WMS, pois o WMS não permite integrar documentos com a mesma chave (documento + série + fornecedor) e também não permite eliminar do documento no WMS. A única maneira de reintegrar um documento com o WMS é inativar um registro para que possa ser reintegrado.

Fluxo sugerido:

• Gerar documento no ERP
  • Status ERP “Não integrado”
• Disponibilizar documento para integração.
  • Alterar Status ERP “Liberado para integração”
    • GET Buscar a lista de documentos de recebimento
    • GET Buscar documento de recebimento completo
• POST Atualizar documento de entrada para integrado
  • Alterar Status para “Integrado”.
• POST Finalização da conferência
  • Documento está com divergência?
    • SIM. Alterar status para “WMS Retornou COM divergência”
    • NÃO. Alterar status para “WMS Retornou SEM divergência”

O processo de pedido tem como objetivo integrar os pedidos ou notas fiscais de saida do ERP com fluxo do WMS de gestão de documentos de pedidos.

Dica de negócio: Como os pedidos apresentam várias sequências e muitas vezes são necessários diferentes direcionamentos para estas sequências, uma sugestão e para definição de quais sequências serão integradas com o WMS, sejam por depósito ou armazém no ERP. Pois permite a flexibilidade do processo, pois permite, por exemplo, destinar itens para outros processos que não precisam passar pelo WMS.

No ERP, a confirmação da liberação para integração do documento, deve registrar o data TIME (Ex: 2023-08-19 11:10:12), o qual denominamos STAMP, que é uma das chaves do filtro. Esta informação é utilizada para que o CORE saiba qual o último horário para realizar nova busca (GET), por isso passamos no filtro e também é recebido no GET de Buscar a lista de pedidos de venda. Ex: no filtro GET o CORE passou 2023-08-19 11:10:12, assim devem ser enviados todos os documentos com time stamp >= que 2023-08-19 11:10:12. Supondo que na lista de documentos foi recebido o último registro recebido foi 2023-08-19 12:05:10, na próxima execução do GET, o filtro encaminhado será 2023-08-19 12:05:11.

O processo está dividido em dois GETs para buscar os documento:

• O primeiro GET é Buscar a lista de pedidos de venda que buscamos o cabeçalho dos documentos que pretendemos integrar e colocamos em uma fila de execução dentro do sistema de gestão de integrações. Caso ocorra alguma divergência de integração, esta informação é apresentada no monitor, permitindo o reprocessamento.
• A fila gerada, executa o outro GET Buscar pedido de venda completo, que busca o documento completo cabeçalho + itens, para assim executar as APIs do WMS para gerar os documentos. Caso ocorra alguma divergência de integração, esta informação é apresentada no monitor, permitindo o reprocessamento.

Esta arquitetura permite “suavizar” o fluxo de informações e as execuções das APIs, assim como o tamanho dos arquivos trafegados, mitigando possíveis capacidades de execução.

Dica de negócio: É importante a API somente disponibilizar no GET os documentos que não serão alterados quando liberados para integração, para evitar divergência de informações entre os sistemas. Normalmente para o sistema do cliente, pode ser um status diferente no documento, que pode ser atualizado por um operador ou um processo automatizado. Este status normalmente é chamado de “Liberado para integração”, assim evita que o documento seja integrado enquanto estiver sendo atualizado no sistema do cliente, evitando ir somente uma parte do documento, pois normalmente um documento de nota fiscal de entrada, podem conter várias sequências. O documento estando no status “Liberado para integração” deve estar bloqueado para alterações, para evitar divergências de informações entre os sistemas e é sugerido via processo de Cancelar pedido de venda que volta ao status anterior ao “Liberado para integração”.

Efetuado com sucesso o GET Buscar pedido de venda completo e consequentemente o documento no WMS, a camada CORE retorna a mensagem de sucesso, via POST Atualizar pedido de venda para integrado para que no sistema de origem da informação, possa acompanhar os status dos processos. Este registro que o documento foi integrado, é importante estar na tabela onde são gravados os documentos disponíveis para integração, pois quando executado o GET de para buscar os documentos para integrar(Buscar a lista de documentos de pedido), este documento não poderá estar disponibilizado para integrar.

Dica de negócio: Sugerimos neste POST atualizar o status do atual “Liberado para integração” para “integrado WMS”. Outra questão importante, é a características de estoque (Lote, data de validade/ série), se no payload encaminhado, esta informação for informada, o WMS recebe esta informação e obrigatoriamente realiza a separação deste. Caso não seja informada, o WMS segue as rotinas dele para seleção de estoque (FIFO, FEFO, Shelf LIFE).

Uma vez no WMS, o documento segue as rotinas do WMS, sendo que no último processo, denominado baixa de estoque/finalização pedido, o monitoramento ativo das transações realizada pelo CORE na nuvem do WMS SaaS, busca as informações do documento e produtos (quantidades, características, etc) para realizar o POST na API Finalização da separação de estoque para que seja possível atualizar as informações nos pedidos. Este processo é importante para atualizar as informações das características de estoque (Lote, data de validade/ série) separadas no WMS, para que sejam atualizadas no ERP.

Dica de negócio: Sugerimos neste POST atualizar o status do atual “Integrado” para “WMS Retornou” para que esteja disponível para faturar. Outro ponto importante é a possibilidade do WMS trabalhar com características e o ERP sem, neste caso a API esteja preparada para desconsiderar esta informação. Ainda neste contexto, se o cliente atua com características de estoque no WMS e no ERP é importante a API que recebe o POST, estar preparada para atualizar estas informações no pedido.

Para manter a integridade entre os sistemas, ainda temos disponíveis a API Cancelar pedido de venda que permite o WMS informar o sistema do cliente que o processo de atendimento do pedido foi cancelado. Este procedimento normalmente é utilizado para que sejam realizadas alterações no documento no sistema do cliente e reintegrado o documento com o WMS, pois o WMS não permite integrar documentos com a mesma chave (pedido + cliente + data) e também não permite eliminar do documento no WMS. A única maneira de reintegrar um documento com o WMS é inativar um registro para que possa ser reintegrado.

Fluxo sugerido:

• Gerar documento no ERP
  • Status ERP “Não integrado”
• Disponibilizar documento para integração (neste momento deve ser gerado o registro do timestamp).
  • Alterar Status ERP “Liberado para integração”
    • GET Buscar a lista de pedidos de venda
    • GET Buscar pedido de venda completo
• POST Atualizar pedido de venda para integrado
  • Alterar Status para “Integrado”.
• POST Finalização da separação de estoque
  • Necessário controlar características de estoque no ERP?
    • SIM. Alterar pedido/estoque para considerar as características de estoques recebidas (lote/data de validade, etc)
    • NÃO.
  • Altera status para “retornou WMS”.

O processo de atualização do número da nota fiscal tem como objetivo integrar o número da nota fiscal dos pedidos já faturados no ERP ao fluxo de expedição do WMS, garantindo que os documentos de transporte e demais etapas logísticas utilizem essa informação de forma precisa e sincronizada.

A primeira etapa consiste na verificação do pedido faturado no ERP e no registro desse documento nas tabelas que serão gerenciadas. A partir desse ponto, inicia-se uma rotina de polling periódica à API do ERP por meio do processo "Atualiza Número Nota Fiscal - Expedição". A API GET Buscar número da nota fiscal do pedido faturado é acionada com o objetivo de recuperar o número da nota fiscal vinculada ao pedido. Uma vez localizada, essa informação é registrada no WMS e associada corretamente ao pedido correspondente.

Dica de negócio: É fundamental que o ERP disponibilize o número da nota fiscal apenas quando o documento estiver em um status estável e definitivo, como “NF Emitida” ou “Pedido Faturado e Liberado”. Isso evita divergências entre os sistemas, como documentos parcialmente processados ou ainda em edição. Uma boa prática é utilizar um campo no ERP com o status “Liberado para integração”, que impede alterações no documento enquanto ele estiver disponível para consumo pelo WMS. Se necessário interromper esse fluxo, recomenda-se utilizar o processo de “Cancelamento de liberação”, retornando o documento ao status anterior.

Após a obtenção bem-sucedida da nota fiscal via GET, o sistema registra o sucesso da integração, vinculando o número da nota fiscal ao pedido no WMS. Em seguida, é realizada a chamada POST Atualizar número da nota fiscal para integrado, informando ao ERP que o documento foi integrado com sucesso. Esse retorno é essencial para o controle do ciclo da integração e evita que o mesmo documento seja incluído novamente em execuções futuras do polling. É imprescindível que esse status seja registrado na mesma entidade ou tabela utilizada para disponibilizar os documentos, garantindo que o GET subsequente ignore registros já processados.

Em caso de falha na consulta — seja por erro técnico ou pela ausência da informação no ERP — o processo registra automaticamente o erro no monitor de integração, permitindo que o operador realize o reprocessamento manual, sem gerar sobrecarga por tentativas automáticas repetitivas.

Fluxo Resumido: Atualização do Número da Nota Fiscal - Expedição

• Faturar pedido de venda no ERP
• Status no ERP: “Faturado - Não Integrado”
• Disponibilizar o pedido faturado para integração (status: “Liberado para integração”)
• Início do processo "Atualiza Número Nota Fiscal - Expedição" no WMS
• GET Buscar número da nota fiscal do pedido faturado (via polling)
• Registrar número da nota fiscal no WMS e associar ao pedido
• POST Atualizar número da nota fiscal para integrado
• Alterar status no ERP para: “Faturado - Integrado”
• Encerrar execução do processo e registrar no monitor de integração

As integrações de estoques, são um conjunto de APIs que permite a conectar os fluxos de manutenção de saldos e fluxos de negócio entre o o WMS e o ERP.

• Finalização inventário: integra os saldos inventariados no WMS com o ERP.

• Atualização montagem e desmontagem de kits: integra as montagens e desmontagens de kits no WMS com o ERP.

• Finalização movimento simplificado: Integra as entradas e saídas e saídas de estoques simplificadas realizadas via APP do WMS com ERP TOTVS.

• Finalizar movimentação de Estoque: Integra os movimentos de trocada de estoques e realizadas via APP do WMS com ERP TOTVS.

O WMS atende os fluxos de manufatura para produtos acabados, nomeado de Entrada de produção e as requisições, que pode ser os atendimentos das matérias primas para o abastecimento da linha de produção e as devoluções que podem ser consideradas os retornos dessas requisições ou até mesmo sobras de matérias primas da linha de volta para o almoxarifado.

O fluxo de requisição e retornos, podem ser também utilizados para movimentações de saídas e entradas internas no WMS, como por exemplo uma transferência entre depósitos, requisição de estoque, etc.

Para gerar os processo de requisição devem ser utilizadas as APIs:

• Buscar lista de requisições e por requisição: Busca os documentos com os itens necessários para realizar a requisição.

O WMS atende os fluxos de manufatura para produtos acabados, nomeado de Entrada de produção e as requisições, que pode ser os atendimentos das matérias primas para o abastecimento da linha de produção e as devoluções que podem ser consideradas os retornos dessas requisições ou até mesmo sobras de matérias primas da linha de volta para o almoxarifado.

O fluxo de requisição e retornos, podem ser também utilizados para movimentações de saídas e entradas internas no WMS, como por exemplo uma transferência entre depósitos, requisição de estoque, etc.

Para gerar os processo de devolução, devem ser utilizadas as APIs:

• Buscar lista dos documentos de devolução a serem integrados e Buscar dados completos do documento de Devolução: O primeiro GET busca os documentos para integrar e o segundo busca o documento completo (utilizar como exemplo o processo de recebimento e pedidos).

O WMS atende os fluxos de manufatura para produtos acabados, nomeado de Entrada de produção e as requisições, que pode ser os atendimentos das matérias primas para o abastecimento da linha de produção e as devoluções que podem ser consideradas os retornos dessas requisições ou até mesmo sobras de matérias primas da linha de volta para o almoxarifado.

O fluxo de requisição e retornos, podem ser também utilizados para movimentações de saídas e entradas internas no WMS, como por exemplo uma transferência entre depósitos, requisição de estoque, etc.

Para gerar os processo de apontamento de produção, devem ser utilizadas as APIs:

• Buscar apontamentos de produção e Atualizar status da produção para integrado: Busca os documentos com os itens necessários para realizar a entrada de produção e confirmação para o ERP do fluxo realizado no WMS.