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

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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


Totvs custom tabs box
tabsDados integrados com Winthor, Buscar Coletas, Salvar Id Coleta Entrega, Buscar Ja Integradas, Salvar Retorno Coleta Entrega, Buscar Nao Integradas
idspasso1,passo2,passo3,passo4,passo5,passo6
Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

Coleta


APIReferência Winthor Tipo(Tamanho)Observacao

friendlyId

pcnfent.numtransentVARCHAR2(60)

externalId

pcnfent.numtransentVARCHAR2(40)

documento

pcnfent.numnotaDATE

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.

pesoTotalBruto

pcnfent.totpeso

cubagemTotal

pcnfent.numvol

valorTotal

pcnfent.vltotal

quantidadeTotalVolumes

pcnfent.numvolume

observacao

pcnfent.obs

EnderecoColeta


APIReferência Winthor Tipo(Tamanho)Observacao
clienteIdpcintegracaodepara.idexterno

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

localidadeIdpcintegracaodepara.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
defaultno
referenciapasso2

Requisição para buscar coletas não integradaspara integrar:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/logistica/apis/v1/coletas/buscar'


Exemplo Retorno:

Bloco de código
languagejs
titleExemplo Retorno
[
	 {
		"friendlyId": "string",
		"externalId": "string",
		"documento": "string",
		"unidadeOperacionalId": "string",
		"unidadeCadastroId": "string",
		"enderecoOrigem": {
			"clienteId": "string",
			"localidadeId": "string",
			"complemento": "string",
			"descricao": "string",
			"tipoEndereco": "string",
			"telefone": "string"
		},
		"pesoTotalBruto": "number",
		"cubagemTotal": "number",
		"valorTotal": "number",
		"quantidadeTotalVolumes": 0,
		"observacao": "string"
	}
]





Totvs custom tabs box items
defaultno
referenciapasso3

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

Bloco de código
languagejs
titleURI
method: 'POST',
url: '/logistica/apis/v1/clientescoletas/salvar-id-coleta-entrega'



Bloco de código
languagejs
titleBody
{
    "numTransEnt": "string",
    "idExterno": "string",
    "dataSituacao": "yyyy-MM-dd'T'HH:mm:ss"
}



Totvs custom tabs box items
defaultno
referenciapasso4

Requisição para buscar coletas já integradas:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/logistica/apis/v1/coletas/buscar-integradas'



Bloco de código
languagejs
titleExemplo Retorno
[
	{
		"numTransEnt": "string",
		"idColetaEntrega": "string",
		"dataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm:ss"
	}
]



Totvs custom tabs box items
defaultno
referenciapasso5

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

Bloco de código
languagejs
titleURI
method: 'POST',
url: '/logistica/apis/v1/coletas/salvar-retorno-coleta-entrega'



Bloco de código
languagejs
titleBody
{
    "idExterno": "string",
    "numTransEnt": "string",
    "situacao": "string",
    "dataUltimaAlteracao": "yyyy-MM-dd'T'HH:mm:ss"
}
Totvs custom tabs box items
defaultno
referenciapasso6

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

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/logistica/apis/v1/coletas/buscar-nao-integradas'


Exemplo Retorno:

Bloco de código
languagejs
titleExemplo Retorno
[
	{
		"numTransEnt": "string"
	}
]