API Atualizar Pedido

Atualiza um pedido em rascunho: os itens, o desconto, o acréscimo e a entrega.

API: Todas

Endpoint

https://api.talkz.ai/api/pdv/pedidos/{pedidoId}

Método

PUT

Autenticação

Bearer {seutokenaqui}

Payload

{
    "itens": [
        {
            "productId": 101,
            "quantidade": 3
        }
    ],
    "descontoTipo": "valor",
    "descontoValor": 10.00,
    "acrescimo": 0,
    "entrega": "retirada",
    "observacao": "Cliente vai buscar no fim da tarde."
}

O pedidoId vai no próprio endereço: é o ID do pedido, que vem na listagem dos pedidos e na resposta da criação.

Só o rascunho pode ser atualizado. Pedido confirmado, entregue ou cancelado é recusado.

“itens”: os produtos do pedido como ele deve ficar — eles substituem os itens atuais. Obrigatório.

Cada item leva o produto pelo productId ou pelo sku do cadastro, e a quantidade.

Os preços são recalculados pelo cadastro de agora, inclusive dos itens que já estavam no pedido.

O corpo enviado vira o pedido inteiro. O que ficar de fora volta ao padrão: sem desconto e sem acréscimo, retirada no local, sem taxa e sem endereço de entrega, e sem observação. Para mudar só a quantidade, mande de novo também o que quer manter.

“descontoTipo”: valor (em reais) ou percentual.

“descontoValor”: o desconto — o valor em reais ou o percentual, conforme o descontoTipo.

“acrescimo”: acréscimo em reais.

“entrega”: retirada ou entrega. Na entrega, o “enderecoEntrega” é obrigatório e a “taxaEntrega” entra no total.

“observacao”: observação do pedido.

O cliente do pedido não muda por aqui.

Utilize o código em requisições HTTPS com ferramentas como cURL ou bibliotecas de integração.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.talkz.ai/api/pdv/pedidos/{pedidoId}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_POSTFIELDS =>'{
    "itens": [
        {
            "productId": 101,
            "quantidade": 3
        }
    ],
    "descontoTipo": "valor",
    "descontoValor": 10.00,
    "acrescimo": 0,
    "entrega": "retirada",
    "observacao": "Cliente vai buscar no fim da tarde."
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {seutokenaqui}' //Token cadastrado na conexão
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
Copiar como cURL