Documentación de la API Propulxia

1. Autenticación

Todas las solicitudes a la API requieren una clave API transmitida en el encabezado de solicitud HTTP Authorization:

Authorization: Bearer plx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Convenciones

• Los identificadores (id) son cadenas de caracteres opacas.
• Los importes se expresan en la unidad monetaria corriente (por ejemplo, 1500.00 para $1500.00).
• Las fechas (createdAt, etc.) son marcas de tiempo Unix en milisegundos.
• Cualquier error devuelve un cuerpo con el formato {"error": "message"} con el código HTTP correspondiente.

3. Propuestas

curl https://app.propulxia.com/api/v1/proposals?status=sent&limit=10 \
  -H "Authorization: Bearer plx_live_..."

{
  "proposals": [
    {
      "id": "abc123",
      "title": "Refonte site web — Acme inc.",
      "status": "sent",
      "clientId": "cl_789",
      "companyId": "co_456",
      "totalAmount": 4500,
      "currency": "CAD",
      "shareUrl": "https://app.propulxia.com/share/a1b2c3...",
      "createdAt": 1737331200000
    }
  ]
}

curl -X POST https://app.propulxia.com/api/v1/proposals \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Refonte site web",
    "clientId": "cl_789",
    "companyId": "co_456",
    "totalAmount": 4500,
    "currency": "CAD"
  }'

curl -X POST https://app.propulxia.com/api/v1/proposals/abc123/send \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "client@example.com"}'

4. Clientes

Gestione sus clientes comerciales (contactos dentro de sus empresas objetivo) a través de estos puntos de enlace:

5. Tareas

Gestione las tareas de seguimiento y recordatorios asociadas a sus propuestas y prospectos:

curl -X POST https://app.propulxia.com/api/v1/tasks \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Relancer le client Acme",
    "dueDate": 1789958156453,
    "proposalId": "abc123",
    "status": "todo"
  }'

6. Plantillas (Templates)

Recupere en modo de sólo lectura las plantillas estructuradas de propuestas creadas en su cuenta:

7. Catálogo de Productos

Sincronice su biblioteca de productos o tarifas con sus herramientas externas:

8. Colaboradores (Equipo)

Gestione las cuentas de los miembros del equipo de su organización:

9. Informes

{
  "totalProposals": 42,
  "byStatus": { "backlog": 5, "in_progress": 3, "sent": 10, "won": 20, "lost": 4 },
  "totalValue": 187500,
  "wonValue": 92000,
  "winRate": 0.8333
}

10. Webhooks

Suscriba una URL HTTPS para recibir notificaciones en tiempo real.

curl -X POST https://app.propulxia.com/api/v1/webhooks \
  -H "Authorization: Bearer plx_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://votre-service.com/webhooks/propulxia",
    "events": ["proposal.sent", "proposal.paid"]
  }'

11. Integraciones (Zapier)

Conecte Propulxia a más de 6000 aplicaciones mediante Zapier, sin escribir código. La integración oficial se apoya en esta API y sus webhooks.

12. Códigos de error