Árbol del API · Productos y precios › priceStructuresConnection

Lista de estructuras de precios

priceStructuresConnection

Tipo

Query

Devuelve

PriceStructureConnection!

Permiso de la llave

Cliente

Página

20 por omisión · máx. 100

Estable

Lista las estructuras de precios de la empresa con las listas de precios que las forman, de la modificada hace más tiempo a la más reciente.

Una estructura de precios agrupa las listas de precios con que AdvantaCloud calcula el precio de un artículo para un cliente. Para los precios de cada lista usa priceListEntriesConnection con el id de la lista. Para el precio ya calculado de un artículo, usa price en productsConnection.

Llegan todas las listas de cada estructura, también las que ya vencieron o todavía no empiezan: revisa validFrom y validUntil.

priceStructuresConnection(
  first: Int  after: String
): PriceStructureConnection!

# estructuras-de-precios.graphql
query EstructurasDePrecios($cursor: String) {
  priceStructuresConnection(first: 100, after: $cursor) {
    nodes {
      id
      code
      name
      currency
      lists(first: 100) {
        nodes { id code name validFrom validUntil }
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Variables: {"cursor": null}

jq -n --rawfile q estructuras-de-precios.graphql \
  '{query: $q, variables: {"cursor":null}}' |
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-de-precios.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,
    variables: { cursor: null },
  }),
});
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.priceStructuresConnection);

import os, requests

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

cursor, nodos = None, []
while True:
    r = requests.post(URL, headers=HEADERS, timeout=30, json={
        "query": QUERY,
        "variables": {"cursor": cursor},
    })
    r.raise_for_status()
    body = r.json()
    if "errors" in body:
        raise RuntimeError(body["errors"][0]["message"])
    page = body["data"]["priceStructuresConnection"]
    nodos += page["nodes"]
    if not page["pageInfo"]["hasNextPage"]:
        break
    cursor = page["pageInfo"]["endCursor"]

<?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-de-precios.graphql'),
        'variables' => ['cursor' => null],
    ]),
]);
$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']['priceStructuresConnection'];

Respuesta 200 OK

{
  "data": {
    "priceStructuresConnection": {
      "nodes": [
        {
          "id": "4",
          "code": "MAY",
          "name": "Mayoreo",
          "currency": "MXN",
          "lists": {
            "nodes": [
              {
                "id": "12",
                "code": "LP-MAY",
                "name": "Lista mayoreo 2026",
                "validFrom": "2026-01-01T00:00:00.000000-06:00",
                "validUntil": "2026-12-31T23:59:59.000000-06:00"
              }
            ]
          }
        },
        {
          "id": "5",
          "code": "MEN",
          "name": "Menudeo",
          "currency": "MXN",
          "lists": {
            "nodes": [
              {
                "id": "13",
                "code": "LP-MEN",
                "name": "Lista menudeo 2026",
                "validFrom": "2026-01-01T00:00:00.000000-06:00",
                "validUntil": "2026-12-31T23:59:59.000000-06:00"
              }
            ]
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": "WzEsInh2cGVzIiwidXBkYXRlZF9hdCIsZmFsc2UsIjIwMjYtMDktMzBUMTI6NDA6MTEuOTAyMTE0LTA2OjAwIiw1XQ=="
      }
    }
  }
}

Ver en el explorador

Argumentos

Argumento	Tipo	Descripción
`first`Int	Int	Cuántas estructuras devolver desde el inicio o desde `after`. Sin `first` llegan 20; si pides más de 100 recibes 100.
`after`String	String	Cursor de la página anterior (`pageInfo.endCursor`). Devuelve las estructuras que siguen.

Lo que devuelve

PriceStructureConnection!

nodes[PriceStructure]Las estructuras de esta página. La forma más corta de leerlas.

edges[PriceStructureEdge]Las mismas estructuras, cada una con su cursor.

pageInfoPageInfo!Dónde estás en la lista.

hasNextPageBoolean!Hay más elementos después de esta página.

endCursorStringCursor del último elemento; pásalo en after para pedir la página siguiente.

hasPreviousPageBoolean!true si pediste esta página con after, es decir, si no es la primera.

startCursorStringCursor del primer elemento de esta página.

Campos principales de PriceStructure

Campo	Tipo	Descripción
`id`ID!	ID!	Identificador de la estructura; es el que se envía en `priceStructureId`.
`code`String	String	Clave de la estructura, p. ej. `MAY`.
`name`String	String	Nombre de la estructura.
`currency`String	String	Clave SAT de la moneda de la estructura, tomada de su primera lista de precios.
`lists`PriceListConnection!	PriceListConnection!	Listas de precios que forman la estructura, de la modificada hace más tiempo a la más reciente, vigentes o no.20 por omisión, hasta 100 por página.

Ver todos los campos de PriceStructure

Paginación

first · after

Pide hasta 100 estructuras de precios por página junto con pageInfo. Repite la misma consulta pasando endCursor en after mientras hasNextPage sea true. El orden es estable: no se saltan estructuras de precios entre páginas. Más sobre paginación.

Si una estructura cambia mientras recorres la lista, pasa al final y te llega otra vez con sus datos nuevos: guarda por id. Las listas de precios de cada estructura (lists) son otra conexión con su propio límite de 100.

Permisos

Llave API Integraciones

Cliente

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

Sin el permiso Error sin código

La respuesta trae data: null y un error en errors con el mensaje «Cannot return null for non-nullable field…», sin extensions.code.

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.
Error sin código	La llave no tiene «Cliente». La respuesta trae `data: null` y un error en `errors` con el mensaje «Cannot return null for non-nullable field…», sin `extensions.code`.	La llave necesita ese permiso; reintentar no ayuda.
`VALIDATION`	El cursor de `after` no tiene el formato de esta lista, o `first` es negativo.	Usa el `endCursor` tal como llegó y con los mismos argumentos; si lo perdiste, reinicia sin `after`.
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