Con lo que realmente estás lidiando

⚠️ Importante: El formato de exportación de Zoho Books no siempre coincide con el de importación. Reimportar un archivo exportado sin limpiarlo previamente es una de las maneras más fiables de reproducir este error.

¿Por qué ocurre este error?: Análisis de la causa raíz

El error "Introduzca el código de estado correcto" casi siempre se produce por una discrepancia en el valor de un campo : Zoho Books recibe un valor que no reconoce en un campo relacionado con el estado. Los desencadenantes más comunes son:

• El campo Lugar de suministro contiene el nombre completo del estado en lugar de un código reconocido.
• El estado de facturación o el estado de envío utilizan un formato inconsistente.
• El formato "StateName-XX" de un archivo exportado (por ejemplo, Maharashtra-27 ) no se limpió antes de la reimportación.
• Los códigos de estado no coinciden exactamente con la lista interna de valores aceptados de Zoho.
• Para cuentas sin GST: las abreviaturas estatales no coinciden con el país seleccionado.

La regla de oro: Zoho Books requiere valores de campo que reconozca con exactitud. No se admiten coincidencias aproximadas.

Antes de empezar: Conozca las especificaciones de su vehículo importado.

Zoho Books tiene requisitos técnicos específicos para la importación de facturas que conviene confirmar con antelación:

• ✅ Formatos compatibles: CSV, TSV y XLS
• ✅ Límite de tamaño de archivo: máximo 10 MB
• ✅ Codificación: UTF-8 (Unicode) — guarda tu CSV con esta codificación.
• ✅ Archivos XLSX: No son compatibles oficialmente con la importación de facturas; conviértalos primero a CSV o XLS.

Consejo práctico: Los archivos XLSX pueden provocar errores de datos silenciosos durante la importación (sobre todo con fechas). Guárdelos siempre como CSV (UTF-8) o XLS antes de importarlos.

Solución 1: Corregir el campo "Lugar de suministro" (Solución más común)

Para las cuentas de Zoho Books habilitadas para el GST en India , la columna "Lugar de suministro" es la principal causa de este error. Zoho requiere un código GST numérico de dos dígitos específico para el estado, no el nombre del estado.

El formato correcto

Cómo solucionarlo

Paso 1: Localice estos encabezados de columna en su archivo CSV:

• Place of Supply
• place_of_supply
• State
• Billing State
• Shipping State

Paso 2: Reemplace todos los nombres de los estados con sus códigos numéricos de 2 dígitos usando la función Buscar y reemplazar (Ctrl+H en Excel o Google Sheets).

Paso 3: Realice una prueba con 3 a 5 filas antes de ejecutar la importación masiva completa.

Solución 2: Deja de usar tu exportación como plantilla de importación.

Esta es la trampa en la que caen la mayoría de los usuarios. Al exportar facturas desde Zoho Books, el campo Lugar de suministro a menudo se exporta en un formato combinado como este:

 Maharashtra-27

Pero el validador de importación de Zoho solo acepta:

 27

Cómo limpiarlo

En Excel:

 =RIGHT(A2, 2)

(Extrae los dos últimos caracteres: el código numérico)

En Google Sheets:

 =REGEXEXTRACT(A2, "\d+$")

(Extrae los dígitos finales)

Otras discrepancias entre exportación e importación a tener en cuenta

Elimine también las columnas que solo se pueden exportar y que no aparecen en la plantilla de importación de Zoho; las columnas adicionales pueden provocar fallos de validación a nivel de fila en todo el archivo.

Solución 3: Utilice la plantilla de ejemplo oficial de Zoho.

Incluso con datos correctos, los encabezados de columna incorrectos provocan que Zoho interprete mal los campos y genere errores de validación. La opción más segura es comenzar siempre con la plantilla propia de Zoho.

Paso 1: Navegue a Zoho Books → Facturas → Importar

Paso 2: Haga clic en "Descargar archivo de ejemplo" y utilícelo como base. No cambie el nombre de las columnas.

Paso 3: Mapee correctamente estos campos críticos:

 ✅ Key Column Names (exact spelling matters):
 - CustomerName → Customer's full name
 - InvoiceDate → Match your org's date format (DD/MM/YYYY or MM/DD/YYYY)
 - PlaceOfSupply → 2-digit state code (eg, 27)
 - BillingState → State name OR code (check org preference)
 - ShippingState → State name OR code
 - ItemTaxName → Must match existing tax name in Zoho exactly

Paso 4: Verifique el formato de fecha en:
Settings → Organization Profile → Date Format

⚠️ Las discrepancias en el formato de fecha pueden provocar errores en otros campos, incluidos fallos en la validación del estado, por lo que siempre debe confirmar esta configuración primero.

Solución 4: Referencia completa del código estatal del GST

Zoho Books mantiene una lista interna de códigos de estado válidos. Úsela como referencia principal:

 01 - Jammu & Kashmir 19 - West Bengal
 02 - Himachal Pradesh 20 - Jharkhand
 03 - Punjab 21 - Odisha
 04 - Chandigarh 22 - Chhattisgarh
 05 - Uttarakhand 23 - Madhya Pradesh
 06 - Haryana 24 - Gujarat
 07 - Delhi 25 - Daman & Diu
 08 - Rajasthan 26 - Dadra & Nagar Haveli
 09 - Uttar Pradesh 27 - Maharashtra
 10 - Bihar 28 - Andhra Pradesh (Old)
 11 - Sikkim 29 - Karnataka
 12 - Arunachal Pradesh 30 - Goa
 13 - Nagaland 31 - Lakshadweep
 14 - Manipur 32 - Kerala
 15 - Mizoram 33 - Tamil Nadu
 16 - Tripura 34 - Puducherry
 17 - Meghalaya 35 - Andaman & Nicobar
 18 - Assam 36 - Telangana
 37 - Andhra Pradesh (New)
 38 - Ladakh
 97 - Other Territory
 99 - Centre Jurisdiction

⚠️ Presta atención a los códigos obsoletos: Ladakh (38) y la división actualizada de Andhra Pradesh (28 frente a 37) son incorporaciones recientes. Las plantillas antiguas pueden contener valores desactualizados que provocarán fallos en la validación.

Solución 5: Utilice la herramienta de asignación de campos de Zoho durante la importación.

En lugar de corregir el archivo CSV a ciegas, utilice el mapeador de campos interactivo de Zoho para detectar discrepancias antes de que se produzcan errores.

Paso 1: Iniciar la importación:
Invoices → ⋮ (More) → Import Invoices → Upload CSV

Paso 2: En la pantalla de mapeo, verifique manualmente:

• El campo " Place of Supply se corresponde con el campo "Lugar de suministro" de Zoho (no con un campo genérico de "Estado").
• Las columnas de estado de facturación y envío se corresponden con sus respectivos campos.
• Ningún campo crítico está configurado como "No importar".

Paso 3: Utilice las filas de vista previa : Zoho muestra una muestra de las primeras filas antes de confirmar los cambios. Compruebe que los valores de estado aparecen como códigos limpios de 2 dígitos.

Paso 4: Guarda tu perfil de mapeo una vez que funcione correctamente. Las importaciones futuras no requerirán reconfiguración.

Solución 6: Cuentas sin GST / Cuentas internacionales

Si su cuenta de Zoho Books no está habilitada para el GST (EE. UU., Reino Unido u otras regiones), el error del código de estado tiene una causa completamente diferente.

Para cuentas en EE. UU. , utilice las abreviaturas estándar de 2 letras del USPS (Servicio Postal de los Estados Unidos):

 California → CA | New York → NY
 Texas → TX | Florida → FL
 Illinois → IL | Ohio → OH
 Georgia → GA | Washington → WA

Factores desencadenantes comunes que no están relacionados con el GST (Impuesto sobre Bienes y Servicios):

• Country = United States pero State = Ontario → discrepancia entre país y estado
• El campo Estado está en blanco cuando las reglas fiscales requieren un valor → rellene con N/A o un valor predeterminado.
• La abreviatura del estado utiliza 3 letras en lugar de las 2 estándar.

Lista de verificación de diagnóstico rápido

Ejecute esto antes de cada intento de importación:

 □ Place of Supply uses 2-digit numeric codes (GST accounts)
 □ Column headers match Zoho's official sample template exactly
 □ Date format matches organization settings (Settings → Org Profile)
 □ No merged cells or extra header rows in the CSV
 □ Tax names match exactly what's configured in Zoho Books
 □ No special characters or extra spaces in state fields
 □ File saved as CSV (UTF-8) or XLS — not XLSX
 □ Billing/Shipping country and state are consistent
 □ Removed export-only columns not accepted on import
 □ File size is under 10 MB
 □ Tested with 3–5 rows before full bulk import

Orden de reparación recomendada

 1️⃣ Download Zoho's official import sample template (don't reuse exports)
 2️⃣ Fix Place of Supply → replace with 2-digit numeric state codes
 3️⃣ Clean exported data: strip "StateName-XX" → keep only "XX"
 4️⃣ Verify date format matches your org settings
 5️⃣ Remove extra/export-only columns from the file
 6️⃣ Test import with 5 rows using the field mapping tool
 7️⃣ Save the mapping profile, then run the full bulk import

Optimice todo su flujo de trabajo de facturación.

Solucionar el error de importación es el primer paso, pero si sueles gestionar grandes volúmenes de facturación, conviene considerar todas las posibilidades. Zoho Books va mucho más allá de la importación de archivos CSV: la facturación recurrente automatizada, la presentación de declaraciones de impuestos, los recordatorios de pago y los paneles financieros en tiempo real se integran en la misma plataforma. Si aún no la utilizas de principio a fin, probablemente estés perdiendo tiempo valioso.

Para las empresas que gestionan el inventario junto con la facturación, Zoho Inventory se integra directamente con Zoho Books, manteniendo sincronizados los niveles de existencias, los pedidos de compra y las facturas sin necesidad de conciliación manual.

Y si necesitas automatizar por completo los flujos de trabajo de importación repetitivos —por ejemplo, extraer datos de facturas de un sistema de terceros e importarlos a Zoho Books según un cronograma— Zoho Flow puede encargarse de ello sin escribir una sola línea de código.

Lecturas relacionadas

Si estás lidiando con otros problemas relacionados con los datos y la importación en Zoho, estos recursos del blog Creator Scripts pueden resultarte útiles:

• Gestión de inventario de Zoho: Método del costo promedio ponderado : combine la importación de facturas con una gestión de costos de inventario más inteligente.
• Dominando las salidas de funciones personalizadas de Zoho Flow : automatiza los flujos de datos entre las aplicaciones de Zoho.
• Solucionar problemas de solicitudes no válidas en Zoho Mail : solucionar otros patrones de error comunes de Zoho.
• Socios de Zoho: Respondemos a las 10 preguntas más frecuentes : Descubra cómo los socios de Zoho pueden acelerar su configuración.

Recursos adicionales

¿Sigues atascado? Obtén ayuda de expertos.

Si has probado todas las soluciones anteriores y el error persiste, es probable que se trate de un problema de configuración de campos específico de la organización , algo que no es visible solo en el archivo CSV. En ese caso:

1. Comuníquese con el soporte de Zoho Books y envíeles un archivo CSV de muestra de 5 filas; ellos podrán identificar posibles discrepancias de configuración por su parte.
2. Trabaje con un socio de Zoho que pueda auditar la configuración de su organización e importar la configuración directamente.

El equipo de Creator Scripts se especializa precisamente en este tipo de solución de problemas y configuración de Zoho Books. Ya sea que necesites solucionar un problema de importación puntual o implementar un flujo de trabajo contable completo, contáctanos aquí y te ayudaremos a que tus importaciones funcionen correctamente.

Conclusiones clave

• ✅ Nunca reutilice un archivo exportado como plantilla de importación : los formatos de exportación e importación de Zoho difieren.
• ✅ El lugar de suministro requiere códigos GST numéricos de 2 dígitos (por ejemplo, 27 no Maharashtra ).
• ✅ Los formatos de importación admitidos son CSV, TSV y XLS (no XLSX), con un límite de tamaño de archivo de 10 MB.
• ✅ Siempre realice una prueba con 3 a 5 filas antes de confirmar una importación masiva completa.
• ✅ Guarda tu perfil de asignación de campos para evitar tener que reconfigurarlo en cada importación.
• ✅ Las discrepancias en el formato de fecha pueden provocar errores de validación de estado; verifique siempre primero la configuración de la organización.

✅ Resumen de optimización

Verificaciones de datos y correcciones aplicadas