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

# Criar Pedido

> Cria um novo pedido no Martan

## Headers

<ParamField header="X-API-Key" type="string" required>
  Sua API key do tipo `orders`
</ParamField>

<ParamField header="X-Store-Id" type="string" required>
  ID da sua loja
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Deve ser `application/json`
</ParamField>

## Body

<ParamField body="order_id" type="string" required>
  ID único do pedido no seu sistema
</ParamField>

<ParamField body="order_date" type="string" required>
  Data do pedido no formato ISO 8601 (ex: `2024-01-01T00:00:00.000Z`)
</ParamField>

<ParamField body="delivery_date" type="string" required>
  Data de entrega do pedido no formato ISO 8601
</ParamField>

<ParamField body="request_review_at" type="string">
  Data para solicitar review (opcional). Se não fornecido, será calculado automaticamente baseado nas configurações da store, evitando fins de semana.
</ParamField>

<ParamField body="products" type="array" required>
  Array de produtos do pedido (mínimo 1 produto)

  <Expandable title="Estrutura do produto">
    <ParamField body="products[].product_id" type="string" required>
      ID do produto no seu sistema
    </ParamField>

    <ParamField body="products[].sku" type="string" required>
      SKU do produto
    </ParamField>

    <ParamField body="products[].name" type="string" required>
      Nome do produto
    </ParamField>

    <ParamField body="products[].price" type="number" required>
      Preço do produto (0 a 9999999999)
    </ParamField>

    <ParamField body="products[].url" type="string" required>
      URL do produto
    </ParamField>

    <ParamField body="products[].pictures" type="array">
      Array de URLs de imagens do produto
    </ParamField>

    <ParamField body="products[].gtin" type="string">
      Código GTIN do produto
    </ParamField>

    <ParamField body="products[].mpn" type="string">
      Código MPN do produto
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="customers" type="array" required>
  Array de clientes do pedido (mínimo 1 cliente)

  <Expandable title="Estrutura do cliente">
    <ParamField body="customers[].name" type="string" required>
      Nome do cliente
    </ParamField>

    <ParamField body="customers[].email" type="string" required>
      Email do cliente
    </ParamField>

    <ParamField body="customers[].phone" type="string" required>
      Telefone do cliente
    </ParamField>

    <ParamField body="customers[].origin" type="string">
      Origem do cliente (ex: "website", "mobile", etc.)
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="id" type="string">
  ID único do pedido criado no sistema Martan
</ResponseField>

## Erros Possíveis

| Status | Código  | Descrição                                      |
| ------ | ------- | ---------------------------------------------- |
| 400    | 802030  | Body JSON mal formatado ou validação falhou    |
| 422    | 103     | Pedido já existe (duplicado)                   |
| 403    | 8121206 | Limite de uso de pedidos excedido para o plano |

<Note>
  `request_review_at` não foi fornecido, então será calculado automaticamente baseado nas configurações da Loja.
</Note>