dcos-core-monalisav2-latam 1.0.0

package/src/common/utils/constants/account-error-codes.json

@@ -0,0 +1,801 @@
+{
+  "accountErrorCodes": {
+    "version": "1.0.0",
+    "lastUpdated": "2025-01-28",
+    "description": "Códigos de error para operaciones de Account Management (crear/actualizar cuentas)",
+    "totalCodes": 30,
+    "errors": {
+      "ACCOUNT_001": {
+        "code": "ACCOUNT_001",
+        "httpStatus": 400,
+        "message": "No body was found",
+        "description": "El cuerpo de la petición está vacío o no se recibió",
+        "context": "Validación inicial de la petición",
+        "category": "Validación de Entrada",
+        "severity": "high",
+        "possibleCauses": [
+          "Petición enviada sin body",
+          "Content-Type incorrecto",
+          "Datos corruptos en transmisión"
+        ],
+        "solutions": [
+          "Verificar que se está enviando un JSON válido en el body",
+          "Confirmar Content-Type: application/json",
+          "Validar la estructura de la petición"
+        ],
+        "relatedEndpoints": [
+          "POST /account/create",
+          "POST /account/sftp"
+        ]
+      },
+      
+      "ACCOUNT_002": {
+        "code": "ACCOUNT_002",
+        "httpStatus": 400,
+        "message": "Account name is required",
+        "description": "El campo AccountName es obligatorio pero no se proporcionó",
+        "context": "Validación de campos requeridos",
+        "category": "Validación de Entrada",
+        "severity": "high",
+        "possibleCauses": [
+          "AccountName no incluido en el JSON",
+          "AccountName con valor null o vacío",
+          "Error de tipeo en el nombre del campo"
+        ],
+        "solutions": [
+          "Incluir AccountName en el body de la petición",
+          "Verificar que AccountName tenga un valor válido",
+          "Confirmar la estructura del JSON"
+        ],
+        "relatedEndpoints": [
+          "POST /account/create",
+          "POST /account/sftp"
+        ]
+      },
+
+      "ACCOUNT_003": {
+        "code": "ACCOUNT_003",
+        "httpStatus": 400,
+        "message": "Client could not be created",
+        "description": "Error al crear el cliente asociado a la cuenta",
+        "context": "Creación de cliente en DynamoDB",
+        "category": "Creación de Cuenta/Cliente",
+        "severity": "high",
+        "possibleCauses": [
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes en la tabla de clientes",
+          "ClientId ya existe en el sistema",
+          "Formato inválido de ClientId"
+        ],
+        "solutions": [
+          "Verificar conectividad con DynamoDB",
+          "Revisar permisos IAM para la tabla CLIENT_DATA_CONFIG_TABLE",
+          "Usar un ClientId único",
+          "Validar formato del ClientId"
+        ],
+        "relatedTables": ["CLIENT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_004": {
+        "code": "ACCOUNT_004",
+        "httpStatus": 400,
+        "message": "Account could not be created",
+        "description": "Error al crear la cuenta en DynamoDB",
+        "context": "Creación de cuenta en DynamoDB",
+        "category": "Creación de Cuenta/Cliente",
+        "severity": "high",
+        "possibleCauses": [
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes en la tabla de cuentas",
+          "Cuenta ya existe con el mismo AccountName y ParentAccountName",
+          "Datos de configuración inválidos"
+        ],
+        "solutions": [
+          "Verificar conectividad con DynamoDB",
+          "Revisar permisos IAM para ACCOUNT_DATA_CONFIG_TABLE",
+          "Usar combinación única de AccountName/ParentAccountName",
+          "Validar estructura de datos de configuración"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_005": {
+        "code": "ACCOUNT_005",
+        "httpStatus": 400,
+        "message": "CodeCountry property is required when SetGeoCoordinatesGlobal or SetGeoCoordinatesApp is enabled",
+        "description": "CodeCountry es requerido cuando las coordenadas geográficas están habilitadas",
+        "context": "Validación de coordenadas geográficas",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "SetGeoCoordinatesGlobal=true sin CodeCountry",
+          "SetGeoCoordinatesApp=true sin CodeCountry",
+          "CodeCountry vacío o null"
+        ],
+        "solutions": [
+          "Incluir CodeCountry en la configuración",
+          "Usar código de país válido (ej: 'CO', 'MX', 'BR')",
+          "Deshabilitar coordenadas geográficas si no son necesarias"
+        ],
+        "relatedFields": ["SetGeoCoordinatesGlobal", "SetGeoCoordinatesApp", "CodeCountry"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_006": {
+        "code": "ACCOUNT_006",
+        "httpStatus": 400,
+        "message": "Default coordinates are not configured in ConditionsGeoCoordinates.default",
+        "description": "Las coordenadas por defecto no están configuradas correctamente",
+        "context": "Validación de coordenadas por defecto",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "ConditionsGeoCoordinates.default no existe",
+          "Coordenadas por defecto con formato incorrecto",
+          "Valores de latitud/longitud inválidos"
+        ],
+        "solutions": [
+          "Configurar ConditionsGeoCoordinates.default con latitude y longitude",
+          "Usar valores numéricos válidos para las coordenadas",
+          "Verificar el formato de las coordenadas geográficas"
+        ],
+        "relatedFields": ["ConditionsGeoCoordinates.default"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_007": {
+        "code": "ACCOUNT_007",
+        "httpStatus": 400,
+        "message": "Invalid default coordinates format",
+        "description": "El formato de las coordenadas por defecto es inválido",
+        "context": "Validación de formato de coordenadas",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "Latitud o longitud no son números",
+          "Valores fuera del rango válido (-90 a 90 para latitud, -180 a 180 para longitud)",
+          "Valores NaN o infinitos"
+        ],
+        "solutions": [
+          "Usar valores numéricos válidos",
+          "Verificar rango de latitud (-90 a 90)",
+          "Verificar rango de longitud (-180 a 180)"
+        ],
+        "relatedFields": ["ConditionsGeoCoordinates.default.latitude", "ConditionsGeoCoordinates.default.longitude"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_008": {
+        "code": "ACCOUNT_008",
+        "httpStatus": 400,
+        "message": "VTEX regions API returned status {status} for {context}",
+        "description": "Error al validar coordenadas con la API de regiones de VTEX",
+        "context": "Validación con API de VTEX",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "Credenciales VTEX inválidas",
+          "Coordenadas fuera del área de cobertura",
+          "Error temporal de la API de VTEX",
+          "País no soportado por VTEX"
+        ],
+        "solutions": [
+          "Verificar credenciales VTEX (key/token)",
+          "Usar coordenadas dentro del área de servicio",
+          "Reintentar la operación",
+          "Verificar que el país esté soportado"
+        ],
+        "relatedAPIs": ["VTEX Checkout Regions API"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_009": {
+        "code": "ACCOUNT_009",
+        "httpStatus": 400,
+        "message": "No regions found for coordinates {context} ({latitude}, {longitude})",
+        "description": "No se encontraron regiones VTEX para las coordenadas especificadas",
+        "context": "Validación de cobertura geográfica",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "Coordenadas fuera del área de cobertura VTEX",
+          "País no tiene regiones configuradas",
+          "Coordenadas incorrectas para el país especificado"
+        ],
+        "solutions": [
+          "Usar coordenadas dentro del área de cobertura",
+          "Verificar configuración de regiones en VTEX",
+          "Consultar áreas de servicio disponibles"
+        ],
+        "relatedAPIs": ["VTEX Checkout Regions API"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_010": {
+        "code": "ACCOUNT_010",
+        "httpStatus": 400,  
+        "message": "Account '{AccountName}' not found as seller for {context} ({latitude}, {longitude})",
+        "description": "La cuenta no está registrada como seller para las coordenadas especificadas",
+        "context": "Validación de seller en regiones",
+        "category": "Coordenadas Geográficas",
+        "severity": "medium",
+        "possibleCauses": [
+          "Cuenta no registrada como seller en VTEX",
+          "Configuración de regiones incompleta",
+          "SellerId diferente al AccountName"
+        ],
+        "solutions": [
+          "Registrar la cuenta como seller en VTEX",
+          "Configurar regiones de entrega para el seller",
+          "Verificar configuración de SellerId"
+        ],
+        "relatedAPIs": ["VTEX Seller Register API"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_011": {
+        "code": "ACCOUNT_011",
+        "httpStatus": 400,
+        "message": "ParentAccountName is required when SavePriceAudience or SavePriceTableCLWL is enabled",
+        "description": "ParentAccountName es requerido para funcionalidades de precio avanzadas",
+        "context": "Validación de configuración de email sharing",
+        "category": "Seller Email Sharing",
+        "severity": "high",
+        "possibleCauses": [
+          "SavePriceAudience=true sin ParentAccountName",
+          "SavePriceTableCLWL=true sin ParentAccountName",
+          "Configuración de seller incompleta"
+        ],
+        "solutions": [
+          "Configurar ParentAccountName para el seller",
+          "Configurar SellerId si el marketplace no requiere estas propiedades",
+          "Deshabilitar SavePriceAudience/SavePriceTableCLWL si no son necesarias"
+        ],
+        "relatedFields": ["SavePriceAudience", "SavePriceTableCLWL", "ParentAccountName"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_012": {
+        "code": "ACCOUNT_012",
+        "httpStatus": 400,
+        "message": "Parent account configuration not found: {ParentAccountName}",
+        "description": "No se encontró la configuración de la cuenta padre",
+        "context": "Validación de cuenta padre",
+        "category": "Seller Email Sharing",
+        "severity": "high",
+        "possibleCauses": [
+          "ParentAccountName no existe en el sistema",
+          "Error de tipeo en ParentAccountName",
+          "Cuenta padre no creada previamente"
+        ],
+        "solutions": [
+          "Crear la cuenta padre primero",
+          "Verificar el nombre de la cuenta padre",
+          "Confirmar que la cuenta padre esté activa"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_013": {
+        "code": "ACCOUNT_013",
+        "httpStatus": 400,
+        "message": "VTEX credentials not found in parent account: {ParentAccountName}",
+        "description": "Las credenciales VTEX no están configuradas en la cuenta padre",
+        "context": "Validación de credenciales VTEX",
+        "category": "Seller Email Sharing",
+        "severity": "high",
+        "possibleCauses": [
+          "Credentials.key faltante en cuenta padre",
+          "Credentials.token faltante en cuenta padre",
+          "Configuración de credenciales incompleta"
+        ],
+        "solutions": [
+          "Configurar key y token VTEX en la cuenta padre",
+          "Verificar permisos de las credenciales",
+          "Actualizar credenciales si han expirado"
+        ],
+        "relatedFields": ["Credentials.key", "Credentials.token"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_014": {
+        "code": "ACCOUNT_014",
+        "httpStatus": 400,
+        "message": "Seller not found in marketplace with SellerId: {SellerId}",
+        "description": "El seller no está registrado en el marketplace VTEX",
+        "context": "Validación de seller en marketplace",
+        "category": "Seller Email Sharing",
+        "severity": "high",
+        "possibleCauses": [
+          "SellerId no registrado en VTEX",
+          "Seller inactivo o suspendido",
+          "Error en configuración de marketplace"
+        ],
+        "solutions": [
+          "Registrar el seller en VTEX marketplace",
+          "Activar el seller si está inactivo",
+          "Verificar configuración de SellerId"
+        ],
+        "relatedAPIs": ["VTEX Seller Register API"],
+        "relatedFields": ["SellerId"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_015": {
+        "code": "ACCOUNT_015",
+        "httpStatus": 400,
+        "message": "Failed to update seller configuration. Please retry.",
+        "description": "Error al actualizar la configuración del seller en VTEX",
+        "context": "Actualización de políticas de seller",
+        "category": "Seller Email Sharing",
+        "severity": "medium",
+        "possibleCauses": [
+          "Error temporal de API VTEX",
+          "Permisos insuficientes en credenciales",
+          "Conflicto de concurrencia en actualización"
+        ],
+        "solutions": [
+          "Reintentar la operación",
+          "Verificar permisos de credenciales VTEX",
+          "Contactar soporte si el error persiste"
+        ],
+        "relatedAPIs": ["VTEX Seller Register API"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_016": {
+        "code": "ACCOUNT_016",
+        "httpStatus": 400,
+        "message": "Process is required",
+        "description": "El campo ProcessExecute es requerido para configuración SFTP",
+        "context": "Validación de configuración SFTP",
+        "category": "Configuración SFTP",
+        "severity": "high",
+        "possibleCauses": [
+          "ProcessExecute no incluido en el body",
+          "ProcessExecute con valor null o vacío"
+        ],
+        "solutions": [
+          "Incluir ProcessExecute en la configuración",
+          "Usar uno de los procesos válidos: prices, inventory, clients, cancel, status"
+        ],
+        "relatedFields": ["ProcessExecute"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_017": {
+        "code": "ACCOUNT_017",
+        "httpStatus": 400,
+        "message": "Process is not valid. The valid processes are: {VALID_PROCESSES}",
+        "description": "El proceso especificado no es válido para SFTP",
+        "context": "Validación de procesos SFTP",
+        "category": "Configuración SFTP",
+        "severity": "high",
+        "possibleCauses": [
+          "ProcessExecute con valor inválido",
+          "Error de tipeo en nombre del proceso"
+        ],
+        "solutions": [
+          "Usar procesos válidos: prices, cancel, inventory, clients, status",
+          "Verificar documentación de procesos SFTP disponibles"
+        ],
+        "relatedFields": ["ProcessExecute"],
+        "validProcesses": ["prices", "cancel", "inventory", "clients", "status"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_018": {
+        "code": "ACCOUNT_018",
+        "httpStatus": 404,
+        "message": "Account not found",
+        "description": "La cuenta especificada no existe en el sistema",
+        "context": "Búsqueda de cuenta para configuración",
+        "category": "Configuración SFTP",
+        "severity": "high",
+        "possibleCauses": [
+          "AccountName no existe",
+          "Cuenta eliminada o inactiva",
+          "Error en el nombre de la cuenta"
+        ],
+        "solutions": [
+          "Verificar que la cuenta existe",
+          "Crear la cuenta si es necesario",
+          "Confirmar el AccountName correcto"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_019": {
+        "code": "ACCOUNT_019",
+        "httpStatus": 400,
+        "message": "Warehouse is required",
+        "description": "El campo Warehouse es requerido para procesos de inventario SFTP",
+        "context": "Validación de configuración de inventario SFTP",
+        "category": "Configuración SFTP",
+        "severity": "high",
+        "possibleCauses": [
+          "ProcessExecute=inventory sin Warehouse",
+          "Warehouse con valor null o vacío"
+        ],
+        "solutions": [
+          "Incluir Warehouse para procesos de inventario",
+          "Verificar configuración de almacenes disponibles"
+        ],
+        "relatedFields": ["Warehouse", "ProcessExecute"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_020": {
+        "code": "ACCOUNT_020",
+        "httpStatus": 400,
+        "message": "Warehouse not found in the account configuration",
+        "description": "El almacén especificado no está configurado en la cuenta",
+        "context": "Validación de almacenes configurados",
+        "category": "Configuración SFTP",
+        "severity": "medium",
+        "possibleCauses": [
+          "Warehouse no existe en ChannelWarehouse",
+          "Error de tipeo en nombre del almacén",
+          "Configuración de almacenes incompleta"
+        ],
+        "solutions": [
+          "Configurar el almacén en ChannelWarehouse",
+          "Verificar nombres de almacenes disponibles",
+          "Actualizar configuración de la cuenta"
+        ],
+        "relatedFields": ["ChannelWarehouse", "Warehouse"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_021": {
+        "code": "ACCOUNT_021",
+        "httpStatus": 400,
+        "message": "SFTP Config could not be created",
+        "description": "Error al crear la configuración SFTP en DynamoDB",
+        "context": "Creación de configuración SFTP",
+        "category": "Configuración SFTP",
+        "severity": "high",
+        "possibleCauses": [
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes en tabla SFTP",
+          "Configuración SFTP duplicada"
+        ],
+        "solutions": [
+          "Verificar conectividad con DynamoDB",
+          "Revisar permisos IAM para SFTP_INBOUND_DATA_TABLE",
+          "Usar configuración única de Directory/ProcessExecute"
+        ],
+        "relatedTables": ["SFTP_INBOUND_DATA_TABLE"],
+        "relatedEndpoints": ["POST /account/sftp"]
+      },
+
+      "ACCOUNT_022": {
+        "code": "ACCOUNT_022",
+        "httpStatus": 500,
+        "message": "Error in properties and VTriggers",
+        "description": "Schema VTEX tiene campos requeridos faltantes",
+        "context": "Validación de schemas VTEX",
+        "category": "Schemas y Hooks VTEX",
+        "severity": "high",
+        "possibleCauses": [
+          "Schema sin Properties definidas",
+          "Schema sin VTriggers configurados",
+          "Estructura de schema incompleta"
+        ],
+        "solutions": [
+          "Configurar Properties en el schema",
+          "Definir VTriggers para el schema",
+          "Verificar estructura completa del schema"
+        ],
+        "relatedFields": ["Properties", "VTriggers"],
+        "relatedTables": ["SCHEMAS_VTEX_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_023": {
+        "code": "ACCOUNT_023",
+        "httpStatus": 400,
+        "message": "Error retrieving schema email",
+        "description": "Error al recuperar la configuración del schema de email",
+        "context": "Recuperación de schemas VTEX",
+        "category": "Schemas y Hooks VTEX",
+        "severity": "medium",
+        "possibleCauses": [
+          "Schema no existe en el sistema",
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes para schemas"
+        ],
+        "solutions": [
+          "Verificar que el schema existe",
+          "Revisar conectividad y permisos",
+          "Crear el schema si es necesario"
+        ],
+        "relatedTables": ["SCHEMAS_VTEX_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_024": {
+        "code": "ACCOUNT_024",
+        "httpStatus": 500,
+        "message": "Error in Filter and Hook",
+        "description": "Hook VTEX tiene campos requeridos faltantes",
+        "context": "Validación de hooks VTEX",
+        "category": "Schemas y Hooks VTEX",
+        "severity": "high",
+        "possibleCauses": [
+          "Hook sin Filter definido",
+          "Hook sin configuración Hook",
+          "Estructura de hook incompleta"
+        ],
+        "solutions": [
+          "Configurar Filter en el hook",
+          "Definir configuración Hook",
+          "Verificar estructura completa del hook"
+        ],
+        "relatedFields": ["Filter", "Hook"],
+        "relatedTables": ["HOOKS_VTEX_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_025": {
+        "code": "ACCOUNT_025",
+        "httpStatus": 400,
+        "message": "Error retrieving hook",
+        "description": "Error al recuperar la configuración del hook",
+        "context": "Recuperación de hooks VTEX",
+        "category": "Schemas y Hooks VTEX",
+        "severity": "medium",
+        "possibleCauses": [
+          "Hook no existe en el sistema",
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes para hooks"
+        ],
+        "solutions": [
+          "Verificar que el hook existe",
+          "Revisar conectividad y permisos",
+          "Crear el hook si es necesario"
+        ],
+        "relatedTables": ["HOOKS_VTEX_TABLE"],
+        "relatedEndpoints": ["POST /account/create"]
+      },
+
+      "ACCOUNT_026": {
+        "code": "ACCOUNT_026",
+        "httpStatus": 500,
+        "message": "Something went wrong, please check the data.",
+        "description": "Error interno del sistema durante la operación",
+        "context": "Error general del sistema",
+        "category": "Errores del Sistema",
+        "severity": "critical",
+        "possibleCauses": [
+          "Error no controlado en el código",
+          "Fallo de servicios dependientes",
+          "Datos corruptos o inconsistentes"
+        ],
+        "solutions": [
+          "Revisar logs detallados del error",
+          "Verificar estado de servicios dependientes",
+          "Contactar soporte técnico con detalles del error"
+        ],
+        "relatedEndpoints": ["POST /account/create", "POST /account/sftp"]
+      },
+
+      "ACCOUNT_027": {
+        "code": "ACCOUNT_027",
+        "httpStatus": 400,
+        "message": "Account name (an) parameter is required",
+        "description": "El parámetro 'an' (AccountName) es requerido en la URL",
+        "context": "Validación de parámetros de URL",
+        "category": "Validación de Entrada",
+        "severity": "high",
+        "possibleCauses": [
+          "Parámetro 'an' faltante en pathParameters",
+          "URL malformada",
+          "Error en routing de API Gateway"
+        ],
+        "solutions": [
+          "Incluir parámetro 'an' en la URL",
+          "Verificar formato de URL: /account/{an}",
+          "Confirmar configuración de API Gateway"
+        ],
+        "relatedEndpoints": ["GET /account/{an}", "DELETE /account/{an}"]
+      },
+
+      "ACCOUNT_028": {
+        "code": "ACCOUNT_028",
+        "httpStatus": 404,
+        "message": "Account '{accountName}' not found",
+        "description": "La cuenta especificada no existe para operaciones de consulta",
+        "context": "Búsqueda de cuenta específica",
+        "category": "Consultas de Cuenta",
+        "severity": "medium",
+        "possibleCauses": [
+          "AccountName no existe en el sistema",
+          "Cuenta eliminada",
+          "Error de tipeo en AccountName"
+        ],
+        "solutions": [
+          "Verificar que la cuenta existe",
+          "Confirmar el AccountName correcto",
+          "Crear la cuenta si es necesario"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["GET /account/{an}", "DELETE /account/{an}"]
+      },
+
+      "ACCOUNT_029": {
+        "code": "ACCOUNT_029",
+        "httpStatus": 404,
+        "message": "No accounts found for parent account '{parentAccountName}'",
+        "description": "No se encontraron cuentas asociadas a la cuenta padre especificada",
+        "context": "Búsqueda de cuentas por cuenta padre",
+        "category": "Consultas de Cuenta",
+        "severity": "low",
+        "possibleCauses": [
+          "ParentAccountName no tiene cuentas asociadas",
+          "Todas las cuentas fueron eliminadas",
+          "Error en configuración de relación padre-hijo"
+        ],
+        "solutions": [
+          "Verificar cuentas asociadas al ParentAccountName",
+          "Crear cuentas hijo si es necesario",
+          "Revisar configuración de jerarquía de cuentas"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["GET /account?parent={parentAccountName}"]
+      },
+
+      "ACCOUNT_030": {
+        "code": "ACCOUNT_030",
+        "httpStatus": 500,
+        "message": "Error retrieving accounts",
+        "description": "Error interno al recuperar información de cuentas",
+        "context": "Operaciones de consulta de cuentas",
+        "category": "Consultas de Cuenta",
+        "severity": "high",
+        "possibleCauses": [
+          "Error de conexión a DynamoDB",
+          "Permisos insuficientes",
+          "Error en consulta de base de datos"
+        ],
+        "solutions": [
+          "Verificar conectividad con DynamoDB",
+          "Revisar permisos IAM",
+          "Consultar logs detallados del error"
+        ],
+        "relatedTables": ["ACCOUNT_DATA_CONFIG_TABLE"],
+        "relatedEndpoints": ["GET /account", "GET /account/{an}"]
+      }
+    },
+
+    "errorCategories": {
+      "Validación de Entrada": {
+        "description": "Errores de validación de datos de entrada y parámetros",
+        "codes": ["ACCOUNT_001", "ACCOUNT_002", "ACCOUNT_027"],
+        "severity": "high",
+        "commonSolutions": [
+          "Verificar estructura del JSON",
+          "Validar campos requeridos",
+          "Confirmar Content-Type correcto"
+        ]
+      },
+      "Creación de Cuenta/Cliente": {
+        "description": "Errores durante el proceso de creación de cuentas y clientes",
+        "codes": ["ACCOUNT_003", "ACCOUNT_004"],
+        "severity": "high",
+        "commonSolutions": [
+          "Verificar conectividad con DynamoDB",
+          "Revisar permisos IAM",
+          "Validar unicidad de identificadores"
+        ]
+      },
+      "Coordenadas Geográficas": {
+        "description": "Errores de validación de coordenadas geográficas y regiones VTEX",
+        "codes": ["ACCOUNT_005", "ACCOUNT_006", "ACCOUNT_007", "ACCOUNT_008", "ACCOUNT_009", "ACCOUNT_010"],
+        "severity": "medium",
+        "commonSolutions": [
+          "Verificar configuración de coordenadas",
+          "Validar credenciales VTEX",
+          "Confirmar cobertura geográfica"
+        ]
+      },
+      "Seller Email Sharing": {
+        "description": "Errores de configuración de políticas de email sharing para sellers",
+        "codes": ["ACCOUNT_011", "ACCOUNT_012", "ACCOUNT_013", "ACCOUNT_014", "ACCOUNT_015"],
+        "severity": "high",
+        "commonSolutions": [
+          "Verificar configuración de seller",
+          "Validar credenciales VTEX",
+          "Confirmar registro en marketplace"
+        ]
+      },
+      "Configuración SFTP": {
+        "description": "Errores de configuración de procesos SFTP",
+        "codes": ["ACCOUNT_016", "ACCOUNT_017", "ACCOUNT_018", "ACCOUNT_019", "ACCOUNT_020", "ACCOUNT_021"],
+        "severity": "high",
+        "commonSolutions": [
+          "Verificar procesos SFTP válidos",
+          "Validar configuración de almacenes",
+          "Confirmar permisos de DynamoDB"
+        ]
+      },
+      "Schemas y Hooks VTEX": {
+        "description": "Errores de configuración de schemas y hooks de VTEX",
+        "codes": ["ACCOUNT_022", "ACCOUNT_023", "ACCOUNT_024", "ACCOUNT_025"],
+        "severity": "medium",
+        "commonSolutions": [
+          "Verificar estructura de schemas",
+          "Validar configuración de hooks",
+          "Confirmar existencia de recursos"
+        ]
+      },
+      "Consultas de Cuenta": {
+        "description": "Errores durante operaciones de consulta y recuperación de cuentas",
+        "codes": ["ACCOUNT_028", "ACCOUNT_029", "ACCOUNT_030"],
+        "severity": "medium",
+        "commonSolutions": [
+          "Verificar existencia de cuentas",
+          "Validar parámetros de consulta",
+          "Revisar permisos de lectura"
+        ]
+      },
+      "Errores del Sistema": {
+        "description": "Errores generales del sistema no categorizados",
+        "codes": ["ACCOUNT_026"],
+        "severity": "critical",
+        "commonSolutions": [
+          "Revisar logs del sistema",
+          "Verificar estado de servicios",
+          "Contactar soporte técnico"
+        ]
+      }
+    },
+
+    "severityLevels": {
+      "critical": {
+        "description": "Errores críticos que impiden el funcionamiento del sistema",
+        "responseTime": "Inmediato",
+        "escalation": "Soporte L3"
+      },
+      "high": {
+        "description": "Errores que impiden completar la operación solicitada",
+        "responseTime": "< 1 hora",
+        "escalation": "Soporte L2"
+      },
+      "medium": {
+        "description": "Errores que permiten workarounds o configuraciones alternativas",
+        "responseTime": "< 4 horas",
+        "escalation": "Soporte L1"
+      },
+      "low": {
+        "description": "Errores informativos o de configuración opcional",
+        "responseTime": "< 24 horas",
+        "escalation": "Documentación"
+      }
+    },
+
+    "troubleshootingGuide": {
+      "commonSteps": [
+        "1. Identificar el código de error específico",
+        "2. Revisar las posibles causas listadas",
+        "3. Aplicar las soluciones sugeridas en orden",
+        "4. Verificar logs detallados del sistema",
+        "5. Contactar soporte si el problema persiste"
+      ],
+      "logLocations": [
+        "CloudWatch Logs: /aws/lambda/account-validation",
+        "CloudWatch Logs: /aws/lambda/services_nodeflow",
+        "DynamoDB CloudWatch Metrics"
+      ],
+      "contactInfo": {
+        "support": "soporte-tecnico@empresa.com",
+        "documentation": "https://docs.internal.com/account-management",
+        "slack": "#account-management-support"
+      }
+    }
+  }
+}