> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importa códigos de cliente

> Carga la homologación de cada cliente: el código con el que esa cadena identifica cada uno de tus productos.

Muchas cadenas no imprimen tu SKU ni el código de barras en sus órdenes de compra: usan un código interno propio, distinto para cada cadena. Los **códigos de cliente** son esa homologación dentro de Riqra: por cada empresa, qué código suyo corresponde a qué producto tuyo.

Con los códigos cargados, las líneas de una OC se asignan solas desde el primer archivo. Además, si el documento no imprime el RUC del comprador, Riqra puede deducir la empresa a partir de sus códigos.

## Dónde importar

* Desde **[Empresas](https://app.riqra.com/clients/companies)**, con **Importar → Códigos de cliente**, para cargar códigos de varias empresas en un solo archivo.
* Desde la pestaña **Códigos** del detalle de una empresa, con **Importar códigos**.

Descarga la plantilla con **Descargar plantilla** en el diálogo de importación.

## Formato del archivo

Una fila por combinación de empresa y código. Tres columnas:

| Columna  | Cómo completarla                                                                           |
| -------- | ------------------------------------------------------------------------------------------ |
| `ruc`    | Documento fiscal de la empresa. La empresa ya debe existir en Riqra. Máximo 50 caracteres. |
| `codigo` | Código con el que esa empresa identifica tu producto. Máximo 120 caracteres.               |
| `sku`    | SKU de tu variante en Riqra. La variante ya debe existir. Máximo 64 caracteres.            |

| `ruc`         | `codigo`  | `sku`              |
| ------------- | --------- | ------------------ |
| `20512345671` | `718803`  | `QUESO-FRESCO-500` |
| `20512345671` | `718804`  | `YOGURT-NAT-1L`    |
| `20487654320` | `55-0212` | `QUESO-FRESCO-500` |

Guarda el archivo como `.xlsx` (hasta 10 MB y 10 000 filas) y conserva las tres columnas con formato de texto: los RUC, los códigos con ceros a la izquierda y los SKU numéricos se dañan si Excel los trata como números.

## Reglas

* Los códigos son **por empresa**. El mismo producto puede tener un código distinto en cada cadena, y dos cadenas pueden usar el mismo número para productos distintos sin conflicto.
* Cada empresa admite un solo SKU por código. Riqra ignora los espacios dentro del código al compararlo: `71 8803` y `718803` son el mismo código, y dos filas así en un archivo se marcan como duplicadas.
* Reimportar un código existente actualiza el SKU al que apunta.
* La empresa y el producto deben existir antes de importar. Si no, la fila falla con `Empresa no encontrada` o `Producto no encontrado`: importa primero [clientes](/ecommerce/transferencia-de-datos/importar-clientes) y [productos](/ecommerce/transferencia-de-datos/importar-productos).

Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo: [Reporte de errores](/ecommerce/transferencia-de-datos/reporte-de-errores).

## Importados y aprendidos

La pestaña **Códigos** de cada empresa muestra todos sus códigos con su origen:

* **Importado**: cargado por archivo y aún sin usar en una OC.
* **Aprendido**: creado o confirmado al revisar órdenes de compra. Cada vez que asignas a mano una línea y confirmas la orden, Riqra guarda el código para esa empresa.

También verás cuántas veces se usó cada código. No necesitas mantener el archivo al día a mano: la homologación crece sola con cada orden confirmada.

## Exportar

* Desde la pestaña **Códigos** de una empresa: exporta solo la homologación de esa empresa.
* Desde **Empresas**, con **Exportar → Códigos de cliente**: exporta los códigos de todas tus empresas.

El archivo exportado usa el mismo formato de la importación, así que puedes editarlo y volver a subirlo.