Exibir origem

Objetivo

Este documento tem como objetivo explicar o funcionamento da geração de pedidos provenientes da integração com o PDVSync.

Pré-Requisitos e Restrições

Necessário a instalação do serviço winthor-pedido-venda.
Para gerar o pedido, o campo situacaoPreVenda deve está igual a RECEBIDO.
Caso o atributo "idOperadorRetaguarda" não seja enviado na requisição, a API consultará o RCA definido no parâmetro "4012 - Código do RCA para cadastro de clientes" da rotina 132- Parâmetros da Presidência.
A tabela PCLOGPEDIDOAPI, é responsável por guardar os retornos dos pedidos importados via integração, sendo Operação (I - inclusão, A - alteração, C - cancelamento) e Status (A - Aceito, R - Rejeitado, P - Processando).
No envio do JSON deve-se enviar no campo preVendaItens.idProdutoRetaguarda o código auxiliar seguido do código do produto. Exemplo: 100-1. Lembrando que o IdRetaguarda dos produtos na base do PDV já seguem esse padrão e são enviadas pelo WSH assim.
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
Caso o cadastro do cliente esteja completo o cliente já vai ser inserido neste processo do pedido.
A regra para gravação ou alteração do cliente seguirá o definido
Ao enviar o cliente, será validado o parâmetro 4672 - Aceita validar CEP online nas APIs do WinThor da rotina 132 permite validar se o CEP informado está valido em API terceiros (ViaCEP e ByJG). Caso falso, essa validação não ocorrerá. O padrão do parâmetro é "Sim";

'

Integração

A integração consiste em receber e enviar dados do pedido que serão utilizados para reserva de estoque

Os dados integrados são:

API	Descrição	Coluna	Tipo	Obrigatório
situacaoPreVenda	0 = CANCELADA 1 = RECEBIDO 2 = DISPONIVEL 3 = RESGATADA		int	SIM
numero	Identificação do pedido no PDV.	PCPEDC.NUMPEDHUBE	String	SIM
observacoes		PCPEDC.OBS
idOperadorRetaguarda	Matricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012.	PCPEDC.CODUSUR	long	NÃO
idLojaRetaguarda	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.*.idProdutoRetaguarda	Código auxiliar mais o código do produto. Ex: 123-1.	PCPEDI.CODPROD		SIM
preVendaItens.*.idVendedorRetaguarda				NÃO
preVendaItens.*.entrega.idRetaguardaLojaEntrega	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	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			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

Exemplo do envio da requisição:

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

{
    "situacaoPreVenda": "DISPONIVEL",
    "id": {{numPedHube}},
    "numero": {{numPedHube}},
    "observacoes": "venda de teste",
    "idOperadorRetaguarda": "1",
    "idLojaRetaguarda": "1",
    "preVendaItens": [
        {
            "quantidade": 1.0,
            "preco": 24.9,
            "desconto": 0.0,
            "descontoPercentual": 0.0,
            "idProdutoRetaguarda": "303-13",
            "idVendedorRetaguarda": "1",
            "entrega": {
                "idRetaguardaLojaEntrega": "1"
            }
        }
    ]
}

{
   "success": true,
   "hasNext": false,
   "message": "",
   "data": {
      "idRetaguardaPedido": "54434",
      "message": "",
      "success": true
   }
}