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
Está integração está disponível a partir da release 12.1.2209. e 12.1.2205.5.IMPORTANTE!
04. ASSUNTOS RELACIONADOS