Datos del negocio: nombre, CIF, dirección, series de facturación, logo.

Series de facturación configuradas.

Lista facturas. issued=True emitidas, False borradores. sort ej: 'date:desc'. Fechas yyyy-MM-dd. Para borradores (issued=False) sin fechas especificadas se aplica automáticamente el año en curso. summary=True devuelve solo id, number, date, customer, total, status, paid (menos tokens).

Detalle completo de una factura por su ID interno.

⚠️ Crea una factura. Confirmar con usuario antes de ejecutar.

invoice_lines: [{quantity, concept, amount, discount, tax, retention, sell_type, tax_regime, tax_subjection_code}] charges: [{amount, payment_method, destination_account(id), paid, date?}] sell_type: "service"|"product"|"supplied_cost" tax: 0,4,10,12,21 (IVA) o 0,3,7,9.5,13.5,20 (IGIC) tax_regime: "01"|"02"|"08"|"11"|"17"|"18"|"20" tax_subjection_code: "S1"–"S2"|"N1"–"N2"|"E1"–"E6" payment_method: "cash"|"receipt"|"wire_transfer"|"card"|"promissory_note"|"other"

⚠️ Actualiza factura. Confirmar con usuario. Líneas/cobros con id=actualiza, sin id=crea, omitidos=se eliminan. Ver create_invoice para estructura de invoice_lines y charges.

⚠️ Elimina una factura (irreversible). Confirmar con usuario.

Link público de la factura para compartir con el cliente (incluye botón de pago Stripe).

Descarga el PDF de la factura. Devuelve el contenido en Base64.

⚠️ Actualiza cobros de una factura (ej: marcarla como cobrada). Confirmar con usuario. charges: [{id?, paid, amount, date, payment_method, destination_account}] Con id=actualiza, sin id=crea, omitidos=eliminados.

⚠️ Marca todos los cobros de una factura como cobrados. Más rápido que update_invoice_charges. Obtiene la factura automáticamente, marca todos los cobros como paid=True y actualiza. payment_date en formato yyyy-MM-dd. Confirmar con usuario.

⚠️ Envía la factura por email. Confirmar con usuario antes de ejecutar.

⚠️ Anula factura Verifactu (irreversible). Solo facturas Verifactu. Confirmar con usuario.

Lista gastos. draft=True borradores, False confirmados. sort ej: 'date:desc'. summary=True devuelve solo id, date, provider, total, draft, document_number (menos tokens).

Detalle completo de un gasto.

⚠️ Crea un gasto. Confirmar con usuario.

document_type: "invoice"|"ticket" expense_lines: [{description, base, tax, retention, imputation, expense_type(código contable ej:"621"), investment?, investment_data?}] payments: [{amount, payment_method, paid, origin_account(id), date?, destination_account?}] vat_eu: True si el CIF del proveedor empieza por "EU".

⚠️ Actualiza gasto. Confirmar con usuario. Líneas/pagos: con id=actualiza, sin id=crea, omitidos=eliminados.

⚠️ Elimina un gasto (irreversible). Confirmar con usuario.

⚠️ Actualiza pagos de un gasto (ej: marcarlo como pagado). payments: [{id?, amount, payment_method, paid, origin_account, date?}]

⚠️ Marca todos los pagos de un gasto como pagados. Más rápido que update_expense_payments. Obtiene el gasto automáticamente, marca todos los pagos como paid=True y actualiza. payment_date en formato yyyy-MM-dd. Confirmar con usuario.

Adjunto de un gasto en Base64 ({filename, data, mimetype}).

⚠️ Actualiza el adjunto de un gasto. data en Base64. Confirmar con usuario.

⚠️ Elimina el adjunto de un gasto (irreversible). Confirmar con usuario.

Lista ingresos (no facturas). sort ej: 'date:desc'. summary=True devuelve solo id, date, customer, total, document_number (menos tokens).

Detalle completo de un ingreso.

⚠️ Crea un ingreso. Confirmar con usuario.

income_lines: [{concept, amount, tax, retention, imputation, income_type?, tax_regime, tax_subjection_code}] charges: [{amount, payment_method, destination_account(id), paid, date?}] document_type: "other_invoice"|"cash_statement"|"interest_settlement"|"bank_doc"|"contract"|"resolution"|"other_doc"

⚠️ Actualiza ingreso. Confirmar con usuario. Líneas/cobros: con id=actualiza, sin id=crea, omitidos=eliminados.

⚠️ Elimina un ingreso (irreversible). Confirmar con usuario.

⚠️ Actualiza cobros de un ingreso. charges: [{id?, paid, amount, date, payment_method, destination_account}]

Adjunto de un ingreso en Base64.

⚠️ Actualiza el adjunto de un ingreso. data en Base64. Confirmar con usuario.

⚠️ Elimina el adjunto de un ingreso (irreversible). Confirmar con usuario.

Lista clientes. q busca en razón social, dirección, CIF, teléfono o email. summary=True devuelve solo id, tradename, cif, email (menos tokens).

Detalle de un cliente.

⚠️ Crea un cliente. Confirmar con usuario.

business_type: "individual"|"company"|"others" Para individual: name y surname_1 obligatorios. Para company/others: business_name obligatorio. default_invoice_language: "default"|"es"|"eu"|"ca"|"en" tax_id_type: "nif"|"vat_id"|"passport"|"country_document"|"residence_certificate"|"other"|"not_registered"|"unidentified"

⚠️ Actualiza un cliente. Confirmar con usuario. Ver create_customer para valores válidos.

⚠️ Elimina un cliente (irreversible). Confirmar con usuario.

Lista proveedores. q busca en razón social, dirección, CIF, teléfono o email. summary=True devuelve solo id, tradename, cif, email (menos tokens).

Detalle de un proveedor.

⚠️ Crea un proveedor. Confirmar con usuario. default_expense_type: código contable ej "600","621","629". Ver Swagger para lista completa. Ver create_customer para business_type, tax_id_type y demás valores válidos.

⚠️ Actualiza un proveedor. Confirmar con usuario. Ver create_provider para valores válidos.

⚠️ Elimina un proveedor (irreversible). Confirmar con usuario.

Lista cuentas bancarias, tarjetas y cuentas de socios. type: cash|bank|card|associate.

Detalle de una cuenta bancaria.

Lista documentos del buzón. assigned=False pendientes de asignar a gasto. extension ej: '!pdf,jpg'.

Detalle de un documento.

⚠️ Sube documento al buzón. data en Base64. Confirmar con usuario.

⚠️ Actualiza documento: asignar a gasto y/o cambiar fecha. Confirmar con usuario.

⚠️ Elimina un documento (irreversible). Confirmar con usuario.

Contenido del adjunto de un documento en Base64.

Lista todas las etiquetas disponibles.

Lista traspasos entre cuentas. payment_method: cash|wire_transfer|promissory_note.

Detalle de un traspaso.

⚠️ Crea traspaso entre cuentas. payment_method: cash|wire_transfer|promissory_note. Confirmar con usuario.

⚠️ Actualiza un traspaso. Confirmar con usuario.

⚠️ Elimina un traspaso (irreversible). Confirmar con usuario.

Resumen de facturas emitidas pendientes de cobro. Itera todas las páginas automáticamente. Excluye facturas anuladas (voided) y ya cobradas (paid=True). year: filtra por año (ej: 2026). Sin year devuelve todos los pendientes. Devuelve: {count, total_pending, invoices: [{id, number, date, customer, total, status}]}

Resumen de IVA de un trimestre (quarter: 1-4). Una sola llamada en vez de iterar manualmente. Agrega todas las facturas emitidas y gastos del período, calcula IVA repercutido y soportado. Devuelve: {period, invoices: {count, taxable_base, vat_charged, retention}, expenses: {count, taxable_base, vat_deductible}, result: {net_vat_payable}}

Resumen de saldos de todas las cuentas bancarias, tarjetas y efectivo. Una sola llamada. Devuelve: {total_balance, accounts: [{id, name, type, balance}]}