Saltar al contenido principal

Descargar las filas descartadas de una importación

GET/v1/lists/{id}/imports/{import_id}/rejects

Para desarrolladores

Descripción​

Descarga las filas que una importación dejó fuera de la lista, tal como venían en el archivo, con su número de fila y el motivo. Sirve para corregirlas en una planilla y cargarlas en otra lista.

El archivo existe cuando la importación descartó alguna fila: lo indica has_rejects en GET /v1/lists/{id}/imports/{import_id}.

Autenticación​

Authorizationbearer tokenheaderobligatorio
API key con scope list:read. Formato: Bearer <API_KEY>.
X-Instance-Slugstringheaderobligatorio
Identificador de su instancia. Ver Autenticación.

Request​

Path params:

idintegerobligatorio
Identificador de la lista.
import_idintegerobligatorio
Identificador de la importación.

Response​

200 OKDevuelve las filas rechazadas como un CSV adjunto (text/csv; charset=utf-8), en UTF-8 con BOM y con el mismo separador que el archivo subido. Las columnas son las que siguen.text/csv
Las del archivo
Los valores de la fila tal como venían, con la cabecera del archivo.
columnas_extra
Solo si alguna fila traía más columnas que la cabecera: los valores que sobraban.
fila
Número de la fila en el archivo, contando como una planilla: la cabecera es la fila 1.
motivo
Por qué quedó fuera: el campo y el problema, o un problema de la fila entera.
Nota

Celdas que empiezan como una fórmula. Para que una planilla no ejecute como fórmula el texto de una celda, el CSV antepone un apóstrofo (') en estos casos:

  • A toda celda de texto que empiece con =, +, -, @, una tabulación o un retorno de carro, incluidas las de la cabecera.
  • A un texto que ya empieza con apóstrofos seguidos de uno de esos caracteres: recibe uno más.

Una celda que es solo un número, sin signo o negativo, se escribe sin cambios: -5, -1200.50. Un teléfono como +56912345678 sí lleva el apóstrofo, para que la planilla lo conserve como texto y no le quite el +.

Si el archivo se abre directamente en Excel, el apóstrofo se ve dentro de la celda. Si las columnas se separan con Datos › Dividir texto en columnas (Excel para la web), o el archivo se importa en Google Sheets, el apóstrofo no se muestra. Al subir a una lista el archivo corregido, la importación quita ese apóstrofo y la celda vuelve a su valor.

Errores​

CódigoCuándo
404La lista no existe (list_not_found), la importación no existe o es de otra lista (list_import_not_found), o la importación no dejó filas fuera (list_import_rejects_not_found).
Notas
  • Una fila repetida aparece solo si su campo único usa unique_action: error. Con discard y replace el repetido se descarta a propósito y no se lista.
  • Una fila sale con el primer motivo que encontró, en este orden: caracteres que no corresponden a la codificación, columnas de más, y después cada campo en el orden de sus columnas.
  • El archivo también existe cuando la importación falló porque un campo era inválido en la mitad o más de las filas: muestra cuáles y por qué.
  • Contiene datos de contactos: la descarga queda en el log de actividad.
Request
curl -X GET "https://$API_HOST/v1/lists/4/imports/17/rejects" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-o rechazos.csv
Response
email;nombre;fila;motivo
ana@ejemplo;Ana;3;Email: valor inválido
;Luis;7;Email: obligatorio y vacío
juan@ejemplo.cl;Juan;9;Email: valor repetido
pedro@ejemplo.cl;Pedro;12;Más columnas que la cabecera