API de Integracion

Conecta Persiq con tu ERP, RP o sistema existente

Disponible en Plan Empresarial

Descripcion General

La API de Persiq permite integrar tu sistema de gestion (RP, ERP, o cualquier software) directamente con la plataforma. Puedes consultar cotizaciones, crear pedidos, sincronizar productos y recibir notificaciones en tiempo real cuando ocurren eventos.

Base URL: https://tu-empresa.persiq.com/api/v1

Autenticacion: Bearer Token (API Key)

Formato: JSON (application/json)

Autenticacion

Todas las llamadas requieren un API Key en el header Authorization:

curl -X GET https://tu-empresa.persiq.com/api/v1/products \
  -H "Authorization: Bearer tu_api_key_aqui" \
  -H "Content-Type: application/json"

Genera tu API Key en: Configuracion → Integraciones → API Keys

Endpoints Disponibles

GETProductos y Catalogo

GET /products

Lista todos los tipos de producto (Enrollable, Duo Line, etc.)

GET /articles?product_type_id=1

Lista articulos de un tipo de producto con precios y dimensiones

GET /articles/search?q=black+out

Busca articulos por nombre, modelo o SKU

GET/POSTCotizaciones

GET /quotations

Lista cotizaciones con filtros (cliente, agente, estatus, fecha)

GET /quotations/:id

Detalle completo de una cotizacion con partidas y totales

POST /quotations

Crear nueva cotizacion desde tu RP

{
  "client_id": 3,
  "reference": "Proyecto desde RP",
  "payment_method_id": 3,
  "is_prepaid": false
}

POST /quotations/:id/items

Agregar partida con calculo automatico de precio y descuentos

{
  "product_type_id": 1,
  "article_id": 1,
  "width": 1.80,
  "height": 2.10,
  "quantity": 2,
  "operation": "Manual"
}

POST /quotations/:id/convert-to-order

Convertir cotizacion aceptada en pedido

GETPedidos

GET /orders

Lista pedidos con filtro por estatus

GET /orders/:id

Detalle del pedido con items y tracking

PATCH /orders/:id/status

Actualizar estatus del pedido (confirmed, shipped, delivered)

GETClientes

GET /users

Lista de usuarios/clientes del tenant

POST /users

Crear cliente desde tu RP

GETReportes y Exportacion

GET /dashboard/kpis?period=month

KPIs: cotizaciones, pedidos, conversion, top productos

GET /export/quotations?from=2026-01-01&to=2026-12-31

Exportar cotizaciones en CSV

GET /export/orders?from=2026-01-01&to=2026-12-31

Exportar pedidos en CSV

Webhooks (Notificaciones en Tiempo Real)

Configura una URL en tu RP para recibir notificaciones automaticas cuando ocurren eventos:

POSTquotation.created — Se creo una cotizacion

POSTquotation.converted — Cotizacion convertida a pedido

POSTorder.status_changed — Cambio de estatus de pedido

POSTpayment.completed — Pago confirmado

// Ejemplo de payload de webhook

{
  "event": "quotation.converted",
  "timestamp": "2026-04-28T20:30:00Z",
  "data": {
    "quotation_id": 2847,
    "order_id": 1523,
    "order_number": "PED-001523",
    "client_name": "Arq. Garcia",
    "grand_total": 24850.00
  }
}

Sincronizacion con ERP

Ademas de la API directa, Persiq puede conectarse activamente a tu sistema:

Tu RP → Persiq

• Importar catalogo de productos
• Sincronizar precios actualizados
• Crear clientes automaticamente

Persiq → Tu RP

• Enviar pedidos confirmados
• Notificar pagos recibidos
• Exportar reportes de ventas

Soportamos conexion con: Odoo, SAP Business One, Contpaqi, Aspel, y cualquier sistema que exponga una API REST.

Rate Limits

Plan	Requests/minuto	Acceso
Inicio	Sin acceso API	—
Profesional	60 req/min	Solo lectura (GET)
Empresarial	300 req/min	Lectura + Escritura (GET/POST/PATCH)

Codigos de Error

Codigo	Significado
200	Exito
201	Recurso creado
400	Datos invalidos (revisa el body)
401	API Key invalida o expirada
403	Sin permisos (plan no incluye esta accion)
404	Recurso no encontrado
429	Rate limit excedido
500	Error interno del servidor

Soporte

Para integraciones, contacta a nuestro equipo tecnico:

Email: api@persiq.com

Documentacion interactiva: https://tu-empresa.persiq.com/docs (Swagger UI)