Tools de FreshBooks
Las 14 operaciones de FreshBooks que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Obtener usuario actualGETDevuelve el usuario conectado. Cada elemento de business_memberships trae el rol del usuario y un business con nombre y account_id, el account_id que piden todas las demás herramientas. Un negocio sin account_id no tiene contabilidad, y las demás herramientas no funcionan en él.
- Listar clientesGETLista los clientes activos y archivados de un negocio, con id, nombres, organización, email, teléfonos, dirección y moneda. La respuesta trae result.clients, page, pages y total: aumenta page hasta llegar a pages.
- Crear clientePOSTCrea un cliente y lo devuelve en result.client, con el id que las facturas usan como customerid y los gastos como clientid. Los campos van dentro de client.
- Actualizar clientePUTCambia los campos enviados de un cliente; los demás quedan como están. Los campos van dentro de client.
- Listar facturasGETLista las facturas activas y archivadas de un negocio, sin sus líneas: id, invoice_number, customerid, organization, create_date, due_date, amount, outstanding, paid, v3_status y payment_status. La respuesta trae result.invoices, page, pages y total: aumenta page hasta llegar a pages.
- Obtener facturaGETDevuelve una factura en result.invoice, sin sus líneas: número, cliente, fechas, amount, outstanding, paid, discount, notes, terms, v3_status y payment_status.
- Crear facturaPOSTCrea una factura en borrador y la devuelve en result.invoice. Los campos van dentro de invoice, que necesita customerid y create_date; las líneas definen el monto. Un borrador no cuenta en los informes y el cliente no puede abrirlo: Enviar factura lo manda por email o lo marca como enviado.
- Actualizar facturaPUTCambia los campos enviados de una factura, como fechas, número, notes, terms o discount; los demás quedan como están. Los campos van dentro de invoice. Las líneas no se cambian aquí: un PUT con lines las reemplaza todas, y ninguna herramienta lee las líneas actuales.
- Enviar facturaPUTEnvía una factura por email a email_recipients, con action_email true, o solo la marca como enviada, con action_mark_as_sent true, para una factura entregada de otra forma. En ambos casos sale del borrador y empieza a contar en los informes. Envía una de las dos acciones y ningún otro campo de la factura: FreshBooks ignora el resto.
- Crear pagoPOSTRegistra un pago recibido en una factura, como transferencia bancaria o efectivo, y lo devuelve en result.payment. Los campos van dentro de payment, con invoiceid y amount. La factura pasa a parcial o pagada según el monto.
- Listar gastosGETLista los gastos de un negocio, con id, amount, date, vendor, categoryid, clientid, notes y status. La respuesta trae result.expenses, page, pages y total: aumenta page hasta llegar a pages.
- Crear gastoPOSTCrea un gasto y lo devuelve en result.expense. Los campos van dentro de expense, que necesita categoryid; amount y date son los habituales.
- Actualizar gastoPUTCambia los campos enviados de un gasto; los demás quedan como están. Los campos van dentro de expense.
- Listar categorías de gastoGETLista las categorías de gasto de un negocio, como Advertising, con categoryid, el id que pide Crear gasto, y parentid. La respuesta trae result.categories, page, pages y total.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.

Conta Azul