Clientes del artículo de producto
Un cliente de un artículo de producto, con sus códigos comerciales, nombre y unidad de venta opcional.
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Nombre | label | Texto I18n | Nombre o descripción corta que el cliente usa para este artículo. | |
| SKU | sku | Texto | SKU del lado del cliente para este artículo. | |
| Código de barras GTIN | gtin | Código de barras GTIN | GTIN opcional (8, 12, 13 o 14 dígitos) para identificar el artículo mediante escaneo. | |
| Cliente | customerId | Referencia | Sí | Cliente que usa estos códigos para el artículo. |
| Artículo | productitemId | Referencia | Sí | Artículo vendible del catálogo al que aplican los códigos del cliente. |
| Unidad de medida | productitemuomId | Referencia | Unidad de venta cuando difiere de la unidad base del artículo. Déjela vacía si aplica la unidad base. | |
| Referencia de plano | drawingRef | Texto | Identificador de plano del cliente o de ingeniería para este artículo. | |
| Revisión | revision | Texto | Número entero sin parte fraccionaria. | |
| Enlaces | links | Enlace | Enlaces | ||
| Tags | tagIds | Tags | Tags en esta relación artículo–cliente, no en el maestro del artículo. | |
| Descripción | description | Campo de Texto I18n | Notas del cliente sobre este artículo en su catálogo. | |
| Datos | data | Datos | ||
| Identificadores externos | identifiers | Identificador externo | Identificadores externos | Claves de sistemas remotos y tipos de id opcionales. Un valor por par de sistema y tipo en este registro. | |
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Cliente customerId | Clientes | agrupado por |
Artículo productitemId | Artículos de producto | agrupado por |
Unidad de medida productitemuomId | Unidades de medida de artículo de producto | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook productitemcustomers.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Vincula un cliente a este artículo de producto. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios de este vínculo de cliente. | App · WebMCP · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar este vínculo de cliente. Sigue visible y puede seguir en documentos existentes. Desbloquéalo para volver a cambiarlo. | App · API · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar este vínculo de cliente. | App · API · CLI |
| Archivar | archive | Retira este vínculo de cliente del artículo de producto. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. El cliente no se archiva. Desarchívalo para restaurar el vínculo. | App · WebMCP · API · MCP · CLI |
| Restaurar | unarchive | Devuelve este vínculo de cliente a las listas y las acciones activas. | App · WebMCP · API · MCP · CLI |
| Eliminar | delete | Quita el cliente del artículo de producto. El cliente no se elimina. No se puede deshacer. | App · WebMCP · API · MCP · CLI |