Categorías de negocio

Descripción general

La consulta getBusinessCategories devuelve todas las categorías de negocio activas con sus subcategorías. Ambos IDs son requeridos por registerBusiness, y una subcategoría solo es válida junto con la categoría a la que pertenece. Permite que el usuario elija una categoría y una de las subcategorías de esa categoría en tu UI, luego pasa ambos UUID.

No codifiques estos UUID. Solo se devuelven categorías actualmente activas, la lista difiere entre entornos y cambia con el tiempo. Obtén los datos en tiempo de ejecución — una subcategoría de una categoría diferente se rechaza en el registro con BS-0006.

Alcances requeridos

Propiedad	Valor
Endpoint	GraphQL API
Autenticación	OAuth Bearer Token, tipo de cuenta `CONSUMER`
Scopes requeridos	`REGISTER_BUSINESS`

Usa el mismo token de consumidor que usarás para registerBusiness. Un token de cuenta de negocio será rechazado y la autenticación Basic no es aceptada.

Estructura básica de la consulta

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

Esta consulta no recibe argumentos.

Detalles de la respuesta

Campo	Tipo	Descripción
`businessCategoryId`	`UUID`	ID de la categoría — pásalo como `businessCategoryId` en `registerBusiness`
`categoryName`	`String`	Nombre para mostrar de la categoría
`categoryDescription`	`String`	Descripción de la categoría. Puede ser `null`
`businessSubCategories`	`[BusinessSubCategory]`	Subcategorías que pertenecen a esta categoría

BusinessSubCategory

Campo	Tipo	Descripción
`businessSubCategoryId`	`UUID`	ID de la subcategoría — pásalo como `businessSubCategoryId` en `registerBusiness`
`subCategoryName`	`String`	Nombre para mostrar de la subcategoría

Las categorías se devuelven ordenadas por categoryName, ascendente.

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 } } }"
  }'

Respuesta de ejemplo

{
  "data": {
    "getBusinessCategories": [
      {
        "businessCategoryId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "categoryName": "Technology",
        "categoryDescription": "Software and IT services",
        "businessSubCategories": [
          {
            "businessSubCategoryId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "subCategoryName": "SaaS"
          }
        ]
      }
    ]
  }
}

Códigos de error

Esta consulta devuelve todos los fallos en el arreglo errors de nivel superior — no hay un payload success: false.

Código	Nombre	Descripción	Cómo resolver
`AUTH-0002`	InvalidCredentials	Se usó autenticación Basic, o el tipo de cuenta del token no es `CONSUMER`	Usa un Bearer token de cuenta de consumidor
`AUTH-0031`	InvalidScope	Al token le falta el scope `REGISTER_BUSINESS`	Agrega el scope en Application Scopes y vuelve a acuñar el token
`G-0001`	InternalError	Error interno al leer categorías	Reintenta una vez. Si persiste, contacta al soporte con la marca de tiempo

Notas

Las categorías que un usuario selecciona aquí son revisadas por un analista humano durante KYB, así que muestra categoryDescription en tu UI donde les ayude a elegir con precisión.
Enviar un ID sin el otro se rechaza en el registro con ARG-0002. Siempre pasa ambos.

Crea una plataforma

Categorías de negocio

Descripción general

Alcances requeridos

Estructura básica de la consulta

Detalles de la respuesta

BusinessSubCategory

Ejemplo con cURL

Respuesta de ejemplo

Códigos de error

Notas

Páginas relacionadas

Descripción general de KYB

Registrar un negocio

​Descripción general

​Alcances requeridos

​Estructura básica de la consulta

​Detalles de la respuesta

​BusinessSubCategory

​Ejemplo con cURL

​Respuesta de ejemplo

​Códigos de error

​Notas

​Páginas relacionadas

Descripción general de KYB

Registrar un negocio

Descripción general

Alcances requeridos

Estructura básica de la consulta

Detalles de la respuesta

BusinessSubCategory

Ejemplo con cURL

Respuesta de ejemplo

Códigos de error

Notas

Páginas relacionadas