01. DADOS GERAIS

Produto:

Segmento:

Módulo:Integração.
Função:Integração WMS Saas / TOTVS Moda
País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :

DVAARM-9733

DVAARM-9732

DVAARM-9583

DVAARM-9595

DVAARM-9579


02. SITUAÇÃO/REQUISITO

Possibilitar a integração entre os sistemas WMS Saas e TOTVS Moda, contemplando a integração de documento fiscal, pedido de venda, movimentação de estoque através do processamento da contagem e balanço.

03. SOLUÇÃO

Para a integração de documento fiscal será utilizado o componente INTFM034 (Lista/Manutenção de Nota Fiscal para Integração), onde será cadastradas as notas fiscais para integração, assim sendo possível também a consulta da sua atual situação perante a integração entre os dois sistemas.

Após integrada a Nota fiscal no TOTVS Moda no componente entrada por XML (GERFM076) pode-se dar continuidade ao processo de contagem e encerramento da NF.

Na integração de pedido de venda será utilizado o componente INTFM035 (Lista/Manutenção de Pedido de Venda para Integração), onde será informado os pedidos de vendas para a integração, sendo possível continuar o pedido venda fazendo o seu faturamento.

Na movimentação de estoque teremos o componente INTFM036 (Configuração Movimentação de Estoque) que será utilizar para determinar a operação a ser utilizada na movimentação de estoque conforme campos configurado no mesmo.

Para efetuar a movimentação de entrada no TOTVS Moda, gerando a transação e movimentando o estoque teremos o componente INTFP074 (Processar Movimento de Estoque).

O componente BALFM015  recebeu um novo campo que armazena o código de inventario do WMS Saas.

Para o de envio das finalizações de ordens de produção para o WMS teremos o componente INTFM038(Lista/Manutenção de Finalização de O.P. para Integração).

Todos os processo de integração com WMS Saas já contemplam itens de lote.

Abaixo os links para acesso a documentação das APIs do TOTVS Moda e também do WMS Saas.


O componente INTFM034 é o componente onde informamos quais notas fiscais serão integradas com o WMS Saas .

No seu quadro de "Filtro" podemos informar "Empresa", "Data fatura" e "Situação" para consultar notas já cadastradas, visualizando seus dados a situação e data de integração.

Para que uma nota fiscal seja integrada deve-se clicar no botão "Incluir NF", que exibirá o filtro de nota, vale lembrar que somente notas fiscais modelo 55 (NF-e) e de entrada serão permitidas.

Para efetuar a gravação das notas fiscais o botão "Gravar" deve ser acionado

A nota fiscal pode ter as seguinte situações durante a integração:

  • Aguardando integração: Significa que a nota foi adicionada para ser integrada mas ainda não foi processada.
  • Aguardando contagem: Indica que a mesma já foi integrada ao WMS Saas.
  • Cancelada: Indica que a mesma não será integrada ao WMS Saas.
  • Contagem encerrada: Habilita os botões "Conf. integração" e/ou "Contagem XML" que permite processar as integrações.

Caso seja necessário retirar uma nota fiscal da integração é preciso selecionar a mesma e clicar no botão cancelar, após integrada não será mais possível efetuar sua remoção


Imagem 1 - Acima vemos como exemplo o componente INTFM034, podemos ver as situações que se encontram as notas fiscais em relação a integração com o WMS Saas.

Após integrada a nota fiscal, podemos dar continuidade a mesma, fazendo a sua contagem que é enviada pelo WMS Saas, pra consultar a contagem vamos no componente GERFM076 → FISFM089 → FISFC078.


Imagem 1 - No GERMF076 clicamos no botão "Manutenção NF...", onde será aberto o componente FISFM089.


Imagem 2 - Para consultar a contagem enviada pelo WMS Saas vamos em "Opções", "Conf. integração...", onde será chamado o componente FISFC078.


Imagem 3 - No componente FISFC078,  podemos conferir a contagem enviada pelo WMS Saas com os itens da nota fiscal.

O componente INTFM035 é responsável por gerenciar os pedidos de venda que serão integrados com o WMS SaaS. Na seção Filtro, é possível realizar consultas utilizando os seguintes parâmetros:

  • Empresa
  • Data pedido
  • Situação

Esses filtros permitem visualizar pedidos já cadastrados, possibilitando a consulta de informações como a situação do pedido ou a data de integração, por exemplo.

Para incluir um pedido de venda para integração, clique no botão "Incluir Pedido". Isso abrirá a tela de filtro para seleção do pedido. Após incluir o pedido, a classificação indicada no parâmetro "CD_TIPOCLAS_WMS" será registrada automaticamente. Selecione os pedidos de venda desejados e clique no botão "Gravar" para concluir o processo e disponibilizar os pedidos para integração com o WMS SaaS.

Caso seja necessário cancelar a integração de um pedido, selecione o pedido e clique no botão "Cancelar". Vale ressaltar que não é possível cancelar a integração de pedidos que já foram integrados. Após o cancelamento, a classificação registrada previamente será removida.

O botão "Faturar" será habilitado apenas para pedidos com a contagem encerrada. Ao clicar nesse botão, será possível faturar o pedido de venda dentro do sistema TOTVS Moda, gerando todas as movimentações.


Imagem 1 - Acima vemos como exemplo o componente INTFM035, podemos ver as situações que se encontram os pedidos de vendas em relação a integração com o WMS Saas.

O componente INTFM036 foi desenvolvido para configurar os tipos de movimentação de estoque.

Ao iniciar o cadastro, o campo sequência pode ser preenchido automaticamente ao pressionar a tecla <TAB>.

Neste componente, será necessário informar o tipo de movimento, que pode ser um dos seguintes:

  • Estoque.
  • Simplificado.

Para movimentação do tipo "Estoque", é obrigatório preencher os seguintes campos:

  • Saldo origem.
  • Saldo destino.

Para movimentação do tipo "Simplificado",  é necessário informar:

  • Saldo origem
  • Tipo de operação.
  • Operação.


Imagem 1 - Exemplo de cadastro com o tipo de movimento igual a "Estoque".


Imagem 2 - Exemplo de cadastro com o tipo de movimento "Simplificado".


O componente INTFP074 foi desenvolvido para processar a movimentação de estoque entre o WMS SaaS e o TOTVS Moda.

Após a integração da movimentação de estoque entre os sistemas, essas movimentações devem ser efetivadas no TOTVS Moda.

No INTFP074, serão exibidas todas as movimentações recebidas. Com base na configuração realizada no componente INTFM036, o sistema sugerirá automaticamente a operação necessária para efetivar o processo.

Ao processar o registro, a movimentação de estoque será registrada no TOTVS Moda, gerando a transação correspondente. Essa transação poderá ser consultada no campo "Transação" dentro do quadro "Movimento".


Imagem 1 - Acima vemos o componente de processar movimento de estoque.


No componente BALFM015 Foi adicionado um novo campo "Cód. integração" que será utilizado para armazenar o código de inventario do WMS Saas.


Imagem 1 - BALFM015 com o campo "Cód. integração" destacado.


O componente INTFM038 (Lista/Manutenção de Finalização de O.P. para Integração) tem como objetivo listar as ordens de produção e realizar a integração das mesmas com o WMS Saas.

O processo de envio das finalizações de ordens de produção para o WMS inicia-se com o acesso ao componente INTFM038. Em seguida, no componente CDFFC038, deve-se clicar no botão "Incluir O.P..." para selecionar as ordens de produção desejadas. Após abrir a tela de seleção, aplica-se o filtro necessário para visualização e seleção das ordens de produção. Essas ordens são então transferidas para o INTFM038 por meio do botão "Confirmar". De volta ao INTFM038, ao pressionar a tecla F3 para gravar, as ordens de produção são marcadas para integração, ficando com o status "Aguardando Integração". Para verificar se as ordens foram devidamente marcadas, realiza-se uma nova consulta no sistema, filtrando pelo status "Aguardando Integração". Dessa forma, é possível confirmar que as ordens selecionadas no processo anterior estão prontas para a integração com o WMS.


  • Imagem 01 INTFM038  Lista/Manutenção de Finalização de O.P. para Integração.

Existe o parâmetro por empresa DS_CONFIG_INT_WMS que reúne todos as configurações necessárias para a utilização do WMS Saas

Imagem 1 - Parâmetro por empresa para utilização do WMS Saas.


Dentro desse parâmetro temos as configurações:

  • DS_URLCREDENCIAIS: URL para requisição do token
  • DS_URLBASE: URL para requisição de dados WMS
  • DS_CLIENTID: Código de identificação para requisição do token
  • DS_CLIENTSECRET: Senha de identificação para requisição do token
  • DS_USERNAME: Usuário de acesso para permissionamento do token
  • DS_PASSWORD: Senha de usuário para permissionamento do token
    • IN_DESMEMBRAMENTO: Utiliza a integração WMS no desmembramento de item de lote
  • NR_CNPJEMPRESA: Código do CNPJ vinculado a unidade no WMS
  • IN_DEPOSITANTE: Define se a empresa e depositante
  • DS_LST_CFOP_DEPOSITANTE: Lista de CFOP para controle de depositante ao documento. exemplo: (10;11;12)
  • QT_CARACTER_CODIGO_BARRA: Quantidade total do código de barra que será incrementado a esquerda para completar o total
  • DS_CARACTER_COMPLETAR: Caráter relacionado ao código de barra que será usado juntamente com o campo anterior
  • CD_TIPOEMBALAGEM: Código do tipo de embalagem usado para contagem de pedidos
  • CD_ARMAZEM: Código do armazém relacionado a empresa
  • TP_ENV_PED_AUTOMATICO_WMS: Envio automático ao WMS Saas: vazio ou 0 não enviar - 1 via api - 2 via painel - 3 via api e painel
  • TP_ESPECIE: 1 - descrição da espécie produto se não informado retornara unidade como padrão
  • IN_AGRUPAMENTO: Utiliza a integração WMS Saas no agrupamento item lote


Imagem 2 - Parâmetro por empresa para utilização do WMS Saas com todas as configurações que podem ser preenchidas.

Foi desenvolvido um painel (PEDFP163) com os pedidos de venda e suas situações, com o objetivo de possuir um controle de todos os pedidos da empresa e realizar as ações necessárias dependendo da sua situação.

O PEDFP163 (Painel de Controle de Pedido de Venda) possui o filtro para buscar os pedidos e possui as abas onde os pedidos são divididos de acordo com a sua posição.

O filtro pode ser selecionado dois tipos:

  • Filtro de pedido: Onde será disponibilizado alguns campos de filtro para buscar os pedidos que serão apresentados no painel. 
    Campos que serão disponibilizados ao selecionar o tipo de filtro "Filtro de pedido" que serão considerados para buscar os pedidos apresentados no painel:
    • "Empresa...*": Botão que permite selecionar as empresas do pedido.
    • "Dt. pedido *": Filtro para informar o intervalo de datas do pedido.
    • "Operação ...": Botão que permite selecionar as operações do pedido.
    • "Situação ..": Botão que permite selecionar as situações do pedido.
  • Seleção de pedido: Ao selecionar este tipo ficará disponível o botão "Pedido...", que ao clicar irá abrir o PEDFF002(Filtro Geral de Pedido de Venda) onde será possível usar os filtros deste componente para filtrar selecionar os pedidos.

Ao listar os pedidos no painel os pedidos serão distribuídos de acordo com a posição atual do pedido.
As abas podem ser:

  • Todos;
  • Recebimento pendente;
  • Aprovação do limite;
  • Envio WMS;
  • Aguardando contagem WMS;
  • Contagem Encerrada WMS;
  • Aguardando separação;
  • Em separação;
  • Separação encerrada;
  • Recebimento saldo pendente;
  • Liberado faturamento;
  • Faturado;
  • Parcialmente atendido.


Sendo:

Todos:

Aba com a lista de todos os pedidos independente da posição atual do pedido.

Nesta aba os botões das ações não são habilitados.


Recebimento pendente:

Esta aba se fez necessária devido a seguinte situação, o cliente tem um primeiro atendimento por meio de um portal onde é lançado os itens e criado via API (Sales Order) o pedido no Totvs Moda. Ocorre que neste primeiro atendimento é solicitado o pagamento total ou parcial do pedido.

Assim ao chegar o pedido no Totvs Moda alguns tipos de documento financeiro precisam ter interações no sistema para finalizar o recebimento enquanto que alguns (fatura, adiantamento) não precisam realizar nenhuma interação do usuário, desta forma este pedidos que necessitam de interação ficam na aba "Recebimento pendente".

Nesta aba é disponibilizado a ação "Receber", onde ao clicar será aberto o FCRFP012 (Entrada por Adiantamento) para finalizar o recebimento. Independente da forma de pagamento a partir deste pagamento gerara um saldo de adiantamento para o cliente que será consumido ao faturar o pedido.


Observação: O recebimento parcial ocorre quando é solicitado ao cliente um valor de entrada antes de realizar a separação do pedido que não representa o valor total do pedido. É necessário para criar o pedido com recebimento parcial, mandar o somatório dos valores do "payments" (valores dos recebimentos) da API Sales Order com o valor diferente do "totalAmountOrder" (valor total do pedido), para isto deve-se informar o percentual mínimo do valor da entrada  desta empresa no parâmetro PR_MIN_PAYMENTS_API_PED caso não tenha definição não será possível o recebimento parcial do valor somente o total assim o valor do "payments" deve ser igual ao "totalAmountOrder".

Aprovação do limite:

Esta aba lista os pedidos com situação "bloqueado" que precisam ser processados validando as políticas comerciais configuradas no PEDFM074 para serem desbloqueados.

Nesta tipagem será disponibilizada a ação "Aprovar", onde ao clicar será executado o processo de validação das políticas comerciais para a aprovação do pedido do PEDFP074 (Processa Pedido de Venda utilizando Política Comercial).

Caso configurado uma política comercial padrão para aprovação no parâmetro CD_POLITICA_COMERCIAL_PAD irá abrir o PEDFPP074 rapidamente em tela, executar e fechar automaticamente desbloqueando o pedido. Caso não esteja liberado será necessário selecionar a política comercial e processar o PEDFP074 manualmente para realizar o desbloqueio do pedido.

Envio WMS:

Nesta aba será listado os pedidos disponíveis para a integração com o WMS.

Somente irá apresentar pedidos nas abas "Envio WMS", "Aguardando contagem WMS" e "Contagem Encerrada WMS" caso o parâmetro DS_CONFIG_INT_WMS esteja configurado.

Nesta tipagem será disponibilizada a ação "Enviar", onde ao clicar será executado o processo do INTFM035 realizando o envio da integração ao WMS, para que possa dar inicio ao processo de separação de estoque dos produtos do pedido de venda pelo WMS.

Aguardando contagem WMS:

Nesta aba será listado os pedidos que foram realizado o envio da integração para o WMS que estão aguardando a realização da separação de estoque dos produtos do pedido e o retorno da contagem pelo WMS.

Contagem Encerrada WMS:

Nesta aba será listado os pedidos que foram retornado pela integração do WMS com a contagem realizada.

Neste momento será criada a contagem vinculada ao pedido com situação encerrada. E será alterado a situação da integração para  "4 - Contagem encerrada".

Aguardando separação:



Em separação:



Separação encerrada:



Recebimento saldo pendente:


Em algumas situações pode ocorrer de gerar um saldo faltante de recebimento, por exemplo no pedido é solicitado uma quantidade de tecido e pago o adiantamento referente a esta quantidade, ao fazer a contagem a quantidade do tecido pode ocorrer de ser maior devido ao tamanho do lote de tecido disponível e este lote não ser desmembrável. Desta forma a diferença entre o valor pago e o valor gerado a partir da contagem deve ser recebida antes do faturamento do pedido.

Assim nesta aba constará os pedidos que possuem saldo pendente de recebimento gerado após a contagem dos produtos.




Liberado faturamento:

Aba com a lista de pedidos que estão liberadas para realizar o faturamento do pedido.



Faturado:

Aba com a lista de pedidos atendidos.

Parcialmente atendido:

Aba com a lista de pedidos parcialmente atendidos.