Saltar al contenido
oqur

Cientos de códigos, un archivo.

No crees uno a uno los códigos de las tarjetas de mesa, las etiquetas de producto o las tarjetas de visita del personal. Sube un archivo CSV, asigna las columnas, mira las filas con errores y créalos todos de una vez. Pronto podrás hacer lo mismo con la API.

  • Negocio y superiores

Pantalla de ejemplo: creación masiva de códigos a partir de un archivo CSV

Creación masiva

Kafe Rıhtım · Plan Negocio

DATOS DE EJEMPLO
  1. Archivo
  2. 2 Asignar columnas
  3. 3 Crear

mesas.csv

48 filas · 3 columnas · UTF-8

Asignar columnas

Cómo se asignan las columnas del CSV a los campos de oqur
Columna del CSVCampo de oqur

Carpeta

Vista previa

5 de 48 filas

Se crearán códigos ·

Petición
curl -X POST https://api.oqur.io/v1/qr-codes/bulk \
  -H "Authorization: Bearer $OQUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "folder": "Sucursal Alsancak",
    "template": "Rıhtım",
    "codes": [
      { "name": "Mesa 01", "type": "url",
        "url": "https://kaferihtim.com/menu?mesa=01" },
      { "name": "Mesa 02", "type": "url",
        "url": "https://kaferihtim.com/menu?mesa=02" }
    ]
  }'

Respuesta

{
  "created": 2,
  "codes": [
    { "id": "qr_7Kq2xP",
      "short_url": "https://oqur.io/d/7Kq2xP" },
    { "id": "qr_8Lr3Hm",
      "short_url": "https://oqur.io/d/8Lr3Hm" }
  ]
}

La API llegará pronto. Cuando llegue, crearás tu clave en la sección Desarrolladores de los ajustes de tu cuenta. Los endpoints son un borrador.

Documentación de la API

Cambia la asignación de columnas y mira cómo reacciona la vista previa. La pestaña API muestra cómo se hará el mismo trabajo en una sola petición con la API que llegará pronto.

Del archivo a la carpeta.

La creación masiva convierte cientos de filas que habría que introducir a mano en un único paso de revisión.

¿Cómo debe ser tu archivo?

Cada fila es un código y cada columna un campo; la primera fila es el encabezado. No hace falta que los nombres de las columnas coincidan con oqur; los asignas después de subirlo. Guarda el archivo en UTF-8 para los acentos y la ñ.

nombre,direccion,sucursal
Mesa 01,https://kaferihtim.com/menu?mesa=01,Alsancak
Mesa 02,https://kaferihtim.com/menu?mesa=02,Alsancak
Mesa 01,https://kaferihtim.com/menu?mesa=k01,Karşıyaka
mesas.csv: separado por comas o puntos y comas, UTF-8.

Los errores aparecen antes de crear nada

Cada fila se revisa en la vista previa: una dirección que falta, un enlace no válido, un nombre repetido. Puedes corregir las filas con errores y volver a subirlas, u omitirlas y crear el resto.

  • Fila 14La dirección está vacía.
  • Fila 31Enlace no válido: «kaferihtim,com/menu».
  • Fila 40Ya existe el mismo nombre en esta carpeta; se añadirá (2) al final.

El diseño y la carpeta se eligen juntos

En la creación masiva eliges una plantilla de diseño y una carpeta de destino. Todos los códigos tienen el mismo aspecto, van a la misma carpeta y se descargan en un solo archivo ZIP.

  1. Elige una plantilla

    Por ejemplo, «Rıhtım».

  2. Elige una carpeta

    O repártelos según la columna de sucursal del CSV.

  3. Descarga el ZIP

    PNG, SVG, PDF o EPS.

Próximamente: automatiza con la API

Si tu catálogo de productos está en otro sistema, no tendrás que subir los códigos a mano. Con la API REST, que llegará pronto, podrás crear códigos, actualizar sus destinos y obtener sus estadísticas.

POST /v1/qr-codes
Crear un código
PATCH /v1/qr-codes/{id}
Actualizar el destino o el diseño
GET /v1/analytics/scans
Estadísticas de escaneo
POST /v1/qr-codes/bulk
Muchos códigos en una sola petición

Sobre Creación masiva

Si la respuesta no está aquí, mira la página de preguntas frecuentes o escríbenos.

Todas las preguntas

El número de códigos que puedes crear depende del límite de códigos dinámicos de tu plan. El plan Negocio tiene 500 códigos dinámicos en total.

En Excel, basta con guardar el archivo como «CSV UTF-8». Elige la codificación UTF-8 para que los acentos y la ñ no se estropeen.

Sí. Cada fila es un código dinámico distinto; puedes cambiar su destino, su diseño y su carpeta con independencia de los demás.

Cuarenta y ocho mesas, un archivo.

Abre una cuenta gratuita; la creación masiva se abre cuando pasas al plan Negocio. La API llegará pronto.