Permisos de Shopify para cada función de Beply

Concede a la app los permisos de las operaciones que vas a utilizar. Después selecciona el perfil correspondiente en Beply y configura la función. Estos tres ajustes cumplen tareas distintas: Shopify autoriza el acceso, el perfil de Beply delimita la capacidad de la cuenta y las opciones de la cuenta habilitan la ejecución. En esta guía, ERP se refiere a la gestión de productos, existencias y documentos de tu empresa en Beply.

Shopify llama scopes a los permisos de la app. Los nombres que aparecen entre comillas de código son los que debes buscar en su configuración. Un permiso de escritura incluye el acceso de lectura al mismo recurso; esa amplitud tampoco activa por sí sola una operación de Beply. Referencia oficial de permisos.

Permisos mínimos para importar pedidos de Shopify

Para importar pedidos nativos de Shopify, selecciona en Beply Perfil de capacidad OAuth > Solo entrada y lectura y concede read_orders.

Este perfil permite leer los pedidos, sus líneas y el tracking que ya figure en sus envíos. La entrada de pedidos conserva y concilia el tracking disponible con el pedido local. Descargar tracking de Shopify es una casilla heredada: el importador actual no la usa como condición para leer ese seguimiento. La subida de tracking es una operación distinta; consulta Tracking y envíos. La importación de pedidos no necesita read_customers, read_products, read_locations ni permisos de escritura para recorrer los datos del pedido.

El acceso a nombres, direcciones, correo y teléfono es un requisito adicional de datos protegidos. Revisa los datos de cliente aunque read_orders ya esté concedido.

Permisos para descargar el catálogo de Shopify

El flujo de catálogo por lotes tiene permisos de lectura adicionales. Conservar el perfil Solo entrada y lectura y concederlos no habilita escrituras en Shopify. Activa el flujo de catálogo en Beply para trabajar con descarga, selección de productos, borrador de efectos e incorporación al ERP.

En Beply, la cuenta debe estar activada y el usuario debe ser su responsable o un administrador. El usuario necesita acceso, actualización e importación en el catálogo de Shopify. Para incorporar al ERP necesita además esos permisos en productos del ERP. Los permisos de la app de Shopify no sustituyen estos permisos de Beply.

Datos o tarea	Permisos en Shopify	Resultado y límites
Productos, variantes, contenido y precios de origen	`read_products`	Es el acceso básico exigido por la descarga de catálogo.
Cantidades de inventario por ubicación	`read_products` + `read_inventory` + `read_locations`	La descarga consulta las cantidades y la ubicación a la que corresponden.
Coste unitario de origen	Acceso al producto; Shopify admite `read_products` o `read_inventory` para su ficha de inventario	Si se aplican permisos de producto detallados, el usuario necesita además View product costs. El coste se consulta por separado y puede quedar inaccesible sin impedir los demás datos.
Referencias a metaobjetos usados en contenido adicional	`read_metaobjects`, cuando sean necesarios	Concede este permiso si tu catálogo utiliza esas referencias y necesitas recuperar su contenido.
Archivos referenciados	Acceso de lectura al archivo concreto	El acceso puede proceder de `read_products` o `read_files` según el recurso. Revisa la cobertura de la descarga antes de añadir permisos.

Si faltan permisos para inventario por ubicación, Beply lo señala como inventario no accesible. Esa información pendiente no representa una cantidad cero ni autoriza a sustituir existencias del ERP. El catálogo descargado tampoco se convierte automáticamente en stock físico.

Shopify documenta por separado la autorización del coste unitario. Ficha de inventario y permiso para ver costes.

Los ajustes heredados de descarga automática de productos, sincronización de precio y descarga de stock son distintos del flujo de catálogo por lotes. Los perfiles explícitos actuales rechazan esas combinaciones heredadas; ampliar permisos en Shopify no elimina ese límite.

Perfiles de Beply para tracking y documentos fiscales

Perfil de capacidad OAuth	Permisos requeridos	Qué habilita como capacidad
Solo entrada y lectura	`read_orders`	Importación de pedidos y lectura del tracking incluido en sus envíos.
Tracking mediante fulfillment	`read_orders` + `read_locations` + `write_merchant_managed_fulfillment_orders`	Crear un envío con tracking sobre una preparación de pedido y una ubicación gestionadas por el comercio.
Documentos fiscales	`read_orders` + `read_files` + `write_files` + `write_orders`	Publicar y comprobar un documento fiscal asociado al pedido de Shopify.

El perfil de tracking requiere Subir tracking a Shopify y un Modo global de escritura en Escritura habilitada. Debe existir un único envío elegible, con la ubicación correcta. Si otra herramienta gestiona el mismo envío, acuerda cuál lo escribirá antes de activar la subida. El perfil actual corresponde a ubicaciones gestionadas por el comercio; otros servicios de preparación necesitan revisión de compatibilidad. Creación de envíos en Shopify.

El perfil fiscal requiere Subida de facturas activada, modo global de escritura en Escritura habilitada y un pedido y documento válidos de la misma cuenta. Generar facturas locales automáticamente es una opción distinta: crea documentos en Beply y exige su propia configuración fiscal. La autorización para publicar documentos no activa esa generación. Para rectificativas se exige además Subida de abonos activada.

El perfil en blanco no impide reenviar pedidos ni las demás escrituras permitidas por sus casillas y el modo global; solo bloquea el tracking y las facturas, que exigen su perfil. Los perfiles actuales son alternativas: el perfil de tracking admite su opción de tracking y el perfil fiscal su opción de facturas. No selecciones un perfil suponiendo que reúne todas las escrituras. La función de catálogo por lotes se configura por separado.

Otras operaciones y permisos de Shopify

Operación	Permiso relacionado	Qué comprobar en Beply
Leer pedidos de más de 60 días directamente desde Shopify	`read_all_orders` junto con `read_orders`	Necesidad real y aprobación de Shopify. Trabajar con pedidos ya guardados localmente no requiere este permiso.
Leer devoluciones creadas en Shopify	`read_returns`	Leer devoluciones creadas en Shopify y un modo de conciliación aplicable. Los reembolsos y cancelaciones del pedido se leen con `read_orders`.
Consultar ubicaciones para stock	`read_locations`	Función de stock y ubicación exacta que se pretende utilizar.
Escribir cantidades de inventario	`write_inventory` y acceso a las ubicaciones necesarias	Compatibilidad del perfil, Subida de stock activada y modo global de escritura en Escritura habilitada. Los perfiles explícitos actuales no admiten esta opción.
Crear pedidos en Shopify	`write_orders`	Perfil de permisos en blanco, opción Crear pedidos en Shopify y modo global en Escritura habilitada. Los perfiles explícitos no la admiten.
Enviar por correo la invoice del pedido de Shopify	`write_orders`	La integración no usa esta acción: publicar el PDF no envía correo al cliente desde Shopify.

Los permisos de escritura disponibles en Shopify no garantizan que una combinación esté admitida en Beply. Mantén la función desactivada hasta que se compruebe esa combinación. La invoice por correo tiene un efecto sobre el destinatario y requiere revisión específica. Envío de invoice de Shopify.

Datos protegidos de cliente en Shopify

Shopify protege tanto los datos del pedido como los campos que identifican al comprador: nombre, dirección, correo y teléfono. Tener read_orders no basta para concluir que todos esos campos estarán disponibles.

La disponibilidad depende del tipo de app. Shopify distingue apps públicas, apps personalizadas y apps antiguas creadas en la administración. Las públicas requieren revisión; la disponibilidad de campos identificativos de las antiguas también puede depender del plan. Para una app personalizada propia del comercio, revisa la autorización efectiva de la instalación y los campos necesarios. No apliques por analogía un trámite de app pública.

Si Shopify deniega o oculta campos, conserva esa incidencia y revisa la autorización. No completes los datos por suposición. La comprobación de acceso puede realizarse sin mostrar valores personales ni incluirlos en capturas. Requisitos oficiales de datos protegidos.

Cambiar y verificar los permisos de Shopify

En una app del Dev Dashboard, modifica los permisos en una nueva versión y publícala. El comercio debe aprobar los nuevos accesos en Shopify; publicar la versión no actualiza automáticamente la autorización de cada instalación. Gestión de permisos de apps.

Beply diferencia permisos que faltan de permisos adicionales. Los que faltan impiden la operación. Los adicionales no la activan ni interrumpen por sí solos una conexión compatible. Pide a soporte una comprobación de los permisos efectivos para la cuenta y la operación; esa comprobación no necesita revelar el token.

Continúa con Conectar Shopify con Beply o Crear la app.