API de AdvantaCloud
/graphql
Un solo endpoint GraphQL para leer y registrar la operación de tu empresa desde tu sistema, con una Llave API y sus permisos. Consulta clientes, artículos, precios, órdenes de venta, facturas y cobros; cotiza y crea órdenes de venta y registra cobros.
- Endpoint
- POST /graphql
- Autenticación
- Llave API · Bearer
- Paginación
- Cursores · hasta 100
- Versionado
- Un schema · cambios aditivos
Tu primera consulta en menos de 5 minutos
-
Apunta al subdominio de tu empresa
El subdominio selecciona la empresa; una llave de otra empresa no da acceso.
POSThttps://mi-empresa.advantacloud.com/graphql -
Envía tu primera consulta
Guarda tu Llave API en
ADVANTA_API_KEYy ejecuta la petición. Debe responder con tus tres órdenes de venta más recientes.
curl https://mi-empresa.advantacloud.com/graphql \
-H "Authorization: Bearer $ADVANTA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "{ ordersConnection(first: 3) { nodes { folio status total } } }"}'const query = "{ ordersConnection(first: 3) { nodes { folio status total } } }";
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 }),
});
console.log(await res.json());import os, requests
query = "{ ordersConnection(first: 3) { nodes { folio status total } } }"
r = requests.post(
"https://mi-empresa.advantacloud.com/graphql",
headers={"Authorization": f"Bearer {os.environ['ADVANTA_API_KEY']}"},
json={"query": query},
timeout=30,
)
print(r.json()){
"data": {
"ordersConnection": {
"nodes": [
{ "folio": "OV00512", "status": "CONFIRMED", "total": "4872.00" },
{ "folio": "OV00511", "status": "REGISTERED", "total": "18560.00" },
{ "folio": "OV00510", "status": "SOLD", "total": "2349.48" }
]
}
}
}
Money), nunca como número flotante.Guías
6 guías
De la llave a la primera consulta, con las reglas que comparten todas las operaciones.
- Primeros pasos
- Autenticación con Llave API
- Paginación con cursores
Referencia
28 consultas · 4 mutaciones
Cada operación con sus argumentos, lo que devuelve, el permiso de la llave y sus errores.
- Ejemplos en cURL, JavaScript, Python y PHP
- Respuestas con datos de ejemplo
- Enums explicados en lenguaje de negocio
Explorador
94 tipos publicados
Navega las operaciones y los tipos que devuelven, de relación en relación.
- Sigue cada campo hasta su tipo
- Sólo lo publicado, sin campos internos
- Descarga
schema.graphqlpara tu cliente
Dominios del API
5
Cambios recientes del schema
Atom| Fecha | Tipo | Cambio |
|---|---|---|
| 22 oct 2026 | Agregado | OrderOrigin agrega el valor CV. |
| 22 oct 2026 | Agregado | OrderStatus agrega los valores QUOTE_APPROVED, QUOTE_CONVERTED, QUOTE_DECLINED, QUOTE_EXPIRED y QUOTE_SENT. |
| 7 oct 2026 | Agregado | OrderLineInput acepta los campos description y unitPrice. |
| 5 oct 2026 | Agregado | InventoryControl agrega los campos quantityDecimals, rounding y roundingType. |
| 1 oct 2026 | Agregado | Order agrega los campos deliveryOn, invoiceRequested, priceLevel, rawShipmentStatus, saleClassifier, shipmentClassifier, shippingCost, tags y totalWeight. |
| 1 oct 2026 | Agregado | OrderLine agrega los campos basePrice, group, inventoryStatusId, lot, packageProductCode, priceStructureCode, priceStructureId, sellerDiscountId, shippingCost, shippingMethodId y weight. |
Estado del servicio
La disponibilidad del API, los incidentes y los mantenimientos programados se publican en la página de estado.
status.advanta.mxAyuda
¿Dudas sobre cómo se usa una pantalla o qué significa un dato? El Centro de Ayuda explica AdvantaCloud control por control.
¿Tu integración falla? Abre un ticket con la consulta, las variables y la respuesta completa, sin la llave.
ayuda.advanta.mx