¿Sin departamento de TI? Integración CSV/SFTP para pequeños clientes 3PL

Déjame contarte algo. Después de todos estos años en la carretera, lo que más temo no es el tráfico. Es un pedido equivocado, especialmente cuando el Excel de un pequeño cliente entra mal en el WMS.

El pasado octubre estaba en la fila de un almacén 3PL en Ontario, esperando a que me descargaran. Llevaba pequeños electrodomésticos, unos cuatrocientos cartones, recogidos cerca de los puertos de Long Beach y con destino a un punto de distribución en Las Vegas. El remitente era un pequeño empresario, siete personas en total, y él era su propio departamento de TI: Excel era todo lo que tenía. Cada tarde exportaba los pedidos del día a Excel, lo enviaba por correo electrónico al almacén, y algún chico allí tecleaba cada línea en el WMS a mano.

Ese día todo se vino abajo. Un SKU en la hoja de cálculo era HD-2204B. Al chico se le resbaló el dedo y tecleó HD-2204D. Una letra de diferencia. Cuando llegué a Las Vegas, el receptor revisó los números de modelo y rechazó toda la carga. Devolví cuatrocientos cartones. Más de quinientas millas de ida y vuelta, dos días perdidos, casi mil dólares en diésel quemado para nada. El dueño le gritó al gerente del almacén por teléfono. El gerente dijo que faltaba personal, que los errores ocurren. El dueño dijo que solo envío unas pocas docenas de pedidos al día y aun así no pueden teclearlos bien. El transportista asumió la mitad del flete. Nos lo tragamos.

La cuestión es esta: un pequeño cliente sin TI no es perezoso. De verdad no tiene a nadie. Si tu 3PL lo trata como una molestia, se irá al almacén de enfrente. Pero si lo cuidas bien, te dará decenas de miles de cartones al año, con la regularidad de un reloj.

¿Sin personal de TI? Este manual de integración CSV/SFTP funciona

Llegué a conocer bastante bien a ese gerente del almacén durante los almuerzos. Me dijo que la mitad de sus veintitantos clientes eran "clientes de Excel". Los grandes tienen EDI y API: se integra una vez y se olvida durante un año. ¿Los pequeños? Excel hoy, una captura de pantalla de un chat mañana, una llamada telefónica al día siguiente. Intentó que pasaran a integraciones por API. La mitad de ellos ni siquiera sabía qué era una API.

Así que elaboraron un conjunto de métodos de baja tecnología — un manual de integración CSV SFTP WMS en lenguaje sencillo para clientes sin personal de TI — y, sinceramente, me pareció brillante. Ahora bien, tu terminología de TI me supera. Te lo explicaré como lo haría un conductor.

Método uno: una plantilla CSV bloqueada.

Piensa en el CSV como el "Guardar como" de Excel. El almacén envía a cada pequeño cliente una plantilla de pedidos fija: qué columnas, en qué orden, las fechas en qué formato, las cantidades deben ser números. Todo congelado. No se permite cambiar ni una coma. El cliente rellena esa hoja cada día y la envía.

Aquel almacén tenía un truco que me encantó: la primera fila no son encabezados, es un ejemplo ya rellenado. El dueño solo copia el patrón. Difícil equivocarse. Cuando el archivo llega, el WMS lo revisa automáticamente primero: una letra en la columna de cantidad, una fecha como "10/5" en lugar de "2026-10-05", y todo el archivo rebota con una nota en lenguaje sencillo que indica la fila rota.

Cuando tecleaban a mano, un chico introducía un par de cientos de líneas al día, y los errores aumentaban cada hora después del almuerzo. Ahora una importación CSV tarda cinco minutos, y cualquier error es un error de tecleo del cliente: la responsabilidad está clarísima.

Método dos: recogida programada por SFTP. Deja que el archivo vuele solo.

Algunos clientes ni siquiera se molestan en enviar el correo electrónico cada día. Piensa en el SFTP como un buzón de archivos cerrado con llave: el almacén le da al cliente una cuenta, el cliente deja el CSV en el buzón cada noche, y el WMS lo recoge según un horario — digamos a las 2 AM — lo revisa y lo importa. Cuando empieza el turno por la mañana, los pedidos ya están en el sistema.

Este es perfecto para el gerente de oficina que sube archivos con la precisión de un reloj a las 4 PM todos los días. Nadie lo vigila. El archivo vuela solo, y el sistema grita si falta uno. Conozco a un pequeño cliente de repuestos de automóvil en Rancho Cucamonga cuya gerente de oficina nunca se perdió una subida a las 4 PM. Tres meses seguidos, cero errores. Me dijo que ahora sale a las 4:05 a recoger a su hijo.

Método tres: análisis de archivos adjuntos de correo electrónico, el último recurso.

Siempre hay uno o dos clientes que olvidan su contraseña de SFTP cada semana y aun así no rellenan bien la plantilla. Deja de pelear con ellos: configura un buzón dedicado, exige "pedidos + fecha" en el asunto, y deja que el WMS barra ese buzón con un temporizador, tome el archivo adjunto, lo analice y lo importe. Si pueden enviar un correo electrónico, están integrados.

Esta es la comparación honesta:

Y aquí va la opinión contraria: para los pequeños clientes, olvídate de la API. Una plantilla CSV congelada da más tranquilidad que una API. Las API suenan elegantes, pero no hay nadie del lado del cliente para mantenerlas. Hoy funciona; el mes que viene cambia su correo electrónico, restablece una contraseña, la conexión se rompe, y tienes que enviar a alguien a arreglarla. El CSV es feo, pero no depende de nadie del otro lado. Si el formato del archivo es correcto, entra. Si es incorrecto, rebota. La responsabilidad está limpia. Después de tantos años conduciendo, creo una cosa: menos piezas, menos averías.

La trampa del mapeo de campos CSV: nombres de columna que cambian cada día

Que sea de baja tecnología no significa que no tenga trampas. La mayor trampa es el mapeo de campos: en palabras sencillas, los nombres de columna de la hoja del cliente no coinciden con los nombres de campo del WMS.

El peor cliente que he visto: el lunes la columna era "Item#", el miércoles "SKU", el viernes las palabras chinas para "número de producto". La importación buscaba coincidencias por nombre de columna, así que un cambio de nombre convirtió todo el archivo en espacios en blanco. Docenas de pedidos quedaron fuera del sistema, camiones esperando en la puerta. Una vez estuve sentado allí cuatro horas por esto.

El gerente me enseñó tres soluciones, y cada una de ellas es sólida:

Primero, una tabla de traducción. Guarda un mapeo en el sistema: el "Item#", el "SKU" y el "número de producto" del cliente se traducen todos al sku_code del sistema. Deja que el cliente lo llame como quiera, siempre que esté en la tabla. Cuando llega un cliente nuevo, dedica medio día a registrar cada nombre de columna de sus archivos antiguos.

Segundo, reglas de validación estrictas. La columna de cantidad debe ser un número. La columna de fecha debe tener el aspecto de 2026-10-05. La columna de SKU no puede estar vacía. Un solo fallo y todo el archivo rebota: ni una sola línea entra. Mejor llegar media hora tarde que dejar entrar datos sucios al edificio. Una vez que los datos sucios están dentro, todo el envío sale mal.

Tercero, tres días de revisión manual en cualquier plantilla nueva. La primera vez que un cliente usa una plantilla nueva, o cambia un nombre de columna, un humano revisa cada línea durante tres días. Confirma que el mapeo es correcto, y luego activa la importación automática. No te saltes esto. Esos tres días te ahorran tres meses apagando fuegos.

Concilia una vez al día. Nunca lo dejes para la noche.

Un último truco, el arma secreta del gerente: quince minutos antes de terminar la jornada, concilia el día.

Compara los pedidos salientes del WMS con los pedidos del archivo del cliente. Si los números no coinciden, nadie se va a casa hasta saber por qué. ¿El archivo no se importó? ¿Se importó pero no se envió? ¿El cliente envió el archivo dos veces? Quince minutos, todos los días, sin excepciones.

No subestimes esos quince minutos. He visto demasiadas peleas a fin de mes: el cliente dice cien pedidos, el almacén dice noventa y ocho, nadie puede demostrar que los otros dos se enviaron, y se reparten la pérdida. Concilia a diario y los problemas salen a la luz el mismo día en que nacen. El fin de mes se convierte en un trámite.

Un consejo para mis colegas 3PL: no trates a los pequeños clientes como un dolor de cabeza. Los grandes clientes son agradables, pero sus contratos se renuevan cada tres años, y perder uno rompe huesos. Los pequeños clientes, uno por uno, parecen poco impresionantes, pero juntos son tu base. Clava la plantilla CSV, la recogida por SFTP y la conciliación diaria, y los pequeños clientes funcionarán mejor que los grandes: una persona de su lado, casi nadie necesario del tuyo.

Hay un viejo dicho: por un pelo, por una milla. Una letra equivocada en un SKU me costó quinientas millas en vacío. Haz bien el papeleo, y el camión funcionará bien. Esa verdad vale en la carretera, y vale también dentro del almacén.

Por Shifu Zhao, Veterano del transporte (15 años)

Traducido del inglés. En caso de discrepancia, prevalece la versión en inglés.