FreshBooks (versión preliminar)
FreshBooks es un software de contabilidad de pequeñas empresas basado en la nube. Enviar facturas, realizar un seguimiento del tiempo, administrar recibos y gastos.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL |
Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://www.freshbooks.com/ |
| Directiva de privacidad | https://www.freshbooks.com/policies/privacy |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 60 segundos |
Acciones
| Agregar nuevo cliente |
Esta operación crea un nuevo cliente en la cuenta. Al menos un campo del cliente (es decir, nombre, apellidos, organización, correo electrónico, etc.) debe especificarse de lo contrario, se producirá un error en la operación. |
| Creación de nuevos gastos |
Esta operación crea un nuevo gasto en la cuenta. |
| Eliminación de gastos |
Esta operación se usa para eliminar un gasto existente de la cuenta. |
| Enumerar los gastos |
Recupera una lista de todos los gastos. |
| Gastos de actualización |
Esta operación se usa para actualizar un gasto existente en su cuenta. |
Agregar nuevo cliente
Esta operación crea un nuevo cliente en la cuenta. Al menos un campo del cliente (es decir, nombre, apellidos, organización, correo electrónico, etc.) debe especificarse de lo contrario, se producirá un error en la operación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
|
Nombre
|
fname | string | ||
|
Apellido
|
lname | string | ||
|
Organización
|
organization | string | ||
|
Dirección de correo electrónico
|
string | |||
|
Número de teléfono
|
bus_phone | string | ||
|
Moneda
|
currency_code | string |
Código de moneda de 3 letras. |
|
|
Dirección postal 1
|
p_street | string | ||
|
Dirección postal 2
|
p_street2 | string | ||
|
City
|
p_city | string | ||
|
Código postal
|
p_code | string | ||
|
País
|
p_country | string | ||
|
Provincia
|
p_province | string |
Devoluciones
- Body
- Client
Creación de nuevos gastos
Esta operación crea un nuevo gasto en la cuenta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
|
Importe
|
amount | True | string | |
|
Moneda
|
code | string |
Código de moneda de 3 letras. |
|
|
Categoría
|
categoryid | True | integer |
Elija una categoría de gastos. |
|
Personal
|
staffid | True | integer |
Elija el miembro del personal para gastos. |
|
Fecha
|
date | True | string |
AAAA:MM-DD o formato ISO datetime. |
|
Proveedor
|
vendor | string |
Elija un proveedor para gastos. |
|
|
Notas
|
notes | string |
Devoluciones
- Body
- Expense
Eliminación de gastos
Esta operación se usa para eliminar un gasto existente de la cuenta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
|
Id. de gastos
|
expenseid | True | string |
Identificador único del gasto. |
Enumerar los gastos
Recupera una lista de todos los gastos.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
Devoluciones
Matriz de gastos.
- Productos
- ExpenseList
Gastos de actualización
Esta operación se usa para actualizar un gasto existente en su cuenta.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
|
Id. de gastos
|
expenseid | True | string |
Identificador único del gasto. |
|
Importe
|
amount | string | ||
|
Moneda
|
code | string |
Código de moneda de 3 letras. |
|
|
Categoría
|
categoryid | integer |
Elija una categoría de gastos. |
|
|
Personal
|
staffid | integer |
Elija el miembro del personal para gastos. |
|
|
Fecha
|
date | string |
AAAA:MM-DD o formato ISO datetime. |
|
|
Proveedor
|
vendor | string |
Elija un proveedor para gastos. |
|
|
Notas
|
notes | string |
Desencadenadores
| Cuando se crea o actualiza un gasto |
Se desencadena cuando se crea un nuevo gasto o se actualiza uno existente. |
| Cuando se crea o actualiza una factura |
Se desencadena cuando se crea una nueva factura o se actualiza una existente. |
| Cuando se registra o actualiza un pago |
Se desencadena cuando se registra un nuevo pago o se actualiza uno existente. |
Cuando se crea o actualiza un gasto
Se desencadena cuando se crea un nuevo gasto o se actualiza uno existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
Devoluciones
- Body
- Expense
Cuando se crea o actualiza una factura
Se desencadena cuando se crea una nueva factura o se actualiza una existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
Devoluciones
- Body
- Invoice
Cuando se registra o actualiza un pago
Se desencadena cuando se registra un nuevo pago o se actualiza uno existente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Cuenta
|
accountid | True | string |
Identificador de la cuenta de gastos. |
Devoluciones
- Body
- Payment
Definiciones
ExpenseList
Matriz de gastos.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Productos
|
Expense |
Gastos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de gasto
|
id | integer |
Único para este identificador de negocio por gastos. |
|
Porcentaje de marcado
|
markup_percent | string |
Decimal, porcentaje para marcar los gastos hacia arriba. |
|
Identificación del proyecto
|
projectid | integer |
Identificador del proyecto relacionado, si procede. |
|
Identificador de cliente
|
clientid | integer |
Identificador del cliente relacionado, si procede. |
|
Porcentaje de impuestos 1
|
taxPercent1 | string |
Decimal, primer porcentaje fiscal. |
|
Nombre fiscal 1
|
taxName1 | string |
Nombre del primer impuesto. |
|
Cantidad de primera tarea
|
taxAmount1.amount | string |
Importe del primer impuesto. |
|
Primer código de moneda fiscal
|
taxAmount1.code | string |
Código de moneda de 3 letras. |
|
Porcentaje de impuestos 2
|
taxPercent2 | string |
Decimal, segundo porcentaje fiscal. |
|
Nombre fiscal 2
|
taxName2 | string |
Nombre del segundo impuesto. |
|
Segundo importe fiscal
|
taxAmount2.amount | string |
Importe del segundo impuesto. |
|
Segundo código de moneda fiscal
|
taxAmount2.code | string |
Código de moneda de 3 letras. |
|
Identificador de factura
|
invoiceid | integer |
Identificador de factura relacionada, si procede. |
|
Estado
|
status | integer |
Valor de la tabla de estado de gastos. |
|
Nombre del banco
|
bank_name | string |
Si procede, se importó el nombre del gasto bancario. |
|
Proveedor
|
vendor | string |
Nombre del proveedor. |
|
Tiene recibo
|
has_receipt | boolean |
True si se adjunta el recibo. |
|
Id. del sistema externo
|
ext_systemid | integer |
Id. del sistema de contratistas relacionado, si procede. |
|
Fecha
|
date | string |
Fecha del gasto. |
|
Identificador de transacción
|
transactionid | string |
Identificador de transacción relacionada, si procede. |
|
Notas
|
notes | string |
Notas de gastos. |
|
Nombre de cuenta
|
account_name | string |
Nombre de la cuenta relacionada, si procede. |
|
Importe
|
amount.amount | string |
Valor decimal. |
|
Código de moneda
|
amount.code | string |
Código de moneda de 3 letras. |
|
Impuesto compuesto
|
compounded_tax | boolean |
True si el impuesto 2 era un impuesto compuesto. |
|
ID de cuenta
|
accountid | string |
Identificador de la cuenta de gastos, si procede. |
Factura
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de factura
|
id | integer |
Identificador de factura único a este sistema. |
|
Número de factura
|
invoice_number | string |
Identificador de factura visible y especificado por el usuario. |
|
Id. de cuenta
|
accountid | string |
Identificador único del sistema. |
|
Código de moneda de 3 letras
|
currency_code | string |
Código de moneda de tres letras para la factura. |
|
Estado de la factura
|
v3_status | string |
Estado de la factura. |
|
Description
|
description | string |
Descripción de la primera línea de factura. |
|
Notas
|
notes | string |
Notas enumeradas en la factura. |
|
Código de lenguaje de dos letras
|
language | string |
Código de idioma de dos letras de la factura. |
|
Id. de cliente
|
customerid | integer |
Identificador de cliente único a este sistema. |
|
Facturación de la organización
|
organization | string |
Nombre de la organización que se factura. |
|
Nombre del cliente
|
fname | string |
Nombre del cliente en la factura. |
|
Apellidos del cliente
|
lname | string |
Apellidos del cliente en la factura. |
|
Fecha de creación de factura
|
create_date | string |
Fecha de creación de la factura, formato aaaa-MM-DD. |
|
Fecha de vencimiento de la factura
|
due_date | string |
La factura de fecha se marca como due by, YYYY-MM-DD formato. |
|
Última actualización
|
updated | string |
Hora en que se actualizó por última vez la factura, aaaa-MM-DD formato HH:MM:SS. |
|
Fecha de creación
|
created_at | string |
Hora en que se creó la factura, aaaa-MM-DD formato HH:MM:SS. |
|
Fecha de pago de la factura
|
date_paid | string |
Fecha de pago total de la factura, formato aaaa-MM-DD. |
|
Estado de pago
|
payment_status | string |
Descripción del estado de pago. Uno de los "no pagados", "parcial", "pagado" y "de pago automático". |
|
Importe de la factura
|
amount.amount | string |
Cantidad total de factura, a dos posiciones decimales. |
|
Importe pagado
|
paid.amount | string |
Importe pagado en la factura, a dos posiciones decimales. |
|
Importe pendiente
|
outstanding.amount | string |
Importe pendiente en la factura, a dos posiciones decimales. |
|
Importe de descuento
|
discount.amount | string |
Cantidad de descuento, a dos posiciones decimales. |
|
Correo Electrónico
|
client.email | string |
Correo electrónico del cliente. |
Pago
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de pago
|
id | integer |
Identificador de pago único a este sistema. |
|
Tipo de pago
|
type | string |
Tipo de pago - Efectivo, cheque, crédito |
|
Nota:
|
note | string |
Notas enumeradas en el pago. |
|
Fecha de pago
|
date | string |
Fecha en que se realizó el pago, YYYY-MM-DD formato. |
|
Id. de cliente
|
clientid | integer |
Identificador de cliente único a este sistema. |
|
Importe de la factura
|
amount.amount | string |
Importe total del pago, a dos posiciones decimales. |
|
Código de moneda de 3 letras
|
amount.code | string |
Código de moneda de tres letras. |
|
Id. de cuenta
|
accounting_systemid | string |
Identificador único para empresas. |
|
Id. de factura
|
invoiceid | integer |
Identificador de la factura relacionada. |
|
Nombre
|
client.fname | string |
Nombre del cliente. |
|
Apellido
|
client.lname | string |
Apellidos del cliente. |
|
Correo Electrónico
|
client.email | string |
Correo electrónico del cliente. |
|
Nombre de usuario
|
client.username | string |
Nombre de usuario usado por el cliente para iniciar sesión. |
|
Organización
|
client.organization | string |
Nombre de la empresa del cliente. |
Client
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
response.result.client.fname | string |
Nombre del cliente. |
|
Apellido
|
response.result.client.lname | string |
Apellidos del cliente. |
|
Fa Number
|
response.result.client.fax | string |
Número de fax del cliente. |
|
Número de IVA
|
response.result.client.vat_number | string |
Número fiscal añadido de valor. |
|
Nombre del IVA
|
response.result.client.vat_name | string |
Nombre fiscal agregado de valor. |
|
Identificador de cliente
|
response.result.client.id | integer |
Único para este identificador de negocio para el cliente. |
|
Provincia
|
response.result.client.s_province | string |
Dirección de envío. |
|
País
|
response.result.client.s_country | string |
Dirección de envío. |
|
City
|
response.result.client.s_city | string |
Dirección de envío. |
|
Calle
|
response.result.client.s_street | string |
Dirección de envío. |
|
Calle 2
|
response.result.client.s_street2 | string |
Dirección de envío. |
|
Código postal
|
response.result.client.s_code | string |
Dirección de envío. |
|
Nota:
|
response.result.client.note | string |
Notas guardadas por el administrador sobre el cliente. |
|
Teléfono móvil
|
response.result.client.mob_phone | string |
Número de teléfono móvil. |
|
Teléfono fijo
|
response.result.client.home_phone | string |
Número de teléfono principal. |
|
Industria de la empresa
|
response.result.client.company_industry | string |
Descripción del cliente del sector está en. |
|
Correo Electrónico
|
response.result.client.email | string |
Correo electrónico del cliente. |
|
Nombre de usuario
|
response.result.client.username | string |
Nombre de usuario usado por el cliente para iniciar sesión. |
|
Provincia
|
response.result.client.p_province | string |
Dirección de facturación. |
|
País
|
response.result.client.p_country | string |
Dirección de facturación. |
|
City
|
response.result.client.p_city | string |
Dirección de facturación. |
|
Calle
|
response.result.client.p_street | string |
Dirección de facturación. |
|
Código postal
|
response.result.client.p_code | string |
Dirección de facturación. |
|
Calle 2
|
response.result.client.p_street2 | string |
Dirección de facturación. |
|
Teléfono
|
response.result.client.bus_phone | string |
Dirección de facturación. |
|
Tamaño
|
response.result.client.company_size | string |
Dirección de facturación. |
|
Identificador del sistema
|
response.result.client.accounting_systemid | string |
El identificador único del cliente empresarial existe. |
|
Language
|
response.result.client.language | string |
Shortcode que indica el idioma del usuario. |
|
Organización
|
response.result.client.organization | string |
Nombre de la empresa del cliente. |
|
Código de moneda
|
response.result.client.currency_code | string |
Código corto de 3 letras para la moneda preferida. |