# Pedidos

## Criar pedido

Cria um novo pedido.

<mark style="color:green;">`POST`</mark> `https://api-v2.linkbolt.com.br/order`

**Autenticação**

Para acessar este endpoint, você deve primeiro obter um Bearer Token fazendo login com seu email e senha.

{% content-ref url="autenticacao" %}
[autenticacao](https://linkbolt.gitbook.io/v2/reference/autenticacao)
{% endcontent-ref %}

| Nome          | Tipo   | Descrição                             |
| ------------- | ------ | ------------------------------------- |
| Authorization | string | Bearer Token (ex.: Bearer seu\_token) |

#### Corpo da requisição

```json
{
  "externalId": "22331",
  "deliveryAt": "2024-06-28T06:00:00",
  "address": {
    "street": "R. Guarujá",
    "number": "31",
    "neighborhood": "Saúde",
    "city": "São Paulo",
    "state": "SP",
    "postalCode": "04052-110",
    "complement": "Casa 02"
  },
  "instructions": "Não bater na porta",
  "customer": {
    "name": "Adriano",
    "phoneNumber": "11998880009"
  }
}
```

| Name                                                   | Type   | Description                                                                   |
| ------------------------------------------------------ | ------ | ----------------------------------------------------------------------------- |
| externalId<mark style="color:red;">\*</mark>           | string | Identificador externo do pedido.                                              |
| deliveryAt<mark style="color:red;">\*</mark>           | string | Data e hora da entrega no formato ISO 8601 em UTC (ex.: 2024-06-28T06:00:00). |
| instructions                                           | string | Instruções de entrega. Ex: "Não bater na porta"                               |
| address<mark style="color:red;">\*</mark>              | object | Informações do endereço de entrega.                                           |
| address.street<mark style="color:red;">\*</mark>       | string | Rua do endereço.                                                              |
| address.number                                         | string | Número do endereço.                                                           |
| address.neighborhood<mark style="color:red;">\*</mark> | string | Bairro do endereço.                                                           |
| address.city<mark style="color:red;">\*</mark>         | string | Cidade do endereço.                                                           |
| address.state<mark style="color:red;">\*</mark>        | string | Estado do endereço.                                                           |
| address.postalCode<mark style="color:red;">\*</mark>   | string | CEP do endereço.                                                              |
| address.complement                                     | string | Complemento do endereço.                                                      |
| customer<mark style="color:red;">\*</mark>             | object | Informações do cliente.                                                       |
| customer.name<mark style="color:red;">\*</mark>        | string | Nome do cliente.                                                              |
| customer.phoneNumber<mark style="color:red;">\*</mark> | string | Número de telefone do cliente.                                                |

{% tabs %}
{% tab title="201 Created" %}

```json
{
  "success": true,
  "data": {
    "id": 1234
  }
}
```

{% endtab %}

{% tab title="400 Bad Request" %}
Dados da requisição inválidos
{% endtab %}

{% tab title="401 Unauthorized" %}

```json
{
  "success": false,
  "message": "Unauthorized - No token provided"
}
```

{% endtab %}
{% endtabs %}

## Desbloquear pedidos

Desbloqueia os pedidos, para serem roteirizados.

<mark style="color:green;">`POST`</mark> `https://api-v2.linkbolt.com.br/order/unlock`

**Autenticação**

Para acessar este endpoint, você deve primeiro obter um Bearer Token fazendo login com seu email e senha.

{% content-ref url="autenticacao" %}
[autenticacao](https://linkbolt.gitbook.io/v2/reference/autenticacao)
{% endcontent-ref %}

<table><thead><tr><th>Nome</th><th width="123">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer Token (ex.: Bearer seu_token)</td></tr></tbody></table>

#### Corpo da requisição

```json
{
 "orders": [1234, 4432, 4535]
}
```

| Nome   | Tipo  | Descrição                                    |
| ------ | ----- | -------------------------------------------- |
| orders | array | Conjunto de pedidos para serem desbloqueados |

**Resposta**

{% tabs %}
{% tab title="200 OK" %}

```json
{
    "success": true,
    "data": {
        "successOrders": [
            {
                "id": 109,
                "externalId": "22330"
            },
            {
                "id": 110,
                "externalId": "22331"
            }
        ],
        "failedOrders": [
            {
                "id": 108,
                "externalId": "22329"
            }
        ],
        "unlockedOrders": [
            {
                "id": 109,
                "externalId": "22330"
            },
            {
                "id": 110,
                "externalId": "22331"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="400 Orders failed" %}

```json
{
  "success": false,
  "message": "All orders have failed"
}
```

{% endtab %}

{% tab title="400 Orders required" %}

```json
{
  "success": false,
  "message": "Orders is required"
}
```

{% endtab %}

{% tab title="401 Unauthorized" %}

```json
{
  "success": false,
  "message": "Unauthorized - No token provided"
}
```

{% endtab %}
{% endtabs %}