# Retornar as categorias de e-commerce por filtro

Retorna categorias específicas para e-commerce (não necessariamente as mesmas categorias internas), permite filtro por descrição. Útil para integrar categorização de produtos entre seu sistema e Conta Azul.

Endpoint: GET /v1/produtos/ecommerce-categorias
Version: v1
Security: BearerAuth

## Query parameters:

  - `busca_textual` (string)
    Busca textual pela descrição da categoria

## Response 200 fields (application/json):

  - `id` (string)
    Example: "b9ec512f-98a5-44b2-b65f-b378a1db3ce5"

  - `items` (array)

  - `items.descricao` (string)
    Example: "Eletrônicos"

  - `items.id` (string)
    Example: "847f77c6-8f70-466e-ae29-1bc91bca696e"

  - `items.subcategorias` (array)

  - `versao` (integer)
    Example: 1

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"