Árbol del API · Pedidos › orderPrintOptions

Formatos de impresión de órdenes

orderPrintOptions

Tipo

Query

Devuelve

OrderPrintOptions!

Permiso de la llave

Ventas

Estable

Lista los formatos de impresión de órdenes de venta y las leyendas opcionales que puedes pedir en Order.pdfUrl.

Los formatos y las leyendas los configura cada empresa. Elige el formato que vas a usar y pide con su id el PDF de una orden:

GraphQL

query PdfDeOrden($id: ID!, $formato: ID!) {
  order(id: $id) {
    folio
    pdfUrl(formatId: $formato)
  }
}

pdfUrl es una liga firmada que vence a los 10 minutos: descárgala de inmediato y no la guardes. La leyenda (legendId) es opcional.

orderPrintOptions: OrderPrintOptions!

# formatos.graphql
query Formatos {
  orderPrintOptions {
    formats { id label }
    legends { id label }
  }
}

jq -n --rawfile q formatos.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("formatos.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.orderPrintOptions);

import os, requests

URL = "https://mi-empresa.advantacloud.com/graphql"
HEADERS = {"Authorization": f"Bearer {os.environ['ADVANTA_API_KEY']}"}
QUERY = open("formatos.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"]["orderPrintOptions"])

<?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('formatos.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']['orderPrintOptions'];

Respuesta 200 OK

{
  "data": {
    "orderPrintOptions": {
      "formats": [
        {
          "id": "3",
          "label": "Orden de venta"
        },
        {
          "id": "7",
          "label": "Orden de venta con imágenes"
        }
      ],
      "legends": [
        {
          "id": "1",
          "label": "PRECIOS SUJETOS A CAMBIO"
        }
      ]
    }
  }
}

Ver en el explorador

Lo que devuelve

OrderPrintOptions!

Permisos

Llave API Integraciones

Ventas

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

Sin el permiso HTTP 422

La respuesta es HTTP 422 con el cuerpo {"error": "invalid_graphql_request"}, sin data.

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	La llave no tiene «Ventas». La respuesta es HTTP 422 con el cuerpo `{"error": "invalid_graphql_request"}`, sin `data`.	La llave necesita ese permiso; reintentar no ayuda.
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