Holded Invoice Component

Holded Invoice Component conecta tu flujo con el módulo de facturación de tu cuenta de Holded. Con un solo componente puedes trabajar con tus contactos, productos y servicios, con los documentos de venta y de compra (facturas, presupuestos, pedidos, albaranes…), con los pagos y con los datos de configuración que los acompañan: cuentas de tesorería, cuentas de gasto, series de numeración, canales de venta, almacenes, impuestos y remesas.

Es útil para que las ventas, los clientes y los cobros que nacen en otros sistemas lleguen a Holded sin teclearlos, o para que un agente de IA consulte facturas y clientes.

Cuándo usarlo

Un cliente se registra en tu tienda online y quieres darlo de alta como contacto en Holded.
Una factura ya está lista en Holded y quieres enviarla por correo al cliente en cuanto se confirma el pedido.
Quieres un informe semanal con las facturas emitidas en un periodo.
Un agente de IA atiende a tus clientes y necesita consultar sus facturas o el stock de un almacén.
Registras los cobros en otra herramienta y quieres anotarlos también en Holded.

Configuración

Necesitas una credencial Holded Task API con la clave de API de tu cuenta de Holded. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Holded Task API con la que se accede a tu cuenta.
Resource	El tipo de dato con el que trabajas. Ver Recursos y operaciones. Por defecto, `Treasury Accounts`.
Operation	Lo que haces con ese dato. La lista cambia según el Resource elegido.

Al elegir el recurso y la operación, el componente muestra solo los campos que esa operación necesita. Todos son obligatorios salvo que se indique lo contrario.

Recursos y operaciones

Contacts (clientes, proveedores y otros contactos)

Operación	Qué hace	Campos
`List`	Trae todos los contactos.
`Create`	Crea un contacto.	Contact Name
`Get`	Trae un contacto.	Contact ID
`Update`	Cambia el nombre de un contacto.	Contact ID, Contact Name
`Delete`	Elimina un contacto.	Contact ID
`Get Attachments List`	Trae la lista de archivos adjuntos de un contacto.	Contact ID
`Get Attachment`	Trae un archivo adjunto de un contacto, codificado en base64 junto con su tipo y su tamaño.	Contact ID, Filename

Contact Groups (grupos de contactos)

Operación	Qué hace	Campos
`List`	Trae todos los grupos.
`Create`	Crea un grupo.	Group Name
`Get`	Trae un grupo.	Group ID
`Update`	Cambia el nombre de un grupo.	Group ID, Group Name
`Delete`	Elimina un grupo.	Group ID

Documents (documentos de venta y de compra)

Operación	Qué hace	Campos
`List`	Trae los documentos de un tipo, con la posibilidad de limitar el periodo.	Document Type, Filter Document Start (opcional), Filter Document End (opcional)
`Create`	Crea un documento para un contacto con la fecha indicada.	Document Type, Document Date, Document Contact
`Get`	Trae un documento.	Document Type, Document ID
`Update`	Cambia la fecha o el contacto de un documento.	Document Type, Document ID, Document Date, Document Contact
`Delete`	Elimina un documento.	Document Type, Document ID
`Send`	Envía el documento por correo desde Holded a las direcciones indicadas.	Document Type, Document ID, Document Emails
`Pay`	Registra un pago del documento en la fecha indicada.	Document Type, Document ID, Payment Date, Payment Amount
`Update Pipeline`	Pasa un pedido de venta o un albarán a otra fase del pipeline.	Document Type, Document ID, Pipeline Stage
`Ship All Items`	Marca como enviados todos los artículos de un pedido de venta.	Document ID
`Shipped Units by Item`	Trae las unidades enviadas de cada artículo de un documento.	Document Type, Document ID
`List Payment Methods`	Trae las formas de pago configuradas en Holded.

En Document Type eliges el tipo de documento: invoice (factura), salesreceipt (ticket de venta), creditnote (factura rectificativa), salesorder (pedido de venta), proform (proforma), waybill (albarán), estimate (presupuesto), purchase (compra), purchaseorder (pedido de compra) o purchaserefund (devolución de compra). Por defecto, invoice. En Document Contact va el identificador del contacto, y en Document Emails una o varias direcciones de correo.

Products (productos)

Operación	Qué hace	Campos
`List`	Trae todos los productos.
`Create`	Crea un producto.	Product Kind, Product Name
`Get`	Trae un producto.	Product ID
`Update`	Cambia el tipo o el nombre de un producto.	Product ID, Product Kind, Product Name
`Delete`	Elimina un producto.	Product ID
`List Images`	Trae la lista de imágenes de un producto.	Product ID
`Get Main Image` / `Get Secondary Image`	Trae la imagen principal de un producto, o la del nombre indicado, codificada en base64 junto con su tipo y su tamaño.	Product ID, Image name (solo la secundaria)
`Update Stock`	Actualiza el stock del producto en un almacén con las unidades indicadas.	Product ID, Warehouse ID, Stock

En Product Kind eliges el tipo de producto de Holded: simple, lots (por lotes), variants (con variantes) o pack. Por defecto, simple.

Services (servicios)

Operación	Qué hace	Campos
`List`	Trae todos los servicios.
`Create`	Crea un servicio con su descripción, impuesto y precio sin impuestos.	Service Name, Description, Tax, Subtotal
`Get`	Trae un servicio.	Service ID
`Update`	Cambia los datos de un servicio.	Service ID, Service Name, Description, Tax, Subtotal
`Delete`	Elimina un servicio.	Service ID

Tax (el impuesto) y Subtotal (el precio sin impuestos) se escriben como números enteros.

Payments (pagos)

Operación	Qué hace	Campos
`List`	Trae los pagos, con la posibilidad de limitar el periodo.	Filter Payment Start (opcional), Filter Payment End (opcional)
`Create`	Registra un pago en una cuenta bancaria y, si quieres, de un contacto.	Bank Id, Contact Id (opcional), Amount
`Get`	Trae un pago.	Payment ID
`Update`	Cambia los datos de un pago.	Payment ID, Bank Id, Contact Id (opcional), Amount
`Delete`	Elimina un pago.	Payment ID

Treasury Accounts (cuentas de tesorería)

Operación	Qué hace	Campos
`List`	Trae todas las cuentas de tesorería.
`Create`	Crea una cuenta de caja o de banco.	Account Name, Account Type (`cash` o `bank`; por defecto, `bank`)
`Get`	Trae una cuenta.	Account ID

Expenses Accounts (cuentas de gasto)

Operación	Qué hace	Campos
`List`	Trae todas las cuentas de gasto.
`Create`	Crea una cuenta de gasto.	Account Number, Expense Account Name
`Get`	Trae una cuenta de gasto.	Expense Account ID
`Update`	Cambia el nombre de una cuenta de gasto.	Expense Account ID, Expense Account Name
`Delete`	Elimina una cuenta de gasto.	Expense Account ID

Sales Channels (canales de venta)

Operación	Qué hace	Campos
`List`	Trae todos los canales de venta.
`Create`	Crea un canal de venta.	Account Number, Channel Name
`Get`	Trae un canal.	Channel ID
`Update`	Cambia el nombre de un canal.	Channel ID, Channel Name
`Delete`	Elimina un canal.	Channel ID

Warehouses (almacenes)

Operación	Qué hace	Campos
`List`	Trae todos los almacenes.
`Create`	Crea un almacén.	Warehouse Name
`List Products Stock`	Trae el stock de los productos de un almacén.	Warehouse ID
`Get`	Trae un almacén.	Warehouse ID
`Update`	Cambia el nombre de un almacén.	Warehouse ID, Warehouse Name
`Delete`	Elimina un almacén.	Warehouse ID

Numbering Series (series de numeración)

Operación	Qué hace	Campos
`Get by Type`	Trae las series de un tipo.	Series Type
`Create`	Crea una serie.	Series Type, Series Name, Series Format
`Update`	Cambia el nombre y el formato de una serie.	Series Type, Series ID, Series Name, Series Format
`Delete`	Elimina una serie.	Series Type, Series ID

En Series Type eliges invoice (ventas) o purchase (compras). Series Format debe incluir al menos un símbolo %, que Holded sustituye por el número.

Taxes (impuestos)

Operación	Qué hace	Campos
`Get Taxes`	Trae los impuestos configurados en Holded.

Remittances (remesas)

Operación	Qué hace	Campos
`List`	Trae todas las remesas.
`Get`	Trae una remesa.	Remittance ID

Resultado

La salida Response devuelve en texto la respuesta de Holded: los datos del elemento con el que has trabajado, la lista de elementos en las operaciones que listan, o una confirmación en las que eliminan o envían.

Puedes conectar el resultado a un agente para que lo interprete, o a un componente que extraiga los datos que necesites. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar facturas o clientes. Ver Tool Mode.

Ejemplo

Una tienda online quiere que cada cliente nuevo exista también en Holded.

El registro del cliente llega al flujo con su nombre.
Añade Holded Invoice Component con el recurso Contacts y la operación Create.
En Contact Name pon el nombre del cliente.
Guarda el identificador del contacto que devuelve Response para usarlo después en sus documentos, en Document Contact.

Buenas prácticas

Los identificadores de contactos, cuentas, productos y documentos se consultan con la operación List de cada recurso. Guárdalos para no buscarlos en cada ejecución.
Antes de usar Send con clientes reales, prueba el envío con una dirección de correo tuya.

Componentes relacionados

Holded CRM Component: embudos, oportunidades y reservas.
Holded Accounting Component: libro diario y plan de cuentas.
Holded Projects Component: proyectos y tareas.