Preguntas Frecuentes

Preguntas frecuentes y mejores prácticas.

Preguntas Generales

P: ¿Cuánto tiempo es válida la API Key? R: Por defecto no expira, aunque al crearla puede fijarle una fecha de vencimiento. Se deshabilita revocándola desde Mi Compañía → Integraciones → Integración por API.

P: ¿Puedo volver a cargar datos para actualizar registros existentes? R: Sí, los registros se emparejan por sus campos erp_*_id y se actualizan si ya existen.

P: ¿Qué sucede si cargo archivos fuera de orden? R: Las filas cuya dependencia no exista (por ejemplo, un contacto de un cliente que aún no está cargado) se descartan al procesar el archivo, y la respuesta ya había confirmado la carga: no se entera por ahí. En contactos, segmentaciones, facturas, comprobantes y cuotas, si ninguna dependencia del archivo existe no se procesa nada; los pagos, en cambio, se reportan como exitosos aunque se descarten todas las filas. Siempre cargue en el orden recomendado.

P: ¿Hay un límite de tamaño de archivo? R: La API no fija un límite propio, pero conviene dividir los archivos muy grandes: la validación y la carga son más rápidas y los errores más fáciles de ubicar.

Mejores Prácticas

  1. Codificación UTF-8: Siempre guarde los archivos CSV con codificación UTF-8.
  2. Respetar Dependencias: Cargue las entidades base (Clientes) primero.
  3. Procesamiento por Lotes: Para grandes conjuntos de datos, divida los archivos y cárguelos por lotes.
  4. Seguridad de la API Key: Guarde la API Key de forma segura; solo se muestra al crearla. Si se expone, revóquela y cree una nueva.