Parrotfy · Centro de ayuda

Centro de ayuda › Centro de Ayuda Parrotfy (nuevo)

Conecta Parrotfy con otros sistemas usando la API

Actualizado 2026-08-22

Con la API de Parrotfy puedes leer y crear información de tu empresa —clientes, facturas, cotizaciones, productos, leads y más— desde tu propio sistema o aplicación, sin entrar al panel. Es la vía para automatizar tareas e integrar Parrotfy con tu e-commerce, tu ERP o tus propios scripts.

¿Qué es la API de Parrotfy?

La API (interfaz de programación) es un conjunto de endpoints HTTP que exponen los datos y operaciones de tu cuenta para que otros programas los consuman. La versión actual es la API V2 (REST, respuestas en JSON). Cada llamada se autentica con un Token API y opera solo sobre los datos de tu propia cuenta.

Si lo que buscas es conectar un asistente de IA (Claude, ChatGPT, Cursor) en lenguaje natural, usa el MCP de Parrotfy en su lugar. La API es para integraciones programáticas directas.

Antes de empezar

  • Una cuenta activa de Parrotfy con permisos de administrador.

  • Tu Token API de Parrotfy (lo generas en el Paso 1).

  • El nombre de tu URL de Parrotfy (tu subdominio): es la parte tucuenta en https://tucuenta.parrotfy.com, el mismo con el que ingresas al panel.

Paso 1 · Genera tu Token API

  1. En tu panel de Parrotfy, ve a Mi empresa → Integraciones.

  2. Abre la pestaña API y MCP.

  3. En la sección Token API V2, haz clic en + Nuevo Token.

  4. Asígnale un nombre (por ejemplo, integracion-erp) y créalo.

  5. Copia el token —comienza con ptfy_— y guárdalo en un lugar seguro.

Trátalo como una contraseña. Tu token da acceso a los datos de tu empresa. No lo compartas ni lo publiques. Puedes revocarlo o rotarlo cuando quieras desde la columna Acciones de esa misma tabla. Es el mismo token que se usa para el MCP.

💡 Toda cuenta Parrotfy viene con un "Default API token" creado automáticamente al activarse — si ves uno que no creaste tú, es ese. Puedes usarlo directamente o crear tokens propios por integración.

Paso 2 · Abre la documentación de tu cuenta

La referencia completa de endpoints, con sus parámetros y la opción de probarlos en vivo, vive en tu propia cuenta:

https://tucuenta.parrotfy.com/api-docs/index.html

Reemplaza tucuenta por el nombre de tu URL de Parrotfy. En el selector superior elige API V2 ES Docs. También está disponible la referencia interactiva más reciente en https://tucuenta.parrotfy.com/api-reference.

Paso 3 · Haz tu primera llamada

Todas las llamadas usan tu subdominio como base, el prefijo /api/v2/ y el token en el header Authorization con el esquema Bearer:

curl https://tucuenta.parrotfy.com/api/v2/clients \
  -H "Authorization: Bearer ptfy_TU_TOKEN_AQUI"

Esto devuelve la lista de clientes en JSON. Para crear o actualizar datos usas POST, PUT o DELETE con el cuerpo en JSON (Content-Type: application/json). Por ejemplo, emitir una factura es un POST /api/v2/sale_invoices (crea el borrador) seguido de POST /api/v2/sale_invoices/{id}/emit.

Qué puedes hacer con la API

La API V2 cubre las áreas principales de Parrotfy:

  • Clientes y contactos — listar, crear, actualizar, adjuntar archivos y consultar lugares de despacho o listas de precios.

  • Facturas de venta — crear borradores, emitir documentos, listar, ver reportes y top de productos.

  • Facturas de compra y guías de despacho — crear, listar y consultar.

  • Cotizaciones — crear solicitudes y cotizaciones, actualizarlas y obtener reportes.

  • Productos e inventario — listar productos, consultar stock actual y movimientos de inventario.

  • Pagos y cobranza — listar facturas pendientes y enviar correos de cobranza (individuales o masivos).

  • CRM — leads, columnas, actividades, campos personalizados.

  • Bancos — cuentas, transacciones, conciliación y flujo de caja.

  • Otros — órdenes de trabajo, vendedores, proveedores, bodegas, centros de negocio y métricas del dashboard.

Paginación y búsqueda

Los endpoints de listado devuelven resultados paginados. Controlas la página con parámetros de consulta:

  • page — número de página (por defecto 1).

  • limit — registros por página (por defecto 20, entre 1 y 100).

  • search — texto para filtrar (por ejemplo, por código o nombre).

  • active — filtra por estado activo (por defecto true).

Ejemplo: GET /api/v2/clients?page=2&limit=50&search=acme.

Seguridad y buenas prácticas

  • Tu token equivale a acceso a los datos de tu empresa: trátalo como una contraseña.

  • No lo compartas por chat ni lo subas a repositorios públicos; guárdalo en una variable de entorno.

  • Puedes revocar o rotar un token cuando quieras desde Integraciones → API y MCP → Acciones.

  • Usa un token distinto por integración para poder revocarlos por separado.

¿Problemas?

  • 401 Unauthorized: el token falta, está mal escrito o fue revocado. Verifica el header Authorization: Bearer ptfy_… y genera uno nuevo si hace falta.

  • 403 Forbidden: el token es válido pero la cuenta no tiene permiso para esa operación. Confirma que lo creaste con un usuario administrador.

  • No resuelve el dominio: revisa que tucuenta sea tu subdominio real (el mismo con el que ingresas al panel), no el de ejemplo.

  • No encuentro un endpoint: consulta la documentación de tu cuenta en https://tucuenta.parrotfy.com/api-docs/index.html (selecciona API V2).

Preguntas relacionadas

Artículos relacionados