Saltearse al contenido

PayPal Invoice

PayPal Invoice gestiona las facturas de tu cuenta de PayPal. Puede crear una factura para un cliente, enviársela por correo para que la pague con PayPal, cancelarla, registrar que se ha pagado por otro medio y consultar una factura o la lista de facturas.

Cuándo usarlo

  • Terminas un trabajo para un cliente y quieres enviarle la factura de PayPal desde el mismo flujo.
  • Un cliente te paga por transferencia o en efectivo y quieres dejar la factura de PayPal como pagada.
  • Un pedido se anula y quieres cancelar su factura avisando al cliente.
  • Quieres un resumen semanal de las facturas pendientes de cobro.

Configuración

Necesitas una credencial PayPal API con el Client ID y el Client Secret de tu aplicación de PayPal, y el entorno: Sandbox para pruebas o Live para cobros reales. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial PayPal API de tu cuenta.
Operation (obligatorio)La acción que realiza el componente. Por defecto, Create. Consulta Operaciones.
Get ModeSolo en Get. By ID consulta una factura concreta; All devuelve la lista de facturas. Por defecto, By ID.
Invoice IDEl identificador de la factura en PayPal. Obligatorio en Cancel, Mark As Paid, Send y Get con By ID.
Recipient EmailSolo en Create, y obligatorio en ella. El correo del cliente que recibe la factura.
CurrencySolo en Create. La moneda de la factura, como EUR o USD. Por defecto, USD.
Item NameSolo en Create, y obligatorio en ella. El producto o servicio que se factura.
QuantitySolo en Create. Cuántas unidades se facturan. Vacío, 1.
Unit AmountSolo en Create, y obligatorio en ella. El precio de cada unidad con decimales, por ejemplo 25.00.
Due DateSolo en Create. Fecha límite de pago, en el formato AAAA-MM-DD, por ejemplo 2026-11-30.
NoteEn Create, una nota para el cliente que aparece en la factura. En Cancel, el mensaje que acompaña a la cancelación.
Terms and ConditionsSolo en Create. Las condiciones que aparecen en la factura.
Payment MethodSolo en Mark As Paid. Cómo se ha cobrado: BANK_TRANSFER (transferencia), CASH (efectivo), CHECK (cheque), CREDIT_CARD, DEBIT_CARD, PAYPAL, WIRE_TRANSFER (transferencia internacional) u OTHER. Por defecto, PAYPAL.
Payment DateSolo en Mark As Paid, y obligatorio en ella. La fecha en que se recibió el pago, en el formato AAAA-MM-DD.
LimitSolo en Get con All. Número máximo de facturas que se devuelven, entre 1 y 100. Por defecto, 20.

Cada factura que crea este componente tiene un único concepto: el de Item Name, Quantity y Unit Amount.

Operaciones

  • Cancel: cancela una factura que ya se ha enviado, con la nota de Note si la escribes.
  • Create: crea la factura en borrador. El cliente no la recibe hasta que la envías con Send.
  • Get: con By ID devuelve una factura; con All devuelve la lista de facturas.
  • Mark As Paid: registra un pago recibido fuera de PayPal, con su forma de pago y su fecha.
  • Send: envía la factura al cliente por correo para que la pague.

Resultado

La salida Data devuelve la factura con la que has trabajado, con sus datos actualizados después de la operación. Con Get y All, devuelve un elemento por cada factura. Cada elemento incluye el identificador y el número de la factura, su estado, la moneda, el importe total y el pendiente, el correo del cliente, las fechas de emisión y de vencimiento, la nota y el enlace en el que el cliente ve y paga la factura (payer_view_url).

Puedes conectarla a un correo, a tu hoja de facturación o a una condición que compruebe el estado. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.

Ejemplo

Una diseñadora gráfica factura cada encargo cuando lo entrega.

  1. Al marcar el encargo como entregado en su gestor de tareas, el flujo recibe el correo del cliente y el precio.
  2. Añade PayPal Invoice con Operation en Create. Pon el correo en Recipient Email, “Diseño de logotipo” en Item Name, 350.00 en Unit Amount, Currency en EUR y una Due Date a 15 días.
  3. Añade otro PayPal Invoice con Operation en Send y pasa a Invoice ID el identificador de la factura creada.
  4. El cliente recibe la factura por correo y puede pagarla con PayPal.

Buenas prácticas

  • Prueba tus flujos con una credencial en Sandbox antes de usar una en Live.
  • Recuerda que Create deja la factura en borrador: añade siempre un paso con Send si quieres que llegue al cliente.

Componentes relacionados