Qapla'
Acceder
Qapla'

API y webhooks para envíos, etiquetas y tracking

API REST con una clave por canal y sandbox. Los webhooks avisan a tus sistemas en cada cambio de estado, con los mismos estados para todos los transportistas. Y si la integración la escribe tu IA, está la skill qapla-api.

Documentación pública Sandbox para cada canal Webhooks en todos los planes
Animación: una petición a la API de Qapla' lee un envío del Transportista 1 y recibe el estado normalizado; poco después llega un webhook con el paso a En reparto.
REST y JSON
Llamadas HTTPS, respuestas en JSON.
Una clave por canal
Cada tienda o canal tiene su propia clave API.
Sandbox
El mismo endpoint, con el flag de prueba.
9 estados estándar
Iguales para 450+ transportistas.

Qué puedes hacer con las API de Qapla'

Todo el ciclo del envío, desde el pedido hasta la entrega. Para cada grupo de endpoints encuentras el plan en el que está disponible.

ÁreaQué hacesEjemplosPlan

Tracking

Lee el estado de cada envío, con los mismos estados para todos los transportistas y el historial de eventos.

getShipmentgetQaplaStatus Todos los planes

Webhook

Recibe una llamada en cada cambio de estado, sin consultar a los transportistas.

status_change Todos los planes

Cotizaciones y tarifas

Compara las tarifas de tus contratos con los transportistas antes de crear el envío.

quote Desde Plus

Envíos y etiquetas

Creas envíos y etiquetas con el transportista elegido, en PDF o ZPL.

pushShipmentlabel Qapla' One

Importación de pedidos

Importas a Qapla' los pedidos de canales personalizados, software de gestión y ERP.

pushOrder Qapla' One

Puntos de recogida y direcciones

Buscas los puntos de recogida cerca del cliente y verificas las direcciones antes de enviar.

pickupPointsaddress Por consumo

Los nombres de los métodos y los parámetros completos están en la documentación de la API 1.3.

Webhooks: el estado llega a ti, ya traducido

Registras una URL y Qapla' la llama en cada cambio de estado. No consultas a más de 450 transportistas con formatos distintos: recibes siempre uno de los 9 estados estándar, con el detalle cuando hay una incidencia.

  • Pendiente de retirar
  • Enviado
  • En tránsito
  • En reparto
  • Intento de entrega fallido
  • En retraso
  • Problema
  • Punto de retiro
  • Entregado

El software de gestión, ERP, marketplace o helpdesk se actualizan solos. Para el estado dentro de los tickets también está Qapla' Companion, sin código.

Documentación de los webhooks
POST https://tu-tienda.es/qaplaapplication/json
{
"event": "status_change",
"reference": "10493",
"courier": "Transportista 1",
"courierStatus": "Entrega no realizada: destinatario ausente",
"qaplaStatus": "En depósito",
"exception": "destinatario ausente",
"date": "2026-10-16 09:12"
}

De la sandbox a producción, sin reescribir

Pruebas todo con el flag sandbox y luego cambias la clave. Los endpoints y las respuestas siguen siendo los mismos.

Sandbox

Para pruebas
Clave
Clave API del canal
Flag
sandbox activo
Envíos
Ningún envío real
Webhook
Llegan a tu URL de prueba

Producción

Live
Clave
Clave API de producción
Flag
sandbox desactivado
Envíos
Reales, con tus contratos
Monitorización
Llamadas y errores desde el panel
Animación: en la terminal se pide a Claude que integre el tracking de Qapla'; el asistente lee la skill qapla-api, crea el cliente, configura el webhook y supera las pruebas en sandbox.

Tu IA puede escribir la integración

Dos herramientas para dos trabajos distintos.

Skill qapla-api
Una skill pública que explica a tu asistente endpoints, autenticación, ejemplos y errores. Le das la tarea y él escribe el cliente y las pruebas.
MCP server
El estándar abierto para conectar Claude, ChatGPT o tus agentes a los datos de tu cuenta de Qapla', con sus credenciales. Desde el plan Plus.
Descubre IA y agentes

Preguntas frecuentes

¿Las API de Qapla' están incluidas en los planes?

Tracking y webhooks están incluidos en todos los planes. La comparación de tarifas por API es desde el plan Plus; la creación de envíos y etiquetas y la importación de pedidos por API están en Qapla' One. La búsqueda de puntos de recogida y la verificación de direcciones son por consumo.

Sí. Cada canal tiene su clave API y con el flag sandbox pruebas las llamadas sin crear envíos reales. En producción cambian solo la clave y el flag: los endpoints siguen siendo los mismos.

Registras una URL y Qapla' la llama en cada cambio de estado del envío, con el estado ya normalizado para todos los transportistas. Tu software de gestión, ERP o helpdesk se actualiza sin consultar a los transportistas.

Sí. La skill pública qapla-api explica a tu asistente de IA endpoints, autenticación, ejemplos y errores. Con el servidor MCP, Claude, ChatGPT o tus agentes leen los datos de tu cuenta con sus credenciales.

No. Con las 16 plataformas eCommerce nativas conectas la tienda sin escribir código. Las API sirven para canales personalizados, software de gestión, ERP o flujos que quieras automatizar.

Integra Qapla' esta tarde

Documentación pública, sandbox para cada canal, skill para tu IA.

¿Varias marcas, ERP o volúmenes altos? Habla con el equipo de Qapla' One