Árbol del API · Catálogos › priceStructureOptions

Estructuras de precios

priceStructureOptions

Tipo

Query

Devuelve

[CatalogOption!]!

Permiso de la llave

Selects y autocompletes GraphQL

Estable

Lista las estructuras de precios de la empresa o, con orderId, sólo las que admite una orden de venta.

value es el priceStructureId de los precios de productsConnection. Para una orden nueva usa priceStructureId de orderDefaults: createOrder sólo acepta la estructura principal o la auxiliar del cliente.

Para ver las listas de precios que forman cada estructura usa priceStructuresConnection.

priceStructureOptions(
  orderId: ID
): [CatalogOption!]!

# estructuras.graphql
query Estructuras {
  priceStructureOptions {
    value
    label
  }
}

jq -n --rawfile q estructuras.graphql \
  '{query: $q}' |
curl https://mi-empresa.advantacloud.com/graphql \
  -H "Authorization: Bearer $ADVANTA_API_KEY" \
  -H "Content-Type: application/json" \
  --data @-

import { readFile } from "node:fs/promises";

const query = await readFile("estructuras.graphql", "utf8");

const res = await fetch("https://mi-empresa.advantacloud.com/graphql", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ADVANTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);

const { data, errors } = await res.json();
if (errors) throw new Error(errors[0].extensions?.code ?? errors[0].message);
console.log(data.priceStructureOptions);

import os, requests

URL = "https://mi-empresa.advantacloud.com/graphql"
HEADERS = {"Authorization": f"Bearer {os.environ['ADVANTA_API_KEY']}"}
QUERY = open("estructuras.graphql").read()

r = requests.post(URL, headers=HEADERS, timeout=30, json={
    "query": QUERY,
})
r.raise_for_status()
body = r.json()
if "errors" in body:
    raise RuntimeError(body["errors"][0]["message"])
print(body["data"]["priceStructureOptions"])

<?php
$ch = curl_init('https://mi-empresa.advantacloud.com/graphql');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ADVANTA_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'query' => file_get_contents('estructuras.graphql'),
    ]),
]);
$respuesta = curl_exec($ch);
$estatus = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($respuesta === false || $estatus !== 200) {
    throw new RuntimeException("HTTP $estatus " . curl_error($ch));
}
$body = json_decode($respuesta, true);
if (!empty($body['errors'])) {
    throw new RuntimeException($body['errors'][0]['message']);
}
$resultado = $body['data']['priceStructureOptions'];

Respuesta 200 OK · 2 estructuras

{
  "data": {
    "priceStructureOptions": [
      {
        "value": "4",
        "label": "MAY | Mayoreo"
      },
      {
        "value": "5",
        "label": "MEN | Menudeo"
      }
    ]
  }
}

Ver en el explorador

Argumentos

Argumento	Tipo	Descripción
`orderId`ID	ID	Sólo las estructuras de precios que admite esta orden de venta, según su tipo de venta, su cliente y su almacén, ordenadas por clave. Sin `orderId` llegan todas, sin un orden garantizado. Si la orden no existe, la respuesta es HTTP 422.

Lo que devuelve

[CatalogOption!]!

Campos principales de CatalogOption:

Campo	Tipo	Descripción
`value`ID!	ID!	Identificador de la opción; es el que envías en el argumento o campo que pide ese catálogo.
`label`String!	String!	Texto para mostrar. Casi siempre es la clave y el nombre separados por una barra vertical, p. ej. `MAY \| Mayoreo`.

Ver todos los campos de CatalogOption

Permisos

Llave API Integraciones

Selects y autocompletes GraphQL

La llave ve los registros de toda la empresa del subdominio.

Sin el permiso Sin error

La consulta responde sin error, pero la lista llega vacía.

Así lo conserva el API para las integraciones que ya lo usan: revisa los permisos de la llave si una lista llega vacía sin razón.

Errores

Código	Cuándo ocurre	Qué hacer
HTTP 401	Falta el header `Authorization` o la llave no existe en la empresa del subdominio. La respuesta no trae cuerpo.	Revisa la llave y el subdominio. No reintentes.
HTTP 422	Falla interna o dato rechazado al guardar. El cuerpo es `{"error": …}`, sin `data`.	Si no cambiaste nada, reintenta con espera exponencial.

Los errores de la consulta llegan con HTTP 200 en errors, con su código en extensions.code. Revisa siempre errors, no sólo el estatus HTTP. Errores y reintentos.

Relacionadas

Schema del 26 oct 2026 · Ver cambios¿Algo no cuadra? Repórtalo en ayuda.advanta.mx