Atenção
A partir de 06/2023 esta integração não se faz necessária. A informação de NCM já vai direto na integração do produto, tag NCM.
Integrando NCM
Abaixo iremos mostrar como configurar o Processo de NCM no Protheus para integra-lo com o sistema Totvs Chef. Siga o Passo a Passo.
Cadastrando o Processo de NCM
Para integrarmos o NCM com o Totvs Chef primeiramente é necessário realizar o cadastro do Processo NCM no Protheus.
1- No módulo 12 (Controle de Lojas), acesse Atualizações/ RMI/ Cadastros/ Processos.
2- No Browse clique em Incluir e preencha os campos:
Processo: NCM
Tabela: SYD
Chave: YD_FILIAL+YD_TEC
Exemplo do cadastro de Processo do NCM:
Vinculando o Processo de NCM ao Assinante CHEF
1- No módulo 12 (Controle de Lojas), acesse Atualizações/ RMI/ Cadastros/ Assinantes.
2- Com o assinante CHEF previamente cadastrado, posicione no assinante CHEF e clique em alterar.
3- Na guia Assinantes x Processos, preencha os seguintes campos:
Processo: NCM
Ativo: Sim
Tipo Process: Envio
Filiais Proc: Informe o código das filiais que deseja enviar o Processo
Configuração: Preencha esta campo de acordo com a sua URL da API NCM, como mostra o exemplo abaixo:
{ "url":"http://{url_do_servidor}/api/produto/salvarNCM", (caminho para a API do Chef que manipula o NCM) "tagretorno":"sucesso", "tagcodigo":"codigo" }
Layout Envio: Preencha este campo de acordo com o exemplo abaixo: Lembrando que é permitido utilizar macro execuções no Layout abaixo, após o &.
{ "codigoNCM":"&self:oPublica['YD_TEC']", "descricao":"&self:oPublica['YD_DESC_P']", "status":"&self:cEvento == '1'" }
Layout Publicação: Vazio.
Exemplo da configuração do Processo NCM no assinante CHEF:
Fluxo de integração
Após ter realizado as configurações acima a integração do NCM seguirá o seguinte fluxo:
Com os serviços RMIPUBLICA, RMIDISTRIB e RMIENVIA configurados e ativos, será gerado as publicações na tabela MHQ, com os NCM's incluídos, alterados ou com o campo de exportação YD_MSEXP vazio.
Após a publicação sera realizado a distribuição das publicações de NCM para o Assinante CHEF na tabela MHR.
Com as distribuições realizadas o serviço RMIENVIA realizara o envio de NCM para o Totvs Chef, após a finalização do serviço RMIENVIA, no campo MHR_ENVIO, será gravado o json que enviamos para o Chef e no campo MHR_RETORN é gravado a mensagem de retorno do Chef, se obteve sucesso ou não na inclusão do NCM.
Caso tenha sucesso na inclusão do NCM no Totvs Chef, no Protheus será gravado um De/Para com o código do NCM no Chef e o código do NCM no Protheus. Para acessar o cadastro de De/Para acesse: Modulo 12 (Controle de Lojas) e em seguida, Atualizações/ RMI/ Cadastros/ De/Para.