Overview
Catalog queries provide access to master data and reference information used throughout the Satélite API. These queries support material selection, client lookup, product management, and various operational catalogs.
General Catalog Queries
GetAllCatalogos
Retrieve all active catalogs from the system.
Query
query {
getAllCatalogos {
idCatalogo
nombre
valor
orden
estado
idCatalogoPadre {
idCatalogo
nombre
}
}
}
Unique catalog identifier
Parent catalog if hierarchical
GetCatalogoById
Retrieve a specific catalog entry by ID.
Query
query GetCatalogo($id: Int!) {
getCatalogoById(id: $id) {
idCatalogo
nombre
valor
orden
estado
}
}
The catalog ID to retrieve
GetAllCatalogosTodos
Retrieve all catalog entries including inactive ones.
Query
query {
getAllCatalogosTodos {
idCatalogo
nombre
valor
estado
}
}
GetAllCatalogosTodosByPadre
Retrieve all catalog entries under a specific parent catalog.
Query
query GetCatalogsByParent($id: Int!) {
getAllCatalogosTodosByPadre(id: $id) {
idCatalogo
nombre
valor
idCatalogoPadre {
idCatalogo
nombre
}
}
}
GetAllCatalogosBusqueda
Search catalogs by name or value.
Query
query SearchCatalogs($valor: String!) {
getAllCatalogosBusqueda(valor: $valor) {
idCatalogo
nombre
valor
}
}
Search term to match against catalog names and values
GetAllCatalogosNombre
Retrieve catalogs by name.
Query
query GetCatalogsByName($valor: String!) {
getAllCatalogosNombre(valor: $valor) {
idCatalogo
nombre
valor
}
}
Catalog name to search for
Material Catalog Queries
GetCatalogoMaterialesHomologados
Retrieve homologated materials catalog, optionally filtered by channel, cluster, category, and business unit.
Query
query GetHomologatedMaterials(
$canal: String
$cluster: String
$categoria: String
$negocio: String
$codigoCliente: String
) {
getCatalogoMaterialesHomologados(
canal: $canal
cluster: $cluster
categoria: $categoria
negocio: $negocio
codigoCliente: $codigoCliente
) {
nombreCliente
codigoCliente
codigoCanal
listaPrecios
codigoBarras
codigoMaterial
nombreMaterial
nombreFamilia
cluster
categoria
negocio
tipo
subtipo
marca
categoriaExco
propioPrivadoHomologado
precioActual
pvp
promedioVenta
}
}
Sales channel code (required for filtered results)
Cluster code (required for filtered results)
ObtenerMaterialesHomologadosPlanComercial
Retrieve homologated materials specifically for commercial plan integration.
Query
query GetMaterialsForCommercialPlan(
$canal: String!
$cluster: String!
$categoria: String
$negocio: String
$listaPrecios: String
$codigoCliente: String
) {
obtenerMaterialesHomologadosPlanComercial(
canal: $canal
cluster: $cluster
categoria: $categoria
negocio: $negocio
listaPrecios: $listaPrecios
codigoCliente: $codigoCliente
) {
codigoMaterial
nombreMaterial
listaPrecios
precioActual
pvp
}
}
GetAllListMaterialesHomologados
Retrieve the complete list of all homologated materials.
Query
query {
getAllListMaterialesHomologados {
codigoMaterial
nombreMaterial
categoria
negocio
}
}
GetUniqueNameClients
Retrieve a list of unique client names from the materials catalog.
Query
query {
getUniqueNameClients
}
GetUniqueCatalogosMateriales
Retrieve the hierarchical structure of material catalogs (categories).
Query
query {
getUniqueCatalogosMateriales {
# Category structure
}
}
Client Catalog Queries
GetClientesPorSociedad
Retrieve active clients for a specific company/society.
Query
query GetClients($sociedad: String!) {
getClientesPorSociedad(sociedad: $sociedad) {
id
codigoCliente
nombreCliente
sociedad
}
}
Company/society code to filter clients
Product Catalog Queries
GetProductosPorSociedad
Retrieve active products for a specific company/society.
Query
query GetProducts($sociedad: String!) {
getProductosPorSociedad(sociedad: $sociedad) {
id
codigoMaterial
nombreMaterial
sociedad
}
}
Company/society code to filter products
Catalog Type Queries
GetCatalogoTipos
Retrieve all catalog types with their hierarchical structure.
Query
query {
getCatalogoTipos {
id
nombre
codigo
activo
padreId
padre {
id
nombre
}
catalogos {
id
nombre
codigo
}
}
}
GetCatalogoTipoByCode
Retrieve a specific catalog type by its code.
Query
query GetCatalogTypeByCode($code: String!) {
getCatalogoTipoByCode(code: $code) {
id
nombre
codigo
catalogos {
id
nombre
codigoSap
}
}
}
Reimbursement Catalogs
GetAllTipoReembolsos
Retrieve all reimbursement types.
Query
query {
getAllTipoReembolsos {
idCatalogo
nombre
valor
}
}
GetAllGastoByIdReembolso
Retrieve expense types associated with a specific reimbursement type.
Query
query GetExpensesByReimbursement($id: Int!) {
getAllGastoByIdReembolso(id: $id) {
idCatalogo
nombre
valor
}
}
Rejection and Approval Catalogs
GetAllMotivosRechazo
Retrieve rejection reasons for a specific system.
Query
query GetRejectionReasons($sistema: String!) {
getAllMotivosRechazo(sistema: $sistema) {
idCatalogo
nombre
valor
}
}
System identifier (e.g., “REEMBOLSOS”, “ACTIVOS_FIJOS”)
Fixed Assets Catalogs
GetAllMotivoBajaActivosFijos
Retrieve motives for fixed asset deactivation.
Query
query {
getAllMotivoBajaActivosFijos {
idCatalogo
nombre
valor
}
}
GetAllMotivoTrasladoActivosFijos
Retrieve motives for fixed asset transfers.
Query
query {
getAllMotivoTrasladoActivosFijos {
idCatalogo
nombre
valor
}
}
GetAllTipoSolicitudActivosFijos
Retrieve request types for fixed assets.
Query
query {
getAllTipoSolicitudActivosFijos {
idCatalogo
nombre
valor
}
}
SOLPED Catalogs
GetAllTipoSolicitudSolped
Retrieve SOLPED request types.
Query
query {
getAllTipoSolicitudSolped {
idCatalogo
nombre
valor
}
}
GetAllTipoGastoSolped
Retrieve SOLPED expense types.
Query
query {
getAllTipoGastoSolped {
idCatalogo
nombre
valor
}
}
Document and Financial Catalogs
GetAllTipoDocumentos
Retrieve all document types.
Query
query {
getAllTipoDocumentos {
idCatalogo
nombre
valor
}
}
GetAllGrupoDocumentos
Retrieve all document group classifications.
Query
query {
getAllGrupoDocumentos {
idCatalogo
nombre
valor
}
}
GetAllGrupoGastos
Retrieve all expense group classifications.
Query
query {
getAllGrupoGastos {
idCatalogo
nombre
valor
}
}
GetAllTipoMoneda
Retrieve all currency types.
Query
query {
getAllTipoMoneda {
idCatalogo
nombre
valor
}
}
GetAllMontos
Retrieve monetary amount categories.
Query
query {
getAllMontos {
idCatalogo
nombre
valor
}
}
GetAllPorcentaje
Retrieve percentage categories.
Query
query {
getAllPorcentaje {
idCatalogo
nombre
valor
}
}
Organizational Catalogs
GetAllTipoAprobadores
Retrieve approver types.
Query
query {
getAllTipoAprobadores {
idCatalogo
nombre
valor
}
}
GetAllBeneficiario
Retrieve beneficiary types.
Query
query {
getAllBeneficiario {
idCatalogo
nombre
valor
}
}
GetAllCompanias
Retrieve all companies.
Query
query {
getAllCompanias {
# Company fields
}
}
Calendar Catalogs
GetAllFeriados
Retrieve all holidays/non-working days.
Query
query {
getAllFeriados {
idCatalogo
nombre
valor
}
}
