Categorías de negocio

Descripción general

Recupera todas las categorías de negocio activas y sus subcategorías desde la API. Usa esta consulta para obtener los valores businessCategoryId y businessSubCategoryId requeridos para la mutación registerBusiness.

Alcances requeridos

Property	Value
Endpoint	GraphQL API
Authentication	OAuth Bearer Token
Required Scopes	`REGISTER_BUSINESS`

Parámetros

Esta consulta no requiere ningún parámetro y no admite paginación

Estructura básica de la consulta

Solicitud de ejemplo:

query GetBusinessCategories {
  getBusinessCategories {
    businessCategoryId
    categoryName
    categoryDescription
    businessSubCategories {
      businessSubCategoryId
      subCategoryName
    }
  }
}

Respuesta de ejemplo:

json

{
  "data": {
    "getBusinessCategories": [
      {
        "businessCategoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "categoryName": "Retail Trade",
        "categoryDescription": "Businesses engaged in selling merchandise to consumers",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "subCategoryName": "E-commerce"
          },
          {
            "businessSubCategoryId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "subCategoryName": "Brick and Mortar Retail"
          }
        ]
      },
      {
        "businessCategoryId": "d4e5f6a7-b8c9-0123-defg-234567890123",
        "categoryName": "Professional Services",
        "categoryDescription": "Businesses providing professional or consulting services",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "e5f6a7b8-c9d0-1234-efgh-345678901234",
            "subCategoryName": "Consulting"
          },
          {
            "businessSubCategoryId": "f6a7b8c9-d0e1-2345-fghi-456789012345",
            "subCategoryName": "Legal Services"
          }
        ]
      }
    ]
  }
}

Detalles de la respuesta

Field	Type	Description
`businessCategoryId`	`UUID`	Identificador único de la categoría de negocio
`categoryName`	`String`	Nombre de la categoría de negocio
`categoryDescription`	`String`	Descripción de la categoría de negocio (puede ser null)
`businessSubCategories`	`[BusinessSubCategory]`	Lista de subcategorías dentro de esta categoría

BusinessSubCategory

Field	Type	Description
`businessSubCategoryId`	`UUID`	Identificador único de la subcategoría de negocio
`subCategoryName`	`String`	Nombre de la subcategoría

Ejemplo con cURL

curl -X POST https://transactional-graph.staging.fluzapp.com/api/v1/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "query": "query GetBusinessCategories { getBusinessCategories { businessCategoryId categoryName categoryDescription businessSubCategories { businessSubCategoryId subCategoryName } } }"
    }'

Notas

Las categorías están ordenadas alfabéticamente por categoryName.
Usa los valores businessCategoryId y businessSubCategoryId de esta consulta al llamar a la mutación registerBusiness.
La subcategoría debe pertenecer a la categoría elegida para ser válida durante el registro del negocio.

​Descripción general

​Alcances requeridos

​Parámetros

​Estructura básica de la consulta

​Detalles de la respuesta

​BusinessSubCategory

​Ejemplo con cURL

​Notas