# Alterar pedido

> Muda a situação de um pedido e os dados de entrega.

Endereço: https://docs.nextags.com.br/referencia/ecommerce/alterar-pedido/
Tipo: Endpoint

```http
POST https://app.nextagsai.com.br/api/contacts/{contact_id}/order/{order_id}
X-ACCESS-TOKEN: <sua chave de API>
```

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](https://help.nextags.com.br/tutoriais/ecommerce/pedidos-cupons-e-vendedores/).

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](https://docs.nextags.com.br/comecar/autenticacao/).

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `contact_id` | integer | sim | O ID do contato. |
| `order_id` | string | sim | O ID do pedido (texto). Ele vem em `order_id`, no carrinho e no pedido. |

## Corpo da requisição (JSON)

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `status` | integer | não | A situação nova: `6` Aceito, `7` Entregando, `10` Concluído ou `13` Cancelado. Valores: `6`, `7`, `10`, `13`. |
| `name` | string | não | O nome de quem recebe a entrega. |
| `phone` | string | não | O telefone para a entrega. |
| `email` | string | não | O e-mail para a entrega. |
| `country` | string | não | O país da entrega. |
| `state` | string | não | O estado. |
| `city` | string | não | A cidade. |
| `zip_code` | string | não | O CEP. |
| `address` | string | não | O endereço de entrega. |
| `street_1` | string | não | A primeira linha do endereço: rua e número. |
| `street_2` | string | não | A segunda linha do endereço, como o complemento. |
| `note` | string | não | Uma observação sobre o pedido. |

```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."
}
```

## Exemplo

```bash
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."
  }'
```

Os exemplos em JavaScript, Python e PHP estão na página e no contrato (`x-codeSamples` em https://docs.nextags.com.br/openapi.json).

## Respostas

### 200 Sucesso

O pedido foi alterado.

| Campo | Tipo | Descrição |
|---|---|---|
| `success` | boolean | `true` quando deu certo. |

```json
{
  "success": true
}
```

### 400 Requisição inválida

O `status` não é 6, 7, 10 nem 13.

### 402 Não concluído

O pedido já está nessa situação.

### 404 Não encontrado

O pedido não existe para este contato.

### 401 Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja [Autenticação](https://docs.nextags.com.br/comecar/autenticacao/).

```json
{
  "error": {
    "code": 401,
    "message": "No valid API key provided."
  }
}
```