Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.piriod.com/llms.txt

Use this file to discover all available pages before exploring further.

La importación por lote permite cargar múltiples clientes en Piriod desde un archivo, sin necesidad de crearlos manualmente. Ve a Configuración de la organización → Importar → Clientes.

​
Requisitos del archivo

  • Formato: CSV, XLSX o JSON
  • Los nombres de las columnas deben coincidir exactamente con los definidos
  • Evita símbolos especiales (# $ % & - /), tildes y ñ
  • El orden de las columnas no afecta la importación
Puedes descargar un archivo de ejemplo directamente desde la pantalla de importación o desde aquí.

​
Estructura del archivo

Una fila por cliente. Las columnas disponibles son:

​
Campos obligatorios

CampoDescripción
nameNombre del cliente
addressDirección del cliente
emailEmail de facturación
stateID del estado, región o provincia
countryID del país
currencyMoneda del cliente: CLP, USD, MXN, EUR

​
Campos condicionales

CampoDescripción
tax_idRUT, DNI, NIF o VAT del cliente. Obligatorio según el país
tax_settings__cl_activity_descriptionActividad económica o giro del cliente

​
Campos opcionales

CampoDescripción
phoneTeléfono del cliente
websiteSitio web del cliente
metadataInformación adicional en formato clave/valor. Ej: {"my_custom_data":"valor"}

​
Importar el archivo

  1. Haz clic en Seleccionar un archivo
  2. Busca el archivo en tu equipo
  3. Haz clic en Importar
Si el archivo es válido, Piriod mostrará un mensaje de éxito indicando cuántos registros fueron importados. Si hay errores de formato o faltan columnas obligatorias, la importación no se realizará.

​
Errores comunes

  • Faltan columnas obligatorias
  • Los nombres de las columnas no coinciden exactamente
  • RUTs inválidos para clientes de Chile — el sistema los valida automáticamente
  • El campo metadata no está en formato clave/valor correcto
  • IDs de país o estado inválidos
Una vez completada la importación, los clientes estarán disponibles en Contactos → Clientes.