> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# integração de estoque

> a integração de estoque permite atualizar as quantidades disponíveis de SKUs na plataforma teceo, tanto para pronta entrega quanto para estoque futuro (pré-venda)

<Note>
  o processamento das atualizações de estoque é **assíncrono**. as requisições são adicionadas a uma fila e processadas conforme disponibilidade. o tempo de processamento pode variar de acordo com o volume do payload.
</Note>

## estoque de pronta entrega

atualiza o estoque disponível imediatamente para venda.

### endpoint

```
PATCH /v1/stock/sync/{skuCode}
```

<ParamField path="skuCode" type="string" required>
  código do SKU.
</ParamField>

### payload

```json theme={null}
{
  "totalAmount": 0,
  "availabilityStartDate": "2025-01-28T15:22:57.748Z",
  "availabilityEndDate": "2025-01-28T15:22:57.748Z",
  "availability": true
}
```

<ResponseField name="totalAmount" type="integer" required>
  quantidade total disponível em estoque.
</ResponseField>

<ResponseField name="availabilityStartDate" type="string">
  data de início da disponibilidade (ISO 8601).
</ResponseField>

<ResponseField name="availabilityEndDate" type="string">
  data de fim da disponibilidade (ISO 8601).
</ResponseField>

<ResponseField name="availability" type="boolean">
  indica se o SKU está disponível para venda.
</ResponseField>

### resposta de sucesso

```json theme={null}
{
  "message": "Stock update sent to queue"
}
```

para mais informações, consulte o [swagger](https://integration.teceo.co/swagger#/Stock%3A/StockController_updateSkuStock).

***

## estoque futuro (pré-venda)

atualiza o estoque futuro de um SKU, usado para pedidos de pré-venda vinculados a janelas de entrega.

### endpoint

```
PATCH /v1/future-stock/sync/{skuCode}
```

<ParamField path="skuCode" type="string" required>
  código do SKU.
</ParamField>

### payload

```json theme={null}
{
  "deliveryWindowCode": "Abr25",
  "totalAmount": 10,
  "availableForSale": true,
  "availabilityStartDate": "2025-01-28T15:35:48.813Z",
  "availabilityEndDate": "2025-01-28T15:35:48.813Z"
}
```

<ResponseField name="deliveryWindowCode" type="string" required>
  código da janela de entrega (ex: `Abr25` para abril de 2025).
</ResponseField>

<ResponseField name="totalAmount" type="integer" required>
  quantidade total disponível para esta janela.
</ResponseField>

<ResponseField name="availableForSale" type="boolean">
  indica se o SKU está disponível para venda nesta janela.
</ResponseField>

<ResponseField name="availabilityStartDate" type="string">
  data de início da disponibilidade (ISO 8601).
</ResponseField>

<ResponseField name="availabilityEndDate" type="string">
  data de fim da disponibilidade (ISO 8601).
</ResponseField>

### resposta de sucesso

```json theme={null}
{
  "message": "stock created with success"
}
```

para mais informações, consulte o [swagger](https://integration.teceo.co/swagger#/Future%20Stock/FutureStockController_updateSkuStock).

***

## comparativo

| característica        | pronta entrega             | estoque futuro                    |
| --------------------- | -------------------------- | --------------------------------- |
| **uso**               | vendas imediatas           | pré-vendas                        |
| **janela de entrega** | não possui                 | obrigatório                       |
| **endpoint**          | `/v1/stock/sync/{skuCode}` | `/v1/future-stock/sync/{skuCode}` |