Importar y exportar un archivo CSV de contratos

Puedes utilizar un archivo CSV (valores separados por comas) para importar contratos de una aplicación externa de suscripciones en la aplicación Shopify Subscriptions o exportar contratos desde esta última aplicación.

Para obtener más información sobre cómo usar archivos CSV, consulta Abrir y editar un archivo CSV.

Descargar un archivo CSV de muestra

Puedes descargar y ver un archivo CSV de contratos de muestra y usarlo como plantilla.

Consideraciones para el archivo CSV de contratos

Antes de usar un archivo CSV de contratos para importar contratos, revisa las siguientes consideraciones.

Dar formato al archivo CSV

Para que el archivo CSV de contratos se importe de forma adecuada, verifica que cumpla con los siguientes criterios:

  • La primera línea del archivo CSV de contratos debe contener los encabezados de las columnas tal como se especifican en la tabla de descripción del archivo CSV de contratos.
  • Cada columna debe estar separada por una coma.
  • Un archivo CSV puede tener un tamaño máximo de 10 MB.

Entender la columna del identificador

El identificador se usa para identificar a cada contrato de manera única. Los identificadores se usan para gestionar los datos de las siguientes maneras:

  • Agrupar contratos con varias líneas de artículo: los contratos con varias líneas de artículo se agrupan por un identificador compartido.
  • Evitar contratos duplicados: se omiten los contratos duplicados al importar. Si una fila con el mismo identificador se importó anteriormente de forma correcta, esa fila se omite en el nuevo proceso de importación. Este mecanismo ayuda a evitar la duplicación de datos.

Contratos con varias líneas de artículo

Los contratos que incluyen varias líneas de artículo requieren una fila separada para cada una de ellas y se agrupan junto con la columna del identificador.

Por ejemplo, si un contrato tiene tres líneas de artículo, se debe agregar cada una de ellas como una fila separada. La primera fila contiene toda la información del contrato y las siguientes dos filas solo contienen valores en las siguientes columnas:

  • handle
  • line_variant_id
  • line_quantity
  • line_current_price
  • Opcional: line_selling_plan_id
  • Opcional: line_selling_plan_name

El identificador debe ser idéntico para las tres columnas. Todas las demás columnas en las filas dos y tres deben estar vacías.

Descripción del archivo CSV

La información utilizada en el archivo CSV de contratos se divide en las siguientes categorías: * El nombre del contrato * Los datos del cliente y de facturación * La forma y los detalles de entrega * Los artículos incluidos en la suscripción

Todas las columnas deben agregarse al archivo CSV para importarse correctamente y todos los campos son obligatorios, a menos que se indique lo contrario.

Descripción de las columnas en el archivo CSV de contratos
Columna Descripción
Handle Los identificadores son únicos para cada contrato. Pueden contener letras y números, y suelen ser una cadena combinada de letras, números o ambos. Cada contrato debe tener un identificador único.
upcoming_billing_date La próxima fecha de facturación del contrato. La hora se indica en UTC (Tiempo Universal Coordinado), y debe tener el formato AAAA-MM-DDTHH:MM:SSZ. Por ejemplo, las 15:50 h del 7 de septiembre de 2019 en el huso horario de UTC (Tiempo Universal Coordinado) se representan como 2019-09-07T15:50:00Z.
customer_id La identificación del cliente. Debe coincidir con la de un cliente existente en el panel de control de Shopify.
currency_code El código de moneda del contrato. El código de moneda debe coincidir con una moneda que esté activa en la tienda.
status El estado del contrato. Los contratos pueden tener uno de los siguientes estados:
  • Activo
  • En pausa
cadence_interval La frecuencia de entrega de la suscripción. Un contrato puede tener uno de los siguientes intervalos de cadencia:
  • Semanal
  • Mes
  • Año
cadence_interval_count La frecuencia de entrega de la suscripción dentro del intervalo general. Por ejemplo, el recuento del intervalo de cadencia para cada mes es 1 y el intervalo de cadencia para cada dos semanas es 2.
customer_payment_method_id La identificación de la forma de pago que utilizó el cliente para el contrato.
delivery_price El precio de la entrega en el formato de moneda correcto.
delivery_method_type La forma de entrega de la suscripción. Debe ser uno de los siguientes tipos:
  • Envíos
  • Entrega local
  • Retiro
  • Ninguno
delivery_address_first_name El nombre del destinatario en la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_last_name El apellido del destinatario en la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_address1 La primera línea de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_address2 La segunda línea de la dirección de entrega. Este campo es obligatorio solo si la dirección tiene un segundo campo y la forma de entrega es Envío o Entrega Local.
delivery_address_city La ciudad de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_province_code La provincia o el estado de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_country_code El código de país de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_company El nombre de la empresa de la dirección de entrega. Este campo es obligatorio solo si el pedido es para un negocio y la forma de entrega es Envío o Entrega local.
delivery_address_zip El código postal de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_address_phone El número de teléfono de la dirección de entrega. Este campo solo es obligatorio para las formas de entrega Envío y Entrega local.
delivery_local_delivery_phone El número de teléfono de la dirección de entrega. Este campo es obligatorio para suscripciones con la forma de entrega Entrega local.
delivery_local_delivery_instructions Instrucciones de entrega local. Este campo solo se debe incluir cuando se proporcionan instrucciones para suscripciones con la forma de entrega Entrega local.
delivery_pickup_method_location_id La identificación de la sucursal para el método de retiro. Este campo solo es obligatorio para suscripciones con la forma de entrega Retiro en tienda.
line_variant_id La identificación de cada línea de artículo incluida en la suscripción. Si hay varias líneas de artículo incluidas en la suscripción, cada una se debe agregar como una nueva línea con la identificación de variante única.
line_quantity La cantidad de cada línea de artículo incluida en la suscripción. Si hay varias líneas de artículo incluidas en la suscripción, es recomendable que la cantidad agregada sea para ese artículo específico, no para la cantidad total de todos los artículos incluidos.
line_current_price El precio de la línea de artículo de suscripción en el formato de moneda correcto.
line_selling_plan_id La identificación del plan de suscripción. Este campo es opcional.
line_selling_plan_name El nombre del plan de suscripción. Este campo es opcional.

Importar contratos con un archivo CSV

Puedes usar un archivo CSV para importar contratos existentes desde una aplicación de suscripción externa de la Shopify App Store u otra tienda de Shopify a tu aplicación Shopify Subscriptions. No se puede usar un archivo CSV para editar o sobrescribir contratos existentes. Al importar, se omiten los duplicados de contratos existentes.

Pasos:

  1. Desde tu panel de control de Shopify, ve a Suscripciones > Contratos.
  2. Haz clic en Importar.
  3. Haz clic en Agregar archivo y luego selecciona el archivo CSV que deseas importar.
  4. Haz clic en Cargar archivos.

Después de que el archivo CSV se suba, recibirás un correo electrónico de confirmación de Shopify en la cuenta que utilizaste para configurar la tienda de Shopify. Lee las soluciones para errores de importación comunes a fin de resolver cualquier problema de importación.

Exportar contratos con un archivo CSV

Puedes exportar los contratos para tus registros o importar a otra tienda de Shopify donde tengas instalada la aplicación Shopify Subscriptions.

Pasos:

  1. Desde tu panel de control de Shopify, ve a Suscripciones > Contratos.
  2. Haz clic en Exportar.

¿Estás listo/a para comenzar a vender con Shopify?

Prueba gratis