Páginas filhas
  • Integração Recebimento com WMS SaaS

01. SITUAÇÃO/REQUISITO

Adaptação do módulo de recebimento da linha Datasul para realizar a integração com o WMS Saas/Externo. 

02. SOLUÇÃO

Para usar esta integração do recebimento da linha Datasul com o WMS Saas/Externo, será necessário realizar toda a configuração no WMS Saas/Externo e no sistema Datasul.

No que diz respeito a configuração do sistema Datasul será necessário configurar as seguintes rotinas: 

CD0101 - Atualização Parâmetro Global

Na pasta "Integr II", deverá ser marcado o campo "WMS Externo".


CD0601 - Manutenção Depósitos

Criar um novo depósito que terá os saldos controlados pelo WMS Saas/Externo, marcando o campo "Depósito WMS Externo". Deve-se também criar uma localização para o depósito (CE0105 - Localização Estoque) e contas de saldo (CE0110 - Contas Contabilização).


CD0140 - Manutenção Item x Estab Materiais

Definir os itens que serão armazenados no depósito controlado pelo WMS Saas/Externo. Para isso pode-se informar o depósito de WMS Externo como sendo o padrão do item.


RE0103 - Manutenção Parâmetros Recebimento ou html.mre.receivingParameters - Parâmetros Recebimento

Se estiver parametrizado para se trabalhar com o "Receb Físico", todas as notas de itens que devem ser armazenados no depósito de WMS Externo deverão ser lançadas pelo recebimento físico. 


Abaixo, colocamos a imagem contendo o fluxo da integração do recebimento físico com o WMS Saas/Externo. Em resumo, a nota deverá ser digitada/gerada normalmente no recebimento físico, quando pronta, o usuário deverá clicar para atualizar a nota, neste momento o sistema verificará se a nota possui depósitos configurados para integrar com WMS Saas/Externo, se possuir, a nota terá a situação WMS externo alterado para "Aguardando". A integração com o WMS Saas/Externo é assíncrona, então o recebimento irá aguardar o WMS Saas/Externo vir buscar a nota. Quando a nota for buscada e criada no WMS Saas/Externo a situação WMS externo da nota no recebimento será alterada para "Em Processo".

Neste momento o fluxo de trabalho deverá ser realizado no WMS Saas/Externo, efetuando a conferência das quantidades dos itens da nota. Após o término desta conferência, o WMS Saas/Externo irá retornar para o recebimento se a conferência realizada apresentou ou não diferenças. No caso de apresentar diferenças, a situação WMS externo será alterada para "Conferência NOK", neste caso, sugere-se que a nota seja ajustada enviando as quantidades divergências para outro depósito que não seja WMS Saas/Externo. No caso de não apresentar diferenças, a situação WMS externo será alterada para "Conferência OK".

Após o retorno da conferências do WMS Saas/Externo, a nota poderá ser atualizada no estoque.




RE2001 - Recebimento Físico

A tela de digitação/manutenção de documentos do recebimento físico foi alterada para apresentar o campo "Situação WMS Ext", para que o usuário do recebimento possa acompanhar o status de integração do recebimento com o WMS Saas/Externo. 

Quando a nota for digitada/gerada, ela ficará com o campo "Situação WMS Ext" como "Não Integra".


Quando a nota estiver pronta, o usuário deverá clicar no botão check verde (Atualização), para que o sistema verifique se esta nota possui depósitos configurados para integrar com o WMS Saas/Externo, caso possua, o sistema irá apresentar uma mensagem informando que o documento foi disponibilizado para integração e o campo "Situação WMS Ext" será alterado para "Aguardando" e não irá integrar a nota com o estoque neste momento.



Importante:

  • Itens com depósitos marcados como "Depósito CQ", e que possuírem no relacionamento item x estabelecimento (CD0140 - Manutenção Item x Estab Materiais) o depósito padrão um depósito marcado "Depósito WMS Externo", também serão integrados com o WMS Saas/Externo, pois o seu destino final de armazenagem será um depósito controlado pelo WMS Saas/Externo.
  • Não serão enviados para o WMS Saas/Externo itens de controle debito direto, itens com ordem de produção informada, itens com quantidade zero, itens de controle total com conta informada, ou itens que não baixem estoque.


Quando a nota for buscada e criada no WMS Saas/Externo, o campo "Situação WMS Ext." será alterado para "Em Processo".


Depois do término da conferência, o WMS Saas/Externo irá retornar para o recebimento se a conferência realizada apresentou ou não diferenças. No caso de apresentar diferenças, o campo "Situação WMS Ext" será alterado para "Conferência NOK", neste caso, sugere-se que a nota seja ajustada, informando outro depósito que não seja WMS Saas/Externo para as quantidades divergências. No caso de não apresentar diferenças, o campo "Situação WMS Ext" será alterado para "Conferência OK".


Quando a nota estiver com a "Situação WMS Ext" como "Conferência OK" ou "Conferência NOK", a nota poderá ser atualizada no estoque, e poderá seguir o fluxo restante normalmente, ou seja, poderá ser puxada para o recebimento fiscal e atualizada no recebimento fiscal.

Atenção: Caso a nota esteja com a "Situação WMS Ext" como "Conferência NOK", o usuário deverá possuir permissão para atualizar com advertência. E após a atualização da nota, ficará registrado nas mensagens de erro/advertência da nota (RE2020), que a nota apresentou diferença na conferência do WMS Saas/Externo.


Caso o WMS Saas/Externo possua a necessidade de reabrir a conferência, o campo "Situação WMS Ext" será alterado para "Em processo". Para que seja possível reiniciar a conferência, a nota não poderá ter sido atualizada.


RE2005 - Atualização Doctos Físicos

A rotina de atualização de documentos do recebimento físico, foi alterada para identificar se a nota deve ou não ser integrada com o WMS Saas/Externo, e para impedir a atualização da nota, caso a nota não esteja com a "Situação WMs Ext" como "Conferência OK" ou "Conferência NOK". 


RE2006 - Desatualização Doctos Físicos

Caso haja a necessidade de desatualizar a nota, para exclui-la, ou para excluir um item, ou para refazer a integração da nota com o WMS Saas/Externo, pode-se efetuar a inativação do documento no WMS Saas/Externo, ao fazer isso, o campo "Situação WMs Ext" da nota será alterado para "Inativado".


Na tela de desatualização de documentos do recebimento físico, na pasta Parâmetros, foi adicionado o campo "Considerar Situação WMs Externo?", que irá verificar a "Situação WMs Ext" para permitir ou não a desatualização da nota.


Quando marcado o campo "Considerar Situação WMs Externo?", o sistema irá verificar se a "Situação WMs Ext" da nota está como "Inativado", caso não esteja, não irá permitir a desatualização da nota.

Quando desmarcado, o sistema irá permitir a desatualização da nota, mas irá habilitar ou desabilitar os botões do RE2001 (Recebimento Físico), conforme a "Situação WMs Ext" que o documento se encontra. Por exemplo, se estiver como "Conferencia OK", não irá permitir, modificação ou exclusão do documento ou dos itens.


RE2020 - Listagem Recebimento Físico

No relatório de documentos do recebimento físico, foi adicionado o campo "WMS Externo" para a apresentação da situação de integração da nota do recebimento com o WMS Saas/Externo.


RE2701 - Consulta Doctos Recebimento Físico

Na consulta de documentos do recebimento físico, foi adicionado o campo "WMS Ext" para a apresentação da situação de integração da nota do recebimento com o WMS Saas/Externo.


Abaixo, colocamos a imagem contendo o fluxo da integração do recebimento fiscal com o WMS Saas/Externo. Em resumo, a nota deverá ser digitada/gerada normalmente no recebimento fiscal, quando pronta, o usuário deverá clicar para atualizar a nota, neste momento o sistema verificará se a nota possui depósitos configurados para integrar com WMS Saas/Externo, se possuir, a nota terá a situação WMS externo alterado para "Aguardando". A integração com o WMS Saas/Externo é assíncrona, então o recebimento irá aguardar o WMS Saas/Externo vir buscar a nota. Quando a nota for buscada e criada no WMS Saas/Externo a situação WMS externo da nota no recebimento será alterada para "Em Processo".

Neste momento o fluxo de trabalho deverá ser realizado no WMS Saas/Externo, efetuando a conferência das quantidades dos itens da nota. Após o término desta conferência, o WMS Saas/Externo irá retornar para o recebimento se a conferência realizada apresentou ou não diferenças. No caso de apresentar diferenças, a situação WMS externo será alterada para "Conferência NOK", neste caso, sugere-se que a nota seja ajustada enviando as quantidades divergências para outro depósito que não seja WMS Saas/Externo. No caso de não apresentar diferenças, a situação WMS externo será alterada para "Conferência OK".

Após o retorno da conferências do WMS Saas/Externo, a nota poderá ser atualizada no estoque.



RE1001 - Manutenção de documentos

A tela de digitação/manutenção de documentos do recebimento fiscal foi alterada para apresentar o campo "Situação WMS Ext", para que o usuário do recebimento possa acompanhar o status de integração do recebimento com o WMS Saas/Externo.

Quando a nota for digitada/gerada, ela ficará com o campo "Situação WMS Ext" como "Não Integra".

Quando a nota estiver pronta, o usuário deverá clicar no botão check verde (Atualização), para que o sistema verifique se esta nota possui depósitos configurados para integrar com o WMS Saas/Externo, caso possua, o sistema irá apresentar uma mensagem informando que o documento foi disponibilizado para integração e o campo "Situação WMS Ext" será alterado para "Aguardando" e não irá integrar a nota com o estoque neste momento.

Importante:

  • Itens com depósitos marcados como "Depósito CQ", e que possuírem no relacionamento item x estabelecimento (CD0140 - Manutenção Item x Estab Materiais) o depósito padrão um depósito marcado "Depósito WMS Externo", também serão integrados com o WMS Saas/Externo, pois o seu destino final de armazenagem será um depósito controlado pelo WMS Saas/Externo.
  • Não serão enviados para o WMS Saas/Externo itens de controle debito direto, itens com ordem de produção informada, itens com quantidade zero, itens de controle total com conta informada, ou itens que não baixem estoque.


Quando a nota for buscada e criada no WMS Saas/Externo, o campo "Situação WMS Ext." será alterado para "Em Processo".


Depois do término da conferência, o WMS Saas/Externo irá retornar para o recebimento se a conferência realizada apresentou ou não diferenças. No caso de apresentar diferenças, o campo "Situação WMS Ext" será alterado para "Conferência NOK", neste caso, sugere-se que a nota seja ajustada, informando outro depósito que não seja WMS Saas/Externo para as quantidades divergências. No caso de não apresentar diferenças, o campo "Situação WMS Ext" será alterado para "Conferência OK".


Quando a nota estiver com a "Situação WMS Ext" como "Conferência OK" ou "Conferência NOK", a nota poderá ser atualizada no estoque e integrar com os demais módulos.

Atenção: Caso a nota esteja com a "Situação WMS Ext" como "Conferência NOK", o usuário deverá possuir permissão para atualizar com advertência. E após a atualização da nota, ficará registrado nas mensagens de erro/advertência da nota (RE0701a), que a nota apresentou diferença na conferência do WMS Saas/Externo.


Caso o WMS Saas/Externo possua a necessidade de reabrir a conferência, o campo "Situação WMS Ext" será alterado para "Em processo". Para que seja possível reiniciar a conferência, a nota não poderá ter sido atualizada.


RE1005 - Atualização de Documentos

A rotina de atualização de documentos do recebimento fiscal, foi alterada para identificar se a nota deve ou não ser integrada com o WMS Saas/Externo, e para impedir a atualização da nota, caso a nota não esteja com a "Situação WMs Ext" como "Conferência OK" ou "Conferência NOK". 


Caso o recebimento físico esteja configurado nos parâmetros do recebimento, essa rotina irá impedir a atualização da nota digitada/gerada diretamente no recebimento fiscal, quando a nota possuir depósito configurado para integrar com o WMS Saas/Externo.


Se a natureza de operação da nota estiver marcado para "Gerar nota Faturamento", o sistema irá bloquear a atualização da nota caso esta possua um depósito configurado para integrar com o WMS Saas/Externo.


RE0402 - Desatualização Documentos

Caso haja a necessidade de desatualizar a nota, para exclui-la, ou para excluir um item, ou para refazer a integração da nota com o WMS Saas/Externo, pode-se efetuar a inativação do documento no WMS Saas/Externo, ao fazer isso, o campo "Situação WMs Ext" da nota será alterado para "Inativado".

Na tela de desatualização de documentos do recebimento fiscal, na pasta Parâmetros, foi adicionado o campo "Considerar Situação WMs Externo", que irá verificar a "Situação WMs Ext" para permitir ou não a desatualização da nota.


Quando marcado o campo "Considerar Situação WMs Externo", o sistema irá verificar se a "Situação WMs Ext" da nota está como "Inativado", caso não esteja, não irá permitir a desatualização da nota.

Quando desmarcado, o sistema irá permitir a desatualização da nota, mas irá habilitar ou desabilitar os botões do RE1001 (Manutenção de Documentos), conforme a "Situação WMs Ext" que o documento se encontra. Por exemplo, se estiver como "Conferencia OK", não irá permitir, modificação ou exclusão do documento ou dos itens.


RE0401 - Listagem Conferência Documentos

Na listagem de documentos do recebimento fiscal, foi adicionado o campo "WMS Externo" para a apresentação da situação de integração da nota do recebimento com o WMS Saas/Externo.

RE0701a - Consulta Detalhes Documento

Na consulta de detalhes do documentos do recebimento fiscal, foi adicionado o campo "WMS Ext" para a apresentação da situação de integração da nota do recebimento com o WMS Saas/Externo.


03. DEMAIS INFORMAÇÕES

Resumo das situações WMS Externo das notas de recebimento:

  • Não Integra: Nota digitada ou atualizada e sem depósito de WMS Externo.
  • Aguardando: Nota aguardando o WMS Externo vir buscá-la. Não habilita botões de modificar/excluir e não permite a atualização da nota.
  • Em Processo: Nota em processo de conferência no WMS Externo. Não habilita botões de modificar/excluir e não permite a atualização da nota.
  • Conferência OK: Nota conferida pelo WMS Externo sem diferenças. Não habilita botões de modificar/excluir. Permite a atualização da nota.
  • Conferência NOK: Nota conferida pelo WMS Externo com diferenças. Habilita os botões de modificação, mas não os de excluir. Permite a atualização da nota.
  • Inativado: Nota foi inativada no WMS Externo. Pode ser desatualizada para um novo envio ao WMS Externo ou para ser excluída do Datasul.

04. DETALHES TÉCNICOS

API doctoEntrada/integr/wms/
API doctoFisico/integr/wms/

POST /integr/wms/inactiveDocument
POST /integr/wms/cancelConference
POST /integr/wms/returnConference
POST /integr/wms/confirmGet


IMPORTANTE!

Está integração está disponível a partir da release 12.1.2209. e 12.1.2205.5.


04. ASSUNTOS RELACIONADOS