Integrações RMS > Integrações via API

Integração via API

A solução permite integrações via API.

Como fazer as integrações via API?

Utilize as APIs disponíveis em https://dev.senior.com.br/apis/

Quais informações posso integrar via API para a solução de Roteirização e Torre de Controle?

Estas são as mais comuns:

Categoria	Item	Ações principais	Descrição	Link da API
Cadastro	Motoristas	insereMotorista alteraMotorista deletaMotorista buscaMotoristas		https://dev.senior.com.br/apis/tmsentregas_motoristas/
	Veículos	insereVeiculo insereGrupoVeiculo alteraGrupoVeiculo alteraVeiculo deletaVeiculo deletaGrupoVeiculo buscaVeiculos buscaFiliaisEmpresa buscaSituacaoVeiculo buscaTiposCombustivel buscaGruposVeiculos buscaVeiculosDisponiveis buscaTiposVeiculo buscaTiposVeiculosPlacas		https://dev.senior.com.br/apis/tmsentregas_veiculos/
	Tipos de Ocorrências	insereTiposOcorrencia alteraTiposOcorrencia deletaTiposOcorrencia buscaTiposOcorrencia buscaSituacoesTipoOcorrencia buscaCamposObrigTipoOcorrencia		https://dev.senior.com.br/apis/tmsentregas_tiposocorrencia/
	Destinos	buscaDestinos insereDestinos		https://dev.senior.com.br/apis/tmsentregas_empresas/
	Busca Ponto Apoio por Filiais	numeroCpnjFilial	Retornar os pontos de apoio de uma ou mais filiais.	Exemplo JSON: Solicitação: { "numeroCpnjFilial" : ["0", "0"] } Resposta: { [ { "id": 1, "nome": "Nome do ponto de apoio 1" }, { "id": 2, "nome": "Nome do ponto de apoio 2" } ] }
Processo	Atividades	insereLoteAtividades	Possibilita inserir várias atividades de uma só vez. Para informações sobre como preencher os campos, consulte nossa explicação.
	Atividades	insereAtividade alteraAtividade deletaAtividade buscaAtividades buscaAtividadesDiaVeiculo buscaTiposAtividades		https://dev.senior.com.br/apis/tmsentregas_atividades/
	Ocorrências e comprovantes	buscaAtividades	Retorna a atividade e as ocorrências apontadas.	https://dev.senior.com.br/apis/tmsentregas_atividades/
	Ocorrências e comprovantes	buscaDadosRecebedor	Retorna os dados do recebedor, imagens e assinaturas dos comprovantes.	https://dev.senior.com.br/apis/tmsentregas_atividades/

Como utilizar?

Para todas as ações é necessário o uso do Token. Para isso, é preciso fazer a seguinte requisição:

Requisição

https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/usuarios/userManager/actions/login

Header

Chave	Valor	Descrição
Content-Type	Application/json	Tipo do retorno da requisição

Body

Nome	Tipo	Descrição
username	string	Usuário do sistema senior X
password	string	Senha do usuário no sistema senior X

Resultado esperado

{\"scope\":\"desktop\",\"token_type\":\"Bearer\",\"expires_in\":3039,\"refresh_token\":\"7e37ca7ea7d60919b2028673e2449994\",\"access_token\":\"62c46928c8055d9df588ff6149feae74\"}

Veja este exemplo de integração de Atividade:

{

"atividades": [

{

"inAtividade": 2,

"cdDestino": "XPTO-0001",

"dsDestinatario": "João da Silva",

"dsLocal": "Rua XV de Novembro",

"cdNumero": 1071,

"dsBairro": "Centro",

"dsCidade": "Blumenau",

"dsEstado": "SC",

"dsPais": "Brasil",

"qtVolumes": 3,

"qtPeso": 12,

"dsNrDocto": "654351354",

"dtPrazoEntr": "2018-12-31T18:00:00.000Z",

"dtAgendamento": null,

"nrCep": 89010002,

"dsRefRoteiro": "Conhecimento X",

"dtIniRoteiro": "2018-08-03T08:00:00.000Z",

"dtPrevChegada": "2018-08-03T08:15:00.000Z",

"cdSeqExecucao": 1,

"nrPlaca": "AAA-1111",

"nrCpf": "12345678900",

"dtJanelaIni": "1900-01-01T08:00:00.000Z",

"dtJanelaFim": "1900-01-01T18:00:00.000Z",

"qtTempoAtend": "1900-01-01T00:30:00.000Z",

"qtMetrosCubicos": 1,

"inPrioridade": 1,

"nrCNPJFilial": "54073288000153"

{

"inAtividade": 1,

"cdDestino": "XPTO-0002",

"dsDestinatario": "José dos Santos",

"dsLocal": "Rua Sete de Setembro",

"cdNumero": 1314,

"dsBairro": "Centro",

"dsCidade": "Blumenau",

"dsEstado": "SC",

"dsPais": "Brasil",

"qtVolumes": 4,

"qtPeso": 20,

"dsNrDocto": "654684684",

"dtPrazoEntr": "2018-12-31T18:00:00.000Z",

"dtAgendamento": null,

"nrCep": 89015250,

"dsRefRoteiro": "Conhecimento X",

"dtIniRoteiro": "2018-08-03T08:00:00.000Z",

"dtPrevChegada": "2018-08-03T09:00:00.000Z",

"cdSeqExecucao": 2,

"nrPlaca": "AAA-1111",

"nrCpf": "12345678900",

"dtJanelaIni": "1900-01-01T08:00:00.000Z",

"dtJanelaFim": "1900-01-01T18:00:00.000Z",

"qtTempoAtend": "1900-01-01T00:20:00.000Z",

"qtMetrosCubicos": 1,

"inPrioridade": 5,

"nrCNPJFilial": "54073288000153"

{

"inAtividade": 2,

"cdDestino": "XPTO-0004",

"dsDestinatario": "Carlos Filho",

"dsLocal": "Rua Antônio da Veiga",

"cdNumero": 548,

"dsBairro": "Victor Konder",

"dsCidade": "Blumenau",

"dsEstado": "SC",

"dsPais": "Brasil",

"qtVolumes": 4,

"qtPeso": 13,

"dsNrDocto": "655351344",

"dtPrazoEntr": "2018-12-31T18:00:00.000Z",

"dtAgendamento": null,

"nrCep": 89012500,

"dtIniRoteiro": "2018-08-03T08:00:00.000Z",

"dtPrevChegada": "2018-08-03T08:30:00.000Z",

"cdSeqExecucao": 1,

"nrPlaca": "BBB-2222",

"nrCpf": "12345678901",

"dtJanelaIni": "1900-01-01T08:00:00.000Z",

"dtJanelaFim": "1900-01-01T18:00:00.000Z",

"qtTempoAtend": "1900-01-01T00:20:00.000Z",

"qtMetrosCubicos": 1,

"inPrioridade": 2,

"nrCNPJFilial": "54073288000153"

}

]

}

PORTAL DE DOCUMENTAÇÃO
Roteirização e Torre de Controle - senior X