Integração ERP x WMS x RMS x TMS

Apoio para o fluxo da integração do WMS x RMS.

Apoio para o fluxo.

• Estas integrações ocorrerão somente com notas fiscais onde a transportadora esteja marcada para Integrar com RMS Senior.
• As integrações entre Gestão de Armazenagem | WMS Senior e RMS ocorrerão somente para notas fiscais em que a transportadora esteja configurada com o parâmetro Integrar com RMS Senior ativado.
• Para que as exportações Rest v2 ocorram, é preciso que o depositante possua um registro na Configuração de Integração sem vínculo com armazém, mas com o parâmetro Integração via Serviço Rest ativado.
• Deixe ativado o parâmetro Exportar Arquivo Produto e Embalagem para exportação do produto, no cadastro do Produto x Depositante.

• Integrações somente entre Sistemas Senior.
• Para a transmissão dos dados do Gestão de Armazenagem | WMS Senior para o TMS, a configuração do parâmetro Integrar com TMS Senior no cadastro de Depositante não é necessária para o tipo de integração modelo Banco a Banco, sendo exigida apenas para o modelo REST V2.

Com o Gestão de Armazenagem | WMS Senior.

Acesse Cadastro > Entidade > Entidade > guia RMS Senior

1. Localize a entidade transportadora.
   • Marque o parâmetro: Integrar com RMS Senior para o funcionamento da integração RMS Senior.
2. Defina as URL´s para as devidas comunicações:
   • URL Obtenção Token de Acesso
     https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/login
   • URL Criação das Atividades
     https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/tmsentregas/atividades/actions/integraAtividades
   • URL Obtenção do Roteiro
     https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/tmsentregas/roteiros/queries/buscaRoteirosPorLote
   • URL Obtenção das Atividades
     https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/tmsentregas/atividades/actions/consultaTicketIntegracao
   • URL Altera Chave de Acesso
     https//cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/tmsentregas/atividades/actions/alteraChaveAcesso
   • URL Cancelar Atividades
     https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/tmsentregas/atividades/actions/inutilizaAtividade
   • Observação: o endereço da URL deve ser avaliado na implantação da integração juntamente com RMS, pois o WMS precisa saber qual ambiente será utilizado platform.senior.com.br , cloud-leaf.senior.com.br ou platform-homologx.senior.com.br
3. A informação Código da Ocorrência deve ser solicitado ao RMS, essa informação é obrigatória para o envio de Cancelar Atividades.
4. Os botões abaixo validam as URLs:
   • Validar URL Token
   • Validar URL Atividade
   • Validar URL Roteiro
   • Validar Usuário e Senha: serve para autenticar o Usuário e Senha.
   • Validar Consulta Atividades
   • Validar Alterar Chave de Acesso
   • Validar Cancelar Atividade

Acesse Configuração > Configuração onda

1. guia Filtros para Listagem de Documentos
   • ative o parâmetro Somente notas fiscais roteirizadas pelo RMS Senior, indica que a onda permite somente pedidos/notas roteirizadas pelo RMS.
2. guia Dados da Configuração da Onda
   • para o campo Tipo de Expedição marque a opção Carga, que é responsável pelo Fluxo de Carga, porém o responsável pelo controle de Rotas nesse caso será o RMS.

Configuração necessária somente para integração com o TMS Senior no modelo banco a banco.

Acesse Configuração > Configuração geral > botão Alterar > guia Integração

• Deixe marcado o parâmetro Integrar com TMS Senior.
  Para o modelo Banco a Banco - ETL/DML, a configuração do parâmetro Integrar com TMS Senior no cadastro de Depositante não é tecnicamente necessária, pois essa configuração é apenas visual e não ativa funcionalidades específicas para esse tipo de integração. No entanto, é importante manter as configurações obrigatórias para as exportações Banco a Banco ativas.

Acesse Cadastro > Depositante > botão Cadastrar > guia Integração TMS Senior.

• É opcional a ativação do parâmetro Integrar com TMS Senior.
• É opcional a ativação do Tipo de Integração TMS Senior para a opção Banco a Banco - ETL/DML

Configuração necessária somente para integração com o TMS Senior.

Acesse Cadastro > Depositante > botão Cadastrar > guia Exportação

Escolha os tipos de integrações Banco a banco.

• Entidade: int_envio_entidade
• Cancelamento: int_envio_cancelamento
• Embalagem: int_envio_embalagem
• Produto: int_envio_produto
• Nota Fiscal de Remessa e Retorno de Armazenagem: int_envio_nf_armazenagem / int_envio_nf_armazenagemdet

Acesse Cadastro > Depositante > botão Cadastrar > guia Integração TMS Senior

1. Para o modelo REST, ative o parâmetro Integrar com TMS Senior para liberar a configuração das seguintes exportações (produto, embalagem, cancelamento NF, Fatura/Serviços, NF Armazenagem (Notas de Retorno e/ou Remessa) e Entidade) .
2. Utilize o parâmetro Tipo de Integração TMS Senior e selecione uma das opções abaixo para definir o modelo de integração:
   • Banco a Banco - ETL/DML: (configuração opcional). Neste modelo, oGestão de Armazenagem | WMS Senior utiliza o Agente como arquitetura para disponibilizar as exportações exclusivamente para o TMS no formato Banco a Banco.
   • Rest - Versão 2: neste modelo, o WMS comunica-se diretamente com o TMS, sem intermediários. Os dados de exportação são enviados em formato JSON para a URL configurada no cadastro do depositante.
3. Valide a autenticação de usuário e senha somente para a exportação do Rest - versão 2.
4. Defina as URL´s para as devidas comunicações somente para a exportação do Rest - versão 2:
• URL Obtenção Token de Acesso
  https://cloud-leaf.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/login
• URL Enviar Entidade
  https://{Base URL}/entidade
• URL Enviar Produto
  https://{Base URL}/produto
• URL Enviar Embalagem
  https://{Base URL}/embalagem
• URL Enviar Fatura/Serviço
  https://{Base URL}/fatura_servico
• URL Enviar Cancelamento NF
  https://{Base URL}/nf_armazenagem/cancelamento
• URL Enviar NF Armazenagem (Remessa e/ou Retorno)
  https://{Base URL}/nf_armazenagem

Observação: o endereço da {Base URL} deve ser avaliado durante a implantação da integração com o TMS. Além disso, para a URL de Obtenção do Token de Acesso, o TMS precisará informar qual ambiente será utilizado: platform.senior.com.br, cloud-leaf.senior.com.br ou platform-homologx.senior.com.br.

5. Os botões abaixo validam as URLs:
   
   • Validar URL Token
   • Validar Usuário e Senha: serve para autenticar o usuário e senha.
   • Validar URLs de Envio: serve para validar até que todas as URLs estejam livres de mensagens de erro para os endpoints de produto, embalagem, nf_armazenagem, fatura_servico, entidade e cancelamento.

Configuração necessária somente para integração com o TMS Senior no modelo banco a banco.

Acesse Gestão de Contrato > Gerenciador de Contrato > botão Cadastrar > guia Exportação

Escolha o tipo de integração banco a banco.

• Fatura de Serviço: INT_ENVIO_FATURA_SERVICO / INT_ENVIO_FATURA_SERVICODET

Para as integrações de pedido, foram acrescentados os campos DATA_AGENDAMENTO, JANELA_INICIO e JANELA_FIM, onde o ERP envia para o WMS que por sua vez repasse para o RMS.

• INT_PEDIDO ( banco a banco)
• INT_PEDIDO ( TXT)
• Integração de Pedido ( Rest )
• Integração de Pedido ( Rest V2)

Serviços disponíveis para integração WMS x RMS

1 - Integrar Atividades

Controle de Envio: o Gestão de Armazenagem | WMS Senior tem um serviço que envia todas as notas fiscais em lote e sem ticket(Controle de Envio), ou seja, o Gestão de Armazenagem | WMS Senior envia as notas para o RMS e recebe um ticket(Controle de Envio). Este ticket é por lote, ou seja, um único número de envio para todas as notas enviadas. Nesse momento o Gestão de Armazenagem | WMS Seniornão tem o conhecimento se deu sucesso ou erro na criação da atividade para o RMS, temos somente um número que foi enviado para o RMS.

A informação cdNumero é referente ao número do endereço da entidade, o Gestão de Armazenagem | WMS Senior permite cadastros de número de endereço com letras, porém o RMS aceita somente números. Com isso a regra de negócio define que nesse cenário a nota ficará com status de erro, e para que seja enviada novamente o cadastro deverá ser alterado manualmente no Gestão de Armazenagem | WMS Senior.

{
	"atividades": [
		{
			"inAtividade": 2,
			"nrCNPJFilial": "",
			"dsDestinatario": "",
			"nrCep": 0,
			"dsLocal": "",
			"dsBairro": "",
			"dsCidade": "",
			"dsEstado": "",
			"dsPais": "",
			"cdNumero": 0,
			"dsComplemento": "",
			"vlMercadoria": 0,
			"qtPeso": 0,
			"qtMetrosCubicos": 0,
			"qtVolumes": 0,
			"dsNrDocto": "",
			"dtPrazoEntr": "2023-01-19T03:35:19.144Z",
			"dtAgendamento": "2023-01-19T03:35:19.144Z",
			"dtJanelaIni": "2023-01-19T03:35:19.144Z",
			"dtJanelaFim": "2023-01-19T03:35:19.144Z",
			"cdChaveAcesso": "",
			"inDocto": 0,
			"dsObservacao": "",
                        "codigoTracking": ""
		}
	]
}

2 - Criar Atividades

Código Atividade: após o retorno do ticket(Controle de Envio), o Gestão de Armazenagem | WMS Senior tem um serviço onde busca o código da atividade do RMS, se sucesso(consultar na tela Resultado Integração RMS) se erro(consultar na tela Log de Integração). O código de atividade é único por nota.

{
  "ticket": 0
}

3 - Consultar Roteiro

Código Roteiro RMS Senior: com o Código Atividade recebido do RMS, o Gestão de Armazenagem | WMS Senior tem um serviço onde busca a informação no RMS, e verifica se a nota fiscal já foi roteirizada e com isso registra o código do roteiro, este ficará disponível para formação da onda.

O roteiro possui os seguintes status no RMS Senior:
0 - Em elaboração
1 - Confirmado
2 - Em execução
3 - Finalizado

Para obter ou atualizar o roteiro, somente notas com a situação 0,1 e 2 são enviadas para o RMS, possibilitando assim a atualização do roteiro no WMS, caso haja alguma alteração no RMS. Portanto, notas com situação de roteiro 3 (finalizado) não serão enviadas pelo serviço do Gestão de Armazenagem | WMS Senior.

Para o RMS Senior uma nota pode ter seu roteiro 3 (finalizado), porém estar como ocorrência de "Não entrega", pois essa nota será vinculada a outro roteiro, já para o Gestão de Armazenagem | WMS Senior existe somente o controle de 3 (finalizado) e para esse status não existe um serviço de integração com o RMS Senior, portanto a regra para não atualizar o roteiro para 3 (finalizado) no Gestão de Armazenagem | WMS Senior é sempre enviar o campo "desconsiderarRotNaoEntregue", com isso o RMS Senior retornará para o Gestão de Armazenagem | WMS Senior somente notas com status 3 (finalizado) e que tenha ocorrência de "Entrega".

Para o cenário, onde a nota é retirada de um roteiro do RMS, e para garantir que no Gestão de Armazenagem | WMS Senior o roteiro seja atualizado. O Gestão de Armazenagem | WMS Senior verifica quais notas não voltaram com roteiro no serviço que consulta roteiros, e faz uma atualização para retirar o código do roteiro, atualizando o status para 0 (em elaboração). Direcionado a nota para a esteira de integração.

O código do roteiro (de entrega das mercadorias) pode estar vinculado a uma ou mais notas.

{
  "listaCdAtividade": [
    0
  ],
  "desconsiderarRotNaoEntregue": true,
  "limit": 0
}

Alterar Chave de Acesso

O Gestão de Armazenagem | WMS Senior tem um serviço que informa a alteração na chave de acesso ao RMS Senior.

O Gestão de Armazenagem | WMS Senior busca as notas que tiveram a chave de acesso alterada e que já possua o Código Roteiro RMS Senior. A chave de acesso pode ser consultada pela coluna Status Chave Acesso.

Controle de envio de alteração para o RMS:
0 - Não enviar
1 - Enviar para alteração
2 - Alterado

{
  "cdAtividade": 0,
  "cdChaveAcessoNova": "",
  "inDoctoAtual": 0
}

Cancelamento de atividades

O Gestão de Armazenagem | WMS Senior tem um serviço que busca todas as notas canceladas que já tenha alguma atividade cadastrada, e envia para o RMS realizar o cancelamento e validar duplicidade de atividades.

Notas que possuem código de roteiro cadastrado no Gestão de Armazenagem | WMS Senior, não serão enviadas para cancelamento e a mensagem "Alteração de status indevida. A nota fiscal está sendo alterada para cancelado e liberado para roteirização.", que será apresentada ao tentar realizar o cancelamento das notas no Gestão de Armazenagem | WMS Senior , ou seja, uma nota será enviada para cancelamento no RMS, caso tenha código de atividade registrada e não tenha código de roteiro.

No RMS será permitido cadastrar o código de ocorrências padrão para cancelamento de atividade, esse código deverá ser cadastrado no Gestão de Armazenagem | WMS Senior, para ser enviado no momento do cancelamento da atividade.

Status do controle de envio de cancelamento para o RMS:
0 - Não enviar
1 - Enviar para cancelamento
2 - Cancelado

{
  "codigoAtividade": 0,
  "codigoOcorrencia": 0
}

Etiquetas

As informações do motorista e placa do veículo são compartilhadas entre as integrações RMS X WMS. Abaixo, representação de etiquetas que contêm essas informações e que podem ser personalizadas por meio do Gerenciador de Etiquetas:

• Volume com Conteúdo
• Volume Sem Conteúdo

Essas etiquetas podem ser customizadas para exibir os dados "RMSMOTORISTA" e "RMSNRPLACAVEICULO".

A integração entre o Gestão de Armazenagem | WMS Senior e o TMS Senior, é realizada através de algumas exportações que são realizadas pelo Gestão de Armazenagem | WMS Senior.

Portanto antes de receber informações do RMS, o TMS deverá consumir as informações necessárias, e em alguns cenários, quando ativado a comunicação RMS x TMS se faz necessário solicitar uma carga inicial para o Gestão de Armazenagem | WMS Senior.

Entidade

int_envio_tms_entidade

{
	cnpj: "", 
	razaoSocial: "", 
	fantasia: "", 
	pessoa: "", 
	inscrEstadual: "", 
	codigoInterno: "", 
	tipoentidade: "", 
	inscricaoSuframa: "", 
	cep: 0, 
	endereco: "", 
	numero: "", 
	bairro: "", 
	cidade: "", 
	estado: "", 
	pais: "", 
	complemento: "",
	telefone: ""
}

Produto

int_envio_tms_produto

{
	idProduto: 0, 
	descr: ""
}

Embalagem

int_envio_tms_embalagem

{
	idProduto: 0, 
	descr: "",
	dr: "", 
	fatorConv: 0
}

Cancelamento Nota Fiscal

int_envio_tms_cancelamento

{
	cnpj_Depositante: "", 
	sequencia: "", 
	codigoInterno: 0,
	motivoCancelamento: "", 
	tipo: ""
}

Fatura de Serviços

int_envio_tms_fatura_servico e int_envio_tms_fatura_servicodet

{ 
    cnpjUnidade: "",
    idFatura: 0,
    numeroContrato: 0,
    cnpjDepositante: "",
    dataApuracao: "" ,
    vencimento: "",
    valor: 0,
    desconto: 0,
    valorLiquido: 0,
    fatura_ServicoDet = [{
		id: 0,
		servico: "",
		qtde: 0,
		valorUnitario: 0,
		valorTotal: 0,
		desconto: 0,
		valorTotalLiquido: 0
	}]
}

Nota Fiscal de Armazenagem

int_envio_tms_nf_armazenagem e int_envio_tms_nf_armazenagemdet

{
	cnpjDepositante: "", 
	codigoUnidade: "", 
	sequencia: "", 
	codigoInterno: 0, 
	dataEmissao: "", 
	data: "",
	dataEntrada: "",
	tipo: "", 
	operacao: "", 
	observacao: "", 
	cfop: "", 
	peso: 0, 
	pesoLiquido: 0, 
	cancelado: "",
	idNotaFiscal: 0, 
	chaveNfe: "", 
	protocoloNfe: "",	
	valorContabil: 0, 
	valorDespacessOrias: 0, 
	baseIcms: 0,
	aliqIcms: 0,
	valorIcms: 0,
	aliqIpi: 0,
	valorIpi: 0,
	baseIss: 0,
	aliqIss: 0,
	valorIss: 0,
	baseCofins: 0,
	valorCofins: 0,
	basePis: 0,
	valorPis: 0,
	baseCsllRetido: 0,
	valorCsllRetido: 0,
	baseIcmsSub: 0,
	valorIcmsSub: 0,
	valorIrrf: 0,
	nf_ArmazenagemDet = [{
		seq_Itens: 0, 
		idProduto: 0, 
		data: "", 
		cfop: "",
		qtde: 0, 
		precoUnitario: 0, 
		precoTotal: 0,
		aliqIpi: 0,
		valorIpi: 0,
		cstIpi: 0,
		baseIcms: 0, 
		aliqIcms: 0,
		valorIcms: 0,
		codigoSt: 0,
		baseIcmsSubst: 0,
		icmsSubst: 0,
		aliqIss: 0, 
		valorIss: 0, 
		vlrOutras: 0, 
		vlrIsento: 0, 
		cstPis: 0, 
		aliqPis: 0,  
		valorPis: 0, 
		cstCofins: 0, 
		aliqCofins: 0, 
		valorCofins: 0 
	}]
}

Acesse Movimentação > Saída > Gerenciador de Expedição > botão Formar

1. Escolha a Configuração da Onda com o parâmetro Somente notas fiscais roteirizada pelo RMS Senior marcado.

Com este processo o sistema gera as coletas automáticas com as notas fiscais roteirizadas pelo RMS Senior.

A coluna Cód.Roteiro RMS Senior é um facilitador para realizar filtros nas notas fiscais para a formação da onda.

Vale lembrar que a coluna Roteiro, não faz parte do fluxo de Integração WMS x RMS Senior.

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

A partir desta tela acompanhamos os logs de erro ou sucesso retornados também pelo RMS e os que foram enviados ao TMS.

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

Esta tela é utilizada para acompanhar a integração.

Visualiza as principais informações das notas ou pedidos integrados, os retornos do RMS, número de controle de envio, atividade, roteiro, dentre outras informações.

Caso o status esteja com erro, o sistema permite selecionar uma ou mais notas para reintegrar e destravar a operação.
Por exemplo: se num lote com 100 documentos, enviado do Gestão de Armazenagem | WMS Senior> RMS a nota 2/100 apresentar erro, as outras 98 ficam sem processar até que esta seja removida ou ajustada no RMS. Após ocorrer o ajuste no RMS a nota poderá ser reintegrada no Gestão de Armazenagem | WMS Senior.