Un lote canario consiste en conectar un nuevo proveedor sobre un perímetro deliberadamente limitado, observable y reversible antes de cualquier importación general. Selecciona productos representativos de las dificultades del catálogo, fija las reglas de aceptación, conserva las respuestas en bruto y prevé condiciones de parada. La prueba debe verificar el acceso autorizado, la estructura, los identificadores, los precios, la divisa, el stock, la frescura y la repetibilidad del flujo. Un resultado positivo no promete ni ventas ni margen: solo demuestra que el catálogo puede superar los controles definidos para ese perímetro y ese periodo.
Por qué limitar la primera importación
Un flujo que responde correctamente puede seguir conteniendo columnas ambiguas, variantes confundidas, precios cuyo régimen fiscal se desconoce o stocks difíciles de interpretar. Importar todo el catálogo de una vez multiplica el número de objetos a corregir y dificulta aislar la causa de una anomalía. El lote canario reduce ese radio de impacto.
El método no es un muestreo estadístico universal. Su objetivo es operativo: exponer rápidamente los casos que pueden romper el contrato de datos. El tamaño del lote depende del número de formatos, categorías, divisas, variantes y escenarios de stock a cubrir. Debe justificarse con una matriz de casos, no elegirse porque un número redondo resulte tranquilizador.
Antes de cualquier recopilación, pasa el archivo o la respuesta por los controles descritos en las columnas que hay que verificar antes de importar. El canario no debe servir para descubrir a posteriori qué significan price, stock, tax o updated_at.
Definir el perímetro canario por caso de riesgo
Selecciona líneas que cubran las situaciones realmente presentes en la documentación oficial del proveedor. Una matriz simple hace que la selección sea verificable:
| Caso a cubrir | Ejemplo de prueba esperada | Riesgo observado | Decisión posible |
|---|---|---|---|
| Producto simple | identificador, precio, divisa, disponibilidad | campo ausente o tipo incoherente | corregir el mapeo |
| Variante | identificador distinto y atributo explícito | fusión de tallas o colores | aislar las correspondencias |
| Stock nulo o no disponible | valor bruto y significado documentado | cero confundido con desconocido | bloquear la publicación |
| Promoción o escalado de precio | fechas, cantidad mínima y unidad | precio fuera de condiciones | excluir el precio del cálculo |
| Producto sin GTIN | otro identificador estable y procedencia | emparejamiento incierto | revisión humana obligatoria |
| Actualización repetida | dos recopilaciones con marca de tiempo | sobrescritura o desaparición sin explicar | analizar el diferencial |
Esta cuadrícula debe reflejar la fuente probada. Si el proveedor no gestiona ni escalados ni variantes, no crees esos casos artificialmente. A la inversa, no elijas únicamente las líneas más completas: el canario perdería su capacidad de revelar los límites del contrato.
Redactar el protocolo antes de lanzar la prueba
Un protocolo canario útil cabe en una ficha revisable. Contiene:
1. La identidad de la fuente. Dominio, endpoint o ruta autorizada, tipo de flujo, cuenta implicada y referencia de la documentación oficial. 2. La base jurídica y contractual. Licencia, términos de uso, acuerdo comercial o permiso por escrito, finalidades autorizadas y plazo de conservación. El acceso técnico no sustituye estos derechos. 3. El perímetro. Criterios de selección de los productos, categorías incluidas, casos cubiertos y exclusiones conocidas. 4. El mapeo. Columna de origen, campo de destino, tipo, unidad, regla de transformación y tratamiento de los valores ausentes. 5. Los controles. Regla, prueba conservada, gravedad y responsable de la decisión. 6. Las condiciones de parada. Incidente de acceso, cambio de formato, identificador ambiguo, divisa desconocida o cualquier otra anomalía crítica definida por el equipo. 7. La marcha atrás. Identificador del lote, objetos creados, forma de desactivarlos y conservación del registro.
El protocolo no debe contener claves, tokens ni identificadores personales. Los secretos permanecen en el almacenamiento previsto por la infraestructura. El registro puede conservar un identificador técnico de conexión sin exponer el secreto en sí.

Ejecutar el canario en cuatro pasadas
Pasada 1: recuperar sin transformar
Conserva la respuesta en bruto, su marca de tiempo, su huella, el estado del transporte y las cabeceras útiles. Para HTTP, la RFC 9110 recoge la semántica de los códigos de estado y de campos como ETag o Last-Modified. Estos metadatos documentan el intercambio; no demuestran que el precio incluido en la respuesta acaba de revisarse.
Pasada 2: validar sin publicar
Aplica el mapeo y clasifica cada línea: aceptada, rechazada o pendiente de revisión. No sustituyas silenciosamente una divisa ausente, un stock desconocido o un GTIN inválido. Conserva el valor de origen y el motivo. Las claves GS1 identifican objetos comerciales concretos; un identificador válido en su forma no demuestra que el producto recibido corresponda a la ficha correcta.
Pasada 3: repetir en las mismas condiciones
Vuelve a lanzar la recopilación según la frecuencia prevista y compara las versiones. Busca columnas que hayan aparecido o desaparecido, cambios de tipo, variaciones de volumen y fechas internas. El objetivo no es exigir una estabilidad absoluta, sino comprobar que los cambios son explicables y que el tratamiento es idempotente: repetir la misma entrada no debe multiplicar las fichas.
Pasada 4: decidir con las pruebas
Elabora un balance por regla, no solo un veredicto global. Una anomalía crítica puede bastar para prolongar la prueba, aunque la mayoría de las líneas sea correcta. A la inversa, unos pocos campos opcionales ausentes no obligan necesariamente a detenerla. La decisión debe citar la regla, la observación y la persona que la validó.
El índice de fiabilidad del proveedor puede resumir los resultados tras la prueba, siempre que cada componente siga siendo consultable. No sustituye las condiciones de parada del canario.
Respetar los límites técnicos y contractuales
Un archivo robots.txt se refiere al comportamiento de clientes automatizados sobre URI. La RFC 9309 precisa que sus reglas se solicitan a los robots y que no constituyen una autorización de acceso. Una regla Allow no es, por tanto, una licencia de reutilización; la ausencia de regla no sustituye las condiciones del proveedor. El protocolo canario debe respetar a la vez las restricciones técnicas, los límites de frecuencia y los derechos contractuales.
Evita también convertir la prueba en una carga involuntaria. Utiliza el mecanismo de exportación oficial cuando exista, respeta las cuotas documentadas, añade una temporización y detente ante errores repetidos. Un incidente no debe desencadenar un bucle agresivo. Cualquier ampliación del volumen o de la frecuencia exige una nueva validación del perímetro.
Qué puede automatizar ArbitragePro+ / qué debe verificar el vendedor
La función lanzamiento-canario descrita aquí es una especificación propuesta, no una función presentada como disponible. Podría crear un lote aislado, asociar las reglas versionadas, registrar los pasos, impedir la publicación por defecto y generar un balance con marcha atrás. La pantalla esperada debería mostrar la fuente, el perímetro, cada control, las anomalías y la decisión, sin mostrar ningún secreto ni dato personal.
El vendedor sigue siendo responsable de la autorización de uso, de la elección de los casos representativos, del significado de los campos, de las condiciones de parada y de la validación final. Debe realizar en particular el control descrito en los derechos de uso de un feed de productos antes de lanzar cualquier recopilación automatizada.
Checklist de salida del canario
- La documentación oficial y la autorización aplicables están archivadas.
- El perímetro cubre los casos de riesgo realmente presentes.
- Los datos en bruto, fechas y huellas se conservan.
- Cada línea tiene un estado y un motivo consultables.
- Los campos críticos nunca se completan por suposición.
- Una segunda recopilación confirma que el mapeo puede repetirse.
- Los errores repetidos detienen la prueba sin generar un bucle de peticiones.
- La marcha atrás se ha verificado sobre el lote aislado.
- El balance distingue bloqueos, alertas y campos opcionales.
- La ampliación es una decisión humana fechada, no la consecuencia automática de una puntuación.
Preparar la fuente que se va a probar
Abrir la gestión de fuentes en ArbitragePro+
Fuentes oficiales
- IETF, RFC 9110 — HTTP Semantics: https://www.rfc-editor.org/rfc/rfc9110.html (consultado el 2026-08-17).
- IETF, RFC 9309 — Robots Exclusion Protocol: https://www.rfc-editor.org/rfc/rfc9309.html (consultado el 2026-08-17).
- GS1, Global Trade Item Number (GTIN): https://www.gs1.org/standards/id-keys/gtin (consultado el 2026-08-17).
