Integração entre Gestão Empresarial | ERP 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 Gestão Empresarial | ERP.
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 Gestão Empresarial | ERP for integrado com o Gestão de Armazenagem | WMS Senior, 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.
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." |
Fluxo do processo |
Pré-requisitos
- Gestão Empresarial | ERP na versão 5.10.3.50 ou superior;
- Gestão de Armazenagem | WMS Senior na versão 8.12.7.244 ou superior (+ infoObrigatório se existir integração entre Gestão Empresarial | ERP x Gestão de Armazenagem | WMS Senior);
- Possuir a solução Tracking de Pedidos. Para isso, acesse a Senior Store ou entre em contato com o executivo responsável por sua conta.
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.


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 |

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 |

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 |

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 |

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 |

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 |
Central de Configurações Senior
- Informar o nome do tenant, chave de acesso a plataforma e chave secreta de acesso;
- 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
- Acesse a tela de Cadastro de Processo Automático (F000AGE);
- Crie o agendamento para a rotina sapiens 168 - Integração ERP x Tracking - Envio;
- (Opcional) Crie o agendamento para a rotina sapiens 169 - Integração ERP x Tracking - Exclusão de logs.
Se existir integração entre Gestão Empresarial | ERP x Gestão de Armazenagem | WMS Senior, 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:

Permite criar o tracking para determinado documento, para que seja possível acompanhar as ocorrências posteriormente. Para realizar este processo:
- Mapeie o processo que deseja criar o tracking;
- Identificar o ponto de regra que possa ser utilizado nesse momento;
- Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
- Crie uma regra chamando a função de programador Tracking_RegistrarDocumento e associe ao identificador de regra;
- 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.

Permite registrar as ocorrências do documento no tracking. Para realizar este processo:
- Mapeie os processos que deseja registrar a ocorrência no tracking;
- Identificar o ponto de regra que possa ser utilizado nesse momento;
- Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
- Crie uma regra chamando a função de programador Tracking_RegistrarFase e associe ao identificador de regra;
- 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.

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 Gestão Empresarial | ERP x Gestão de Armazenagem | WMS Senior. Para realizar este processo:
- Mapeie o processo que deseja realizar a transferência do tracking;
- Identificar o ponto de regra que possa ser utilizado nesse momento;
- Acesse Cadastros > Identificadores e parâmetros > Identificador de Regras (F098REG);
- Crie uma regra chamando a função de programador Tracking_Transferir e associe ao identificador de regra;
- 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.
- Acesse Cadastros > Integrações > Plataforma > Log de Integrações ERP x SeniorX (F115PRL);
- Selecione a opção "Tracking" no Tipo Integração;
- 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.

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 Central de Configurações Senior.
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.

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.

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.

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.