Saltar al contenido
P4 Software P4 Software / logisticaHQ Portal de clientes

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://p4-software.opendocs.page/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Importar y exportar con Excel

logisticaHQ Portal de Clientes
Importar y exportar con Excel

Esta página le muestra cómo crear y actualizar muchos Productos, Clientes o Proveedores a la vez con una hoja de cálculo de Excel, y cómo descargar sus listas como archivos de Excel. Es para los usuarios que administran Productos, Clientes o Proveedores; cualquier persona que pueda consultarlos puede usar las exportaciones.

Quién puede usarlo

  • Importar (el botón Importar desde Excel, el enlace Descargar plantilla y las páginas de importación) requiere Administrar Productos, Administrar Clientes o Administrar Proveedores, según la lista. Un usuario con acceso de solo consulta no ve estos botones, y si abre una página de importación verá No tiene acceso a esta sección.
  • Exportar (Exportar y Exportar a Excel) está disponible para todos los que pueden consultar la lista.

Cómo llegar

Empiece en la lista con la que quiere trabajar: Datos maestros > Productos, Clientes o Proveedores. Los botones de importación y exportación están en la parte superior de cada lista.

Las dos exportaciones

Cada lista tiene dos formas distintas de exportar. Elija según lo que necesite.

ComparaciónExportar (barra de herramientas)Exportar a Excel
Qué obtieneUna copia de la lista tal como la ve: las filas que coinciden con su búsqueda y filtros actuales, en el orden actual, solo con las columnas que se muestran. Se incluyen todas las páginas, no solo la que está en pantalla.Toda su lista como un libro que puede editar e importar de nuevo: en Clientes y Proveedores con exactamente las columnas de la plantilla de importación, en Productos con el formato de producto anterior, que también se sigue importando.
Nombre del archivoPortalProducts.xlsx, PortalCustomers.xlsx o PortalVendors.xlsxProducts.xlsx, Customers.xlsx o Vendors.xlsx
FiltrosSe respetan.Se ignoran: siempre obtiene toda la lista, ordenada por SKU (Productos) o por código (Clientes y Proveedores).
FechasSe escriben como Jan 05, 2026 - 03:30 PM.El libro no tiene columnas de fecha.
Ideal paraCompartir o imprimir lo que está viendo.Respaldos, cambios masivos y volver a cargar datos en el portal.

El libro de Productos de Exportar a Excel incluye los Productos descontinuados, aunque la lista de Productos no los muestra. Está en el formato de producto anterior, más corto, que también se sigue importando, así que no contiene datos que ese formato no puede llevar, como las cantidades en existencia, las Unidades de Empaque o los componentes. El libro de Clientes no contiene direcciones de entrega.

En el libro de Productos, las tres columnas IsLotControlled, IsSerialControlled e IsExpiryControlled se escriben con las palabras True y False.

Consejo: La forma más rápida de saber cómo se escribe un valor es hacer clic en Exportar a Excel y mirar una fila que ya tiene. Para cambios masivos, exporte, cambie las celdas, guarde e importe el mismo archivo.

Cómo funciona una importación

Hay dos tipos de importación. La importación de Productos le muestra una vista previa y no guarda nada hasta que usted confirma. Las importaciones de Clientes y de Proveedores no tienen vista previa: guardan el archivo en cuanto usted hace clic en Importar. Abajo están los pasos y los resultados de cada una, y luego las reglas que valen para todas y las que valen solo para un tipo.

Paso a paso: Productos

  1. En la lista de Productos, haga clic en Descargar plantilla (el enlace pequeño junto a Importar desde Excel). Su navegador guarda products-import-template.xlsx, un libro en su idioma con tres hojas: Productos, Ejemplo y Léame.
  2. Ábralo en Excel y llene la hoja Productos, una fila por cada Unidad de Empaque de un producto, empezando en la fila 2. Deje el nombre de la hoja y los nombres de columna de la fila 1 tal como están. Guarde el archivo como libro de Excel (.xlsx). Las columnas y las reglas para llenarlas están en la página Productos.
  3. De vuelta en el portal, haga clic en Importar desde Excel. Se abre la página Importar Productos. Una línea debajo del título dice: "Descargue la plantilla, llene sus Productos bajo los nombres de sus columnas y suba aquí el archivo. La plantilla viene en su idioma, con un ejemplo e instrucciones. El SKU siempre es obligatorio, y su almacén puede exigir otros campos. Antes de guardar nada verá lo que haría el archivo."
  4. Elija su archivo con el selector de archivos. Importar no está disponible hasta que se elige un archivo.
  5. Haga clic en Importar. Mientras se revisa el archivo, el botón dice Leyendo el archivo... Todavía no se guarda nada. La página muestra la vista previa: Todavía no se ha guardado nada. Revise qué pasará con este archivo., luego Filas en el archivo: 12, las cifras, cada una una frase corta con su número, por ejemplo 2 products to create, 1 product to update y 1 product that will be refused (por ahora estas frases se muestran en inglés; también hay tres cifras de Unidades de Empaque cuando el archivo tiene filas de Unidades de Empaque), la lista Filas que no se importarán, las Notas sobre las filas que se importarán y las columnas y hojas que se ignorarán.
  6. Si la vista previa es lo que quiere, haga clic en el botón que indica lo que se guardará, por ejemplo Importar 3 Productos o Importar 1 producto y 2 Unidades de Empaque. Si no, haga clic en Cancelar o elija otro archivo: no se crea ni se cambia nada.
  7. Lea el resultado (abajo). Haga clic en Volver a Productos para regresar a la lista y use Recargar si no ve los cambios.

Qué significa cada línea de la vista previa, las columnas de la plantilla y los motivos por los que se rechaza una fila se describen en Importar Productos desde Excel, en la página Productos.

El resultado de una importación de Productos

Después de confirmar, la vista previa se reemplaza por el resultado y aparece un mensaje verde:

  • Importación completa: {0} creados, {1} actualizados. {0} es el número de Productos nuevos y {1} el número de Productos que ya existían y se actualizaron. Cuando el archivo tenía filas de Unidades de Empaque, sigue una segunda línea: Unidades de Empaque: {0} creadas, {1} actualizadas.
  • Filas que no se importaron enumera cada fila rechazada, con el número de fila (como lo ve en Excel) y el SKU, por ejemplo Fila 4 · SKU-1, seguidos del motivo. Las demás filas sí se importaron.
  • La importación falló: {0} en rojo: se rechazó el archivo y no se guardó nada; {0} indica el motivo.
  • No se importó nada. Revise el archivo e inténtelo de nuevo. Sus datos cambiaron después de la vista previa y no se pudo guardar nada. Elija el archivo de nuevo y lea la nueva vista previa.

Paso a paso: Clientes y Proveedores

  1. En la lista, haga clic en Descargar plantilla (el enlace pequeño junto a Importar desde Excel en la lista de Clientes; debajo del botón en la lista de Proveedores). Su navegador descarga un libro vacío, Customers-template.xlsx o Vendors-template.xlsx, con una hoja, una fila de encabezados en negrita y ningún dato.
  2. Abra el archivo en Excel y escriba un registro por fila, empezando en la fila 2 (vea las tablas de columnas más abajo). Deje los encabezados de la fila 1 exactamente como están. Guarde el archivo como libro de Excel (.xlsx).
  3. De vuelta en el portal, haga clic en Importar desde Excel. Se abre la página Importar Clientes o Importar Proveedores. Una línea debajo del título explica qué hace la importación, y una tarjeta enumera las columnas reconocidas.
  4. Elija su archivo con el selector de archivos.
  5. Haga clic en Importar. El botón no está disponible hasta que se elige un archivo; si llega a presionarlo sin archivo, verá Elija un archivo primero. Mientras se procesa el archivo, el botón dice Importando... El archivo se guarda de inmediato: no hay vista previa ni confirmación.
  6. Lea el resultado (abajo). Haga clic en Volver a Clientes o Volver a Proveedores para regresar a la lista, y use Recargar si no ve los cambios.

El resultado de una importación de Clientes o Proveedores

Cuando termina la importación, la página muestra cuatro contadores (filas, creados, actualizados y omitidos), un mensaje verde y, cuando hay algo que informar, una lista con el encabezado Advertencias.

  • Importación completa: {0} creados, {1} actualizados. La importación funcionó. {0} es el número de registros nuevos y {1} el número de registros que ya existían y se actualizaron.
  • Row {n}: missing CustomerCode - skipped. (Proveedores: Row {n}: missing VendorCode - skipped.) aparece en Advertencias cuando una fila no tiene clave. {n} es el número de fila en su hoja, donde la fila de encabezados es la fila 1. La fila se cuenta como omitida y no se guarda nada de ella. Estas advertencias aparecen en inglés.
  • La importación falló: {0} en rojo. Se rechazó todo el archivo; {0} indica el motivo.
  • Elija un archivo primero. Presionó Importar sin elegir un archivo.

Reglas que se aplican a toda importación

  • La columna clave decide si se crea o se actualiza. La clave es Sku en Productos, CustomerCode en Clientes y VendorCode en Proveedores. La clave se compara sin importar las mayúsculas y sin los espacios al inicio y al final. Si su empresa ya tiene un registro con esa clave, la fila lo actualiza. Si no, la fila crea un registro nuevo.
  • Una celda vacía conserva el valor actual. En un registro existente, una celda que deja vacía no cambia nada. En la plantilla de Productos puede vaciar un valor de texto o de número escribiendo (borrar) en su celda; en las importaciones de Clientes y de Proveedores no puede vaciar un campo importando, así que edite el registro en su página.
  • Tamaño del archivo. Un archivo de más de 15 MB se rechaza antes de enviarse, con La importación falló: Supplied file with size {n} bytes exceeds the maximum of 15728640 bytes. (el detalle aparece en inglés). La plantilla de Productos además acepta como máximo 5,000 filas a la vez.
  • Solo sus propios registros. Una importación solo lee y modifica registros de su propia empresa.
Importante: Una importación modifica datos reales y no se puede deshacer con un clic. Pruebe primero con un archivo pequeño y conserve una copia de Exportar a Excel de antes del cambio.

Reglas para Clientes y Proveedores

  • Solo se lee la primera hoja. Ponga sus datos en la primera hoja del libro. La fila 1 debe contener los encabezados de las columnas.
  • Encabezados. Use los encabezados de la plantilla. Se reconocen sin importar las mayúsculas ni los espacios. Una columna cuyo encabezado no se reconoce se ignora sin ningún mensaje.
  • Una fila sin clave se omite con la advertencia indicada arriba. Si la misma clave aparece en varias filas, la primera fila crea el registro y las siguientes lo actualizan. Las demás filas se procesan igualmente.
  • Una sola celda incorrecta detiene todo el archivo. Si una columna numérica contiene texto, o una columna TRUE / FALSE contiene algo que no es un valor TRUE / FALSE (por ejemplo la palabra Si), la importación falla con un mensaje que empieza con La importación falló: Row [n], Col [ColumnName]. Cannot convert [value] to [Decimal] (o [Boolean]) y puede continuar con texto técnico en inglés. No se guarda nada, ni siquiera las filas correctas. Use el nombre de la columna y el valor del mensaje para encontrar la celda, corríjala e importe de nuevo.
  • Todo se guarda a la vez. Si el almacén no puede guardar los cambios, no se guarda nada del archivo.
Consejo: Los códigos que empiezan con cero pierden el cero cuando Excel los trata como números. Dé formato de Texto a esas columnas antes de escribir los valores.

Importar Productos

La plantilla de Productos, sus 30 columnas, las reglas para llenarla, la vista previa y los motivos por los que se rechaza una fila se describen en la página Productos, en la sección Importar Productos desde Excel. Un archivo con el formato de producto anterior, más corto, como el libro de Exportar a Excel, también se sigue importando y muestra la misma vista previa; en él, escriba TRUE o FALSE en las columnas de control de lote, de serie y de expiración.

Importar Clientes

La página Importar Clientes dice: "Suba un archivo Excel (.xlsx) para crear o actualizar Clientes de forma masiva. Las filas se relacionan con su lista por código." La plantilla Customers-template.xlsx tiene una hoja, Customers, con estas columnas. Solo CustomerCode es obligatoria.

ColumnaEquivale a este campo de la página del clienteQué escribir
CustomerCode (obligatoria, la clave)Número ClienteSu código único del cliente.
CompanyNameNombre de EmpresaEl nombre legal o comercial.
ContactPersonPersona de ContactoA quién debe contactar el almacén.
EmailCorreo electrónicoUna o varias direcciones separadas por comas.
PhoneTeléfono (sección Detalles)Un número de contacto.
DescriptionDescripciónNotas sobre el cliente.
TaxIdID fiscalEl número de registro tributario.
BillToNameFacturar A (sección Facturar A)El nombre para las Facturas cuando es distinto del nombre de la empresa.
BillToPhoneTeléfono (sección Facturar A)Un teléfono de quien recibe la factura.
BillToAddress1Dirección 1La dirección (calle) de la factura.
BillToAddress2Dirección 2Oficina, unidad o piso.
BillToCityCiudadLa ciudad.
BillToStateProvinceEstado/ProvinciaEl estado o la provincia.
BillToZipPostalCódigo postalEl código postal.
BillToCountryPaísEl país.

La importación de Clientes nunca toca las direcciones de entrega (ship-to). Solo cambia los datos y los campos de Facturar A. Un cliente creado por importación no tiene direcciones de entrega hasta que usted las agregue en la pestaña Direcciones de su página, y una importación nunca cambia ni elimina las direcciones existentes. El libro de Exportar a Excel (Customers.xlsx, hoja Customers) tiene las mismas 15 columnas.

Importar Proveedores

La página Importar Proveedores dice: "Suba un archivo Excel (.xlsx) para crear o actualizar Proveedores de forma masiva. Las filas se relacionan con su lista por código." La plantilla Vendors-template.xlsx tiene una hoja, Vendors, con estas columnas. Solo VendorCode es obligatoria.

ColumnaEquivale a este campo de la página del proveedorQué escribir
VendorCode (obligatoria, la clave)Número de ProveedorSu código único del proveedor.
CompanyNameNombre de EmpresaEl nombre legal o comercial.
DescriptionDescripciónNotas sobre el proveedor.
ContactPersonPersona de ContactoA quién contactar sobre las Órdenes de compra.
EmailCorreo electrónicoUna o varias direcciones separadas por comas.
PhoneTeléfonoUn número de contacto.
Address1Dirección 1La dirección (calle) desde la que se envía la mercancía.
Address2UnidadOficina, unidad o piso.
CityCiudadLa ciudad.
StateProvinceEstado/ProvinciaEl estado o la provincia.
ZipPostalCodeCódigo PostalEl código postal.
CountryPaísEl país.

El libro de Exportar a Excel (Vendors.xlsx, hoja Vendors) tiene las mismas 12 columnas.

Mensajes que puede ver

MensajeQué significaQué hacer
Elija un archivo primero.Presionó Importar sin elegir un archivo (Clientes y Proveedores).Elija su archivo .xlsx y presione Importar de nuevo.
Importación completa: {0} creados, {1} actualizados.La importación funcionó.Haga clic en Volver a Productos (o Clientes, Proveedores) y revise la lista.
Row {n}: missing CustomerCode - skipped. / Row {n}: missing VendorCode - skipped. (en inglés)La fila {n} de la hoja no tiene clave, así que se omitió (Clientes y Proveedores). En una importación de Productos esa misma fila aparece en Filas que no se importarán.Complete la clave en esa fila e importe de nuevo; las filas que ya funcionaron simplemente se actualizan otra vez.
La importación falló: {0}Se rechazó todo el archivo. {0} indica el motivo, como una celda que no es un número o un archivo demasiado grande.Corrija el problema. No se guardó nada, así que importe de nuevo el archivo completo.
No tiene acceso a esta sección.Su usuario no puede administrar esta lista.Pida a su almacén que active el interruptor de administración.

Es bueno saber

  • En las importaciones de Clientes y de Proveedores no se puede borrar un valor: una celda vacía siempre conserva lo que ya hay. En la plantilla de Productos, escriba (borrar) para vaciar un valor de texto o de número.
  • En las importaciones de Clientes y de Proveedores, una sola celda numérica o TRUE / FALSE incorrecta detiene todo el archivo y no se guarda nada hasta que el archivo esté limpio. En la importación de Productos, una fila con un valor incorrecto se rechaza en la vista previa y las demás filas sí se importan.
  • No hay advertencias para un valor que se acepta pero se ve raro, como un error de escritura en una categoría. Revise la lista después de importar.
  • Volver a importar un archivo es seguro para las filas que no cambiaron: las claves existentes se actualizan, no se duplican.

Páginas relacionadas

¿Te resultó útil esta página?