Integração entre e Tracking de Pedidos

Informamos que esta integração se encontra em fase piloto e ainda não está disponível para todos os clientes do .

O Tracking de Pedidos é uma solução que possibilita um acompanhamento detalhado das ocorrências relacionadas ao pedido, desde o momento de sua emissão até o faturamento. Essa funcionalidade permite rastrear cada etapa do processo, fornecendo visibilidade e controle sobre o status dos pedidos. Caso o for integrado com o , também é possível acompanhar todo o processo de expedição da mercadoria pelo Tracking. Nos links abaixo, conheça um pouco mais sobre o Tracking de Pedidos TMS e WMS.

Tracking de Pedidos TMS

Tracking de Pedidos WMS

Quer saber mais? Então veja a matéria sobre Tracking de pedidos: entenda mais sobre a solução que preparamos para você!

A parametrização do Tracking de Pedidos na deve ser feita antes de qualquer configuração no Gestão Empresarial | ERP. Saiba mais aqui.

Como funciona?

Definição dos processos e criação da integração

Primeiro, é realizada a definição dos processos que irão enviar as ocorrências do documento ao tracking. Após isso, no momento que o usuário executar algum dos processo mapeados, um evento de integração será criado para o tracking consumir. Com a integração realizada, é possível consultar todo o histórico de ocorrências do documento no tracking, pela senior X Platform."

Confira o vídeo do processo

Fluxo do processo Confira o detalhamento do fluxo do processo

Pré-requisitos

Parametrizações

Identificadores de Regra

Por se tratar de uma integração totalmente personalizável, as ocorrências que serão enviadas para o Tracking deverão ser registradas por meio de identificadores de regra. Portanto, será necessário mapear os processos que deseja realizar o acompanhamento para criar os eventos de integração.

Exemplos: VEN-120CONDG01

Saiba mais sobre o identificador VEN-120CONDG01.

@ Variáveis passadas para a regra @
Definir Numero VSCodEmp;
Definir Numero VSCodFil;
Definir Numero VSNumero;

Definir Alfa VSPedCli;
Definir Alfa VSPedBlo;
Definir Alfa VSEstado;
Definir Alfa VSTelaOrigem;

@ Variáveis auxiliares da regra @
Definir Numero NCodigoFase;
Definir Numero NCodigoPlano;

Definir Alfa AStatus;
Definir Alfa AMensagemErro;
Definir Alfa ATipoDocumento;
Definir Alfa ASerieDocumento;
Definir Alfa ANumeroDocumento;
Definir Alfa AEncerrarTracking;
Definir Alfa AMensagemNotificacao;

inicio
  se ((VSTelaOrigem = "F120GPD")) {
    NCodigoPlano = 4;  
    ATipoDocumento = "Pedido";
    IntParaAlfa(VSNumero, ANumeroDocumento);  

    se (VSEstado = "INSERINDO") {      
      Tracking_RegistrarDocumento(VSCodEmp, VSCodFil, ATipoDocumento, ANumeroDocumento, ASerieDocumento, VSPedCli, NCodigoPlano, AStatus, AMensagemErro);
      
      se (AStatus = "OK") {
        NCodigoFase = 1;
        AEncerrarTracking = "N";
  
        Tracking_RegistrarFase(VSCodEmp, VSCodFil, ANumeroDocumento, NCodigoFase, AMensagemNotificacao, AEncerrarTracking, AStatus, AMensagemErro);
      }
    }            
  }
fim

VEN-120DEPAN01

Saiba mais sobre o identificador VEN-120DEPAN01

// Some comments here
@ Variáveis passadas para a regra @
Definir Numero VenNEmpresa;
Definir Numero VenNFilialNovo;
Definir Numero VenNPedidoNovo;

@ Variáveis auxiliares da regra @
Definir Alfa ATipoDocumento;
Definir Alfa ANumeroDocumento;
Definir Numero NCodigoPlano;  
Definir Alfa ASerieDocumento;
Definir Numero NCodigoFase;
Definir Alfa AEncerrarTracking;
Definir Alfa AMensagemNotificacao;

Definir Alfa AStatus;
Definir Alfa AMensagemErro;

inicio
  NCodigoPlano = 4;
  ATipoDocumento = "Pedido";
  IntParaAlfa(VenNPedidoNovo, ANumeroDocumento);
  
  Tracking_RegistrarDocumento(VenNEmpresa, VenNFilialNovo, ATipoDocumento, ANumeroDocumento, ASerieDocumento, "", NCodigoPlano, AStatus, AMensagemErro);
  se (AStatus = "OK") {
    NCodigoFase = 1;
    AEncerrarTracking = "N";
  
    Tracking_RegistrarFase(VenNEmpresa, VenNFilialNovo, ANumeroDocumento, NCodigoFase, AMensagemNotificacao, AEncerrarTracking, AStatus, AMensagemErro);
  }
fim

VEN-120LIBER04

Saiba mais sobre o identificador VEN-120LIBER04

@ Variáveis passados para regra @
Definir Numero VenNCodEmp;
Definir Numero VenNCodFil;
Definir Numero VenNCodCli;
Definir Numero VenNNumPed;
Definir Numero VenNCodRep;
Definir Alfa VenAPedAca;

@ Variáveis auxiliares da regra @
Definir Alfa ANumeroDocumento;
Definir Numero NCodigoFase;
Definir Alfa AEncerrarTracking;
Definir Alfa AMensagemNotificacao;

Definir Alfa AStatus;
Definir Alfa AMensagemErro;

inicio
  se (VenAPedAca = "L") {
    NCodigoFase = 2;
    AEncerrarTracking = "N";
    IntParaAlfa(VenNNumPed, ANumeroDocumento);
  
    Tracking_RegistrarFase(VenNCodEmp, VenNCodFil, ANumeroDocumento, NCodigoFase, AMensagemNotificacao, AEncerrarTracking, AStatus, AMensagemErro);
  }                       
fim

VEN-120CAPED01

Saiba mais sobre o identificador VEN-120CAPED01

@ Variáveis passados para regra @
Definir Alfa VSCancelado;

@ Variáveis auxiliares da regra @
Definir Alfa AStatus;
Definir Alfa AMensagemErro;
Definir Alfa ANumeroDocumento;

inicio  
  se (VSCancelado = "SIM") {  
    IntParaAlfa(E120PED.NumPed, ANumeroDocumento);
    Tracking_Cancelar(E120PED.CodEmp, E120PED.CodFil, ANumeroDocumento, AStatus, AMensagemErro);
  }                        
fim

GER-000INWMS28

Saiba mais sobre o identificador GER-000INWMS28

@ Variáveis passadas para a regra @
Definir Numero IntNEmpresa;
Definir Numero IntNFilial;
Definir Numero IntNNumeroDocumento;
Definir Numero IntNSequenciaDocumento;
Definir Numero IntNTipoDocumento;
Definir Numero IntNEnviar;

@ Variáveis auxiliares da regra @
Definir Alfa AStatus;
Definir Alfa AMensagemErro;
Definir Alfa ATipoDocumento;
Definir Alfa ANumeroDocumento;
Definir Alfa ASerieDocumento;

inicio
  se ((IntNTipoDocumento = 2) E (IntNEnviar = 1)) {
    ATipoDocumento = "Pre-fatura";
    IntParaAlfa(IntNNumeroDocumento, ANumeroDocumento);
    IntParaAlfa(IntNSequenciaDocumento, ASerieDocumento);
  
    Tracking_Transferir(IntNEmpresa, IntNFilial, ATipoDocumento, ANumeroDocumento, ASerieDocumento, AStatus, AMensagemErro);  
  }
fim

GER-000INWMS30

Saiba mais sobre o identificador GER-000INWMS30

@ Variáveis passadas para a regra @
Definir Numero IntNEmpresa;
Definir Numero IntNFilial;
Definir Numero IntNNumeroDocumento;
Definir Numero IntNSequenciaDocumento;
Definir Numero IntNTipoDocumento;

@ Variáveis auxiliares da regra @
Definir Alfa AStatus;
Definir Alfa AMensagemErro;
Definir Alfa ATipoDocumento;
Definir Alfa ANumeroDocumento;
Definir Alfa ASerieDocumento;

inicio
  se (IntNTipoDocumento = 2) {
    ATipoDocumento = "Pre-fatura";  
    IntParaAlfa(IntNNumeroDocumento, ANumeroDocumento);
    IntParaAlfa(IntNSequenciaDocumento, ASerieDocumento);
  
    Tracking_CancelarTransferido(IntNEmpresa, IntNFilial, ATipoDocumento, ANumeroDocumento, ASerieDocumento, AStatus, AMensagemErro);
  }
fim

  1. Informar o nome do tenant, chave de acesso a plataforma e chave secreta de acesso;
  2. Validar e aguardar a mensagem "Autenticação na Plataforma SeniorX realizada com sucesso.".

Caso não tenha as informações para realizar a configuração, consulte Gerenciamento de aplicações.

Processo automático de integração

  1. Acesse a tela de Cadastro de Processo Automático (F000AGE);
  2. Crie o agendamento para a rotina sapiens 168 - Integração ERP x Tracking - Envio;
  3. (Opcional) Crie o agendamento para a rotina sapiens 169 - Integração ERP x Tracking - Exclusão de logs.

Se existir integração entre x , o processo automático 165 - Integração WMS ERP x senior X deve ser configurado como sucessor do processo criado para a integração do Tracking de Pedidos.

O que você pode fazer:

Registrar tracking

Permite criar o tracking para determinado documento, para que seja possível acompanhar as ocorrências posteriormente. Para realizar este processo:

  1. Mapeie o processo que deseja criar o tracking;
  2. Identificar o ponto de regra que possa ser utilizado nesse momento;
  3. Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
  4. Crie uma regra chamando a função de programador Tracking_RegistrarDocumento e associe ao identificador de regra;
  5. Após execução da regra, será criado um evento de integração para ser consumido pelo processo automático.

Importante:

  • Somente pedidos são suportados.
  • O cancelamento do tracking pode ser realizado pela função de programador Tracking_Cancelar.
 Registrar andamento do tracking

Permite registrar as ocorrências do documento no tracking. Para realizar este processo:

  1. Mapeie os processos que deseja registrar a ocorrência no tracking;
  2. Identificar o ponto de regra que possa ser utilizado nesse momento;
  3. Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
  4. Crie uma regra chamando a função de programador Tracking_RegistrarFase e associe ao identificador de regra;
  5. Após execução da regra, será criado um evento de integração para ser consumido pelo processo automático.

Importante:

  • Somente pedidos são suportados.
  • O cancelamento da ocorrência pode ser realizado pela função de programador Tracking_CancelarFase.
 Registrar transferência do tracking

Permite transferir um tracking, ou seja, um tracking origem com todas as suas ocorrências e documentos serão transferidos para novo tracking. O processo é necessário quando existir integração entre x . Para realizar este processo:

  1. Mapeie o processo que deseja realizar a transferência do tracking;
  2. Identificar o ponto de regra que possa ser utilizado nesse momento;
  3. Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
  4. Crie uma regra chamando a função de programador Tracking_Transferir e associe ao identificador de regra;
  5. Após execução da regra, será criado um evento de integração para ser consumido pelo processo automático.

Importante:

  • Somente pré-faturas são suportadas.
  • O cancelamento da transferência pode ser realizado pela função de programador Tracking_CancelarTransferido.

Acompanhamento da integração

É possível acompanhar os documentos integrados com o tracking, permitindo análise problemas com a integração.

  1. Acesse Cadastros > Integrações > Plataforma > Log de Integrações ERP x SeniorX (F115PRL);
  2. Selecione a opção "Tracking" no Tipo Integração;
  3. Clique em Mostrar para carregar os registros.

Resolução de Problemas

Se na consulta de logs do processo agendado foi encontrado algum registro na situação "Erro", siga as instruções abaixo para possível solução do problema.

Não foi possível autenticar na

Problema: A configuração de integração não está parametrizada corretamente.

Solução: Consultar os pré-requisitos da integração e seguir as instruções da guia .

Se na consulta de logs de Integrações ERP x Senior X foi encontrado algum registro na situação "Erro/Rejeitado", siga as instruções abaixo para possível solução do problema.

Fase não encontrada

Problema: A fase que foi parametrizado no identificador de regra não existe nas definições do tracking.

Solução: Consultar nas definições do tracking as fases disponíveis, após isso, ajustar o identificador de regra com a informação correta.

 Código do plano não encontrado

Problema: O plano que foi parametrizado no identificador de regra não existe nas definições do tracking.

Solução: Consultar nas definições do tracking os planos disponíveis, após isso, ajustar o identificador de regra com a informação correta.

 Tipo de documento não encontrado

Problema: O tipo de documento que foi parametrizado no identificador de regra não existe nas definições do tracking.

Solução: Consultar nas definições do tracking os tipos de documento disponíveis, após isso, ajustar o identificador de regra com a informação correta.