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

# Inserir Pedido de Compra

> Cria um novo pedido de compra com seus itens.

**Atenção — comportamento divergente dos demais endpoints de escrita:** esta rota sempre retorna HTTP `200`, mesmo quando a operação falha por regra de negócio. O `success` do envelope externo não indica o resultado da operação. Para saber o resultado real, inspecione o corpo em `data`: `data.notifications` é preenchido em caso de falha e `data.payload` traz o pedido criado em caso de sucesso. O formato de `data.payload` difere do retornado nas rotas de consulta (GET) — não assuma a mesma estrutura.

<Warning title="Esta rota sempre retorna HTTP 200">
  Diferente dos demais endpoints de escrita da API, este **sempre responde `200`**, mesmo quando a operação falha por regra de negócio. Verifique `data.notifications`: vazio indica sucesso (com o pedido em `data.payload`); não vazio indica falha.
</Warning>

<Note>
  O `data.payload` de retorno usa um formato **diferente** do retornado nas rotas de consulta (GET) — não assuma a mesma estrutura.
</Note>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.gestio.com.br/llms.txt).