Histórico da Página

...

Necessário a instalação do serviço winthor-pedido-venda.
Para cancelar um pedido o campo situacaoPreVenda deve está igual a 0.
O cancelamento do pedido será total e deverá ser feito pela rotina 4177 do módulo 041.
Para realizar o cancelamento o pedido no Winthor ele não deve está estar faturado, caso esteja faturado o cliente deve se dirigir ao setor responsável por devolução/troca da empresa.
O atributo "idRetaguarda" que informa o código que representa o código do pedido na retaguarda e que em paralelo representa o número do pedido no Winthor e será obrigatório nesse processo, para que possa ser possível a identificação do pedido.
Essa API será utilizada pelo PDVSync para cancelamento online, e também pelo WSH do Winthor para cancelamentos offline.
API criada com base da documentação fornecida pelo PDVSync: https://pdvsync-core-controle-dev-aadivv24nq-ue.a.run.app/swagger/index.html?urls.primaryName=V2

...

(ProcessoOnlinePreVenda)

Integração

Totvs custom tabs box

tabs	Dados integrados c/ Winthor, Gravação Pedido/Retorno
ids	passo1,passo2

A integração consiste em receber o número do pedido para cancelamento no Winthor.

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

0 = CANCELADA
1 = RECEBIDO
2 = DISPONIVEL
3 = RESGATADA

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

Caso já exista um cliente com mesmo CGC e o idRetaguarda não seja informado será usado o cliente mais antigo que contém o mesmo CGC

API

Descrição

Coluna

Tipo

Obrigatório

situacaoPreVenda

int

SIM

numero

Identificação do pedido no PDV.

PCPEDC.NUMPEDHUBE

String

SIM

observacoes

PCPEDC.OBS

id

Código do pedido(campo chave)

String

NÃO

idInquilino

Código do inquilino para uso do PDVSync.

String

NÃO

idProprietario

Código do proprietário.

String

NÃO

idRetaguarda

Código do pedido na retaguarda.

PCPEDC.NUMPED

String

SIM

situacao

0 = Cancelado (Valor default 0)

int

NÃO

offline

Caso envie true será replicado o valor da coluna PECPEDC.ORIGEMINTEGRACAO na PCNFCAN.ORIGEMINTEGRACAO.
Caso não envie esse campo o será replicado o valor da coluna PECPEDC.ORIGEMINTEGRACAO na PCNFCAN.ORIGEMINTEGRACAO com a adição do texto "ONLINE" (ex: na PECPEDC.ORIGEMINTEGRACAO estará "PDVSYNC" e na PCNFCAN.ORIGEMINTEGRACAO ficará "PDVSYNCONLINE")

Boolean

operador.idRetaguarda

Matricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012.

PCPEDC.CODUSUR

long

NÃO

loja.idRetaguarda

Código da filial.

SIM

preVendaItens.*.quantidade

Deve ser maior que zero.

PCPEDI.QT

int

SIM

preVendaItens.*.preco

Deve ser maior que zero.

PCPEDI.PVENDA

preVendaItens.*.desconto

Valor de desconto.

NÃO

preVendaItens.*.descontoPercentual

Percentual de desconto.

NÃO

preVendaItens.*.produto.idRetaguarda

Código auxiliar mais o código do produto. Ex: 123-1.

PCPEDI.CODPROD

SIM

preVendaItens.*.vendedor.idRetaguarda

NÃO

preVendaItens.*.lojaEntrega.idRetaguarda

Código da filial retira.

NÃO

cliente

Caso não seja informado o cliente será usado o cliente consumidor final.

Caso o cliente esteja com o cadastro completo, ele já será gravado na base do winthor .

NÃO

cliente.bairro

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.telefone

Caso não preenchido será usado o campo celular

NÃO

cliente.celular

Caso não preenchido será usado o campo telefone

NÃO

cliente.cep

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.cidade

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.complemento

NÃO

cliente.cpfCnpj

NÃO

cliente.email

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.endereco

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.estado

Este campo é obrigatório para gravar o cliente, caso não seja informado o cliente não será gravado e será usado o cliente consumidor final para gerar a reserva de estoque

NÃO

cliente.idRetaguarda

Código cliente

NÃO

cliente.numero

NÃO

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

method:  'POSTPATCH',
url:  '/api/wholesale/v1/orders/pdvsync'

Bloco de código

language	js
title	Body Request

{
   "situacaoPreVenda": "1",
   "numero": "1234556",
   "observacoes": "venda de teste",
   "operador": {
         	
   "idRetaguarda": "11000044"
   },
   "lojaoffline": {
      "idRetaguarda": "1"
   },
   "preVendaItens": [
      {
         "quantidade": 1.0,
         "preco": 24.9,
         "desconto": 0.0,
         "descontoPercentual": 0.0,
         "produto": {
            "idRetaguarda": "2-2"
         },
         "vendedor": {
            "idRetaguarda": "string"
         },
         "lojaEntrega": {  "idRetaguarda": "1" }
      }
   ]
}false 
}

Bloco de código

language	js
title	Body Response

{
    "success": true,
    "hasNext": false,
    "message": "Pedido 1000044 cancelado no Winthor com sucesso.",
    "data": {
        "idRetaguardaPedido": "54434",
        "message": "",
        "success": true
    }
}

Páginas filhas

Versões comparadas

Versão antiga 4

Nova versão Atual

Chave

Integração