> ## 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.

# criar pedido

> cria um novo pedido para uma marca/distribuidora



## OpenAPI

````yaml /integracoes/store/store.json post /orders
openapi: 3.0.3
info:
  title: API sell-out
  description: API para gerenciamento de lojas e pedidos na plataforma teceo
  version: 1.0.0
servers:
  - url: https://api.teceo.co/store/v1
    description: produção
security:
  - bearerAuth: []
paths:
  /orders:
    post:
      tags:
        - pedidos
      summary: criar pedido
      description: cria um novo pedido para uma marca/distribuidora
      operationId: createOrder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderInput'
            example:
              brand_id: brand_abc
              items:
                - product_id: prod_abc123
                  quantity: 10
                - product_id: prod_def456
                  quantity: 5
              notes: entregar no período da manhã
      responses:
        '201':
          description: pedido criado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
        '400':
          description: dados inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    OrderInput:
      type: object
      required:
        - brand_id
        - items
      properties:
        brand_id:
          type: string
          description: id da marca/distribuidora
        items:
          type: array
          items:
            type: object
            required:
              - product_id
              - quantity
            properties:
              product_id:
                type: string
              quantity:
                type: integer
                minimum: 1
        notes:
          type: string
          description: observações do pedido
    Order:
      type: object
      properties:
        id:
          type: string
          description: id único do pedido
        number:
          type: string
          description: número do pedido
        status:
          type: string
          enum:
            - pending
            - confirmed
            - shipped
            - delivered
            - cancelled
          description: status do pedido
        total:
          type: number
          format: float
          description: valor total do pedido
        items_count:
          type: integer
          description: quantidade de itens
        brand:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
        created_at:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        code:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````