Fuentes de ingresos
Todos tus sitios. Un solo libro de ingresos.
Conecta WooCommerce, Shopify o cualquier sitio propio. Cada venta llega como un registro de Ingreso en el libro contable de Finanzas del CRM, y el comprador se vincula automáticamente con un contacto.
- Push o pull
- Alimenta Finanzas del CRM
- Sin doble contabilidad
Última actualización:
Envíanos tus ventas, o deja que las recojamos nosotros
Push es lo ideal cuando tu sitio puede lanzar una petición HTTP en cada venta. Pull es lo ideal cuando prefieres publicar un feed y dejar que Pinlyx lo consulte de forma programada. Usa uno de los dos, o ambos.
curl -X POST https://api.pinlyx.com/public/v1/revenue/events \ -H "Authorization: Bearer rsk_live_***" \ -H "Content-Type: application/json" \ -d '{ "externalId": "wc_10482", "amount": 129.00, "currency": "USD", "status": "completed", "customer": { "email": "sara@acme.io" } }'- 120 eventos por minutoUn límite generoso, con hasta 500 eventos por petición en lote.
- Claves rsk_, visibles una sola vezLa clave completa se muestra una única vez y después solo se guarda como hash BCrypt.
- Instrucciones para tu IACopia un prompt listo para usar en Cursor o Claude y deja que escriba el código PHP, cURL o Node para tu propio sitio.
Cada venta, registrada con todo detalle
Solo hay tres campos obligatorios. Todo lo demás es opcional, así que envías todo lo que tengas: líneas de producto, impuestos y comisiones, el cliente y cualquier metadato personalizado.
{ "externalId": "wc_10482", // dedupe key "type": "income", // or "expense" "status": "completed", "amount": 129.00, "currency": "USD", "occurredAt": "2026-06-02T14:32:18Z", "tax": 21.50, "fee": 4.07, // net = amount - fee "product": "Pro Plan", "sku": "PRO-001", "quantity": 1, "unitPrice": 129, "discount": 0, "coupon": "SPRING", "customer": { "externalId": "cust_77", "email": "sara@acme.io", "name": "Sara Miller", "country": "US" }, "metadata": { "orderTags": ["vip"] }}externalIdTu propio ID de la venta. Sirve para evitar duplicados y para actualizarla.amountMonto bruto de la venta, en la moneda indicada.occurredAtCuándo se produjo realmente la venta (ISO 8601).
statuscompleted, pending, refunded o failed.typeincome, o expense para registrar el gasto en anuncios por el mismo endpoint.
product / skuNombre del producto y código de referencia (SKU).quantity / unitPriceCuántas unidades y el precio de cada una.discount / couponMonto del descuento y el código de cupón usado.
taxImpuesto cobrado en la venta.feeComisión de procesamiento. El neto se calcula como monto menos comisión.
externalId / emailSirve para vincular un contacto existente del CRM o crear uno nuevo.name / phone / companyCampos de perfil que enriquecen la ficha del contacto.country / cityUbicación, asociada al contacto.
metadataCualquier JSON libre que quieras adjuntar al evento.
Pérdidas y ganancias, por fuente
En cada fuente conectada, Pinlyx resta los costos a los ingresos, tanto los gastos que registras a mano como las comisiones de procesamiento de cada venta, para que veas la ganancia real y no solo la facturación.
- Sin duplicados gracias al ID externoSi envías la misma venta dos veces, se actualiza el registro existente en lugar de crear uno duplicado. Reintentar es totalmente seguro.
- Reembolsos registrados de verdadSi más tarde marcas una venta como reembolsada o fallida, el panel de finanzas se ajusta y resta el reembolso de los ingresos ya contabilizados.
- Aceptadas142
- Duplicadas9
- Actualizadas6
- Rechazadas1
Cada ejecución registra qué se aceptó, qué se omitió por estar duplicado, qué se actualizó y qué se rechazó, para que nada desaparezca sin que lo sepas.
Enriquecimiento de clientes
Cada venta enriquece un contacto
Pinlyx vincula cada comprador con un contacto existente del CRM, o crea uno nuevo, y le añade la compra, la ubicación y los campos de perfil que hayas enviado. La vinculación sigue un orden de prioridad claro:
externalIdemailphoneSeguro por diseño
Los feeds pull están protegidos contra SSRF
Cuando Pinlyx consulta la URL de tu feed, se bloquean las peticiones a redes privadas e internas. Las credenciales guardadas de tu feed siguen cifradas, y una URL maliciosa nunca podrá llegar a donde no debe.
- Rangos de red privada bloqueados
- Secretos del feed guardados cifrados
Libro contable
- WooCommerce+129,00 US$
- Shopify+84,50 US$
- Gasto en anuncios-40,00 US$
Cuando quieras
Reúne todos tus ingresos en un solo libro contable
Conecta tu primera fuente en minutos. Envía una venta o indícanos un feed, y verás aparecer en Pinlyx los ingresos, la ganancia y los contactos enriquecidos.
- Parte de Finanzas, en Pro y Business
- API push o pull programado, tú eliges
- Idempotente, sin duplicados y con reembolsos registrados
- Cancela cuando quieras desde los ajustes de facturación