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

# Lista os itens de pedido da loja

> Retorna uma lista paginada de 25 itens de pedido com suporte a filtros por status e data.
Status válidos: 'pending', 'accepted', 'in_production', 'shipped', 'delivered', 'cancelled'.
Datas devem estar no formato YYYY-MM-DD.



## OpenAPI

````yaml /openapi.json get /pedidos
openapi: 3.1.0
info:
  title: Akeba
  version: 1.0.0
  description: >-
    API REST da Akeba para integração com ERPs. Permite consultar pedidos,
    atualizar o status de entrega dos itens (aceitar, iniciar produção, enviar
    com código de rastreio, voltar para produção), gerenciar preços e estoque.
    Autentique com o token gerado em /vendedor/integracoes enviando o header
    Authorization: Bearer <token>. Eventos de webhook: "pedido.pago",
    "item.status_alterado", "pedido.cancelado". Assinatura de webhook:
    X-Akeba-Signature: sha256=HMAC-SHA256(corpo, segredo).
servers:
  - url: https://akeba.com.br/api/v1
    description: Produção
security:
  - http: []
paths:
  /pedidos:
    get:
      tags:
        - Pedido
      summary: Lista os itens de pedido da loja
      description: >-
        Retorna uma lista paginada de 25 itens de pedido com suporte a filtros
        por status e data.

        Status válidos: 'pending', 'accepted', 'in_production', 'shipped',
        'delivered', 'cancelled'.

        Datas devem estar no formato YYYY-MM-DD.
      operationId: v1.pedidos.index
      parameters:
        - name: status
          in: query
          schema:
            type:
              - string
              - 'null'
            enum:
              - pending
              - accepted
              - in_production
              - shipped
              - delivered
              - cancelled
        - name: data_inicio
          in: query
          schema:
            type:
              - string
              - 'null'
            format: date
        - name: data_fim
          in: query
          schema:
            type:
              - string
              - 'null'
            format: date
        - name: atualizado_apos
          in: query
          schema:
            type:
              - string
              - 'null'
            format: date-time
      responses:
        '200':
          description: Paginated set of `PedidoItemResource`
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/PedidoItemResource'
                  links:
                    type: object
                    properties:
                      first:
                        type:
                          - string
                          - 'null'
                      last:
                        type:
                          - string
                          - 'null'
                      prev:
                        type:
                          - string
                          - 'null'
                      next:
                        type:
                          - string
                          - 'null'
                    required:
                      - first
                      - last
                      - prev
                      - next
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        minimum: 1
                      from:
                        type:
                          - integer
                          - 'null'
                        minimum: 1
                      last_page:
                        type: integer
                        minimum: 1
                      links:
                        type: array
                        description: Generated paginator links.
                        items:
                          type: object
                          properties:
                            url:
                              type:
                                - string
                                - 'null'
                            label:
                              type: string
                            active:
                              type: boolean
                          required:
                            - url
                            - label
                            - active
                      path:
                        type:
                          - string
                          - 'null'
                        description: Base path for paginator generated URLs.
                      per_page:
                        type: integer
                        description: Number of items shown per page.
                        minimum: 0
                      to:
                        type:
                          - integer
                          - 'null'
                        description: Number of the last item in the slice.
                        minimum: 1
                      total:
                        type: integer
                        description: Total number of items being paginated.
                        minimum: 0
                    required:
                      - current_page
                      - from
                      - last_page
                      - links
                      - path
                      - per_page
                      - to
                      - total
                required:
                  - data
                  - links
                  - meta
        '401':
          $ref: '#/components/responses/AuthenticationException'
        '422':
          $ref: '#/components/responses/ValidationException'
components:
  schemas:
    PedidoItemResource:
      type: object
      properties:
        id:
          type: string
        order_id:
          type: string
        product_id:
          type: string
        product_nome:
          type: string
        preco_unitario:
          type: string
        quantidade:
          type: string
        subtotal:
          type: string
        frete_valor:
          type: string
        item_status:
          type: string
        tracking_code:
          type: string
        cancellation_reason:
          type: string
        variation_options:
          type: string
        personalization_data:
          type: string
        delivery_type:
          type: string
        label_url:
          type: string
        superfrete_status:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        aceito_em:
          type: string
        em_producao_em:
          type: string
        enviado_em:
          type: string
        entregue_em:
          type: string
        cancelado_em:
          type: string
        financeiro:
          type:
            - object
            - 'null'
          properties:
            valor_liquido_vendedor:
              type: string
            comissao_pct:
              type:
                - string
                - 'null'
            valor_comissao:
              type:
                - string
                - 'null'
            status:
              type: string
            data_credito:
              type: string
          required:
            - valor_liquido_vendedor
            - comissao_pct
            - valor_comissao
            - status
            - data_credito
        pedido:
          type: object
          properties:
            id:
              type: string
            numero:
              type: string
            status:
              type: string
            metodo_envio:
              type: string
            created_at:
              type: string
          required:
            - id
            - numero
            - status
            - metodo_envio
            - created_at
      required:
        - id
        - order_id
        - product_id
        - product_nome
        - preco_unitario
        - quantidade
        - subtotal
        - frete_valor
        - item_status
        - tracking_code
        - cancellation_reason
        - variation_options
        - personalization_data
        - delivery_type
        - label_url
        - superfrete_status
        - created_at
        - updated_at
        - aceito_em
        - em_producao_em
        - enviado_em
        - entregue_em
        - cancelado_em
      title: PedidoItemResource
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
    ValidationException:
      description: Validation error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Errors overview.
              errors:
                type: object
                description: A detailed description of each field that failed validation.
                additionalProperties:
                  type: array
                  items:
                    type: string
            required:
              - message
              - errors
  securitySchemes:
    http:
      type: http
      description: Token de API gerado em /vendedor/integracoes.
      scheme: bearer

````