Alterar pedido
/contacts/{contact_id}/order/{order_id}Muda a situação de um pedido e os dados de entrega. A situação vai em status, pelo código: 6 Aceito (em processamento), 7 Entregando (enviado), 10 Concluído e 13 Cancelado. O Não processado (código 4) não pode ser escolhido aqui. Veja Pedidos, cupons e vendedores.
curl -X POST "https://app.nextagsai.com.br/api/contacts/123456789/order/PED-1001" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"status": 7,
"name": "Ana Souza",
"phone": "5511988776655",
"city": "São Paulo",
"state": "SP",
"zip_code": "01310-100",
"street_1": "Av. Paulista, 1578",
"street_2": "Apto 45",
"note": "Entregar na portaria."
}'const resposta = await fetch('https://app.nextagsai.com.br/api/contacts/123456789/order/PED-1001', {
method: 'POST',
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
status: 7,
name: 'Ana Souza',
phone: '5511988776655',
city: 'São Paulo',
state: 'SP',
zip_code: '01310-100',
street_1: 'Av. Paulista, 1578',
street_2: 'Apto 45',
note: 'Entregar na portaria.',
}),
});
const dados = await resposta.json();
console.log(resposta.status, dados);import os
import requests
resposta = requests.post(
"https://app.nextagsai.com.br/api/contacts/123456789/order/PED-1001",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
json={
"status": 7,
"name": "Ana Souza",
"phone": "5511988776655",
"city": "São Paulo",
"state": "SP",
"zip_code": "01310-100",
"street_1": "Av. Paulista, 1578",
"street_2": "Apto 45",
"note": "Entregar na portaria.",
},
timeout=30,
)
print(resposta.status_code, resposta.json())<?php
$ch = curl_init('https://app.nextagsai.com.br/api/contacts/123456789/order/PED-1001');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'status' => 7,
'name' => 'Ana Souza',
'phone' => '5511988776655',
'city' => 'São Paulo',
'state' => 'SP',
'zip_code' => '01310-100',
'street_1' => 'Av. Paulista, 1578',
'street_2' => 'Apto 45',
'note' => 'Entregar na portaria.',
]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);Autenticação
Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.
Parâmetros de caminho
contact_idintegerobrigatórioO ID do contato.
order_idstringobrigatórioO ID do pedido (texto). Ele vem em order_id, no carrinho e no pedido.
Corpo da requisição
JSONContent-Type: application/json
statusintegerA situação nova: 6 Aceito, 7 Entregando, 10 Concluído ou 13 Cancelado.
Valores: 6 7 10 13
namestringO nome de quem recebe a entrega.
phonestringO telefone para a entrega.
emailstringO e-mail para a entrega.
countrystringO país da entrega.
statestringO estado.
citystringA cidade.
zip_codestringO CEP.
addressstringO endereço de entrega.
street_1stringA primeira linha do endereço: rua e número.
street_2stringA segunda linha do endereço, como o complemento.
notestringUma observação sobre o pedido.
Respostas
O pedido foi alterado.
successbooleantrue quando deu certo.
O status não é 6, 7, 10 nem 13.
O pedido já está nessa situação.
O pedido não existe para este contato.
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Limites, erros e boas práticas
Guia que usa este endpointCarrinho, pedidos e produtos
Guia que usa este endpointCarrinho e pedidos na conversa
Tutorial da Central de AjudaPedidos, cupons e vendedores
Tutorial da Central de AjudaConsultar produto
GET /products/{product_id}Atualizar produto
POST /products/{product_id}Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.