Códigos de Error

{
  "detail": "Mensaje descriptivo",
  "error_code": "categoria.error_especifico"
}

async function downloadXML(documentId: string) {
  try {
    const response = await fetch(
      `https://api.integracpe.com/api/v1/sunat/receptor/xml/${documentId}`,
      {
        headers: {
          'Authorization': 'Bearer sk_live_tu_api_key'
        }
      }
    );

    if (!response.ok) {
      const error = await response.json();
      const [category] = String(error.error_code).split('.');

      switch (category) {
        case 'auth':
          if (error.error_code === 'auth.trial_expired') {
            console.log('Trial expirado. Suscríbete a un plan.');
            // Redirigir a página de planes
          } else {
            console.log('Error de autenticación:', error.detail);
          }
          break;

        case 'sunat': {
          const retryAfter = response.headers.get('Retry-After');
          if (error.error_code === 'sunat.auth_failed') {
            // Definitivo: la clave SOL no sirve. NO reintentar (puede bloquear la cuenta SOL)
            console.log('Actualizar la Clave SOL de la API Key:', error.detail);
          } else if (error.error_code === 'sunat.document_not_ready') {
            // "Todavía no": reintentar en horas, no en segundos
            console.log(`Aún no disponible. Reintentar en ${retryAfter}s o más`);
          } else if (
            error.error_code === 'sunat.request_failed' ||
            error.error_code === 'sunat.auth_unavailable'
          ) {
            console.log(`Falla pasajera de SUNAT. Reintentar en ${retryAfter}s (con backoff)`);
          } else {
            // document_not_found, resource_not_available, supplier_excluded: definitivos
            console.log('Definitivo, no reintentar:', error.detail);
          }
          break;
        }

        case 'rate_limit':
          console.log(`Rate limit. Esperar ${response.headers.get('Retry-After')}s`);
          break;

        case 'validation':
          console.log('Error de validación:', error.detail);
          // Mostrar error al usuario
          break;

        default:
          // Cuota y otros sin prefijo con punto: quota_exceeded, enterprise_quota_exceeded...
          if (error.error_code === 'quota_exceeded' || error.error_code === 'enterprise_quota_exceeded') {
            console.log(`Cuota excedida. Reintentar en ${response.headers.get('Retry-After')}s`);
          } else {
            console.log('Error:', error.detail);
          }
      }

      throw new Error(error.detail);
    }

    return await response.json();

  } catch (error) {
    console.error('Error de conexión:', error);
    throw error;
  }
}