Facturación
Datos fiscales de la empresa, historial de movimientos y facturas en PDF de los pagos.
- Categoría: Pagos y administración
- Estado: Disponible
- Requisitos: Ser miembro de la empresa para ver; admin para editar los datos fiscales
- Herramientas MCP (Solo leen):
ver_consumo_periodo_empresa
¿Qué permite hacer?
- Cargar los datos fiscales: país, NIF o número de IVA, nombre fiscal, dirección y correo de contacto.
- Ver el historial de movimientos, paginado, con su tipo.
- Descargar el PDF de cada factura emitida.
¿Cuándo conviene usarlo?
Antes de los primeros pagos, para que las facturas salgan con los datos correctos, y cada vez que se necesite un comprobante.
¿Cómo funciona en ArduMaker?
Solo los pagos (movimientos positivos y exitosos) son facturables; los cobros, consumos y comisiones no generan factura. Cada factura se asocia a un pago y guarda una copia de los datos fiscales del momento en que se emitió: cambiar los datos después no altera las facturas ya hechas.
Las facturas las emite ArduMaker sobre los pagos facturables. Sin NIF ni nombre, la factura sale a consumidor final. El historial se pagina de a 50 por defecto, hasta 100.
¿Qué cambia realmente?
Editar los datos fiscales actualiza la empresa. Emitir una factura crea el documento con su PDF, asociado al pago.
Resultado esperado
En el historial, cada pago facturado muestra su factura. El PDF se descarga a través de ArduMaker, que comprueba que quien lo pide sea de la empresa.
Errores y resolución
- 403 al editar datos fiscales: solo un admin de la empresa puede cambiarlos.
- 404 `factura_not_found`: la factura no es de esa empresa.
- 404 sin PDF: la factura existe pero todavía no tiene el PDF generado.
- Pago sin factura: el movimiento es facturable y la factura todavía no se emitió.
Relación con MCP
Un agente puede leer el historial de movimientos de un período con ver_consumo_periodo_empresa. No hay herramientas para datos fiscales ni facturas. Ver /mcp/docs.