Integração ERP x WMS x Tracking de Pedidos Senior x RMS

• Estas integrações ocorrerão somente com notas fiscais onde a entidade (depositante) esteja marcada para Integrar com Tracking Senior.
• O processo de expedição continuará em paralelo à integração com o Tracking de Pedidos.
• Durante o processo de pré-fatura, caso haja corte físico no Gestão de Armazenagem | WMS Senior, seguirá o fluxo padrão, mantendo a comunicação com o ERP Senior. Subsequentemente, o ERP Senior enviará uma nova Pré-fatura para realizar o processo de expedição.

• Atualmente, o conceito de Pré-fatura equivale ao Pedido dentro do Gestão de Armazenagem | WMS Senior. Porém, em alguns casos, uma Pré-fatura para o ERP Senior funciona como um agrupador de Pedidos. No entanto, O Gestão de Armazenagem | WMS Senior não faz o controle desses Pedidos vinculados à Pré-fatura do ERP Senior, portanto, nessa integração só será permitido Pré-fatura contendo apenas um Pedido.
• Em caso de erro na integração, o Gestão de Armazenagem | WMS Senior armazenará a ocorrência para transmissão posterior. Embora possa haver atrasos nas informações durante a comunicação em situações pontuais como essa, o Tracking de Pedidos não enfrentará problemas ao receber parcialmente os status. O Gestão de Armazenagem | WMS Senior controlará o número de tentativas por requisição, limitado a 3 tentativas, para evitar um grande número de requisições desnecessárias na plataforma SeniorX. Ao atingir 3 tentativas, o status da exportação é considerado como "Erro", podendo ser reenviado manualmente via sistema. Ao solicitar o reenvio, o número de tentativas é zerado, possibilitando mais 5 tentativas automáticas (uma tentativa a cada 2 min).
• Após a correção de eventuais problemas na integração, o reenvio será manual.
• Para o Tracking de Pedidos, uma vez enviada a Ocorrência, a data não é alterada. Ou seja, caso exista um contrafluxo no Gestão de Armazenagem | WMS Senior, as informações enviadas pela primeira vez serão as que constarão no painel do Tracking de Pedidos.

• Enquanto a nota não está processada, o cancelamento pode ser feito via Gestão de Armazenagem | WMS Senior, atualizando o status da nota imediatamente e exportando a ocorrência. No entanto, se o cancelamento for via ERP, o mesmo só pode ser feito após a nota estar faturada, porém o status da nota não é atualizado de imediato. É necessário cancelar a onda, para que o status da nota seja atualizado, e assim, exportar a ocorrência para o tracking.

Esta funcionalidade será compatível com as versões superiores a 8.12.7.244 do Gestão de Armazenagem | WMS Senior.

(Referente WMS-15270)

Acesse Cadastro > Entidade > Entidade > guia Tracking de Pedidos

1. Localize a entidade (tipo: depositante/proprietário).
   • Marque o parâmetro Integrar com Tracking Senior para funcionamento da integração Tracking de Pedidos.
2. Informe os dados para autenticação:
   • Usuário
   • Senha
3. Defina as URL´s para as devidas comunicações:
   • URL Obtenção Token de Acesso
     https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/login
   • URL Consultar Código do Tracking
     https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/tms/tck/queries/consultaTracking
   • URL Enviar Ocorrência
     https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/tms/tck/actions/salvaTracking
   • Observação: o endereço da URL deve ser avaliado na implantação da integração juntamente com TMS, pois o Gestão de Armazenagem | WMS Senior precisa saber qual ambiente será utilizado platform.senior.com.br , cloud-leaf.senior.com.br ou platform-homologx.senior.com.br
4. Na comunicação entre o Gestão de Armazenagem | WMS Senior e o Tracking, é necessário utilizar um Código de Ocorrência. Cada status gerado pelo Gestão de Armazenagem | WMS Senior é vinculado a um código numérico no Tracking de Pedidos. Essas informações precisam ser requisitadas ao TMS e são cruciais para assegurar o correto funcionamento da integração. Nos campos abaixo preencha com o código que será utilizado pelo Tracking, para representar cada status. Entre parenteses está o código que é usado pelo lado do Gestão de Armazenagem | WMS Senior.
   • Nota Fiscal Digitada/Importada (12): este é o único campo obrigatório em todas as ocorrências. Ele indica se a nota fiscal foi digitada manualmente ou importada para o sistema quando a mercadoria chegou ao armazém.
   • Aguardando Formação de Onda (0)
   • Aguardando Separação (1)
   • Separação Iniciada (2)
   • Separação Concluída (4)
   • Packing Iniciado (5)
   • Packing Concluído (6)
   • Enviado para Faturamento (7)
   • Coleta Iniciada (8)
   • Expedido (9)
   • Cancelado (10)
5. Os botões abaixo validam as URLs:
   • Validar Usuário e Senha: serve para autenticar o Usuário e Senha.
   • Validar URL Token
   • Validar URL Consultar
   • Validar URL Ocorrência

O ERP pode enviar uma Pré-fatura correspondente ao Pedido dentro do Gestão de Armazenagem | WMS Senior ou um Pedido direto, onde o CNPJ do emitente esteja corretamente configurado na entidade (depositante) do WMS.

O serviço de exportação de ocorrências opera com um intervalo de execução de 2 minutos, resultando em uma periodicidade de 2 minutos na comunicação com o Tracking de Pedidos.

Serviços disponíveis para integração Gestão de Armazenagem | WMS Senior x Tracking de Pedidos.

1- Consultar ou Criar Código do tracking

Quando o Gestão de Armazenagem | WMS Senior recebe uma Nota Fiscal do ERP, ele verifica se o Depositante está configurado como "Integrar com Tracking Senior". Se sim, uma consulta é realizada para verificar se o código tracking já existe para essa Nota Fiscal. Se o Tracking de Pedidos encontrar a Nota Fiscal, ele retorna ao Gestão de Armazenagem | WMS Senior o código tracking do pedido correspondente. O Gestão de Armazenagem | WMS Senior registra essa informação para utilizar no envio dos status (passo 2 - Registrar Ocorrência) da Nota Fiscal durante o processo de expedição. Se o Tracking de Pedidos não encontrar o código tracking, o Gestão de Armazenagem | WMS Senior solicita automaticamente a criação. O Tracking de Pedidos cria e retorna o código tracking, que é então registrado pelo Gestão de Armazenagem | WMS Senior.

Consultar Tracking

{
	"inscricaoFiscal": "",
	"documento": "",
	"tipoDocumento": {
		"codigo": "",
		"descricao": ""
	}
}

Grupo	Campo	Descrição
	inscricaoFiscal	CNPJ do Destinatário da Nota Fiscal/Pedido.
	documento	Independente do que o ERP envie (Pré-fatura ou Pedido) o WMS vai considerar como identificador do pedido o Número do Pedido do Fornecedor (numpedidofornecedor) como essa informação não é obrigatória então se o ERP não enviar essa informação vamos considerar o número da Nota Fiscal (codigointerno), pois é uma informação obrigatória para que o Tracking de Pedidos consiga encontrar o Documento (nota fiscal, pedido ou pré-fatura).
tipoDocumento	codigo	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
tipoDocumento	descricao	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.

CriarTracking

{
	"cnpjFilial": "",
	"dataPrevisaoEntrega": "",
	"listaTrackingFase": [
		{
			"executada": true,
			"dataExecucao": "",
			"fase": {
				"codigo": 
			}
		}
	],
	"listaDocumento": [
		{
			"identificadorCliente": "",
			"numero": "",
			"serie": "",
			"tipoDocumento": {
				"descricao": ""
			}
		}
	],
	"listaClienteDocumento": [
		{
			"tipoClienteRec": {
				"descricao": "Remetente"
			},
			"cliente": {
				"nome": "",
				"inscricaoFiscal": "",
				"tipoInscricaoFiscal": 1 ou 0
			},
			"documento": {
				"identificadorCliente": "",
				"numero": "",
				"serie": "",
				"tipoDocumento": {
					"descricao": ""
				}
			}
		},
		{
			"tipoClienteRec": {
				"descricao": "Destinatário"
			},
			"cliente": {
				"nome": "",
				"inscricaoFiscal": "",
				"tipoInscricaoFiscal": 1 ou 0
			},
			"documento": {
				"identificadorCliente": "",
				"numero": "",
				"serie": "",
				"tipoDocumento": {
					"descricao": ""
				}
			}
		}
	]
}

Grupo	Campo	Descrição
	cnpjFilial	CNPJ do Destinatário da Nota Fiscal/Pedido.
	dataPrevisaoEntrega	Corresponde a Data Esperada de Embarque, quando não informado na Nota Fiscal/Pedido enviamos a Data atual do envio para criação do código tracking.
listaTrackingFase	executada	Fixo "true".
listaTrackingFase	dataExecucao	Data e Hora que o aconteceu a alteração de status da Nota Fiscal/Pedido dentro do Gestão de Armazenagem | WMS Senior.
listaTrackingFase : fase	codigo	Código cadastrado na entidade (depositante) que corresponde ao cadastro de status no Tracking de Pedidos. Para enviar a ocorrência é obrigatório essa informação registrada na Entidade.
listaDocumento	identificadorCliente	CNPJ do Remetente.
listaDocumento	numero	Independente do que o ERP envie (Pré-fatura ou Pedido) o Gestão de Armazenagem | WMS Senior vai considerar o Número do Pedido do Fornecedor (numpedidofornecedor) como essa informação não é obrigatória então se o ERP não enviar essa informação vamos considerar o número da Nota Fiscal (codigointerno), pois é uma informação obrigatório para que o Tracking de Pedidos consiga encontrar o Documento.
listaDocumento	serie	Indica a Série da Nota Fiscal/Pedido.
listaDocumento : tipoDocumento	codigo	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
listaDocumento : tipoDocumento	descricao	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
listaClienteDocumento : tipoClienteRec	descricao	Fixo 'Remetente'.
listaClienteDocumento : cliente	nome	Razão Social do Remetente.
listaClienteDocumento : cliente	inscricaoFiscal	CNPJ do Remetente.
listaClienteDocumento : cliente	tipoInscricaoFiscal	Indica se é Pessoa Física(0) ou Pessoa Jurídica (1).
listaClienteDocumento : documento	identificadorCliente	CNPJ do Remetente.
listaClienteDocumento : documento	numero	Independente do que o ERP envie (Pré-fatura ou Pedido) o WMS vai considerar o Número do Pedido do Fornecedor (numpedidofornecedor) como essa informação não é obrigatória então se o ERP não enviar essa informação vamos considerar o número da Nota Fiscal (codigointerno), pois é uma informação obrigatório para que o Tracking de Pedidos consiga encontrar o Documento.
listaClienteDocumento : documento	serie	Indica a Série da Nota Fiscal/Pedido.
tipoDocumento	codigo	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
tipoDocumento	descricao	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
listaClienteDocumento : tipoClienteRec .	descricao	Fixo 'Destinatário'.
listaClienteDocumento : cliente	nome	Razão Social do Destinatário.
listaClienteDocumento : cliente	inscricaoFiscal	CNPJ do Destinatário.
listaClienteDocumento : cliente )	tipoInscricaoFiscal	Indica se é Pessoa Física(0) ou Pessoa Jurídica (1).
listaClienteDocumento : documento	identificadorCliente	CNPJ do Destinatário.
listaClienteDocumento : documento	numero	Independente do que o ERP envie (Pré-fatura ou Pedido) o WMS vai considerar o Número do Pedido do Fornecedor (numpedidofornecedor) como essa informação não é obrigatória, então se o ERP não enviar essa informação vamos considerar o número da Nota Fiscal (codigointerno), pois é uma informação obrigatório para que o Tracking de Pedidos consiga encontrar o Documento.
listaClienteDocumento : documento	serie	Indica a Série da Nota Fiscal/Pedido.
tipoDocumento	codigo	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.
tipoDocumento	descricao	Indica o tipo de documento a ser consultado. Quando o tipo do documento for Eletrônica (E) então enviamos 'Nota Fiscal', os demais tipos sempre serão enviados para o Tracking de Pedidos como 'Pré-fatura'.

2 - Registrar ocorrência

Para Notas Fiscais que já possuem o código tracking, o Gestão de Armazenagem | WMS Senior percorre os status disponíveis no processo de expedição que tenham Código de Ocorrência cadastrado no depositante e envia a Ocorrência para o Tracking de Pedidos. O Gestão de Armazenagem | WMS Senior registra o retorno com sucesso na Situação da integração.

{
	"cnpjFilial": "",
	"codigoTracking": "",
	"listaTrackingFase": [
		{
			"executada": true,
			"dataExecucao": "2024-01-24T07:35:00.000Z",
			"fase": {
				"codigo": 102
			}
		}
	]
}

Grupo	Campo	Descrição
	cnpjFilial	CNPJ do Depositante no Gestão de Armazenagem | WMS Senior.
	codigoTracking	Somente um código tracking por Nota Fiscal/Pedido. Para enviar a ocorrência é obrigatório essa informação registrada na Nota Fiscal.
listaTrackingFase	executada	Fixo "true".
listaTrackingFase	dataExecucao	Data e Hora que o aconteceu a alteração de status da Nota Fiscal/Pedido dentro do WMS.
listaTrackingFase : fase	codigo	Código cadastrado na entidade (depositante) que corresponde ao cadastro de ocorrência no Tracking de Pedidos. Para enviar a ocorrência é obrigatório essa informação registrada na Entidade.

Quando o Gestão de Armazenagem | WMS Senior recebe um Pedido/Nota Fiscal de Saída, ele verifica se já existe um Código de Tracking associado. Caso não exista, o sistema solicita a criação de um novo Código de Tracking ao módulo de Tracking de Pedidos da Senior. Após obter o Código de Tracking, o Gestão de Armazenagem | WMS Senior o enviará na Integração de Atividade no RMS Senior.

Quando o Gestão de Armazenagem | WMS Senior cancela uma Pré-fatura ou Pedido, o status de cancelamento é comunicado ao Tracking de Pedidos. Além disso, o cancelamento é informado ao ERP Senior, que assume a responsabilidade pelo cancelamento no Tracking de Pedidos Senior.

Acesse Integração > Log de Integração

• A partir desta tela acompanhamos os logs de erro ou sucesso retornados também pelo Tracking de Pedidos Senior.

Acesse Nota Fiscal > Controle Nota Fiscal

• Ao visualizar o grid da Nota Fiscal, observe o "Código do Tracking" apenas para fins informativos. Essa informação não afetará o processo de expedição do Gestão de Armazenagem | WMS Senior.

Para filtrar apenas informações desse fluxo, adicionamos na coluna Tipo a informação "Exportação de Ocorrência de Nota Fiscal para o Trancking de Pedido Senior".

Acesse Integração > Integração de Arquivo > filtro Exibir > Opção Exportação > botão Integrar novamente

• Em caso de erro na transmissão do arquivo (JSON), essa opção permitirá reiniciar a integração.

Acesse Integração > Integração de Arquivo > filtro Exibir > Opção Exportação > botão Baixar Arquivo Exportado

• Isso permitirá visualizar o arquivo (JSON) enviado para o sistema de terceiros, facilitando a análise da integração entre Gestão de Armazenagem | WMS Senior e Tracking de Pedidos.

Acesse Integração > Resultado de Integração RMS

• Esta tela é utilizada para acompanhar a integração, onde está disponível o campo Código Tracking de Pedidos Senior e enviado para o RMS Senior.

1. O ERP envia os dados do Pedido/Nota Fiscal para o Tracking de Pedidos.
2. O Tracking de Pedidos recebe os dados e cria um "código do Tracking".
3. O ERP envia o Pedido/Nota Fiscal para o WMS Senior.
4. O WMS Senior consulta os dados do Pedido/Nota Fiscal no Tracking de Pedidos.
5. O Tracking de Pedidos retorna com o "código do Tracking".
6. O WMS Senior registra o "código do Tracking".
7. O WMS Senior envia o status do Pedido/Nota Fiscal em cada etapa com registro de ocorrência do processo de Expedição.
8. O Tracking de Pedidos apresenta o status do Pedido/Nota Fiscal para o Destinatário Final.