TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • APIs Logistica - Integração Coleta Entrega - Viagens

Objetivo

Este documento tem como objetivo explicar o funcionamento da integração de Viagens.

Pré-Requisitos e Restrições

  • Necessário a instalação do serviço winthor-logistica-apis. Para realizar a instalação desse serviço, segue link com as devidas explicações:

Comece por aqui -> Parametrizações WTA

Integração


Os dados integrados são: 

Viagem


APIReferência Winthor Tipo(Tamanho)Observação

externalId

pccarreg.numcarNUMBER(8)

descricao

pccarreg.destinoVARCHAR2(20)

unidadeOperacionalId

pcintegracaodepara.idexterno
Para a tabela com valor PCFILIAL e campo CODFILIAL no qual corresponde ao codfilial da PCNFENT.

unidadeCadastroId

pcintegracaodepara.idexterno
Para a tabela com valor PCFILIAL e campo CODFILIAL no qual corresponde ao codfilial da PCNFENT.

motoristaId

pcintegracaodepara.idexterno
Para a tabela com valor PCCARREG e campo CODMOTORISTA no qual corresponde ao CODMOTORISTA da PCCARREG.
IdentificacaoViagem


APIReferência Winthor Tipo(Tamanho)Observação
numeropcveicul.placaVARCHAR2(10)

Para a tabela com valor PCCLIENT e campo CGCENT no qual corresponde ao CGCENT sem pontos e tracos da PCCLIENT.

TarefaViagem


APIReferência Winthor Tipo(Tamanho)Observação
idpcnfsaid.idexternocoletaentregaVARCHAR2(40)
tipo

Sempre sera ENTREGA pois não serão enviadas coletas diretamente com os carregamentos
sequencia

Sequencia montada de acordo com a ordem das notas vinculadas ao carregamento

Requisição para buscar viagens para integrar:

URI
method: 'GET',
url: '/logistica/apis/v1/viagens/buscar'


Exemplo Retorno:

Exemplo Retorno
[
	 {
		"externalId": "string",
		"descricao": "string",
		"identificacao": {
			"numero": "string"
		},
		"motoristaId": "string",
		"tarefas": [
			{
				"id": "string",
				"tipo": "string",
				"sequencia": 0
			}
		],
		"unidadeCadastroId": "string",
		"unidadeOperacionalId": "string"
	}
]





Requisição para inserir o idExterno do coleta entrega na viagem.

URI
method: 'POST',
url: '/logistica/apis/v1/viagens/salvar-id-coleta-entrega'



Body
{
    "numcar": "string",
    "idExterno": "string",
    "dataSituacao": "yyyy-MM-dd'T'HH:mm:ss"
}



Requisição para buscar viagensjá integradas:

URI
method: 'GET',
url: '/logistica/apis/v1/viagens/buscar-integradas'



Exemplo Retorno
[
	{
		"numCar": "string",
		"idColetaEntrega": "string",
		"dataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm:ss"
	}
]



Requisição para inserir os dados recebidos do coleta entrega na viagem:

URI
method: 'POST',
url: '/logistica/apis/v1/viagens/salvar-retorno-coleta-entrega'



Body
{
    "idExterno": "string",
    "numCar": "string",
    "situacao": "string",
    "dataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm:ss"
}

Requisição para buscar viagensnão integradas:

URI
method: 'GET',
url: '/logistica/apis/v1/viagens/buscar-nao-integradas'


Exemplo Retorno:

Exemplo Retorno
[
	{
		"numCar": "string"
	}
]







  • Sem rótulos