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

# Retorna produtos

> Retorna lista de produtos cadastrados no Agulhão



## OpenAPI

````yaml /api-convertr/openapi.yaml get /produtos
openapi: 3.1.0
info:
  title: Agulhão API - Convertr
  description: API do sistema Agulhão para integração com Convertr.
  contact:
    email: contato@softros.com.br
    url: https://agulhao.com.br
  version: 1.0.1
servers:
  - url: https://api-integracoes.agulhao.com.br
    description: Produção
security: []
tags:
  - name: filiais-cr
  - name: pessoas-cr
  - name: produtos-cr
  - name: pedidos-cr
  - name: tipos-lancamento-cr
externalDocs:
  description: Mais sobre a API
  url: https://docs.agulhao.com.br/api
paths:
  /produtos:
    get:
      tags:
        - produtos-cr
      summary: Retorna produtos
      description: Retorna lista de produtos cadastrados no Agulhão
      operationId: getProdutos
      parameters:
        - name: pagina
          in: query
          description: Número da página para paginação dos resultados
          schema:
            type: integer
            default: 1
            example: 1
        - name: qtdePorPagina
          in: query
          description: Quantidade de produtos por página
          schema:
            type: integer
            default: 100
            example: 10
        - name: ultimaAtualizacao
          in: query
          description: Data da última atualização dos produtos (formato ISO 8601)
          schema:
            type: string
            format: date-time
            example: '2025-01-01T00:00:00Z'
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: number
                      description: Identificador único do produto
                      example: 1
                    nomePersonalizado:
                      type: string
                      description: Nome personalizado do produto
                      example: Produto Personalizado
                    descricao:
                      type: string
                      description: Descrição do produto
                      example: Descrição do produto
                    nomeAbreviado:
                      type: string
                      description: Nome abreviado do produto
                      example: Prod. Abreviado
                    referencia:
                      type: string
                      description: Referência do produto
                      example: REF123
                    nome:
                      type: string
                      description: Nome do produto
                      example: Nome do Produto
                    sexo:
                      type: string
                      description: Sexo do produto (M, F, U)
                      example: M
                    marca:
                      type: string
                      description: Marca do produto
                      example: Marca do Produto
                    altura:
                      type: number
                      format: float
                      description: Altura do produto em centímetros
                      example: 10.5
                    largura:
                      type: number
                      format: float
                      description: Largura do produto em centímetros
                      example: 20
                    comprimento:
                      type: number
                      format: float
                      description: Comprimento do produto em centímetros
                      example: 30
                    peso:
                      type: number
                      format: float
                      description: Peso do produto em kg
                      example: 0.57
                    unidadeMedidaSigla:
                      type: string
                      description: Sigla da unidade de medida do produto
                      example: UN
                    ativo:
                      type: boolean
                      description: Indica se o produto está ativo
                      example: true
                    precoMinimo:
                      type: number
                      format: float
                      description: Preço mínimo do produto
                      example: 10
                    precoMaximo:
                      type: number
                      format: float
                      description: Preço máximo do produto
                      example: 100
                    ultimaAlteracao:
                      type: string
                      format: date-time
                      description: Data da última atualização do produto
                      example: '2025-01-01T00:00:00Z'
                    cores:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: number
                            description: Identificador único da cor
                            example: 1
                          nome:
                            type: string
                            description: Nome da cor
                            example: Azul
                          hexadecimal:
                            type: string
                            description: Código hexadecimal da cor
                            example: '#0000FF'
                          url:
                            type: string
                            description: URL da imagem da cor
                            example: https://example.com/cor-azul.png
                    marcadores:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: number
                            description: Identificador único do marcador
                            example: 1
                          nome:
                            type: string
                            description: Nome do marcador
                            example: Marcador 1
                    imagens:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: number
                            description: Identificador único da imagem
                            example: 1
                          url:
                            type: string
                            description: URL da imagem do produto
                            example: https://example.com/imagem-produto.png
                          ordem:
                            type: number
                            description: Ordem de exibição da imagem
                            example: 1
                          idCor:
                            type: number
                            description: >-
                              Identificador da cor associada à imagem (se
                              aplicável)
                            example: 1
                    grades:
                      type: array
                      items:
                        type: object
                        properties:
                          numero:
                            type: string
                            description: Número da grade do produto
                            example: M
                          id:
                            type: number
                            description: Identificador único da grade do produto
                            example: 1
                          ean:
                            type: string
                            description: EAN (código de barras) da grade do produto
                            example: '1234567890123'
                          idCor:
                            type: number
                            description: >-
                              Identificador da cor associada à grade do produto
                              (se aplicável)
                            example: 1
                          preco:
                            type: number
                            format: float
                            description: Preço da grade do produto
                            example: 50
                          precoPromocional:
                            type: number
                            format: float
                            description: >-
                              Preço promocional da grade do produto (se
                              aplicável)
                            example: 45
                          estoque:
                            type: number
                            format: integer
                            description: Quantidade em estoque da grade do produto
                            example: 100
      security:
        - chaveApi: []
components:
  securitySchemes:
    chaveApi:
      description: Chave da API gerada no agulhão
      type: apiKey
      name: x-api-key
      in: header

````