Exibir origem

Objetivo

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

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

Para realizar o cadastro de clientes no WinThor, acesse o link abaixo:

Como cadastrar cliente na rotina 302?

Integração

Os dados integrados são:

API	Referência Winthor	Tipo(Tamanho)	Observacao
Coleta
friendlyId	pcnfent.numtransent	VARCHAR2(60)
externalId	pcnfent.numtransent	VARCHAR2(40)
documento	pcnfent.numnota	DATE
unidadeOperacionalId	pcintegracaodepara.idexterno		Para a coluna com valor PCFILIAL e campo CODFILIAL no qual corresponde ao codfilial da PCNFENT.
unidadeCadastroId	pcintegracaodepara.idexterno		Para a coluna com valor PCFILIAL e campo CODFILIAL no qual corresponde ao codfilial da PCNFENT.
pesoTotalBruto	pcnfent.totpeso
cubagemTotal	pcnfent.numvol
valorTotal	pcnfent.vltotal
quantidadeTotalVolumes	pcnfent.numvolume
observacao	pcnfent.obs

Requisição para buscar clientes não integrados:

method: 'GET',
url: '/logistica/apis/v1/clientes/buscar'

Exemplo Retorno:

[
	{
		"nome": "string",
		"nomeFantasia": "string",
		"documentoIdentificacao": {
			"numero": "string"
		},
		"horarioFuncionamento": [
			{
				"diasSemana": "string",
				"horarioInicio": "HH:mm",
				"horarioFim": "HH:mm",
				"tipo": "string"
			}
		],
		"enderecos": [
			{
				"numero": "string",
				"complemento": "string",
				"descricao": "string",
				"tipoEndereco": "PRINCIPAL|DEPOSITO",
				"telefone": "string",
				"localidade": {
					"tipoLocalidade": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOURO",
					"componentesEnderecos": [
						{
							"nomeLongo": "string",
							"nomeCurto": "string",
							"tipoComponente": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOURO"
						}
					]
				}
			}
		],
		"dataAtualizacao": "yyyy-MM-dd'T'HH:mm:ss"
	}
]

Requisição para buscar clientes já integrados para atualização:

method: 'GET',
url: '/logistica/apis/v1/clientes/buscar-atualizar'

*PARAMS:*
dataUltimaAlteracao: date - Informe a data de última alteração para trazer clientes alterados apos esta data.

Exemplo Retorno:

[
	{
		"nome": "string",
		"nomeFantasia": "string",
		"documentoIdentificacao": {
			"numero": "string"
		},
		"horarioFuncionamento": [
			{
				"diasSemana": "string",
				"horarioInicio": "HH:mm",
				"horarioFim": "HH:mm",
				"tipo": "string"
			}
		],
		"enderecos": [
			{
				"numero": "string",
				"complemento": "string",
				"descricao": "string",
				"tipoEndereco": "PRINCIPAL|DEPOSITO",
				"telefone": "string",
				"localidade": {
					"tipoLocalidade": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOURO",
					"componentesEnderecos": [
						{
							"nomeLongo": "string",
							"nomeCurto": "string",
							"tipoComponente": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOURO"
						}
					]
				}
			}
		],
		"dataAtualizacao": "yyyy-MM-dd'T'HH:mm:ss"
	}
]