Proveedor

Ruta /pimia/proveedores/[supplierId] · componentes, campos y acciones del checkout documentado.

Ruta y puntos de edición

Ruta: /pimia/proveedores/[supplierId]. 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

Proveedor 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/proveedores/[supplierId]/page.tsx`
Adaptador Next.js	`src/host/screens/PimiaSupplierScreens.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaSupplierScreen.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStates.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaScreenShell.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaPageHeader.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaSupplierPurchases.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaSupplierDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaAmountCell.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaConnectDialog.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaStatusBadge.tsx`
Vista o componente asociado	`src/features/pimia/ui/PimiaAddressFields.tsx`

PimiaSupplierScreen

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

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Proveedores	`() => void goPimiaPath("/pimia/proveedores")`	`No declarado en este nodo`	133
Editar	`() => setIsEditing(true)`	`No declarado en este nodo`	191
Nueva factura recibida	`() => void goPimiaReceivedInvoiceNew(supplier.id)`	`No declarado en este nodo`	199
Reintentar	`() => void stats.refetch()`	`No declarado en este nodo`	326
Rótulo dinámico / icono	`() => { void openExternalUrl(website).catch((error: unknown) => toast.error( error instanceof PimiaApiError ? error.message : "No se pudo abrir la web", ), ); }`	`No declarado en este nodo`	466

Estados reutilizados

PimiaNotConnected
PimiaRowsSkeleton
PimiaErrorState
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-muted-foreground, gap-2, gap-x-3, gap-y-1, bg-muted/60, text-xs, text-foreground, text-sm, gap-3, bg-muted/40, text-base, grid-cols-1, gap-5, lg:grid-cols-3, p-4, p-0, gap-4, sm:grid-cols-3, gap-2.5, text-left, overflow-hidden, bg-muted, bg-foreground/30.

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.

PimiaSupplierPurchases

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

Columnas declaradas

Número
Fecha
Vencimiento
Total
Pendiente

Acciones

Rótulo literal	Handler o envío	Deshabilitado cuando	Línea
Reintentar	`onRetry`	`No declarado en este nodo`	149
Ver la factura recibida	`(event) => { event.stopPropagation(); onOpenInvoice(invoice.id); }`	`No declarado en este nodo`	333

Estados reutilizados

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.

text-sm, text-muted-foreground, p-0, gap-4, bg-card, p-4, gap-2, text-foreground, text-xs, text-center, overflow-hidden, hover:bg-transparent, text-right, text-left.

PimiaSupplierDialog

Fuente: src/features/pimia/ui/PimiaSupplierDialog.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
Nombre (obligatorio)	`Input`	`form.name`	`No declaradas en este nodo`	293
Persona de contacto	`Input`	`form.contactName`	`No declaradas en este nodo`	316
NIF / CIF	`Input`	`form.taxId`	`No declaradas en este nodo`	326
Email	`Input`	`form.email`	`No declaradas en este nodo`	343
Teléfono	`Input`	`form.phone`	`No declaradas en este nodo`	373
Web	`Input`	`form.website`	`No declaradas en este nodo`	385
Sin etiqueta literal resoluble	`Select`	`form.currencyId === null ? SIN_MONEDA : String(form.currencyId)`	`No declaradas en este nodo`	401
Prefijo	`Input`	`form.prefix`	`No declaradas en este nodo`	443
Notas internas	`Textarea`	`form.notes`	`No declaradas en este nodo`	454
Dirección de servicio: tiene una distinta de la fiscal	`Switch`	`form.hasShipping`	`No declaradas en este nodo`	498

Acciones

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

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

Etiqueta o pista	Control	Enlace de estado	Reglas JSX	Línea
A nombre de	`Input`	`form.name`	`No declaradas en este nodo`	70
Dirección	`Input`	`form.street1`	`No declaradas en este nodo`	79
Segunda línea	`Input`	`form.street2`	`No declaradas en este nodo`	89
Código postal	`Input`	`form.zip`	`No declaradas en este nodo`	99
Ciudad	`Input`	`form.city`	`No declaradas en este nodo`	108
Provincia	`Input`	`form.state`	`No declaradas en este nodo`	116
Teléfono de esta dirección	`Input`	`form.phone`	`No declaradas en este nodo`	126

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.

Hooks, adaptadores y utilidades relacionados

src/features/pimia/api/addresses.ts
src/features/pimia/api/auth.ts
src/features/pimia/api/estimates.ts
src/features/pimia/api/invoices.ts
src/features/pimia/api/pimiaClient.ts
src/features/pimia/api/receivedInvoices.ts
src/features/pimia/api/shell.ts
src/features/pimia/hooks/usePimiaAuth.ts
src/features/pimia/hooks/usePimiaFacturasRecibidas.ts
src/features/pimia/hooks/usePimiaProveedores.ts
src/features/pimia/hooks/usePimiaResources.ts
src/features/pimia/lib/calendar.ts
src/features/pimia/lib/closedDoors.ts
src/features/pimia/lib/missingRecord.ts
src/features/pimia/lib/money.ts
src/features/pimia/lib/receivedInvoices.ts
src/features/pimia/lib/scopeDenial.ts
src/features/pimia/lib/supplierDraft.ts
src/features/pimia/lib/suppliers.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