Editar factura

Ruta /pimia/facturas/[invoiceId]/editar · componentes, campos y acciones del checkout documentado.

Ruta y puntos de edición

Ruta: /pimia/facturas/[invoiceId]/editar. Revisión: 2aec1b16cc01.

Esta ficha procede de lectura estática del código. Los componentes asociados pueden incluir diálogos cerrados y bloques condicionales. Las expresiones dinámicas se conservan como código; no equivalen a campos siempre visibles ni a permisos concedidos.

Vista en el tenant de referencia

Editar factura en Pimia

Captura de escritorio del tenant de demostración Reformas Vera, S.L., tomada el 10 de septiembre de 2026. Los datos ilustran la composición de la pantalla y pueden cambiar.

Capa	Archivo relativo al repositorio
Ruta	`src/app/pimia/facturas/[invoiceId]/editar/page.tsx`
Adaptador Next.js	`src/host/screens/PimiaInvoiceScreens.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaInvoiceEditorScreen.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaScreenShell.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStates.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaPageHeader.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaCustomerCombobox.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaInvoiceLineRow.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaImportTimeEntriesDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaConnectDialog.tsx`

PimiaInvoiceEditorScreen

Fuente: src/features/pimia/ui/PimiaInvoiceEditorScreen.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Cliente	`PimiaCustomerCombobox`	`customerId`	`disabled=isLocked`	555
Sin etiqueta literal resoluble	`Select`	`paymentMethodId === null ? NONE : String(paymentMethodId)`	`disabled=isLocked`	574
Fecha de emisión	`Input`	`invoiceDate`	`type=date; disabled=isLocked`	599
Vencimiento	`Input`	`dueDate`	`type=date; disabled=isLocked`	610
Notas de la factura	`Textarea`	`notes`	`disabled=isLocked`	738

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => void goPimiaPath(INVOICES_PATH)`	`No declarado en este nodo`	493
Rótulo dinámico / icono	`submit del formulario`	`!canSubmit`	500
Añadir línea	`() => setLines((current) => [ ...current, // Con el catálogo ya en pantalla, la línea añadida nace con el // predeterminado puesto (P1-4), no esperando al efecto. { ...emptyLine((current.at(-1)?.id ?? 0) + 1), ...taxDefaults }, ])`	`isLocked`	694
Rótulo dinámico / icono	`() => setIsImportOpen(true)`	`isLocked \|\| customerId === null`	713

Estados reutilizados

PimiaErrorState
PimiaRowsSkeleton

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

gap-2, bg-destructive/5, text-sm, text-destructive, text-muted-foreground, gap-4, md:grid-cols-2, text-foreground, overflow-x-auto, overflow-y-hidden, text-right, text-xs, bg-muted/30, text-base.

PimiaStates

Fuente: src/features/pimia/ui/PimiaStates.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Conectar una empresa	`() => setIsConnectOpen(true)`	`No declarado en este nodo`	99
Rótulo dinámico / icono	`() => void goPimiaPath(notFound.listPath)`	`No declarado en este nodo`	233
Rótulo dinámico / icono	`delegado al contenedor`	`No declarado en este nodo`	247
Rótulo dinámico / icono	`() => void goPimiaPath( closedDoor.action?.kind === "plan" ? PLAN_PATH : MODULES_SETTINGS_PATH, )`	`No declarado en este nodo`	257
Volver a conectar	`() => setIsConnectOpen(true)`	`No declarado en este nodo`	273
Reintentar	`onRetry`	`No declarado en este nodo`	279

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

gap-4, p-8, text-center, text-base, text-foreground, text-sm, text-muted-foreground, gap-2, overflow-hidden, bg-muted/40.

PimiaCustomerCombobox

Fuente: src/features/pimia/ui/PimiaCustomerCombobox.tsx.

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
label	`delegado al contenedor`	`disabled`	87

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-muted-foreground, p-0, text-xs.

PimiaInvoiceLineRow

Fuente: src/features/pimia/ui/PimiaInvoiceLineRow.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
`Concepto de la línea ${position}`	`Input`	`line.name`	`disabled=disabled`	242
`Cantidad de la línea ${position}`	`Input`	`line.quantity`	`disabled=disabled`	285
Sin etiqueta literal resoluble	`Select`	`line.unitName ?? NONE`	`disabled=disabled`	298
`Precio de la línea ${position}`	`Input`	`line.price`	`disabled=disabled`	324
`Descuento de la línea ${position}`	`Input`	`discount.value`	`disabled=disabled`	339
Sin etiqueta literal resoluble	`Select`	`line.vatTaxTypeId === null ? NONE : String(line.vatTaxTypeId)`	`disabled=disabled`	377
Sin etiqueta literal resoluble	`Select`	`line.withholdingTaxTypeId === null ? NONE : String(line.withholdingTaxTypeId)`	`disabled=disabled`	410

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
discount.type === "percentage" ? `Descuento de la línea ${position} en porcentaje. Cambiar a euros` : `Descuento de la línea ${position} en euros. Cambiar a porcentaje`	`() => discount.onTypeChange( discount.type === "percentage" ? "fixed" : "percentage", )`	`disabled`	352
`Quitar la línea ${position}`	`onRemove`	`disabled \|\| !canRemove`	448
linked === null ? `Enlazar la línea ${position} con un artículo` : `Línea ${position} enlazada con ${linked.name}. Cambiar o desenlazar`	`delegado al contenedor`	`disabled`	491

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-2xs, text-muted-foreground, gap-1, text-xs, text-right, text-sm, p-0.

PimiaImportTimeEntriesDialog

Fuente: src/features/pimia/ui/PimiaImportTimeEntriesDialog.tsx.

Campos y controles

La columna «Reglas JSX» recoge propiedades explícitas; la validación adicional vive en los helpers y en el servidor. El enlace de estado indica dónde se lee el valor.

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
`Todos los partes de ${group.itemName ?? "Horas"}`	`Checkbox`	`allOn ? true : groupSelected.length > 0 ? "indeterminate" : false`	`No declaradas en este nodo`	202
`Parte del ${entry.date ?? "día sin fecha"}`	`Checkbox`	`selected.has(entry.id)`	`No declaradas en este nodo`	224

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => onOpenChange(false)`	`No declarado en este nodo`	270
Añadir a la factura	`confirm`	`selectedEntries.length === 0`	277

Estados reutilizados

PimiaErrorState

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
Tu empresa	`Input`	`baseUrl`	`disabled=connect.isPending`	114

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Cancelar	`() => handleOpenChange(false)`	`No declarado en este nodo`	155
Rótulo dinámico / icono	`submit del formulario`	`!canSubmit`	162

Clases de presentación locales

Selección de clases literales; las clases condicionales y los estilos de los primitivos se consultan en el archivo.

text-sm, text-foreground, gap-2, text-muted-foreground, text-xs, text-destructive.

Hooks, adaptadores y utilidades relacionados

src/features/pimia/api/auth.ts
src/features/pimia/api/customers.ts
src/features/pimia/api/invoiceEditor.ts
src/features/pimia/api/invoices.ts
src/features/pimia/api/items.ts
src/features/pimia/api/pendingTimeEntries.ts
src/features/pimia/api/pimiaClient.ts
src/features/pimia/api/taxTypes.ts
src/features/pimia/api/units.ts
src/features/pimia/hooks/usePimiaAuth.ts
src/features/pimia/hooks/usePimiaResources.ts
src/features/pimia/lib/calendar.ts
src/features/pimia/lib/closedDoors.ts
src/features/pimia/lib/deliveryNotes.ts
src/features/pimia/lib/invoiceDraft.ts
src/features/pimia/lib/missingRecord.ts
src/features/pimia/lib/money.ts
src/features/pimia/lib/plegarTexto.ts
src/features/pimia/lib/scopeDenial.ts
src/features/pimia/lib/taxTypes.ts
src/features/pimia/lib/timeEntryImport.ts

Antes de entregar un retoque

Revisa los archivos de formulario y sus helpers antes de cambiar tipos, obligatoriedad o valores iniciales.
Prueba carga, error, vacío, permisos insuficientes y guardado pendiente en las variantes que usa esta pantalla.
Comprueba escritorio, móvil, teclado, tema oscuro y scroll con suficientes filas.
Conserva los handlers y la invalidación de datos al modificar la presentación.

En esta página