Páginas filhas
  • APIs Integrações - Pedido - Reservar estoque PDVSync - INTERNA

Versões comparadas

Chave

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

...

  • Necessário a instalação do  serviço winthor-pedido-venda
  • Para reservar o estoque o campo situacaoPreVenda deve está igual a 1.
  • Os pedidos entraram sempre como bloqueado.
  • Caso o atributo "operador.idRetaguarda" 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 na Ciashop" 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).
  • Ao inserir um pedido através da API, o campo "PCPEDI.PBASERCA" gravará de acordo com o campo “PCPEDI.PTABELA”, não é necessário enviá-lo pela API.
  • No envio do JSON deve-se enviar no campo  preVendaItens.produto.idRetaguarda o código auxiliar seguido do código do produto. Exemplo: 100-1 
  • Api 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 de reserva de estoque

'

 Integração


Totvs custom tabs box
tabsDados integrados c/ Winthor, Gravação Pedido/Retorno
idspasso1,passo2

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

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

APIDescriçãoColunaTipoObrigatório
situacaoPreVenda0 = CANCELADA

1 = RECEBIDO

2 = DISPONIVEL

3 = RESGATADA

intSIM
numeroIdentificação do pedido no PDVPCPEDC.NUMPEDHUBEStringSIM
observacoes
PCPEDC.OBS

operador.idRetaguardaMatricula do funcionário. Caso não informado irá usar o RCA do parâmetro 4012PCPEDC.CODUSURlongNÃO
loja.idRetaguardaCódigo da filial 

SIM
preVendaItens.*.quantidadeDeve ser maior que zero PCPEDI.QTintSIM
preVendaItens.*.precoDeve ser maior que zero PCPEDI.PVENDA

preVendaItens.*.descontoValor de desconto 

NÃO
preVendaItens.*.descontoPercentualPercentual de desconto 

NÃO
preVendaItens.*.produto.idRetaguardaCódigo auxiliar mais o código do produto. Ex: 123-1PCPEDI.CODPROD
SIM
preVendaItens.*.vendedor.idRetaguarda


NÃO
preVendaItens.*.lojaEntrega.idRetaguardaCódigo da filiar retira

NÃO 
Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'POST',
url: '/api/wholesale/v1/orders/pdvsync'
Bloco de código
languagejs
titleBody Request
{
   "situacaoPreVenda": "1",
   "numero": "1234556",
   "observacoes": "venda de teste",
   "operador": {
      "idRetaguarda": "1"
   },
   "loja": {
      "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" }
      }
   ]
}
Bloco de código
languagejs
titleBody Response
{
   "success": true,
   "hasNext": false,
   "message": "",
   "data": {
      "idRetaguardaPedido": "54434",
      "message": "",
      "success": true
   }
}