Skip to main content
POST
/
orders
Criar Pedido
curl --request POST \
  --url https://api.example.com/orders \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-Store-Id: <x-store-id>' \
  --data '
{
  "order_id": "<string>",
  "order_date": "<string>",
  "delivery_date": "<string>",
  "request_review_at": "<string>",
  "products": [
    {
      "products[].product_id": "<string>",
      "products[].sku": "<string>",
      "products[].name": "<string>",
      "products[].price": 123,
      "products[].url": "<string>",
      "products[].pictures": [
        {}
      ],
      "products[].gtin": "<string>",
      "products[].mpn": "<string>"
    }
  ],
  "customers": [
    {
      "customers[].name": "<string>",
      "customers[].email": "<string>",
      "customers[].phone": "<string>",
      "customers[].origin": "<string>"
    }
  ]
}
'
{
  "id": "<string>"
}

Headers

X-API-Key
string
required
Sua API key do tipo orders
X-Store-Id
string
required
ID da sua loja
Content-Type
string
required
Deve ser application/json

Body

order_id
string
required
ID único do pedido no seu sistema
order_date
string
required
Data do pedido no formato ISO 8601 (ex: 2024-01-01T00:00:00.000Z)
delivery_date
string
required
Data de entrega do pedido no formato ISO 8601
request_review_at
string
Data para solicitar review (opcional). Se não fornecido, será calculado automaticamente baseado nas configurações da store, evitando fins de semana.
products
array
required
Array de produtos do pedido (mínimo 1 produto)
customers
array
required
Array de clientes do pedido (mínimo 1 cliente)

Response

id
string
ID único do pedido criado no sistema Martan

Erros Possíveis

StatusCódigoDescrição
400802030Body JSON mal formatado ou validação falhou
422103Pedido já existe (duplicado)
4038121206Limite de uso de pedidos excedido para o plano
request_review_at não foi fornecido, então será calculado automaticamente baseado nas configurações da Loja.