Histórico da Página

...

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

Integração

Totvs custom tabs box

tabs	Dados integrados com Winthor, Buscar Clientes, Buscar Clientes AtualizarColetas, Salvar Id Coleta Entrega, Buscar Ja Integradas, Salvar Retorno Coleta Entrega, Buscar Nao Integradas
ids	passo1,passo2,passo3,passo4,passo5,passo6

Totvs custom tabs box items

default	yes
referencia	passo1

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 tabela com valor PCFILIAL e campo CODFILIAL no qual corresponde ao codfilial da PCNFENT.
unidadeCadastroId	pcintegracaodepara.idexterno		Para a coluna tabela 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

EnderecoColeta
API	Referência Winthor	Tipo(Tamanho)	Observacao
clienteId	pcintegracaodepara.idexterno		Para a tabela com valor PCCLIENT e campo CGCENT no qual corresponde ao CGCENT sem pontos e tracos da PCCLIENT.
localidadeId	pcintegracaodepara.idexterno		Para a coluna com valor PCCLIENT\|PCCLIENTENDENT e campo LOGRADOURO\|NUMERO\|CEP no qual corresponde a concatenacao dos campos ENDERENT, NUMEROENT E CEPENT com pipe(\|).
complemento	pcclientendent.complementoent, pcclient.complementoent	VARCHAR2(80)
tipoEndereco			PRINCIPAL utilizado nos enderecos principais e DEPOSITO utilizado nos enderecos alternativos.

Totvs custom tabs box items

default	no
referencia	passo2

Requisição para buscar clientes não integradoscoletas para integrar:

Bloco de código

language	js
title	URI - Cadastrar Cliente

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

Exemplo Retorno:

Bloco de código

language	js
title	BodyExemplo Retorno

[
	 {
		"nomefriendlyId": "string",
		"nomeFantasiaexternalId": "string",
		"documentoIdentificacao": {
			"numerodocumento": "string"
		},
		"horarioFuncionamentounidadeOperacionalId": [
			{
				"diasSemana": "string",
				"horarioIniciounidadeCadastroId": "HH:mmstring",
				"horarioFimenderecoOrigem": "HH:mm",{
				"tipoclienteId": "string"
			}
		],
		"enderecos": [
			{
				"numerolocalidadeId": "string",
				"complemento": "string",
				"descricao": "string",
				"tipoEndereco": "PRINCIPAL|DEPOSITOstring",
				"telefone": "string",
				"localidade": {},
					"tipoLocalidadepesoTotalBruto": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOUROnumber",
					"componentesEnderecoscubagemTotal": [
						{
							"nomeLongo": "string""number",
							"nomeCurtovalorTotal": "stringnumber",
							"tipoComponentequantidadeTotalVolumes": "PAIS|ESTADO|MUNICIPIO|BAIRRO|LOGRADOURO|CODIGO_POSTAL|NUMERO_LOGRADOURO"
						}
					]
				}
			}
		]0,
		"dataAtualizacaoobservacao": "yyyy-MM-dd'T'HH:mm:ssstring"
	}
]

Totvs custom tabs box items

default	no
referencia	passo3

Requisição para buscar clientes já integrados para atualização:inserir o idExterno do coleta entrega na coleta.

Bloco de código

language	js
title	URI Parameters - Listar um único cadastro

method: 'GETPOST',
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:

coletas/salvar-id-coleta-entrega'

Bloco de código

language	js
title	URI Parameters - Listar todos cadastros	Body

{
    "numTransEnt[
	{
		"nome": "string",
		"nomeFantasia    "idExterno": "string",
		"documentoIdentificacao    "dataSituacao": {
			"numero": "string"
		},
		"horarioFuncionamento":"yyyy-MM-dd'T'HH:mm:ss"
}

Totvs custom tabs box items

default	no
referencia	passo4

Requisição para buscar coletas já integradas:

Bloco de código

language	js
title	URI

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

Bloco de código

language	js
title	Exemplo Retorno

[
	{
		"numTransEnt [
			{
				"diasSemana": "string",
				"horarioInicioidColetaEntrega": "HH:mmstring",
				"horarioFimdataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm",
				"tipo": ":ss"
	}
]

Totvs custom tabs box items

default	no
referencia	passo5

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

Bloco de código

language	js
title	URI

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

Bloco de código

language	js
title	Body

{
    "idExternostring"
			}
		],
		"enderecos": [
			{
				"numero": "string",
				"complemento    "numTransEnt": "string",
				"descricao    "situacao": "string",
				"tipoEndereco    "dataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm:ss"
}

Totvs custom tabs box items

default	no
referencia	passo6

Requisição para buscar coletas não integradas:

Bloco de código

language	js
title	URI

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

Exemplo Retorno:

Bloco de código

language	js
title	Exemplo Retorno

[
	{
		"numTransEnt": "stringPRINCIPAL|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"
	}
]

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Integração