Pimia
DocumentaciónFrontendIntegracionesAPI ReferenceKnowledge BaseChangelog
PantallasClientes y CRM

Cliente

Ruta /pimia/clientes/[customerId] · componentes, campos y acciones del checkout documentado.

Ruta y puntos de edición

Ruta: /pimia/clientes/[customerId]. 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

Cliente 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.

CapaArchivo relativo al repositorio
Rutasrc/app/pimia/clientes/[customerId]/page.tsx
Adaptador Next.jssrc/host/screens/PimiaClientScreens.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaCustomerScreen.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaStates.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaScreenShell.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaPageHeader.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaCustomerIdentity.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaAmountCell.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaCustomerVolume.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaInvoiceList.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaEstimateList.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaCustomerDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaConnectDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaSortableHead.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaStatusBadge.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaInvoiceActions.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaEstimateDocument.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaEstimateActions.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaAddressFields.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaCompanyDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaInvoiceSendDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaInvoicePaymentDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaDocumentParts.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaEstimateRejectDialog.tsx
Vista o componente asociadosrc/features/pimia/ui/PimiaEstimateSendDialog.tsx

PimiaCustomerScreen

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

Columnas declaradas

  • Concepto
  • Cantidad
  • Facturado
  • Nombre
  • Rol
  • Email
  • Teléfono

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
ReintentaronRetryNo declarado en este nodo295
Editar() => setIsEditOpen(true)No declarado en este nodo531
Nuevo presupuesto() => void goPimiaPath( `/pimia/presupuestos/nuevo?cliente=${encodeURIComponent(customer.id)}`, )No declarado en este nodo539
Clientes() => void goPimiaPath("/pimia/clientes")No declarado en este nodo553
Nuevo presupuesto() => void goPimiaPath( `/pimia/presupuestos/nuevo?cliente=${encodeURIComponent(customer.id)}`, )No declarado en este nodo746

Estados reutilizados

  • PimiaNotConnected
  • PimiaErrorState
  • PimiaRowsSkeleton
  • PimiaEmpty

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, text-2xl, text-foreground, text-xs, text-sm, bg-muted, gap-3, sm:grid-cols-3, gap-2, bg-primary/10, text-primary, text-base, overflow-x-auto, overflow-y-hidden, hover:bg-transparent, text-right, overflow-hidden, bg-primary.

PimiaStates

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

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Conectar una empresa() => setIsConnectOpen(true)No declarado en este nodo99
Rótulo dinámico / icono() => void goPimiaPath(notFound.listPath)No declarado en este nodo233
Rótulo dinámico / iconodelegado al contenedorNo declarado en este nodo247
Rótulo dinámico / icono() => void goPimiaPath( closedDoor.action?.kind === "plan" ? PLAN_PATH : MODULES_SETTINGS_PATH, )No declarado en este nodo257
Volver a conectar() => setIsConnectOpen(true)No declarado en este nodo273
ReintentaronRetryNo declarado en este nodo279

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.

PimiaCustomerIdentity

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

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => { void openExternalUrl(href).catch((error: unknown) => { toast.error( error instanceof Error ? error.message : "No se pudo abrir la web del cliente", ); }); }No declarado en este nodo148
revealed ? "Ocultar el IBAN" : "Mostrar el IBAN"() => setRevealed((current) => !current)No declarado en este nodo260

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.5, text-muted-foreground/70, text-2xs, text-muted-foreground, text-left, text-primary, gap-1.5, text-sm, text-foreground, gap-3, bg-muted, text-xs, overflow-hidden, bg-card, overflow-x-auto, overflow-y-hidden.

PimiaCustomerVolume

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

Columnas declaradas

  • Mes
  • Facturado
  • Cobrado

Clases de presentación locales

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

bg-card, p-4, sm:p-5, text-sm, text-foreground, text-xs, text-muted-foreground, gap-1.5, gap-x-6, gap-y-3, gap-x-4, gap-y-1, bg-primary, bg-primary/40, gap-2, text-2xs, gap-px, text-center.

PimiaInvoiceList

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

Columnas declaradas

  • Cliente
  • Cobro
  • Acciones

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => onOpen(invoice.id)No declarado en este nodo237
Sin numeraronOpen ? () => onOpen(invoice.id) : undefinedNo declarado en este nodo253
Ver la factura() => onOpen(invoice.id)No declarado en este nodo406
Ver el cliente() => onOpenCustomer(customerId)No declarado en este nodo412
Copiar el número() => { void navigator.clipboard?.writeText( invoice.invoiceNumber as string, ); }No declarado en este nodo418

Clases de presentación locales

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

hover:bg-transparent, text-foreground, text-muted-foreground, text-2xs, text-xs, text-right.

PimiaEstimateList

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

Columnas declaradas

  • Destinatario
  • Acciones

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => onOpen(estimate.id)No declarado en este nodo276
Ver el presupuesto() => onOpen(estimate.id)No declarado en este nodo401
Ver el cliente() => onOpenCustomer(customerId)No declarado en este nodo407
Copiar el número() => { void navigator.clipboard?.writeText(estimate.estimateNumber); }No declarado en este nodo412

Clases de presentación locales

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

hover:bg-transparent, text-foreground, gap-2, text-muted-foreground, text-right, text-xs.

PimiaCustomerDialog

Fuente: src/features/pimia/ui/PimiaCustomerDialog.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 pistaControlEnlace de estadoReglas JSXLínea
Nombre (obligatorio)Inputform.nameNo declaradas en este nodo274
Persona de contactoInputform.contactNameNo declaradas en este nodo296
NIF / CIFInputform.taxIdNo declaradas en este nodo306
EmailInputform.emailNo declaradas en este nodo332
TeléfonoInputform.phoneNo declaradas en este nodo357
WebInputform.websiteNo declaradas en este nodo376
Sin etiqueta literal resolubleSelectform.currencyId === null ? SIN_MONEDA : String(form.currencyId)No declaradas en este nodo395
Sin etiqueta literal resolubleSelectform.paymentMethodId === null ? SIN_FORMA : String(form.paymentMethodId)No declaradas en este nodo436
Prefijo de numeraciónInputform.prefixNo declaradas en este nodo470
Notas internasTextareaform.notesNo declaradas en este nodo482
Dirección de envío: tiene una distinta de la de facturaciónSwitchform.hasShippingNo declaradas en este nodo516
IBANInputform.ibanNo declaradas en este nodo563
BIC / SWIFTInputform.bicNo declaradas en este nodo581
Referencia del mandatoInputform.sepaMandateIdNo declaradas en este nodo601
Fecha de firma del mandatoInputform.sepaMandateDatetype=date613

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo636
Rótulo dinámico / iconosubmit del formularioNo declarado en este nodo643

Clases de presentación locales

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

overflow-y-auto, text-sm, text-foreground, text-muted-foreground, text-xs, text-destructive, grid-cols-1, gap-4, sm:grid-cols-2, bg-destructive/5, bg-muted/40.

PimiaConnectDialog

Fuente: src/features/pimia/ui/PimiaConnectDialog.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 pistaControlEnlace de estadoReglas JSXLínea
Tu empresaInputbaseUrldisabled=connect.isPending114

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => handleOpenChange(false)No declarado en este nodo155
Rótulo dinámico / iconosubmit del formulario!canSubmit162

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.

PimiaSortableHead

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

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => onSortChange({ direction: isActive && sort.direction === "desc" ? "asc" : ("desc" as const), field, })No declarado en este nodo61

PimiaInvoiceActions

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

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => { if (primary === "publish") { pedirEmision("publish"); } else if (primary === "send") { pedirEmision("send"); } else { requestPayment(); } }isBusy356
`Acciones de ${invoice.invoiceNumber ?? "la factura sin numerar"}`delegado al contenedorisBusy391
Editar() => void goPimiaPath( `/pimia/facturas/${encodeURIComponent(invoice.id)}/editar`, )No declarado en este nodo409
Publicar() => pedirEmision("publish")No declarado en este nodo421
Rótulo dinámico / icono() => pedirEmision("send")No declarado en este nodo426
Marcar como enviada() => pedirEmision("markSent")No declarado en este nodo436
Registrar cobrorequestPaymentNo declarado en este nodo444
Crear rectificativa() => setConfirmation("creditNote")No declarado en este nodo454
Duplicar() => setConfirmation("clone")No declarado en este nodo459
Descargar el PDF() => void handlePdf()No declarado en este nodo467
Copiar el enlace para el cliente() => void handleCopyLink()No declarado en este nodo478
Publicar() => void handlePublish()No declarado en este nodo509
Marcar como enviada() => void handleMarkSent()No declarado en este nodo539
Duplicar() => void handleClone()No declarado en este nodo558
Crear rectificativa() => void handleCreditNote()No declarado en este nodo584
Volver a conectar() => { setConfirmation(null); setIsReconnectOpen(true); }No declarado en este nodo604
Rellenar los datos de mi empresa() => { setConfirmation(null); setIsCompanyOpen(true); }No declarado en este nodo634

PimiaEstimateDocument

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

Columnas declaradas

  • Concepto
  • Importe

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-xs, text-base, text-foreground, text-muted-foreground, gap-x-6, gap-y-2, text-2xs, text-lg, text-2xl, grid-cols-1, gap-5, sm:grid-cols-3, bg-primary, gap-7, xl:grid-cols-2, overflow-x-auto, text-left, text-sm, gap-2, sm:text-right.

PimiaEstimateActions

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

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Rótulo dinámico / icono() => { if (primary === "send") { setIsSendOpen(true); } else if (primary === "convert") { requestConvert(); } else if (primary === "clone") { setConfirmation("clone"); } else { void handleStatus(primary); } }isBusy311
`Acciones de ${estimate.estimateNumber}`delegado al contenedorisBusy355
Editar() => void goPimiaPath( `/pimia/presupuestos/${encodeURIComponent(estimate.id)}/editar`, )No declarado en este nodo379
Rótulo dinámico / icono() => setIsSendOpen(true)No declarado en este nodo390
Rótulo dinámico / icono() => { if (status === "REJECTED") { setIsRejectOpen(true); return; } void handleStatus(status); }No declarado en este nodo401
Duplicar() => setConfirmation("clone")No declarado en este nodo422
Convertir en facturarequestConvertNo declarado en este nodo426
Descargar el PDF() => void handlePdf()No declarado en este nodo437
Copiar el enlace para el cliente() => void handleCopyLink()No declarado en este nodo450
Duplicar() => void handleClone()No declarado en este nodo484
Convertir en factura() => void handleConvert()No declarado en este nodo507
Volver a conectar() => { setConfirmation(null); setIsReconnectOpen(true); }No declarado en este nodo528

PimiaAddressFields

Fuente: src/features/pimia/ui/PimiaAddressFields.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 pistaControlEnlace de estadoReglas JSXLínea
A nombre deInputform.nameNo declaradas en este nodo70
DirecciónInputform.street1No declaradas en este nodo79
Segunda líneaInputform.street2No declaradas en este nodo89
Código postalInputform.zipNo declaradas en este nodo99
CiudadInputform.cityNo declaradas en este nodo108
ProvinciaInputform.stateNo declaradas en este nodo116
Teléfono de esta direcciónInputform.phoneNo declaradas en este nodo126

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-xs, text-muted-foreground, grid-cols-1, gap-4, sm:grid-cols-3.

PimiaCompanyDialog

Fuente: src/features/pimia/ui/PimiaCompanyDialog.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 pistaControlEnlace de estadoReglas JSXLínea
Razón socialInputform.namerequired=true182
Nombre comercialInputform.tradeNameNo declaradas en este nodo205
NIF / CIFInputform.taxIdNo declaradas en este nodo219
CorreoInputform.emailtype=email249
TeléfonoInputform.phoneNo declaradas en este nodo265
Sin etiqueta literal resolubleSelectform.address.countryIdNo declaradas en este nodo292

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo349
Guardarsubmit del formulario!puedeGuardar356

Clases de presentación locales

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

overflow-y-auto, text-sm, text-foreground, text-xs, text-muted-foreground, grid-cols-1, gap-4, sm:grid-cols-2, text-destructive.

PimiaInvoiceSendDialog

Fuente: src/features/pimia/ui/PimiaInvoiceSendDialog.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 pistaControlEnlace de estadoReglas JSXLínea
ParaInputtotype=email190
AsuntoInputsubjectNo declaradas en este nodo204
MensajetextareabodyNo declaradas en este nodo216

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo244
Rótulo dinámico / iconosubmit del formulario!canSend251

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.5, bg-destructive/10, text-sm, text-foreground, text-destructive, bg-muted/40, text-muted-foreground, gap-1.5, text-2xs, bg-background, text-xs.

PimiaInvoicePaymentDialog

Fuente: src/features/pimia/ui/PimiaInvoicePaymentDialog.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 pistaControlEnlace de estadoReglas JSXLínea
Importe cobradoInputamountNo declaradas en este nodo198
Fecha del cobroInputdatetype=date243
Sin etiqueta literal resolubleSelectmethodIdNo declaradas en este nodo272

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo307
Registrar cobrosubmit del formulario!canRecord314

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-1.5, text-2xs, text-muted-foreground, text-xs, text-destructive, text-sm.

PimiaEstimateRejectDialog

Fuente: src/features/pimia/ui/PimiaEstimateRejectDialog.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 pistaControlEnlace de estadoReglas JSXLínea
Motivo (opcional)textareareasonNo declaradas en este nodo129

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo155
Marcar como rechazadosubmit del formulariochangeStatus.isPending162

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-1.5, text-2xs, text-muted-foreground, bg-background, text-sm, text-foreground, text-xs, text-destructive.

PimiaEstimateSendDialog

Fuente: src/features/pimia/ui/PimiaEstimateSendDialog.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 pistaControlEnlace de estadoReglas JSXLínea
ParaInputtotype=email309
AsuntoInputsubjectNo declaradas en este nodo331
MensajetextareabodyNo declaradas en este nodo343

Acciones

Rótulo literalHandler o envíoDeshabilitado cuandoLínea
Cancelar() => onOpenChange(false)No declarado en este nodo371
Enviarsubmit del formulario!canSend378

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.5, bg-destructive/10, text-sm, text-foreground, text-destructive, bg-muted/40, text-muted-foreground, gap-1.5, text-2xs, text-xs, bg-background.

Hooks, adaptadores y utilidades relacionados

  • src/features/pimia/api/addresses.ts
  • src/features/pimia/api/auth.ts
  • src/features/pimia/api/company.ts
  • src/features/pimia/api/customerEditor.ts
  • src/features/pimia/api/customers.ts
  • src/features/pimia/api/estimateSharedLink.ts
  • src/features/pimia/api/estimates.ts
  • src/features/pimia/api/invoiceSharedLink.ts
  • src/features/pimia/api/invoices.ts
  • src/features/pimia/api/pimiaClient.ts
  • src/features/pimia/api/shell.ts
  • src/features/pimia/hooks/usePimiaAuth.ts
  • src/features/pimia/hooks/usePimiaClientes.ts
  • src/features/pimia/hooks/usePimiaCorreo.ts
  • src/features/pimia/hooks/usePimiaCustomerStats.ts
  • src/features/pimia/hooks/usePimiaEmpresa.ts
  • src/features/pimia/hooks/usePimiaProveedores.ts
  • src/features/pimia/hooks/usePimiaResources.ts
  • src/features/pimia/hooks/usePimiaVerifactuConfig.ts
  • src/features/pimia/lib/calendar.ts
  • src/features/pimia/lib/closedDoors.ts
  • src/features/pimia/lib/companyDraft.ts
  • src/features/pimia/lib/customerDraft.ts
  • src/features/pimia/lib/customers.ts
  • src/features/pimia/lib/documentActivity.ts
  • src/features/pimia/lib/documentSeries.ts
  • src/features/pimia/lib/estimates.ts
  • src/features/pimia/lib/invoiceIssuer.ts
  • src/features/pimia/lib/invoices.ts
  • src/features/pimia/lib/mailConfig.ts
  • src/features/pimia/lib/missingRecord.ts
  • src/features/pimia/lib/money.ts
  • src/features/pimia/lib/payments.ts
  • src/features/pimia/lib/pdfPropio.ts
  • src/features/pimia/lib/scopeDenial.ts
  • src/features/pimia/lib/series.ts
  • src/features/pimia/lib/taxes.ts
  • src/features/pimia/lib/verifactuPublicacion.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