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.
En esta página
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. Puedes descargar la plantilla de archivo CSV de muestra para revisar un ejemplo de un contrato de varias líneas de artículo.
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.
| Columna | Descripción |
|---|---|
| Handle | Los identificadores son únicos para cada contrato. Por ejemplo, camisa roja. 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 YYYY-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. El valor de próxima fecha de facturación debe establecerse en una fecha y hora al menos 24 horas después de la fecha y hora en que se importa el archivo CSV. |
| customer_id | La identificación del cliente. La identificación debe coincidir con la de un cliente existente en el panel de control de Shopify y debe ser una cadena de números. Por ejemplo, 6320530986896. |
| 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:
|
| cadence_interval | La frecuencia de entrega de la suscripción. Un contrato puede tener uno de los siguientes intervalos de cadencia:
|
| 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. La identificación es un código alfanumérico único. Por ejemplo, 24e8c839c47ef47d30ad28346d130e74. |
| 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:
|
| 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 | El código ISO de 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 ISO del 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: por ejemplo, +1 (613) 555-5555. 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. Por ejemplo 53154087005812. 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: por ejemplo, 3607724288. 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 elegible desde la Shopify App Store o desde la aplicación Shopify Subscriptions en otra tienda.
No se puede usar un archivo CSV para editar o sobrescribir contratos existentes. Al importar, se omiten los duplicados de contratos existentes.
Importar contratos desde una aplicación de suscripción externa
Es posible que puedas importar contratos desde una aplicación de suscripción externa. Ten en cuenta los siguientes comportamientos al importar desde una aplicación externa:
- Si la aplicación de suscripción externa no está integrada a Shopify Checkout, no podrás importar los contratos.
- No puedes importar datos directamente desde la aplicación externa. Debes agregar los datos del contrato de la aplicación externa a un archivo CSV compatible con la aplicación Shopify Subscriptions en el formato correcto para importar.
- Si la aplicación de suscripción externa no tiene una función de exportación o si la exportación no incluye todos los datos requeridos, contacta al desarrollador de la aplicación para obtener ayuda.
Pasos:
- Desde tu panel de control de Shopify, ve a Suscripciones > Contratos.
- Haz clic en Importar.
- Haz clic en Agregar archivo y luego selecciona el archivo CSV que deseas importar.
- 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:
- Desde tu panel de control de Shopify, ve a Suscripciones > Contratos.
- Haz clic en Exportar.