CFDI ExpressCFDI Express
If you are an LLM read this 🤖

Carga Masiva de Productos (CSV)

Para tiendas con muchos productos, CFDI Express permite asignar los códigos del SAT (código de producto, unidad, IEPS e IVA especial) a varios productos a la vez mediante una carga masiva por CSV. Esto evita editar producto por producto.

Formato del CSV

El archivo debe tener encabezados y una fila por producto, identificado por su SKU:

Columna Descripción
sku SKU del producto en Shopify (obligatorio)
codigo Código de producto/servicio del SAT
unidad Código de unidad del SAT
ieps_enabled true / false — si el producto lleva IEPS
ieps_rate Tasa de IEPS (ej. 0.08 para 8%)
iva_override true / false — si usas IVA especial
iva_rate Tasa de IVA especial (ej. 0.0 para 0%, 0.16 para 16%)

TODO: Ejemplo de archivo CSV con las columnas

Si dejas vacías las columnas por producto, conservará el valor que ya tenga configurado. Si quieres limpiar todos los metafields de un producto, usa la acción clear en la página individual del producto (Códigos del SAT por producto).

Cómo subir el CSV

  1. Entra a CFDI Express → Productos.
  2. Localiza el botón de carga masiva (CSV).

TODO: Botón de carga masiva CSV

  1. Sube tu archivo .csv con las columnas indicadas.
  2. CFDI Express encola un trabajo en segundo plano (BullMQ) que irá actualizando los metafields de los productos uno por uno mediante GraphQL de Shopify.

Por el volumen, la actualización no es instantánea; puedes cerrar la app y regresar más tarde. Cada producto actualizado pasa a tener sus códigos disponibles para el timbrado.

Recomendaciones

  • Usa los códigos predeterminados de Configuraciones para los productos genéricos y sólo sobreescribe los específicos en el CSV (menos trabajo).
  • Verifica los SKUs; si un SKU no existe en tu tienda, esa fila no tendrá efecto.
  • Para tasas, usa formato decimal con punto (ej. 0.08), no porcentaje.

Limpieza por producto

Si en algún momento requieres quitar todos los metafields de SAT de un producto en específico, abre el producto desde Productos y usa la acción "clear", que eliminará todos los metafields asociados de ese producto.

Video Tutorial